Дизайнер бизнес-процессов > Графические элементы / Генерация по файлу

Генерация по файлу

generate-from-file-1 Блок Генерация по файлу позволяет использовать файл из контекста приложения или процесса в качестве шаблона для формирования документа. Это удобно, когда в ходе процесса необходимо сформировать документ с применением разных шаблонов.

Например, в системе есть приложение Типы договоров, в котором хранятся файлы шаблонов для договоров разных типов. В ходе процесса Оформить заказ сотруднику приходит задача, в которой он заполняет данные о заказе, выбирает тип договора из приложения и отправляет заказ на обработку. Далее с помощью блока Генерация по файлу из выбранного файла шаблона на основе внесённых данных формируется договор.

В качестве шаблонов используйте файлы формата .docx и .xlsx. Для их составления примените правила, описанные в статье «Синтаксис шаблонов».

начало внимание

Настраивать блок Генерация по файлу могут только пользователи, включённые в группу Администраторы.

конец внимание

Настройка процесса с блоком «Генерация по файлу»

  1. Блоком Генерация по файлу обрабатываются только контекстные переменные процесса. Поэтому для корректной работы в контексте процесса добавьте свойства для всех типов договоров. Например, если в договоре о продаже указывается клиент, а о гарантийном обслуживании — подрядчик, добавьте в контекст обе переменные.
  2. Также создайте переменные типа Файлы для загрузки входного файла шаблона и отображения готового документа, например Файл шаблона и Сгенерированный договор.
  3. Добавьте блок Генерация по файлу на схему процесса. Разместите его там, где при исполнении процесса потребуется создать документ.

generate-from-file-4

  1. В нашем примере данные для договора сотрудник введёт во время выполнения задачи Оформить заказ. Чтобы передать значения, а также выбранный сотрудником тип договора в блок Генерация по файлу, используйте графический элемент Присваивание. Например, разместите его после задачи и назовите Получить файл шаблона и значения для договора. В настройках блока сопоставьте свойства приложения с контекстными переменными процесса.
  2. Чтобы получить готовый документ для выполнения задачи Подписать договор, вынесите на её форму контекстную переменную процесса Сгенерированный договор.

Вы также можете воспользоваться блоком Присваивание и разместить его перед задачей подписания. В его настройках сопоставьте контекстную переменную процесса с полем приложения для отображения договора.  

Настройка блока «Генерация по файлу»

На странице процесса на панели инструментов справа от поля для моделирования откройте вкладку Системные элементы.

Добавьте блок Генерация по файлу на схему процесса. Разместите его там, где при исполнении процесса потребуется создать документ.

Чтобы открыть окно с настройками, дважды нажмите на блок.

Вкладка «Основное»

generate-from-file-2

  • Название* — укажите название операции, которое отобразится на схеме процесса;
  • Входной файл* — выберите контекстную переменную процесса типа Файлы, в которой хранится шаблон документа;
  • Выходной файл* — выберите переменную типа Файлы, в которую запишется сформированный по шаблону документ;
  • Имя выходного файла* — укажите название выходного файла. Можно использовать переменные процесса и функцию DateTime(). Если вы добавляете переменную, нажмите значок {+} в правой части поля. Чтобы использовать функцию, нажмите f(x). Подробнее про использование функций читайте в статье «Синтаксис шаблонов». Также в имени файла укажите доступный формат: .doc, .docx, .xls, .xlsx или .rtf;
  • Конвертировать в PDF — включите опцию, чтобы создать документ в формате .pdf;
  • Стандарт pdf — это поле появится, если включена опция Конвертировать в PDF. Выберите нужный формат .pdf. По умолчанию установлен вариант PDF/A-1a. Также доступны форматы PDF/A-1b и PDF1.7

Вкладка «Обработка ошибок»

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

generate-from-file-3

  • Оповещение — включите опцию, чтобы в случае ошибки ответственные пользователи получили уведомление об этом. Вы можете выбрать:
    • текущего пользователя — того, кто выполнил задачу, стоящую перед графическим элементом Генерация по файлу на схеме процесса;
    • контекстную переменную — например, инициатора;
    • группу;
    • элемент оргструктуры.
  • Прервать — установите флажок и выберите переход, по которому пойдёт процесс в случае ошибки.

После того как вы заполнили все поля, нажмите Сохранить.