В пользовательском модуле на вкладке Настройки вы можете добавить глобальные параметры, которые необходимы для корректной работы модуля и выполнения заложенных в него задач. Параметры можно использовать в серверных скриптах виджетов и бизнес‑процессов модулей, а также для создания методов API. Например, можно добавить параметры для хранения токена или ключа API.
После создания параметра он по умолчанию отобразится на странице управления модулем. Вы можете настроить внешний вид этой страницы и задать пользовательскую форму настроек модуля.
Важно: начиная с версии системы 2025.11 для обращения к параметрам в скриптах используйте асинхронный метод Namespace.getParams(). Пример получения параметров модуля с помощью такого метода смотрите в статье «Пользовательский модуль двухфакторной авторизации».
Способ обращения к параметрам модуля с помощью свойства Namespace.params считается устаревшим, но публикация скриптов с ним возможна.
Добавить параметры настроек модуля
- Перейдите в Администрирование > Модули.
- Наведите курсор на модуль и нажмите на появившийся значок шестерёнки.
- Перейдите на вкладку Настройки.
- Нажмите + Добавить и в окне создания заполните поля:
- Отображаемое имя* — название свойства, которое будет отображаться на различных формах модуля и в его настройках;
- Имя свойства* — название свойства, использующееся при работе с API, скриптами;
- Подсказка — дополнительная информация о свойстве;
- Тип* — тип свойства, например, Строка;
- Поиск и сортировка по полю — если вы выберете эту опцию, то значение данного поля будет использоваться в качестве параметра для поиска;
- Быстрый поиск — значение поля с типом Строка будет участвовать в быстром поиске.
- Заполняется по формуле — эта опция доступна только для полей типа строка, число и деньги. Вы можете указать формулу, при помощи которой система будет автоматически рассчитывать значение для данного свойства. Подробнее читайте в статье «Заполнение по формуле и отображение поля».
- Отображается при выполнении условия — эта опция позволяет скрывать/отображать свойство в зависимости от заданных вами условий. Подробнее читайте в статье «Заполнение по формуле и отображение поля».
- После того как вы укажете все настройки, нажмите Сохранить.
Все созданные поля настроек по умолчанию добавляются на страницу подключения модуля. Посмотреть их можно, нажав на название модуля в разделе Администрирование.
Задать пользовательскую форму настроек модуля
Отображение настроек можно менять. Например, часть настроек можно скрыть, добавить поля для проверки токенов или настроить страницу так, чтобы на ней сразу отображались нужные данные из внешнего сервиса. Для этого:
- В модуле на вкладке Настройки нажмите Изменить форму.
- Откроется дизайнер интерфейсов. На вкладке Шаблон в центре расположено поле для моделирования. Здесь по умолчанию размещён виджет Стандартная форма элемента. Удалите его, чтобы настроить пользовательское отображение формы настроек.
- Справа от поля для моделирования находятся доступные виджеты, а на вкладке Свойства — параметры модуля, добавленные ранее на вкладке Настройки. Чтобы создать пользовательскую форму, перетащите виджеты и свойства из этой области на поле для моделирвания.
- На вкладке Контекст вы можете добавить свойства, которые будут использоваться при написании скриптов для виджета. Подробнее о свойствах вы можете почитать в статьях «Типы контекста в интерфейсах» и «Типы данных в системе».
- На вкладке Скрипты вы можете написать скрипты, определяющие поведение виджета.
- После редактирования в левом верхнем углу нажмите Сохранить, а затем Опубликовать.
Удалить параметры из настроек модуля
Если параметры, добавленные на вкладке Настройки, не используются, вы можете удалить их из списка. Для этого:
- Отметьте нужные записи. Чтобы выбрать все параметры, поставьте флажок слева от столбца Отображаемое имя.
- В правом верхнем углу нажмите кнопку Удалить и подтвердите действие.
Обратите внимание, если вы вручную добавили параметр на пользовательскую форму настроек как отдельное поле или внутрь виджета, например Колонки, то при его удалении появится сообщение об ошибке.