В BILLmanager для каждой финансовой операции система формирует электронный документ. Он содержит информацию о проведённой операции и данные о компании. Шаблоны документов отвечают за то, как будет выглядеть готовый документ.
BILLmanager может генерировать следующие документы:
- Договор;
- Акт выполненных работ;
- Счёт;
- Акт сверки;
- Счёт-фактура.
EJS-шаблон
Шаблон документа — это EJS-код, который задает какие поля надо вывести на форму, как их расположить и какое форматирование применить. Подробнее про шаблонизатор EJS.
В рамках начальной настройки рекомендуем ознакомиться с шаблонами документов и при необходимости внести изменения. Для этого перейдите в раздел Настройки → Шаблоны документов → выберите шаблон документа → кнопка Изменить.
Страница редактирования шаблона:
В целях безопасности по умолчанию запрещено выполнение запросов XHR и Fetch:
- в шаблонах документов;
- в шаблонах уведомлений для email.
Если нужно выполнять XHR и Fetch запросы, администратор платформы на свой страх и риск может отключить механизмы защиты. Подробнее см. статью Содержимое EJS-шаблонизатора.
Добавление изображения
Вы можете добавить в шаблон изображение. Например, изображение печати или подписи. Для этого добавьте в нужное место в шаблоне строку:
<div class="company"><img src="stamp009_4.png" width="270" height="145"/></div>где stamp009_4.png — изображение печати с подписью.
Если печать и подпись это отдельные изображения, то таких строк нужно добавить по количеству изображений. Разместите изображения в каталоге /usr/local/mgr5/skins/userdata/.
Безопасность
Изоляция окружения
Начиная с версии 6.124, для защиты от уязвимостей шаблоны формируются в изолированной среде. При установке или обновлении BILLmanager устанавливается пакет ПО billmanager-plugin-template-processor. Этот пакет:
- Устанавливает среду контейнеризации:
- в ОС Ubuntu и Astra Linux — Docker;
- в ОС AlmaLinux — Podman.
- Скачивает образ со скриптами для безопасного формирования шаблонов.
Вы можете отключить использование изолированной среды. Например, если шаблоны формируются некорректно. Для этого:
- Добавьте в конфигурационный файл /usr/local/mgr5/etc/billmgr.conf опцию
Option DisableTemplateProcessor. Подробнее см. статью Конфигурационный файл. - Перезапустите платформу:
/usr/local/mgr5/sbin/mgrctl -m billmgr -R
Связанные статьи: