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

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

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

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

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

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

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

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

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


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


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

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

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

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

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

    <адрес BILLmanager> — укажите адрес вашего BILLmanager;


    <внутреннее имя типа продукта> — укажите внутреннее имя, которое нужно проверить.

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

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