Параметры типа продукта — информация от клиента, которая требуется для открытия услуги. Например: доменное имя при заказе услуги виртуального хостинга. Значение каждого параметра передаётся в обработчик услуг, идентификация параметров происходит по внутреннему имени параметров.
Мы не рекомендуем изменять внутренние имена параметров, встроенных в BILLmanager.
При создании собственного типа продукта используйте ручную обработку услуг или обработку через Shell-скрипты. Подробнее про обработку услуг через Shell-скрипты см. в статье документации Интеграция через ShellScripts.
Некоторые услуги невозможно создать без указания определённых параметров. Такие параметры вы можете сделать обязательными для заполнения клиентом:
- Необязательный параметр — такой параметр допускается оставить пустым. В этом случае при открытии услуги будет использовано стандартное значение.
- Обязательный параметр — невозможно заказать услуги без указания такого параметра. В обработчике услуг для параметра не определено значение по умолчанию или значение должно быть уникальным.
Настройка параметров типа продукта
Для управления параметрами перейдите в раздел Продукты → Типы продуктов → кнопка Параметры. Нажмите кнопку Создать, чтобы добавить параметр:
- Наименование;
-
Внутреннее имя — имя параметра для его идентификации в обработчиках услуг. Должно быть уникальным, не содержать пробелов, специальных символов (кроме нижнего подчеркивания), не должно начинаться с цифры и должно состоять из символов латинского алфавита;
Обратите внимание!Внутреннее имя создаваемого параметра не должно совпадать со встроенными внутренними наименованиями. Проверьте это при помощи API-запроса:
API<адрес BILLmanager>?billmgr?func=<внутреннее имя типа продукта>&out=xml
ПоясненияЕсли в ответе на запрос встречается проверяемое внутреннее имя, используйте другое имя.
- Разрешить настройку подключения к тарифам — опция определяет способ активации параметра для каждого тарифного плана:
- Опция неактивна — параметр будет активен для всех тарифов с данным типом продукта;
- Опция активна — параметр неактивен для всех тарифов с данным типом продукта. Включите его для нужных тарифов в разделе Продукты → Типы продуктов → Параметры → кнопка Тарифы.
- Показывать при заказе — опция для отображения параметра на странице заказа услуги;
- Показывать при открытии — опция для отображения параметра в задаче на открытие услуги при ручной обработке;
- Показывать в списке — опция для отображения параметра в списке услуг этого типа продукта: Товары/Услуги → название типа продукта.
- Доступ на чтение/для изменения — минимальный уровень пользователя, которому доступно чтение/редактирование параметра;
- Вызвать обработчик при изменении — опция для запуска синхронизации значений параметров после редактирования услуги в разделе Товары/Услуги → <Название типа продукта> → кнопка Изменить;
- Тип поля ввода. Если принимает значение "Список" или "Список со множественным вводом", то задайте список значений параметра в разделе Продукты → Типы продуктов → Параметры → Значения. Подробнее про настройку значений параметра см. в статье Значения параметра;
- Тип отображения — способ отображения элементов списка в клиентском интерфейсе BILLmanager 6 (устаревшая). Поле доступно, если Тип поля ввода "Список" или "Список со множественным вводом";
- Обязательный параметр — опция для определения обязательности заполнения параметра. Не отображается, если Тип поля ввода "Флаг";
- Подсказка — подсказка к полю, которая появляется при наведении на символ вопроса в интерфейсе BILLmanager 5. Подсказки не доступны в интерфейсе BILLmanager 6 (устаревшая);
- Описание — описание параметра на странице заказа услуги в клиентском интерфейсе BILLmanager 6 (устаревшая);
- Шифровать — опция для хранения значения параметра в зашифрованном виде;
- Сортировка — параметр сортировки. Влияет на порядок отображения параметра на форме заказа и редактирования услуги;
- Группа — принадлежность параметра к одной из групп. Эта группировка применяется на странице подробной информации об услуге в клиентском интерфейсе BILLmanager 6 (устаревшая).