Настройки расширения

Настройки расширения — это глобальные параметры, которые можно использовать в серверных сценариях виджетов и бизнес-процессов расширения, а также для создания методов API. Например, можно добавить параметры для хранения токена или ключа API.

Для обращения к параметрам в сценариях используйте:

Namespace.params.data."название параметра". 

Чтобы задать или отредактировать настройки расширения:

  1. Перейдите в Администрирование > Расширения.
  2. Наведите курсор на расширение и нажмите на появившийся значок шестеренки.

extention-settings1

  1. Перейдите на вкладку Настройки.
  2. Нажмите +Добавить и в окне создания заполните поля:

exten_4

  • Отображаемое имя*  название свойства, которое будет отображаться на различных формах расширения и в его настройках;
  • Имя свойства*  название свойства, использующееся при работе с API, сценариями;
  • Подсказка  дополнительная информация о свойстве;
  • Тип*  тип свойства, например, «Строка»;
  • Поиск и сортировка по полю  если вы выберете эту опцию, то значение данного поля будет использоваться в качестве параметра для поиска;
  • Полнотекстовый поиск значение поля будет участвовать в полнотекстовом поиске.
  • Заполняется по формуле  эта опция доступна только для полей типа строка, число и деньги. Вы можете указать формулу, при помощи которой система будет автоматически рассчитывать значение для данного свойства. Подробнее читайте в статье «Заполнение и отображение поля по формуле».
  • Отображается при выполнении условия  эта опция позволяет скрывать/отображать свойство в зависимости от заданных вами условий. Подробнее читайте в статье «Заполнение и отображение поля по формуле».

После того, как вы укажете все настройки, нажмите Сохранить.

Все созданные настройки по умолчанию добавляются на страницу подключения расширения. Пользователь увидит их, нажав на название расширения в разделе Администрирование.

exten_20

Отображение настроек

Отображение настроек можно менять. Например, часть настроек можно скрыть, можно добавить поля для проверки токенов, или настроить страницу так, чтобы на ней сразу отображались нужные данные из внешнего сервиса.

Для этого в расширении на вкладке Настройки нажмите Изменить виджет.

exten-18

Откроется Дизайнер интерфейсов, в котором можно настроить собственный виджет для отображения настроек. Когда вы переходите в дизайнер, то сразу открывается вкладка Шаблон. В ней по центру расположено поле для моделирования, справа все доступные виджеты. На вкладке Свойства отображаются настройки расширения.

exten-19

На вкладке Контекст вы можете добавить свойства, которые будут использоваться при написании сценариев для виджета. Подробнее о свойствах вы можете почитать в  статье «Типы данных в системе».

На вкладке Сценарии вы можете написать сценарии, определющие поведение виджета.

Готовый виджет необходимо опубликовать.