Условные блоки и версии шаблона
Как сделать пункты, которые появляются только при условии или повторяются для каждой стороны, и почему у шаблона есть версии.
Зачем условные блоки
Настоящий договор не является фиксированным текстом. Пункт о поручителе нужен в том договоре, где поручитель есть, и больше нигде; блок подписей появляется по разу на каждого арендатора. Вместо пяти почти одинаковых шаблонов отметьте блоки в бланке и скажите, когда каждый действует.
Как отметить блок
В Word оберните часть, которая является условной:
{{#if guarantor}}
5. Поручитель отвечает за обязательства арендатора.
{{/if}}
Между ними можно поставить {{else}} для формулировки, которая действует, когда условие не
выполняется. Чтобы повторить секцию, оберните её в {{#each tenants}} и {{/each}}, а
внутри используйте {{tenants.full_name}}.
Ставьте маркеры отдельными строками. Вместе с блоком удаляется целый абзац, и именно это позволяет Word самому перенумеровать пункты.
Повторяющийся блок {{#each}} повторяется по сканам — например, по одному разу на каждый
загруженный паспорт арендатора. Если же нужно, чтобы строки добавлял человек при заполнении
(услуги в акте, товары в счёте), используйте строку таблицы — см.
Таблицы с переменным числом строк.
Как сказать, когда он действует
В редакторе шаблона раздел Условные блоки содержит по одному правилу на блок. Нажмите Добавить условие и укажите:
- Название блока — так, как вы написали его в бланке (
guarantor); - Тип блока — появляется, если или повторяется для каждого;
- для условия — Поле и Условие: заполнено, пусто, равно, больше или меньше, а при необходимости Значение для сравнения (число или дату);
- для повторяющегося блока — Сканы, по которым он повторяется.
Правило — это выпадающие списки, а не формула.

Блок без правила считается отсутствующим, так что опечатка в названии уберёт пункт, а не тихо добавит его. Это намеренно: отсутствующий абзац замечают, лишний нет.
Если условий нет вовсе, все блоки бланка попадают в каждый документ.
Версии
Всё, что меняет результат генерации, даёт шаблону новую версию: новый бланк, изменённое сопоставление полей, изменённое условие. Переименование шаблона не даёт.
Каждый документ запоминает версию, которой он собран; она видна в списке документов. Это и есть ответ на «почему этот договор читается иначе, чем тот, что мы делали в прошлом месяце» спустя долгое время после того, как шаблон изменился.
Советы
- Проверьте условный шаблон на двух документах: с поручителем и без. Так сразу видно, что блок появляется и пропадает как задумано.
- Называйте блоки так же, как метки: латиницей и по смыслу (
guarantor,has_deposit). - Не вкладывайте условие внутрь абзаца посреди предложения — блок работает целыми абзацами.