Генерация документа из шаблона

Конструктор умеет генерировать документы по шаблону в форматах PDF и DOCX.

Что можно собирать

Счета, договоры, чеки, сметы, акты, списки, таблицы — на основе документа Word, с возможностью конвертации в PDF и отправки клиенту или себе.

---

Как это работает

1. Подготовьте шаблон в формате .docx или .doc со специальными метками.
2. Загрузите файл в действие.
3. Назначьте соответствия между метками в файле и данными конструктора.
4. Настройте отправку готового документа.

---

Синтаксис шаблона

В документе Word используются специальные метки, которые конструктор заменит данными.

Переменная

{name}

Где name — имя шаблона переменной. Метка заменяется переданным значением.

Цикл

{#name} ... {/name}

Где name — имя шаблона цикла. Внутри цикла размещаются переменные, которые будут повторяться вместе с остальным контентом внутри блока.

Главное применение

Циклы нужны для таблиц и списков — позиций счёта, строк акта и т. п.

Условие

{#condition} ... {#cond1} ... {/} {#cond2} ... {/} ... {/}

Где condition — имя шаблона условия, cond1, cond2, condN — отдельные условия. В условие передаётся выражение, переменная или значение true/false. Внутри блока находится контент, который будет показан, если условие истинно.

подсказка

Шаблоны условий можно вкладывать друг в друга — выстраивайте сколь угодно сложные ветвления.

Фото

{name}

Где name — имя шаблона изображения. Метка заменится фото (загруженным или сгенерированным QR-кодом).

Размер изображения

При передаче данных в шаблон обязательно указывайте размеры изображения — иначе в документ оно не попадёт корректно.

Ссылка

{link}

Где link — имя шаблона ссылки. Метка заменится гиперссылкой. При передаче данных укажите название ссылки и сам URL.

---

Настройка действия

Соответствия шаблонам

После загрузки файла в действие задайте соответствия для меток документа:

Тип шаблона	Что настроить
Переменная	Значение или переменная конструктора.
Цикл	Источник данных для повторяющегося блока.
Условие	Выражение или переменная (true/false).
Изображение	Файл или QR-код + размеры.
Ссылка	Название ссылки и URL.

Формат и отправка

Параметр	Описание
Формат	PDF или DOCX.
Адресаты	Кому отправить документ — в бот, на e-mail или привязанному сотруднику.
Сообщение и кнопки	Сопроводительный текст и интерактивные элементы.
Переменная со ссылкой	Имя переменной для сохранения ссылки на готовый документ — пригодится в других действиях.