Перейти до змісту

DOCX-шаблони (MS Word) і змінні {{ ... }}

Плагін xml_ua може генерувати текстові документи (Word .docx) з вашого обмінного XML: він бере значення з XML і підставляє їх у DOCX‑шаблон у місцях, де ви написали змінні на кшталт {{ParcelOwner}}.

Це зручно, коли у вас багато однотипних документів (пояснювальна записка, титульний аркуш, акти тощо) і не хочеться щоразу переписувати одні й ті самі реквізити вручну.

Як це працює (простими словами)

  1. Ви готуєте обмінний файл .xml (геометрія + атрибути).
  2. Ви маєте шаблон .docx, у якому частина тексту — звичайна, а частина — “змінні” {{ ... }}.
  3. У меню плагіна обираєте потрібний шаблон.
  4. Плагін створює новий .docx (заповнений) і зберігає його поруч із вашим .xml (та відкриває у Word, якщо він встановлений).

Швидкий старт: як додати шаблон

  1. Підготуйте ваш .docx шаблон (можна з нуля, але простіше — з копії існуючого).
  2. Скопіюйте .docx у папку плагіна templates/ (див. сторінку Папка плагіна).
  3. Відкрийте меню: Документація → Текстовий документ і виберіть шаблон.

Як створювати шаблони “під себе”

Найкраща стратегія — не робити з нуля, а взяти готовий шаблон і підправити.

Варіант А: змінити існуючий шаблон

  1. Знайдіть шаблон, який найближчий до вашої задачі.
  2. Зробіть копію (щоб “оригінал” лишився на випадок помилок).
  3. Відредагуйте текст: додайте/приберіть розділи, таблиці, оформлення.
  4. Залиште або додайте змінні {{ ... }} у потрібних місцях.

Варіант Б: зробити свій шаблон з нуля

  1. Створіть новий .docx у Word.
  2. Напишіть “скелет” документа.
  3. Уставте змінні {{VariableName}} як звичайний текст.
  4. Покладіть файл у templates/ і перевірте генерацію на одному тестовому .xml.

Як “прибрати зайві” шаблони з меню

Коли шаблонів стає багато, це починає заважати. Є прості способи керувати списком:

1) Сховати в підпапки (рекомендовано)

Залишайте активні шаблони в корені templates/, а старі/чернетки переносьте в підпапки, наприклад:

  • templates/_archive/
  • templates/_drafts/
  • templates/old/

У багатьох реалізаціях список меню збирається з файлів, що лежать безпосередньо в templates/. Якщо у вашій версії плагіна шаблони з підпапок усе одно з’являються в меню — використайте спосіб 2.

2) Тимчасово вимкнути шаблон (через розширення)

Плагін шукає саме файли .docx. Тому можна перейменувати файл, наприклад:

  • my_template.docx → my_template.docx.off

Після цього шаблон не буде сприйматися як Word‑шаблон і не має показуватися в списку.

3) Почистити папку

Якщо шаблон точно не потрібен — видаліть або перенесіть його в окреме місце (наприклад, у ваш “банк” шаблонів поза папкою плагіна).

Важливі правила для змінних {{ ... }}

  • Регістр важливий: {{ParcelOwner}} і {{parcelowner}} — це різні змінні.
  • Використовуйте саме подвійні фігурні дужки: {{ ... }}.
  • Пишіть змінну одним “суцільним” фрагментом (не розривайте переносами/форматуванням усередині {{ ... }}).

Список змінних (доступні в користувацьких шаблонах)

Виконавець робіт

  • {{ExecutorCompanyName}} — назва організації виконавця робіт (CompanyName)
  • {{ExecutorRegion}} — область адреси виконавця
  • {{ExecutorSettlement}} — населений пункт адреси виконавця
  • {{ExecutorStreet}} — вулиця адреси виконавця
  • {{ExecutorApt}} — будинок/будівля адреси виконавця

Земельна ділянка

  • {{ParcelOwner}} — власники/користувачі (рядок; якщо кілька — розділені комою/переносом)
  • {{ParcelLocation}} — розташування: у межах населеного пункту / за межами населеного пункту
  • {{ParcelRegion}} — область
  • {{ParcelDistrict}} — район
  • {{ParcelSettlement}} — населений пункт
  • {{ParcelStreetName}} — вулиця (адреса)
  • {{ParcelBuilding}} — номер будинку (адреса)

Довідкові

  • {{CurrentYear}} — поточний рік (наприклад, 2026)
  • {{MSK}} — значення МСК (перші 2 цифри номера кадастрової зони)

Обладнання (з AdditionalInfoBlock/AdditionalInfo)

Ці значення заповнюються, якщо у вашому XML є відповідні рядки AdditionalInfo.

  • {{ReceiverModel}} — модель GPS‑приймача
  • {{ReceiverSN}} — серійний номер GPS‑приймача
  • {{ReceiverCertNo}} — № сертифіката калібрування GPS‑приймача
  • {{ReceiverCertDate}} — дата сертифіката калібрування GPS‑приймача
  • {{TotStatModel}} — модель тахеометра
  • {{TotStatSN}} — серійний номер тахеометра
  • {{TotStatCertNo}} — № сертифіката калібрування тахеометра
  • {{TotStatCertDate}} — дата сертифіката калібрування тахеометра