Платформа 3V/Экспорт по шаблону/Формирование печатной формы

Для выгрузки по шаблону в Word и Pdf необходимо настроить Word документ со всеми необходимыми полями для выгрузки, который будет использоваться в качестве шаблона.

При экспорте документа по шаблону форматирование текста (размер, шрифт и прочие) применяется на основании заданного для данного поля форматирования в самом Word шаблоне.

Рекомендация: наполняйте шаблон полями постепенно, чтобы избежать проблем в поиске ошибки настройки!

Пример шаблона с таблицами и полями доля выгрузки вы найдете здесь: https://docs.google.com/document/d/164H7ARhkM5pLFmUegyIBuVHs2rlj2ZQ7/edit?usp=sharing&ouid=103053010888258568238&rtpof=true&sd=true

Заголовки и статичные изображения

Для задания в шаблоне статичных заголовков, текста, изображений и прочего, оформите данную информацию сразу в вашем шаблоне с необходимым форматированием.

Атрибуты справочника

1) Добавить на форму элементы с типом "Текстовое поле", "Текстовая область", "Числовое поле", "Календарь", у которых будет задан источник данных - атрибут справочника. Далее в настройке будут использоваться Идентификаторы этих элементов управления

2) В шаблоне документа прописать ссылки на необходимые для выгрузки элементы формы:

• Встать в поле документа и нажать Ctrl+F9;
• Нажать правую кнопку мыши и выбрать "изменить поле";
• Выбрать MergeField → В `Имя поля` задать: $params["control *id* "], где id это Идентификатор элемента на форме;

Например: $params["control1056"]

• Нажать Ок;
• В шаблоне документа отобразится ссылка на элемент формы.

Задание формата для выгрузки числовых полей:

• Без формата: $params["control1056"] - выгрузится 1500
• $!number.format('#0.00',$params["control1056"]) - выгрузится 1500,00
• $!number.format($params["control1056"]) - выгрузится 15 00
• $!number.format($params["control1056"]) - выгрузится 1 500

Задание формата для выгрузки даты:

• $customTool.toDate("dd.MM.yyyy",$params["control1056"])

Расчетные поля

Для вывода в экспортируемый документ расчетных полей требуется сформировать соответствующее выражение в форме и добавить элемент формы, у которого настроенное выражение будет источником данных.

При необходимости на форме данный элемент можно скрыть с помощью флага "Включено" у выбранного элемента.

Примеры выражений для выгрузки:

1) Текущая дата: "Today()"

2) Объединение нескольких атрибутов справочника: "'Номер:'+[1]+' от'+[2]", где [1] - атрибут справочника "Номер договора" и [2] - атрибут справочника "Дата создания"

Далее идентификатор данного элемента мы используем в шаблоне по аналогии с выгрузкой атрибутов справочника.

Раскрывающиеся списки

Для вывода в выгружаемый файл значений, которые отмечены в раскрывающихся списках, по аналогии с расчетными полями необходимо:

1. Сформировать выражение на операнде EntryExpressionDictionarySourceParameter, в котором указать источник - справочник в форме, который используется в качестве источника отображения в требуемом раскрывающемся списке

• Если в раскрывающемся списке возможно отметить только 1 элемент, то выражение (expression) будет иметь следующий вид: "expression":"[1]", где 1 - это идентификатор операнда с типом EntryExpressionDictionarySourceParameter
  
• Если в раскрывающемся списке возможна множественная отметка, то не забудьте у операнда указать флаг "allowMultipleValues": true и само выражение будет иметь следующий вид: Concatenate(',', [1]), где 1 - это идентификатор операнда с типом EntryExpressionDictionarySourceParameter. Функция Concatenate позволит выгрузить выбранные элементы строкой через заданный разделитель, в данном случае через запятую
  

2. Добавить элемент формы с типом "Текстовое поле", у которого настроенное выражение будет источником данных

3. Скрываем данный элемент с помощью флага "Включено"

4. Используем данный элемент в шаблоне

Таблицы

Статичное количество столбцов в таблице

1) Добавить на форму элементы с типом "Таблица", у которых будет задан источник данных - отчет. Далее в настройке будут использоваться Идентификаторы этих элементов управления

2) Задать заголовки столбцов:

• Первый вариант: задать статичные названия в самом шаблоне:

• Второй вариант: задать ссылки на заголовки в самой таблице:

$params["control510"].Headers[0] , где $params["Ссылка на элемент формы"].Headers[номер столбца]

3) Задать данные для выгрузки в первом столбце:

• Добавить в ячейку с помощью Ctrl+F9 (см.выше):

 @before-row#foreach($row in $params["control510"].Data), где id это Идентификатор элемента таблицы на форме;

• В этой же ячейке, без пробелов таким же образом добавить:

$!row["0"] - номер столбца, из которого выгружать данные

• В этой же ячейке, без пробелов таким же образом добавить:

@after-row#end - позволяет выгрузить все строки из таблицы

4) Задать данные для выгрузки в последующих столбцах:

$!row["1"], где указываются номера столбцов, которые требуется выгрузить в столбец таблицы в шаблоне

Динамическое количество столбцов в таблице

1) Для выгрузки заголовков настройте следующие поля в рамках одной ячейки шаблона:

@before-cell#foreach($h in $params["control111"].Headers) + $h + @after-cell#end , где control*id* это Идентификатор элемента таблицы на форме

2) Для выгрузки данных настройте следующие поля в рамках одной ячейки шаблона:

@before-row#foreach($d in $params["control111"].Data) + @before-cell#foreach($ihh in $params["control111"].Headers) + #set( $newVelocityCount = $velocityCount - 1) + #set($colNum = "${newVelocityCount}") + $!d[$colNum] + @after-cell#end + @after-row#end , где control*id* это Идентификатор элемента таблицы на форме

Поячеейчная выгрузка таблицы (транспонированные таблицы)

1) В шаблоне документа вставить таблицу и прописать статичные названия столбцов и строк

2) Задать ячейки отчета для выгрузки в ячейки таблицы шаблона:

$!params["control510"].Data[0]["1"] ", начиная с первой строчки прописываем значения, где Data[номер строки]["номер столбца"].

Изображения с диаграммой

1) Добавить на форму элемент "Диаграмма" и настроить источник данных - отчет.

2) В шаблоне документа вставить любое изображение, с помощью которого ограничиваем поле для выгрузки изображения

3) Далее при выделенном изображении переходим на вкладку "Вставка" п. "Ссылки" и выбираем "Закладка". Задаем название закладки: control*id* , где id это Идентификатор элемента Диаграмма на форме и нажать кнопку "Добавить".

Изображение присвоена закладка, в которую и будет выгружаться диаграмма.

Важно! При выгрузке диаграммы в качестве изображения, необходимо на кнопке в форме, по нажатию на которую будет происходить экспорт по шаблону, добавить свойство "sendImages": true.

Пример кнопки для печати диаграммы
1 { 2 "key": "key1639482298801", 3 "type": "trv-button", 4 "templateOptions": { 5 "sendImages": true, 6 "properties": { 7 ... 8 }, 9 "localizedTitle": { 10 ... 11 }, 12 "dataSourceId": 13 13 }

Пример файла с полем для выгрузки диаграммы вы найдете по этой ссылке: https://docs.google.com/document/d/1vkv18cmqFhsVlL00XLPLjjb4gT7R4zu3/edit?usp=sharing&ouid=103053010888258568238&rtpof=true&sd=true

Пример формы с выгрузкой диаграмм

Форма с выгрузкой диаграмм в pdf

Изображения в формате base64

1) Добавить на форму элемент, который будет выводить изображение в формате base64. Важно! в данной строке не должно содержатся прочей информации, например, data:image/jpeg;base64

2) Указать у данного серверного контрола caption формата image_*id* , где id это Идентификатор элемента Диаграмма на форме

3) В шаблоне документа вставить любое изображение, с помощью которого ограничиваем поле для выгрузки изображения. По аналогии с диаграммой:

4) Далее при выделенном изображении переходим на вкладку "Вставка" п. "Ссылки" и выбираем "Закладка". Задаем название закладки, которое было задано в caption контрола на п.2: image_*id* , где id это Идентификатор элемента Диаграмма на форме и нажать кнопку "Добавить".

Изображение присвоена закладка, в которую и будет выгружаться изображение.

Важно! При выгрузке изображения из base64, необходимо на кнопке в форме, по нажатию на которую будет происходить экспорт по шаблону, добавить свойство "sendImages": true.

Пример кнопки для печати изображения
1 { 2 "key": "key1639482298801", 3 "type": "trv-button", 4 "templateOptions": { 5 "sendImages": true, 6 "properties": { 7 ... 8 }, 9 "localizedTitle": { 10 ... 11 }, 12 "dataSourceId": 13 13 }

Важно! При выгрузке изображения из base64, в действии выгрузки по шаблону добавить свойство "valueAsImageControlIds": [...], где указать идентификаторы контролов, которые содержат base64 для выгрузки

Действие выгрузки по шаблону для печати изображения
1 { 2 "templateFilenameSettings": { 3 "value": "https://3v.3v-group.net/filestorage/api/FileStorage/Db/get/Print_test_image_2.docx", 4 "discriminator": "FixedTextSettings" 5 }, 6 "format": "Docx", 7 "valueAsImageControlIds": [ 8 1 9 ], 10 "discriminator": "ExportAction", 11 ... 12 "id": 1, 13 "name": "Выгрузка по шаблону", 14 "code": null 15 }