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

Шаблоны дополнений

Шаблоны дополнений — модуль BILLmanager. Он позволяет создавать шаблоны дополнений, так же как и обычные дополнения в конфигурации тарифа. Разница в том, что обычное дополнение создаётся для конкретного тарифа, а шаблон дополнений можно привязать сразу для всех нужных тарифов. 

Например, провайдер предоставляет услуги виртуального сервера. У него есть 10 тарифных планов, в которых нужно создать дополнение "Оперативная память". Чтобы не создавать это дополнение отдельно для каждого тарифа, провайдер создаёт шаблон дополнения "Оперативная память". Далее задаёт параметры дополнения и привязывает его к нужным тарифам.

Чтобы установить модуль "Шаблоны дополнений":

  1. Подключитесь к серверу с платформой по SSH. Подробнее о подключении по SSH см. в статье Настройка рабочего места.
  2. Установите пакет ПО:

    Операционная системаКоманда
    AlmaLinux
    dnf install billmanager-plugin-addon-templates
    Ubuntu, Astra Linux
    apt install billmanager-plugin-addon-templates
  3. Перезапустите BILLmanager:

    Перезапустите платформу
    /usr/local/mgr5/sbin/mgrctl -m billmgr -R

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

Чтобы создать шаблон дополнения:

  1. Перейдите в ПродуктыШаблоны дополненийСоздать.
  2. Выберите Провайдера из выпадающего списка.
  3. Нажмите Выбрать на нужном Типе продукта.
  4. Укажите Тарифные планы, к которым нужно привязать дополнение и нажмите Далее.
  5. Настройте параметры дополнения, аналогично созданию дополнения в конфигурации тарифного плана. Подробнее о настройке параметров см. Настройка содержания тарифа.
  6. Нажмите Завершить.

    Обратите внимание!
    Если у тарифного плана уже есть дополнение с таким же типом, как и у шаблона дополнений, то оно заменяется на дополнение из шаблона. Если дополнения такого типа нет, то у тарифа создаётся дополнение с параметрами, указанными в шаблоне.

Например, у провайдера есть тариф "VPS Professional". В конфигурации тарифа настроено дополнение "Оперативная память". В параметрах дополнения указано: тип учёта — "На основе заказанных значений", стоимость — 1 €/мес, включено в тариф — 4 Гб. Провайдер создаёт шаблон дополнения "Оперативная память" с другими параметрами и привязывает к нему этот тариф. После этого у тарифа "VPS Professional" дополнение "Оперативная память" заменится на созданное из шаблона с параметрами: тип учёта — "На основе значения других ресурсов", стоимость — 2 €/мес, включено в тариф — 8 Гб.

Как задать возможные значения цен

Разные значения цен для одного дополнения можно задать в следующих случаях:

  • если в шаблоне дополнения выбран Тип значения — "Перечисление". Чтобы задать разные варианты цен в шаблоне дополнения:
    1. Перейдите в ПродуктыШаблоны дополнений → выберите нужный шаблон → Цены Изменить.
    2. Укажите конкретные цены за период. Нажмите Ok, чтобы сохранить значения.
    3. Нажмите Вкл, чтобы включить это значение в шаблоне.

Например, провайдер предоставляет услуги виртуального сервера. Он создаёт шаблон дополнения "Операционная система" с перечислением. В перечислении он задаёт несколько вариантов операционных систем и цены для них: CentOS-7 — 0.1 €/мес., FreeBSD-11 — 0.1 €/мес., Debian-8 — 0.2 €/мес. Далее этот шаблон он привязывает к тарифному плану "VDS-1". В этом тарифе уже было дополнение "Операционная система", с настроенными ценами у перечислений. Дополнение заменилось на созданное из шаблона. Цены вариантов перечисления установились те, что провайдер указал в шаблоне дополнения.

  • если в шаблоне дополнения выбран Тип учёта — "Выбирается клиентом". При таком типе учёта, клиенту предоставляется выбор количества или значения ресурса. Чтобы задать все возможные варианты цен у шаблона дополнения с таким типом учёта:
    1. Перейдите в ПродуктыШаблоны дополненийЦены Создать.
    2. Создайте варианты дополнения, в каждом из которых укажите конкретную цену. Эти дополнения — дочерние шаблоны дополнений к первоначально созданному шаблону. В тарифных планах все ресурсы, созданные из такого шаблона, также будут иметь дочерние ресурсы. Редактирование цен в шаблоне дополнений аналогично редактированию цен дополнения в конфигурации тарифного плана.

Например, провайдер создаёт шаблон дополнений "Тип диска" и привязывает его к нескольким тарифам по услуге виртуальный сервер. У шаблона дополнения провайдер создаёт дочерние дополнения типа "Дисковое пространство":

  • HDD — по цене 1 €/мес. за 100Гб;
  • SSD — по цене 1 €/мес. за 100 Гб;
  • NVMe — по цене 2 €/мес. за 15 Гб.

Подробнее о настройке дополнения с типом учёта "Выбирается клиентом" см. Тип учета: "Выбирается клиентом".

Как привязать существующий шаблон к тарифу

Чтобы привязать существующий шаблон к тарифному плану:

  1. Перейдите в ПродуктыШаблоны дополнений → выберите нужный шаблон → Тарифные планы. Откроется окно со списком всех тарифов, к которым можно привязать это дополнение.
  2. Выберите нужный тариф и нажмите Вкл. Шаблон дополнения привязан.

Чтобы удалить привязку шаблона к тарифному плану:

  1. Перейдите в ПродуктыШаблоны дополнений → выбрать нужный шаблон → Тарифные планы.
  2. Выберите нужный тариф и нажмите Выкл.

    Обратите внимание!
    Удаляется только связь с шаблоном дополнений, само дополнение остаётся в конфигурации тарифного плана. После этого, если нужно изменить параметры этого дополнения, перейдите Продукты → Тарифные планыКонфиг. А все изменения, внесённые в шаблон, привязанный ранее, не повлияют на дополнение этого тарифа.

Если удалить все привязки шаблона дополнения к тарифным планам, то BILLmanager удалит этот шаблон из списка шаблонов.

Как редактировать шаблон

Чтобы отредактировать шаблон дополнения, перейдите в ПродуктыШаблоны дополненийИзменить.

Редактирование шаблона дополнений выполняется аналогично редактированию дополнения из конфигурации тарифного плана. Изменения, внесённые в шаблоне дополнения, применяются ко всем дополнениям привязанных тарифных планов.

Обратите внимание!
Менять любые параметры дополнения, созданного из шаблона, можно только в меню Шаблоны дополнений. Редактирование из меню Конфиг. тарифного плана для такого дополнения недоступно. Чтобы это стало возможно, удалите привязку шаблона дополнения к этому тарифу.

Как удалить шаблон

Чтобы удалить шаблон дополнения, перейдите в ПродуктыШаблоны дополнений → выберите нужный шаблон → Удалить.

Обратите внимание!
Удаляются только привязки шаблона. Дополнения, созданные из этого шаблона, остаются в конфигурации тарифов.

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