EJS-шаблоны документов

На каждую финансовую операцию в BILLmanager система формирует электронный документ. Он содержит информацию о проведённой операции и необходимые данные о компании.

BILLmanager может генерировать следующие документы:

договоры;
конверты;
акты выполненных работ;
акты сверки;
счета/квитанции;
акты приёмки/передачи оборудования;
соглашения об использовании услуг.

Документы формируются системой автоматически по запросу пользователя: нажатие на кнопку Печать. Печатная форма документа формируется на основе EJS-шаблонов. Алгоритм построения печатной формы документа следующий:

При выводе документа на печать автоматически генерируется XML-файл (исходный файл) со всеми необходимыми сведениями.
Формируется список доступных шаблонов документа.
Применяется базовый шаблон печати. Базовый шаблон определяет набор параметров форматирования текста, который будет применен к документу (определяет стили форматирования).
Применяется конечный шаблон документа.

Настройка шаблонов выполняется в разделе Настройки → Шаблоны документов. Если в данном разделе отсутствует базовый шаблон, то система будет использовать стандартный базовый шаблон.

Обратите внимание!

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

Исходный файл

Под исходным файлом подразумевается XML-файл, содержащий сведения, необходимые для формирования документа. Для просмотра исходного файла необходимо открыть печатную форму документа и в адресной строке браузера изменить формат вывода. Формат вывода определяется параметром out:

"out=doc_print" — печатная форма документа;
"out=xml" — исходный XML-файл.

Например, печатная форма счёта открывается по ссылке:

https://domain.com/billmgr?func=payment.print&elid=20&plid=&out=doc_print

Тогда исходный XML-файл будет доступен по ссылке:

https://domain.com/billmgr?func=payment.print&elid=20&plid=&out=xml

Логирование

Исходный набор данных для формирования документа может фиксироваться в файле лога биллинговой платформы /usr/local/mgr5/var/billmgr.log. Для этого потребуется установить максимальный уровень логирования модуля "Документооборот (billmgr.docflow)": Настройки → Настройка логирования → выделить модуль Документооборот (billmgr.docflow) → кнопка Максимальный: