Документация BILLmanager 5
Документация
/
Документация BILLmanager 5
/
Документы
/
EJS-шаблоны документов

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

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

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

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

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

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

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

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

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

Под исходным файлом подразумевается 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) → кнопка Максимальный: