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

Шаблоны наименования услуг

По умолчанию в актах выполненных работ, счетах на оплату и расходах клиента в BILLmanager используются стандартные наименования услуг. Эти наименования формируются из XSLT-шаблонов в директории /usr/local/mgr5/etc/xslt/:

  • itemname_certificate.xsl — "SSL-сертификат";
  • itemname_dedic.xsl — "Выделенный сервер";
  • itemname_domain.xsl — "Доменные имена";
  • itemname_soft.xsl — "Лицензии ISPsystem";
  • itemname_vds.xsl — "Виртуальный сервер";
  • itemname_vhost.xsl — "Виртуальный хостинг";
  • itemname.xsl — для произвольных услуг.

Чтобы изменить наименование услуги, создайте собственный шаблон в настройках типа продуктов. Созданный шаблон будет использоваться вместо стандартного.

Обратите внимание!
Не рекомендуем изменять существующие шаблоны в директории usr/local/mgr5/etc/xslt/. При обновлении BILLmanager они будут восстановлены в исходное состояние.

Как создать шаблон

  1. Перейдите в раздел Продукты Типы продуктов → выберите тип продукта → кнопка Изменить.
  2. Вставьте текст в поле Шаблона наименования услуги и нажмите кнопку Ok.
  3. Если появилось сообщение об ошибке в тексте шаблона, внесите исправления и повторно нажмите кнопку Ok.

Форма ввода шаблона

Где взять информацию для шаблона

При заказе услуги BILLmanager создаёт XML-файл с подробной информацией о ней. Вы можете использовать данные из этого XML-файла для создания XSLT-шаблона. Существует возможность записать XML-файл в лог BILLmanager /usr/local/mgr5/var/billmgr.log. Для этого установите максимальный уровень логирования модуля "Вспомогательные функции": НастройкиНастройка логирования → выберите Вспомогательные функции (billmgr.util) → кнопка Максимальный.

Как изменить наименование ранее созданной услуги

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

Чтобы привести наименования действующих услуг в соответствие с шаблоном, выполните команду:

/usr/local/mgr5/sbin/mgrctl -m billmgr fix.expensename fromdate=2022-04-10 todate=2022-10-25
Пояснения к команде

Примеры шаблонов

Как вставить дату создания и окончания услуги "Виртуальный хостинг"

Создайте шаблон следующего вида:

<?xml version='1.0' encoding='UTF-8'?>
<xsl:stylesheet version='1.0' xmlns:xsl='http://www.w3.org/1999/XSL/Transform' xmlns:mgr="http://ispsystem.com/xslplugin">
<xsl:output method='text' encoding='UTF-8' doctype-public="-W3CDTD HTML 4.01 Transitional//EN"/>
	<xsl:template match="doc">
	<xsl:value-of select="messages/hostingservice"/> - <xsl:value-of select="item/id"/> ( <xsl:value-of select="/operation/param[@name='fromdate']"/> - <xsl:value-of select="/operation/param[@name='todate']"/> ) за <xsl:value-of select="messages/period_number"/>
	</xsl:template>
</xsl:stylesheet> 

Как изменить формулировку "Телематические услуги" в наименовании услуги "Виртуальный сервер"

Возьмите за основу текст шаблона itemname_vds.xsl. Замените на "Виртуальный сервер" следующий фрагмент:

<xsl:value-of select="messages/telematic"/>

Как удалить формулировку "Дополнительные услуги" в наименовании услуги "Доменные имена"

Возьмите за основу текст шаблона itemname_domain.xsl. Удалите в нём фрагмент:

<xsl:when test="is_addon = 'yes'"><xsl:value-of select="messages/addon"/><xsl:text> </xsl:text>