Чтобы подготовить документ для печати или экспорта данных в pdf или docx файл, необходимо перейти в раздел «Шаблоны» — «Шаблоны для экспорта», где предусмотрено несколько типов шаблонов:
- html — позволяет подготовить шаблон с помощью html редактора.
- html_code — для подготовки шаблона применяется только html код.
- docx — вы можете использовать docx файл в качестве шаблона.
- Этикетка — шаблон с заданным размером.
Создание шаблона
Перейдите на страницу «Шаблоны для экспорта» и нажмите на кнопку «Создать»
В диалоговом окне выберите сущность, для которой будет создан шаблон и укажите тип шаблона.
Обратите внимание, что у вас есть возможность установить фильтры полей, при которых будет отображаться кнопка шаблона.
После создания шаблона нажмите на его название и вы попадете на страницу где у вас будет возможность подготовить документ.
В тело документа вы можете вставлять значения из текущей записи используя специальную конструкцию {#448:Статус}
Так же у вас есть возможность встроить информацию из вложенной или связанной сущности используя конструкции {#entity8:0<2,4,5>}
. Подробное описание данного функционала смотрите в разделе Помощь.
Вывод по условию
Иногда возникает ситуация, когда содержимое в шаблоне нужно отобразить по условию, например, отобразить текст в зависимости от значения поля. Для добавления условия в шаблон нужно использовать следующую конструкцию:
{{if([208]>0):}} Текст, который отобразится по условию. {{endif}}
Где 208
— это ID числового поля. {{endif}}
— конец блока с условием.
Обратите внимание: для сравнения строк, строку нужно взять в кавычки, например:
{{if([208]==0 or [158]=='Test project 2'):}} ... {{endif}}
Как показано в примере выше в конструкции if
можно задать несколько условий используя команды and
и or
. Также допускается использование PHP функции. Например проверка длины значения:
{{if(strlen([160])>0):}} ... {{endif}}
Обратите внимание: не допускается использовать условие в блоке с условием. Также не предусмотрены ветвление условий.
Склонение
Часто при формировании шаблона возникает необходимость преобразовать ФИО и должность в родительный или другой падеж. Для решения это задачи предусмотрена специальная функция name2case(Текст, Падеж)
.
Падеж — введите номер падежа от 1 до 6:
- Именительный.
- Родительный.
- Дательный.
- Винительный.
- Творительный.
- Предложный.
Пример использования:
Заявление выдано: name2case(Директор,5) name2case({#239:Client},5)
Обратите внимание: склонение должности, стоящие из 2 и более слов, не поддерживается.
Для украинского языка используйте функцию name2case_ua(Текст, Падеж)
Кому: name2case_ua(Андрій Миколайович,7)
Обратите внимание: чтобы использовать склонение в docx шаблоне, понадобится создать дополнительное поле с типом «PHP код» и использовать функцию app_name2case()
выполнить склонение. Пример кода:
$text = [239]; $output_value = app_name2case($text,3);
Созданное поле использовать в docx шаблоне.