Шаблоны документов используются для автоматического создания версии документа на основе заполненных полей документа или переменных бизнес-процесса.
В качестве шаблона могут быть использованы файлы форматов: .rtf, .txt, .doc, .docx, .xls, .xlsx, .xml, .html.
Шаблон документа – это документ (файл указанного выше формата), который состоит из двух частей: статической и динамической. Статическая часть не изменяется, а в динамической части вместо данных содержатся названия переменных, значения которых формируются и записываются из атрибутов электронного документа или контекстных переменных процесса.
Синтаксис шаблонов
Шаблон документа может содержать текст, названия атрибутов типа документа, названия контекстных переменных. Все переменные в шаблоне документа должны иметь следующий вид:
{$имя_переменной}
В шаблоне документа могут быть использованы любые атрибуты документа и контекстные переменные процесса любого типа данных. При этом необходимо помнить, что все переменные независимо от типа данных, для корректного отображения в шаблоне преобразуются к типу данных Строка.
Использование блоков
{for Item in {$имя_переменной}}
{$Item.имя_свойства1} {$Item.имя_свойства2} {$Item.имя_свойства3}
{end}
В результате генерации по данному шаблону в результирующий документ свойства блока запишутся по очереди.
Использование условий
Условие начинается с оператора {if <условие>} и заканчивается оператором {end}. Вместо {end} можно использовать {end if}.
<условие> - произвольное условие, например {$имя_переменной}=true.
{else} - оператор, которой позволяет выполнить действие, если условие ложно.
Общий вид условия:
{if <условие>}
<Действие, если условие истинно>
{else}
<Действие, если условие ложно>
{end}
Отображение даты и времени в заданном формате
Для корректного отображения даты и времени в шаблоне необходимо в контексте процесса добавить переменную с типом Дата/Время. При этом синтаксис записи данной переменной будет выглядеть следующим образом: {DateTimeFormat({$Date}; ‘dd –MM –yy , H:mm:ss’)}, где:
dd –MM –yy - формат отображения даты;
H:mm:ss – формат отображения времени.
Отображение чисел в заданном формате
Для корректного отображения чисел в нужном формате необходимо использовать следующий синтаксис: {NumberFormat(2345.6789;2)}, где:
2345.6789 – формат отображения числа;
2 – количество знаков после запятой.
Генерация чисел в документе осуществляется без создания контекстной переменной.
Отображение денежных единиц в заданном формате
Для корректного отображения денежных единиц в заданном формате необходимо использовать следующий синтаксис: {MoneyFormat(2345.6789;2)}, где:
2345.6789 – формат отображения числа;
2 – количество знаков после запятой.
Генерация чисел в документе осуществляется без создания контекстной переменной.
Для создания шаблона документа необходимо выполнить следующие действия:
-
создать документ необходимого формата на локальном компьютере или в системе ELMA;
-
в созданный документ внести текст шаблона документа и необходимые контекстные переменные;
Шаблон документа может быть загружен в систему как с локального компьютера пользователя, так и из документа, хранящегося в системе.
Пример шаблона документа представлен на рис. 1.
Рис.1. Пример шаблона документа
Шаблон документа может быть использован:
Использование шаблона при создании документа
Для того, чтобы при создании документа присутствовала возможность генерации версии документа по шаблону необходимо выполнить следующие действия:
2. Добавить созданный шаблон к типу документа, для которого данный шаблон создан. Шаблон добавляется в настройках типа документа на вкладке Шаблоны в разделе Администрирование - Документооборот - Типы документов.
Для каждого типа документа может быть добавлено несколько шаблонов.
При создании и редактировании документа того типа, к которому добавлен шаблон документа, в блоке Версии будет отображена кнопка Указать шаблон (рис. 2).
Рис.2. Карточка документа. Кнопка "Указать шаблон"
При нажатии на данную кнопку следует выбрать необходимый шаблон, по которому будет генерироваться версия документа (рис. 3).
Рис. 3. Выбор необходимого шаблона документа
После сохранения документа версия документа будет сгенерирована автоматически в соответствии с выбранным шаблоном. Пример сгенерированной по шаблону версии документа представлен на рис. 4. Выделенный текст в примере сгенерирован с помощью атрибутов данного документа.
Рис. 4. Сгенерированная по шаблону версия документа
Использование шаблона документа в ходе выполнения бизнес-процесса
См. также:
