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

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

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

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

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

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

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

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

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

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

 Укажите следующие параметры:

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

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

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

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

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

  • Разрешить настройку подключения к тарифам — опция определяет способ активации параметра для каждого тарифного плана:
    • Опция неактивна — параметр будет активен для всех тарифов с данным типом продукта; 
    • Опция активна — параметр неактивен для всех тарифов с данным типом продукта. Включите его для нужных тарифов в разделе Продукты  Типы продуктов  Параметры → кнопка Тарифы
  • Показывать при заказе — опция для отображения параметра на странице заказа услуги; 
  • Показывать при открытии — опция для отображения параметра в задаче на открытие услуги при ручной обработке; 
  • Показывать в списке — опция для отображения параметра в списке услуг этого типа продукта: Товары/Услуги → название типа продукта. 
  • Доступ на чтение/для изменения — минимальный уровень пользователя, которому доступно чтение/редактирование параметра; 
  • Вызвать обработчик при изменении — опция для запуска синхронизации значений параметров после редактирования услуги в разделе Товары/Услуги <Название типа продукта> → кнопка Изменить
  • Тип поля ввода. Если принимает значение "Список" или "Список со множественным вводом", то задайте список значений параметра в разделе Продукты Типы продуктов Параметры Значения. Подробнее про настройку значений параметра см. в статье Значения параметра
  • Тип отображения — способ отображения элементов списка в клиентском интерфейсе BILLmanager 6 (устаревшая). Поле доступно, если Тип поля ввода "Список" или "Список со множественным вводом"; 
  • Обязательный параметр — опция для определения обязательности заполнения параметра. Не отображается, если Тип поля ввода "Флаг";
  • Подсказка — подсказка к полю, которая появляется при наведении на символ вопроса в интерфейсе BILLmanager 5. Подсказки не доступны в интерфейсе BILLmanager 6 (устаревшая);
  • Описание — описание параметра на странице заказа услуги в клиентском интерфейсе BILLmanager 6 (устаревшая);
  • Шифровать — опция для хранения значения параметра в зашифрованном виде;
  • Сортировка — параметр сортировки. Влияет на порядок отображения параметра на форме заказа и редактирования услуги;
  • Группа — принадлежность параметра к одной из групп. Эта группировка применяется на странице подробной информации об услуге в клиентском интерфейсе BILLmanager 6 (устаревшая).