Настройка параметров пользовательского действия

Описание настройки

Для действия по событию "[Пользовательское событие]" (пользовательское действие) можно настроить параметры, которые необходимо будет заполнять в интерфейсе оператора при выполнении данного действия на специальной форме. Форма открывается после нажатия на элемент управления (кнопку, ссылку, иконку).

Инициация пользовательского действия из веб-интерфейса

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

Форма пользовательского действия по событию открывается, если:

настроены параметры действия по событию (настройка параметров описана в данном разделе);
на форме размещено встроенное приложение, см. Размещение встроенного приложения на формах.

Инициация пользовательского действия из мобильного приложения

Работа с параметрами действия по событию НЕ поддерживается в мобильном приложении.

При инициации действия по событию типа "[Пользовательское событие]" с настроенными параметрами из мобильного приложения, данные параметры будут игнорироваться (переменная контекста params = null).

Место настройки в интерфейсе

Карточка настройки действия по событию "[Пользовательское событие]" в блоке "Параметры".

Выполнение настройки

Чтобы добавить параметры действия по событию, выполните следующие действия:

В меню навигации выберите "Настройка системы" → "Действия по событиям" и нажмите на название действия по событию "[Пользовательское событие]".
Нажмите кнопку "Добавить параметр" в блоке "Параметры". На экране отобразится форма добавления параметра.
Заполните поля формы добавления параметра и нажмите кнопку Сохранить.

Поля формы добавления параметра

Название параметра	Описание и возможные значения	Зависимость от типа параметра
Название	Название параметра, используется в качестве подписи параметра на форме	Для всех параметров
Скрывать название атрибута	Признак, управляющий отображением названия параметра в интерфейсе. флажок снят — название параметра отображается; флажок установлен — название параметра не отображается.	Для всех параметров
Код	Введите код параметра, уникальный в рамках действий по событиям. Недопустимые значения поля "Код": user, parent, state, responsible, responsibleTeam, responsibleEmployee, stateStartTime, massProblem	Для всех параметров
Тип значения	От типа значения параметра зависит набор полей на форме добавления и вид полей для отображения и редактирования значения параметра. Возможные типы значений: Агрегирующий, Вещественное число, Временной интервал, Гиперссылка, Дата, Дата/время, Логический, Набор ссылок на бизнес-объекты, Набор типов класса, Набор элементов справочника, Набор элементов произвольного справочника, Ссылка на бизнес-объект, Строка, Текст, Текст в формате RTF, Текст с подсветкой синтаксиса, Файл, Целое число, Элемент произвольного справочника, Элемент справочника.	Для всех параметров
Редактируемый	Признак, определяющий редактируемость параметра. Флажок установлен — параметр отображается на форме как поле для ввода (вид поля определяется представлением для редактирования). Флажок снят — параметр отображается на форме как фиксированное значение (вид поля определяется представлением для отображения)	Для всех параметров
Обязательный	Признак, определяющий обязательность заполнения значения параметра. Флажок установлен — значение параметра является обязательным для заполнения. Флажок снят — значение не обязательно для заполнения.	Для всех параметров
Вычисление значения	Если флажок установлен, то добавьте или выберите скрипт, в котором указываются правила вычисления значений параметров на различных формах в интерфейсе оператора. Скрипт вычисления значения параметра Добавление и редактирование скрипта. Компонент работы со скриптом	Кроме ссылочных атрибутов, агрегирующего атрибута, набора типов класса, элементов справочника
Агрегировать классы	Классы объектов, которые объединяет атрибут	Для типа "Агрегирующий атрибут"
Класс объекта	Класс объекта, с которым будет создана связь (кроме класса "Компания" (root)	Для типов "Набор ссылок на БО", "Ссылка на бизнес-объект"
Типы объекта	Типы объектов указанного класса, с которыми может быть установлена связь посредством данного параметра	Для типов "Набор ссылок на БО", "Ссылка на бизнес-объект"
Фильтрация значений при редактировании	Признак, определяющий визуальное ограничение возможных значений параметра. Условия фильтрации задаются в скрипте. Скрипт фильтрации значений параметра Добавление и редактирование скрипта. Компонент работы со скриптом	Для типа "Агрегирующий атрибут", "Набор ссылок на БО", "Ссылка на бизнес-объект", "Элемент справочника", "Набор элементов справочника", "Набор элементов произвольного справочника", "Элемент произвольного справочника"
Скрипт вычисления элементов справочника	Скрипт вычисления элементов произвольного справочника Скрипт вычисления элементов произвольного справочника Добавление и редактирование скрипта. Компонент работы со скриптом	Для типа "Набор элементов произвольного справочника", "Элемент произвольного справочника"
Значение атрибута допустимо указывать	Возможные значения: "В прошлом": Флажок установлен (по умолчанию) — уже прошедшие даты можно указывать как значение атрибута. Флажок снят — уже прошедшие даты указывать как значение атрибута НЕ допустимо. "В будущем": Флажок установлен (по умолчанию) — даты в будущем можно указывать как значение атрибута. Флажок снят — даты в будущем указывать как значение атрибута НЕ допустимо. Хотя бы один флажок "В прошлом" или "В будущем" должен быть установлен. В календаре даты, недоступные для выбора, подсвечиваются серым. При вводе недопустимой даты вручную выводится сообщение об ошибке	Для типа "Дата" и "Дата/время"
Дополнительное ограничение на ввод даты	Возможные значения: "Без ограничений" (по умолчанию). "Задать зависимость от атрибута" — ограничение на ввод даты в зависимости от значения другого атрибута типа "Дата" и "Дата/время". В календаре доступны для выбора только допустимые даты. При вводе недопустимой даты вручную выводится сообщение об ошибке. Параметры зависимости: "Условие" — условие зависимости от атрибута: больше или равно, больше, меньше, меньше или равно "Атрибут" — для выбора доступны атрибуты типа "Дата" и "Дата/время", определенные в классе /типе, для которого настраивается атрибут. "Ограничение скриптом" — после выбора данного значения на форме отображается поле "Скрипт" и скрывается поле "Значение атрибута допустимо указывать". При вводе даты с помощью Календаря для выбора доступны только даты, определенные как допустимые в скрипте. При вводе даты вручную, если введенная дата не удовлетворяет заданному в скрипте условию, то выводится сообщение об ошибке, определенное в скрипте. Скрипт ограничения значения атрибутов типа "Дата" и "Дата/время" Добавление и редактирование скрипта. Компонент работы со скриптом Ограничения не влияют на фильтрацию в списках объектов по атрибутам типа "Дата" и "Дата/время"	Для типа "Дата" и "Дата/время"
Представление для отображения	Вид нередактируемого параметра на форме. Параметр отображается, если флажок "Редактируемый" снят	Для всех параметров
Представление для редактирования	Вид поля для редактирования значения параметра. Параметр отображается, если флажок "Редактируемый" установлен	Для всех параметров
Скрывать при редактировании, если нет значений для выбора	Флажок установлен — если у параметра нет доступных для выбора значений, то данный параметр (его название и поле выбора значений) не отображается на форме. Значение параметра считается неуказанным (пустым). Флажок снят — параметр всегда отображается на форме.	Для типа "Агрегирующий атрибут", "Набор ссылок на БО", "Ссылка на бизнес-объект", "Элемент справочника", "Набор элементов справочника", "Набор элементов произвольного справочника", "Элемент произвольного справочника"
Разделять по разрядам	Определяет разбиение значения атрибута по разрядам: Флажок снят (по умолчанию) — разбиения по разрядам нет. Флажок установлен — при вводе значения вручную и при вставке значения (Ctrl+V) целая часть числа разделяется по разрядам, между разрядами ставится пробел. На карточках и в списках значение атрибута отображается с разрядами (в том числе значения, введенные до установки параметра)	Для типа "Вещественное число"
Ограничение на ввод десятичных знаков	Определяет наличие ограничения на ввод десятичных знаков. В поле можно ввести только число от 1 до 10. Если число десятичных знаков указано, то: В поле ввода значения атрибута отображается маска ввода (например, 0.000), где количество нолей после запятой равно заданному числу десятичных знаков. При попытке вставить (Ctrl+V) значение неподходящее по маске, часть значения обрезается. На карточках и в списках значение атрибута отображается с указанным ограничением знаков после запятой (в том числе значения, введенные до установки параметра). Для ранее введенных значений с большим количеством знаков после запятой при отображении используется математическое округление до указанных в параметре единиц (значение в базе данных не изменяется). При редактировании отображаются все знаки и выводится сообщение "Превышено количество десятичных знаков". Если число десятичных знаков не указано, то маска ввода отсутствует и ограничений на ввод значения нет	Для типа "Вещественное число"
Справочник	Справочник, элементы которого могут являться значением данного атрибута	Для типа "Элемент справочника", "Набор элементов справочника"
Сортировка списка	Сортировка списка элементов справочника при редактировании значения параметра: По коду (по умолчанию) — сортировка элементов списка в рамках одного уровня иерархии выполняется лексикографически по коду элемента. По названию — сортировка элементов списка в рамках одного уровня иерархии выполняется лексикографически по названию элемента.	Для типа "Элемент справочника", "Набор элементов справочника"
Описание	Подробное описание параметра и рекомендации по его использованию, отображаемые в интерфейсе оператора	Для всех параметров
Значение по умолчанию	Вычислимое значение по умолчанию (флажок "Вычислимое" установлен) указывается в поле "Скрипт": Скрипт вычисления значения по умолчанию для параметра Добавление и редактирование скрипта. Компонент работы со скриптом	Для всех параметров
Расширенное редактирование связей	Признак использования формы добавления связи. Возможные значения: Выключено (по умолчанию) — для выбора значения параметра используется поле выбора, определенное в параметре "Представление для редактирования". Плоский список — для выбора значения параметра может использоваться форма добавления связи. С использованием структуры — для выбора значения параметра может использоваться форма добавления связи, на которой размещен иерархический список" (кроме агрегирующего атрибута)	Для типа "Агрегирующий атрибут", "Набор ссылок на БО", "Ссылка на бизнес-объект"
Группа атрибутов в списке	Группа атрибутов, которая определяет набор колонок в списке объектов на форме добавления связи. Отображается, если в параметре "Расширенное редактирование связей" выбрано значений "плоский список". Для выбора доступны группы атрибутов класса /типа объектов, с которым устанавливается связь	Для типа "Агрегирующий атрибут", "Набор ссылок на БО", "Ссылка на бизнес-объект"
Структура	Структура, которая применяется для построения иерархического списка на форме добавления связи. Отображается, если в параметре "Расширенное редактирование связей" выбрано значение "с использованием структуры"	Для типа "Набор ссылок на БО", "Ссылка на бизнес-объект"
Редактирование только через расширенную форму	Если флажок установлен, для редактирования используется только форма добавления связи с поиском объектов. Поиск проводится по атрибутам для быстрого поиска объектов, см. Форма добавления связи. Отображается, если в параметре "Расширенное редактирование связей" выбрано значение "плоский список" или "с использованием структуры"	Для типа "Агрегирующий атрибут", "Набор ссылок на БО", "Ссылка на бизнес-объект"
Форма быстрого добавления	Если форма выбрана, то на форме рядом с полем выбора значения данного параметра отображается ссылка для добавления объектов, на которые указывает данный параметр. Отсутствует, если в параметре "Класс объектов" выбран "Запрос" (serviceCall)	Для типа "Набор ссылок на БО", "Ссылка на бизнес-объект"
Форма быстрого редактирования	Если форма выбрана, то на форме рядом с полем выбора значения данного параметра отображается ссылка для редактирования объектов, на которые указывает данный параметр. Отсутствует, если в параметре "Класс объектов" выбран "Запрос" (serviceCall)	Для типа "Набор ссылок на БО", "Ссылка на бизнес-объект"

Особенности заполнения ссылочных параметров:

При заполнении значения параметров типа "Ссылка на бизнес-объект" и "Набор ссылок на бизнес-объекты", можно выбрать его значение из списка уже существующих объектов, добавить новый объект с помощью формы быстрого добавления или изменить существующий объект с помощью формы быстрого редактирования.

Результат настройки

Новый параметр отобразится в блоке "Параметры" в карточке настройки пользовательского действия по событию.

Параметры доступны в скрипте действия по событию при помощи конструкции params'Код_Параметра', например params.title, см. Скрипт действия по событию.

Последующие настройки

Изменение порядка отображения параметров.

Порядок отображения параметров на карточке настройки действия по событию в блоке "Параметры" определяет порядок отображения параметров на форме в интерфейсе оператора.

Порядок отображения параметров устанавливается с помощью с помощью иконок "вверх" и "вниз" в строке с названием параметра в блоке "Параметры".
Редактирование параметра.

Для редактирования параметра нажмите иконку "Редактировать" в строке с названием параметра в блоке "Параметры".
Удаление параметра.

Для удаления параметра нажмите иконку и "Удалить" в строке с названием параметра в блоке "Параметры".