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