Модуль - активити бизнес процесса для генерации DOCX документов по заранее подготовленному шаблону.
Реализованы следующие очень полезные функции:
- перевод текста в число: 1150р = одна тысяча сто пятьдесят рублей
- склонение слов по падежам для использования в формах заявлений (фамилии, должности и т.д.)
Итоговые документы могут в зависимости от настроек сохраняться в разных местах:
- на общем диске компании
- на личном диске владельца процесса
- на личном диске автора, запустившего процесс
Для работы активити нет необходимости дополнительно настраивать сервер и устанавливать сторонние библиотеки. Всё необходимое уже идет в поставке модуля!
Видео настроек и работы модуля
Подробная инструкция по настройке
1. Модуль устанавливается штатными средствами Битрикса (с использованием Маркетплейса).
2. После установки в редактировании шаблонов бизнес-процесса в разделе "Обработка документов" будет находиться активити "Brainforce генератор документов".
3. Далее необходимо выставить активити в нужном месте процесса.
4. Для настройки активити нужно перейти в Настройки параметров действия, после чего откроется следующее окно
Описание полей окна настроек:
- Заголовок - поле для название активити. Используется для лучшего понимания действия внутри процесса.
- Введите ID шаблона - ID документа с шаблоном, который загружен на диск.
- Введите ID папки - папка для хранения результата сформированного документа
- Загрузить автоматически в папку на общем диске? - Если выставлено ДА, то на общем диске создастся папка (имя папки = название бизнес процесса), в которую будут дублироваться сгенерированные документы.
- Загрузить автоматически в папку на личном диске? - Если выставлено ДА, то в папке автора процесса создастся папка (имя папки = название бизнес процесса), в которую будут дублироваться сгенерированные документы.
- Введите имя итогового файла - Имя сгенерированного файла, если не указано, то система автоматически сгенерирует имя.
5. Чтобы добавить обрабатываемое поле, необходимо нажать на "Добавить поле". В результате откроется связанная пара полей вида ключ => значение.
В поле слева указывается название переменной из шаблона в формате {NAME} (как сформировать шаблон читайте здесь), а справа - фактическое значение (может подтягиваться любое значение из БП: переменные, константы, поля, параметры, дополнительные результаты).
Возможные дополнительные параметры имен переменных:
- {NumSTRING} - переводит число Num в строку. Например, в случае {PriceSTRING} = 150 в документ будет выведено "Сто пятьдесят".
- {NumMONEY} - переводит число Num в строку в денежном формате. Для предыдущего примера в документ будет выведено "Сто пятьдесят рублей".
- {NameIMIN} - выводит значение Name в иминительном падеже. Например, в случае {NameIMIN} = Иван в документ будет выведено "Иван".
- {NameROD} - выводит значение Name в родительном падеже. Для предыдущего примера в документ будет выведено "Ивана".
- {NameDAT} - выводит значение Name в дательном падеже. Для предыдущего примера в документ будет выведено "Ивану".
- {NameVIN} - выводит значение Name в винительном падеже. Для предыдущего примера в документ будет выведено "Ивана".
- {NameTVOR} - выводит значение Name в творительном падеже. Для предыдущего примера в документ будет выведено "Иваном".
- {NamePRED} - выводит значение Name в предложном падеже. Для предыдущего примера в документ будет выведено "Иване".
6. После настройки сопоставлений необходимо сохранить изменения. На этом настройка завершена.
Процесс работы активити
В зависимости от настроек активити файл с результатами попадает в одну или несколько папок (см. п.4 инструкции). Далее с ним можно проводить любые манипуляции: просматривать, скачивать, печатать, изменять.
Как сформировать документ-шаблон
На вход активити подается шаблон формата *.docx с уже настроенными полями-переменными. Чтобы это сделать, поля должны быть заключены в конструкцию ${Name} в режиме обычного текста. Пример подготовленного шаблона документа можете взять здесь.