Шаблонизатор документов

В базовой поставке шаблонизатор встроен в документы «Коммерческие предложения» и «Договоры».

Сами шаблоны документов создаются в меню «Настройки» — «Справочники» — «Шаблоны документов».

В документе «Договор» или «Коммерческом предложении» при нажатии на кнопку «Сформировать документ» отправляется запрос в форму редактирования документа с постфиксом «_create» (примеры: contracts_create, commercial_create).

В данной форме происходит парсинг выбранного «Шаблона» и подстановка данных в него для вывода на печать. Готовый текст документа сохраняется в поле «text» объекта.

При любом изменении документа необходимо нажать заново кнопку “Сформировать документ”, чтобы обновить готовый текст документа.

Вывод полей

Для вывода «поля» Объекта в документ используется следующая конструкция: {название поля}.

Пример: вывод значения поля «Дата»

{date}

Шаблонизатор поддерживает иерархию объектов.

Пример: выведем имя организации в тексте договора

{organization.name}

Вывод табличный частей

Вывод табличный частей осуществляется следующим образом:

{table:products}
<table>
   <tbody>
      <tr>
         <td>
            {products.name}
         </td>
         <td>
            {num}
         </td>
      </tr>
   </tbody>
</table>

Сразу перед началом таблицы вставляется тег {table:products}, где products — название табличной части “Объекта”.

В конструкции {products.name}, «product» — это ссылка на объект «Номенклатура», а «name» — поле из «Номенклатуры». Т. е. на экран выведется название «Номенклатуры» из табличной части «products» объекта. {num} — поле «Количество» из табличной части «products» текущего объекта.

Результат:

Вывод числового поля прописью

Пример: вывести поле «Итого» прописью

{total}:text

Результат:

одна тысяча

Вывод суммы в рублях

{total}:money

Результат:

Двести двадцать четыре тысячи девятьсот двадцать девять рублей 00 коп.

Вывод валюты с центами

В объекте должно быть поле «currency» с указателем на справочник «Валют»

{total}:currency

Результат:

Двести двадцать четыре тысячи девятьсот двадцать девять долларов 00 цен.

Вывод даты прописью

{date}:date

Результат:

03 февраля 2022

Также можно самостоятельно расширить возможности шаблонизатора, внеся правки в код обработчиков.

«Форма» для создания «Коммерческого предложения»: /commercial_create/
«Форма» для создания «Договора»: /contracts_create/

HTML-верстка

Для корректной настройки шаблона документа рекомендуем пользоваться иконкой «HTML-верстка»:

Для удобства разработчиков в поставке Системы включен базовый шаблон «Договора» и «Коммерческого предложения».

Подробнее про работу с шаблонами можно прочитать по ссылке.

Документация разработчика