Вернуться к статьям Когда нужен условный блок
Пример — строка КПП, дополнительный адрес или необязательное примечание. Без условия в документе может остаться один заголовок: «Дополнительные условия:», за которым ничего нет. Условие помогает убрать весь ненужный фрагмент вместе с подписью.
Однако обязательную информацию не следует скрывать, чтобы документ выглядел заполненным. Если реквизит необходим для вашего рабочего процесса, сначала исправьте данные CRM, затем повторите генерацию.
Условие в Word
Для короткого фрагмента в одной строке подходит пример:
{% if company.has_kpp %}КПП: {{ company.kpp }}{% endif %}
Если нужно включать или исключать целый абзац, служебные конструкции занимают отдельные абзацы:
{%p if company.has_kpp %}
КПП: {{ company.kpp }}
{%p endif %}
Это три абзаца Word, а не переносы строк внутри одного абзаца. Включите отображение непечатаемых знаков в редакторе и проверьте структуру.
Условная строка в Excel
Для XLSX подготовьте три отдельные строки листа:
{{#if company.has_kpp}}
КПП: {{ company.kpp }}
{{/if}}
В этом синтаксисе проверяется заполненность или истинность пути. Произвольные сравнения и else не поддерживаются. Используйте подготовленные логические признаки, например company.has_kpp, вместо переноса сложного Word-условия в Excel.
Не объединяйте ячейки через границы условного блока. Проверьте, как исчезновение строки влияет на соседние подписи, итоговую таблицу и печать.
Условие и запасной текст решают разные задачи
Условие управляет наличием фрагмента. default задаёт отображение пустого значения, когда подпись и место в документе должны остаться. Например, контактное поле может выводить согласованное пояснение «не указан».
Не используйте запасной текст для выдумывания данных. Если отсутствует банковский счёт, нельзя подставить условный номер из учебного примера. Читатель документа должен понимать, что информации нет.
Проверьте три состояния
| Состояние | Что проверить |
|---|---|
| Условие истинно | Блок виден, значения подставлены |
| Условие ложно или данные отсутствуют | Ненужный блок не оставляет пустой заголовок |
| Значение равно нулю | Значимый ноль не потерян из-за неверного условия |
Ноль, пустота и отсутствие связанной компании имеют разный смысл. Например, бесплатная доставка и ещё не рассчитанная стоимость доставки — разные случаи. Правило отображения должно отражать это различие.
Как безопасно добавлять условия
Сначала проверьте поле без условия. Если значение подставляется правильно, добавьте минимальный блок. Затем сформируйте два документа: с заполненными данными и без них. Только после этого объединяйте условие с таблицами и форматированием.
При ошибке упростите выражение и сравните его с разделом «Примеры и инструкция». Нельзя считать поддерживаемыми все конструкции, похожие на синтаксис другого шаблонизатора.
Частые вопросы
Можно ли одним условием исправить пустые реквизиты?
Условие может скрыть фрагмент, но не получить недостающие сведения. Для обязательных данных нужно исправить CRM-карточку.
Одинаковый шаблон условия работает в DOCX и XLSX?
Нет, способ разметки отличается. Word использует конструкции с процентами, Excel — строки {{#if ...}} и {{/if}} с более ограниченной логикой.
Другие примеры представлены в подробной инструкции. Возможности приложения — на странице «Фабрики документов».