Документация BILLmanager 6

Вывод документов в PDF

Для печати документов в формате PDF выполните предварительную настройку внешнего XSL-FO (XSL formatting objects) процессора. Подробнее см. Apache FOP.

  1. Подключитесь к серверу с платформой по SSH. Подробнее о подключении по SSH см. в статье Настройка рабочего места.
  2. Укажите параметры вызова FO-процессора. Добавьте в конфигурационный файл BILLmanager — /usr/local/mgr5/etc/billmgr.conf строку:

    billmgr.conf
    XSLFOProc fop -c /etc/fop.conf.d/userconfig.xml -xml __xml__ -xsl __xsl__ -pdf __pdf__

    Параметры, помещённые в двойные знаки подчеркивания ("__xml__", "__xsl__" и "__pdf__"), автоматически будут заменены на директории соответствующих файлов.

    Пример
  3. Загрузите в директорию /etc/fop.conf.d/fonts/ файл шрифта.

    Обратите внимание!
    Для примера использован шрифт Arial.

    После размещения файла сгенерируйте файл метрики:

    /etc/fop.conf.d/fonts/
    fop-ttfreader /etc/fop.conf.d/fonts/arial.ttf /etc/fop.conf.d/fonts/arial.xml
  4. Зарегистрируйте используемый шрифт. Для регистрации шрифтов используется конфигурационный файл FOP: /etc/fop.conf.d/userconfig.xml. Если такой файл отсутствует, создайте его вручную.

    Содержание конфигурационного файла FOP, в котором зарегистрирован шрифт Arial:

    userconfig.xml'
    <?xml version="1.0"?>
      <fop>
        <renderers>
          <renderer mime="application/pdf">
            <fonts>
              <font metrics-url="/etc/fop.conf.d/fonts/arial.xml" kerning="yes" embed-url="/etc/fop.conf.d/fonts/arial.ttf">
                <font-triplet name="Arial" style="normal" weight="normal"/>
                <font-triplet name="ArialMT" style="normal" weight="normal"/>
              </font>
            </fonts>
          </renderer>
        </renderers>
      </fop>
  5. Перезапустите BILLmanager:

    /usr/local/mgr5/sbin/mgrctl -m billmgr exit