Платформа 3V/Формы/Действия/Экспорт по шаблону
Действие, которое позволяет выгрузить документ word/pdf заполненный данными из формы по определенном шаблону.
Содержание
Общая информация
1 {
2 "templateFilename": "https://.../filestorage/api/FileStorage/S3/get/Документ.docx",
3 "filenameSettings": {
4 "value": "Наименование выгружаемого документа.docx",
5 "discriminator": "FixedTextSettings"
6 },
7 "format": "Docx",
8 "discriminator": "ExportAction",
9 "comment": null,
10 "enableExpressionId": null,
11 "id": 1,
12 "name": "Выгрузка документа по шаблону",
13 "code": null
14 },
| Свойство | Описание |
|---|---|
| templateFilename | Ссылка на загруженный файл в Файловом хранилище |
| filenameSettings | Наименование документа, с которым он выгрузится на устройство |
| format | Формат выгружаемого документа (Docx или Pdf) |
| id | Идентификатор действия |
| comment | Описание действия |
| enableExpressionId | Условие выполнения действия |
| discriminator | ExportAction |
Пример использования
Необходимо сформировать шаблон документа, в котором будет отображаться информация в виде предзаполненных полей документа. Для настройки данного функционала необходимо выполнить следующие шаги:
Настроить в форме требуемые поля для выгрузки в документ
Настройки всех полей для выгрузки осуществляется в форме, из котороый и происходит выгрузка, в случае когда бОльшая часть необходимых полей должна отображаться на форме. Если для выгрузки требуются элементы, таблицы, диаграммы, бОльшая часть которых не используется для отображения в самой форме - для заполнения по шаблону настраивают отдельную форму, чтобы при открытии текущей не перегружать ее информацией, а подгружать требуемую информацию только в момент "печати" по шаблону.
Как настроить соответствующие поля (текстовые, числовые, даты, таблицы и прочее) см. статью "Настроить элементы формы".
Настроить в файле Word выгружаемые поля
Для выгрузки возможно использовать текстовые, числовые поля, даты, таблицы, ячейку таблицы.
Подробнее о настройке требуемых полей в Word см. статью "Формирование шаблона для печати".
Добавить кнопку для выполнения печати из формы
Для выполнения действия выгрузки документа по шаблону необходимо настроить кнопку, по нажатию на которую будет происходить выгрузка
Подробнее о настройке кнопки см. статью "Платформа_3V/Формы/Компоненты/Основные/Кнопка".
Настроить действие на выгрузку
Для выгрузки определенной формы в документ необходимо добавить действие следующего вида:
1 {
2 "templateFilename": "https://.../filestorage/api/FileStorage/S3/get/Документ.docx",
3 "filenameSettings": {
4 "value": "Наименование выгружаемого документа.docx",
5 "discriminator": "FixedTextSettings"
6 },
7 "format": "Docx",
8 "discriminator": "ExportAction",
9 "comment": null,
10 "enableExpressionId": null,
11 "id": 1,
12 "name": "Выгрузка документа по шаблону",
13 "code": null
14 }
Подробнее про каждое свойство смотри выше.
Варианты настройки наименования выгружаемого файла:
- Фиксированное наименование файла
1 {
2 ...
3 "filenameSettings": {
4 "value": "Фиксированное наименование выгружаемого документа.docx",
5 "discriminator": "FixedTextSettings"
6 },
7 ...
8 }
- Расчетное наименование файла
1 {
2 ...
3 "filenameSettings": {
4 "expressionId": 100,
5 "discriminator": "ExpressionTextSettings"
6 },
7 ...
8 }
Где expressionId - Идентификатор выражения, в котором рассчитывается наименование - должно иметь строковый тип данных