Параметры типа продукта

Параметры типа продукта (услуг) — это необходимая информация от клиента, которая требуется для открытия услуги. Например, доменное имя при заказе услуги виртуального хостинга. Значение каждого параметра передаётся в обработчик услуг, идентификация параметров происходит по внутреннему имени параметров. 

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

Мы не рекомендуем изменять внутренние имена параметров, встроенных в BILLmanager.

При создании собственного типа продукта используйте ручную обработку услуг или обработку через Shell-скрипты. Подробнее про обработку услуг через Shell-скрипты см. в статье документации Интеграция через ShellScripts.

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

• Необязательный параметр — такой параметр допускается оставить пустым. В этом случае при открытии услуги будет использовано стандартное значение. 
• Обязательный параметр — невозможно заказать услуги без указания такого параметра. В обработчике услуг для параметра не определено значение по умолчанию или значение должно быть уникальным.

Настройка параметров типа продукта

Для управления параметрами перейдите в раздел Продукты → Типы продуктов → выберите тип продукта → кнопка Параметры. Нажмите кнопку Создать, чтобы добавить параметр:

1. Наименование.

2. Внутреннее имя — имя параметра для его идентификации в обработчиках услуг. Требования к имени:

   • уникальное;
   • состоит из символов латинского алфавита;

   • не содержит пробелов, специальных символов (кроме нижнего подчеркивания);

   • не начинается с цифры.

     

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

     Внутреннее имя создаваемого параметра не должно совпадать со встроенными внутренними наименованиями. Проверьте это при помощи API-запроса:

     API

     <адрес_BILLmanager>?billmgr?func=<внутреннее_имя_типа_продукта>&out=xml

     CODE

      Пояснения

     • <адрес_BILLmanager> — укажите адрес вашего BILLmanager
     • <внутреннее_имя_типа_продукта> — укажите внутреннее имя, которое нужно проверить

     Если в ответе на запрос встречается проверяемое внутреннее имя, используйте другое имя.

3. Разрешить настройку подключения к тарифам — задаёт способ активации параметра для каждого тарифного плана:
   • Опция неактивна — параметр будет активен для всех тарифов с данным типом продукта; 
   • Опция активна — параметр неактивен для всех тарифов с данным типом продукта. Чтобы включить параметр для нужных тарифов, перейдите в раздел Продукты → Типы продуктов → выберите тип продукта → кнопка Параметры → кнопка Тарифы. 
4. Показывать при заказе — активируйте опцию, чтобы на странице заказа услуги клиент указал значения параметра.
5. Показывать при открытии — активируйте опцию, чтобы при ручной обработке отобразить параметр в задаче на открытие услуги.
6. Показывать в списке — активируйте опцию, чтобы отобразить параметр в списке услуг этого типа продукта: Товары/Услуги → название типа продукта.
7. Доступ на чтение и Доступ для изменения — установите минимальный уровень пользователя, которому доступно чтение и редактирование параметра:
   • клиент;
   • сотрудник;
   • суперпользователь.
8. Вызвать обработчик при изменении — активируйте опцию, чтобы запустить синхронизацию значений параметров после редактирования услуги в разделе Товары/Услуги → <Название типа продукта> → кнопка Изменить.

9. Тип поля ввода — установите тип данных для ввода в поле параметра. От выбранного типа зависят дополнительные настройки:

   Тип поля ввода	Настройки
   Строковое поле	Несколько значений — активируйте опцию, чтобы клиент через пробел мог указать несколько значений параметра. Количество строк ввода — укажите количество строк ввода в текстовом поле. Функция проверки — выберите функцию для проверки введённого значения. Это не позволит пользователю указать значение в неверном формате. Например, параметр должен быть записан в формате "IP-адрес".
   Список	Задайте список значений параметра в разделе Продукты → Типы продуктов → выберите тип продукта → кнопка Параметры → кнопка Значения. Подробнее про настройку значений параметра см. в статье Значения параметра.
   Список со множественным выбором	Задайте список значений параметра в разделе Продукты → Типы продуктов → выберите тип продукта → кнопка Параметры → кнопка Значения. Подробнее про настройку значений параметра см. в статье Значения параметра.
   Флаг	—
   Текстовое поле	Количество строк ввода — укажите количество строк ввода в текстовом поле.

10. Обязательный параметр — опция для определения обязательности заполнения параметра. Не отображается, если Тип поля ввода "Флаг".
11. Подсказка — подсказка к полю, которая появляется при наведении на символ вопроса в интерфейсе BILLmanager.
12. Шифровать — опция для хранения значения параметра в зашифрованном виде.
13. Сортировка — параметр сортировки. Влияет на порядок отображения параметра на форме заказа и редактирования услуги.