Блок Генерация по файлу позволяет использовать файл из контекста приложения или процесса в качестве шаблона для формирования документа. Это удобно, когда в ходе процесса необходимо сформировать документ с применением разных шаблонов.
Например, в системе есть приложение, в котором хранятся типы договоров с настроенными шаблонами. Каждый договор составляется по определённому шаблону в зависимости от типа. Сотруднику приходит задача, в которой он заполняет данные о заказе, выбирает тип договора из приложения и отправляет заказ на обработку. Далее в ходе процесса с помощью блока Генерация по файлу из выбранного файла шаблона на основе внесённых данных формируется договор. Этот договор можно использовать в ходе процесса.
О правилах составления шаблонов можно прочитать в статье «Синтаксис шаблонов».
начало внимание
Настраивать блок Генерация по файлу могут только пользователи, включённые в группу Администраторы.
конец внимание
Настройка блока «Генерация по файлу»
На странице процесса на панели инструментов справа от поля для моделирования откройте вкладку Системные элементы.
Добавьте блок Генерация по файлу на схему процесса. Разместите его там, где при исполнении процесса потребуется создать документ.
Чтобы открыть окно с настройками, дважды нажмите на блок.
Вкладка «Основное»
- Название* — укажите название операции, которое будет отображаться на схеме процесса;
- Входной файл* — выберите файл, в котором хранится шаблон документа. Можно использовать документы в формате .docx и .xlsx. Для выбора доступны контекстные переменные типа Файлы;
- Выходной файл* — выберите файл, в который будет записан сформированный по шаблону документ. Для выбора доступны контекстные переменные типа Файлы;
- Имя выходного файла* — укажите название выходного файла. Можно использовать переменные процесса и функцию
DateTime(). Чтобы добавить переменную, нажмите значок {+} в правой части поля. Чтобы использовать функцию, нажмите f(x). Подробнее про использование функций читайте в статье «Синтаксис шаблонов»; - Конвертировать в PDF — включите опцию, чтобы документ был создан в формате .pdf.
Вкладка «Обработка ошибок»
Во время генерации документа может возникнуть ошибка, например, если сервис создания файлов недоступен. Вы можете установить дальнейший ход процесса и действия, выполняющиеся в этом случае.
- Оповещение — включите опцию, чтобы в случае ошибки ответственные пользователи получили уведомление об этом. Вы можете выбрать:
- текущего пользователя — того, кто выполнил задачу, стоящую перед элементом Генерация по файлу на схеме процесса;
- контекстную переменную — например, инициатора;
- группу;
- элемент оргструктуры.
- Прервать — установите флажок и выберите переход, по которому пойдёт процесс в случае ошибки.
После того как вы заполнили все поля, нажмите Сохранить.
Входной файл шаблона хранится в контексте элемента приложения. Сгенерированный документ сохраняется в переменную, которую вы указали в качестве выходного файла. Добавьте эту переменную на форму соответствующей задачи или используйте в скрипте, чтобы пользователь смог получить документ.