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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    Тип поля вводаНастройки
    Строковое поле

    Несколько значений — активируйте опцию, чтобы клиент через пробел мог указать несколько значений параметра.

    Количество строк ввода — укажите количество строк ввода в текстовом поле.

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

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