Главная

Способы ввода

Способы ввода используются для передачи параметров в открываемые образы, скрипты или переменные с помощью действий по клику (кроме действия Перейти к URL-адресу).

Заметка

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

Из колонки

Cпособ используется, чтобы передавать значение из выбранной колонки таблицы. Для запуска скрипта передается значение из колонки, которая соответствует выбранной строке в таблице. Для действия по клику передается значение из колонки, отфильтрованное значением разреза, при клике на которое было запущено действие. Указанная в способе ввода колонка при этом может не отображаться в дашборде.

Из переменной

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

При выборе этого способа ввода появляется поле Переменная. При нажатии на поле необходимо выбрать переменную дашборда подходящего типа данных.

Заметка

Если открываемый образ генерируется скриптом, то переменная дашборда передается в ожидаемое поле скрипта, а значение ожидаемого поля — в переменную Входящее значение генерируемого образа.

Из модели данных

Способ используется, чтобы передавать в параметр список значений из модели данных: список таблиц (основной параметр) или список колонок (зависимый параметр). Для использования списка колонок необходимо настроить связанный параметр.

Задать формулой

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

Задать агрегацией

Способ используется, чтобы передавать результат агрегации в ожидаемое поле скрипта. Например, если необходимо передать в фильтр генерируемого образа строку с результатом агрегации. Результат агрегации должен совпадать с типом ожидаемого поля.

Заметка

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

Важно

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

Ввести вручную

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

Статический список

Способ используется для выбора значения из заранее заданного списка при запуске действия. Значения списка указываются в формате YAML: можно задать список значений с отображаемыми именами (например, [{"label": "English", "value": "en"}]) или без них (например, ["en", "es"]).

Для параметра также можно указать значение по умолчанию и активировать переключатели Принимать пустое значение и Скрыть параметр.

Динамический список

Способ используется для выбора значения из динамически формируемого списка при запуске действия.

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

Имя события

Этот способ ввода используется только в настройке действий по клику для событий Карты процесса и Сферы процессов. При клике на переход с установленным действием передается имя события этого перехода.

Имя начального события

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

Имя конечного события

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

Заметка

Для способов ввода Имя события, Имя начального события и Имя конечного события передаваемое значение имеет тип данных Строка.

Наборы способов ввода в виджетах

Набор способов ввода зависит от виджета, для которого они настраиваются.

Способ ввода	Виджет
Из колонки	Таблица Сводная таблица Комбинированная диаграмма Столбиковая диаграмма Кольцевая диаграмма Линейный график
Из переменной	Таблица Сводная таблица Комбинированная диаграмма Столбиковая диаграмма Кольцевая диаграмма Линейный график Кнопка Карта процесса (для событий и переходов) Сфера процессов (для событий и переходов) Воронка (для этапов процесса) Панель с показателями Текст
Из модели данных	Таблица Кнопка (только для действия по клику Выполнить скрипт)
Задать формулой	Таблица Сводная таблица Комбинированная диаграмма Столбиковая диаграмма Кольцевая диаграмма Линейный график
Задать агрегацией	Кнопка Кольцевая диаграмма Комбинированная диаграмма Линейный график Сводная таблица Столбиковая диаграмма Таблица Воронка (для этапов процесса) Панель с показателями Текст
Ввести вручную	Таблица Кнопка (только для действия по клику Выполнить скрипт)
Статический список	Таблица Кнопка (только для действия по клику Выполнить скрипт)
Динамический список	Таблица Кнопка (только для действия по клику Выполнить скрипт)
Имя события	Карта процесса (для событий) Сфера процессов (для событий)
Имя начального события	Карта процесса (для переходов) Сфера процессов (для переходов)
Имя конечного события	Карта процесса (для переходов) Сфера процессов (для переходов)