Открыть образ
С помощью этого действия в режиме просмотра можно открывать образ: пустой, созданный или генерируемый.
Образ текущего дашборда можно открывать в:
- Окне (выбрано по умолчанию. В текущем окне открывается выбранный образ вместо домашнего)
- Переключатель Открыть в новом окне (Образ открывается в новой вкладке браузера)
- В боковом окне
- Выравнивание (справа или слева на экране)
- Кнопки действий
- В модальном окне
- В месте клика (в режиме просмотра модальное окно с образом открывается рядом с местом последнего клика)
- Кнопки действий
- В плейсхолдере (образ открывается в выбранном плейсхолдере)
Для действия по клику Открыть образ необходимо настроить параметры для всех переменных типа Входящее значение, если они заданы в настройках открываемого образа.
При открытии генерируемого образа может понадобиться настроить параметры. Для настройки параметров используются способы ввода Из колонки, Из переменной, Задать формулой или Задать агрегацией.
- При выбранном способе ввода Задать формулой в параметр передается не сама формула, а ее вычисленное значение.
- Для способов ввода Задать формулой и Задать агрегацией используются формулы агрегации с лимитом значения равным
1
. - В плейсхолдере при настройке параметров для генерируемого образа доступны только способы ввода Из переменной и Задать агрегацией.
При открытии образа во всех вариантах окон в режиме просмотра в него наследуются фильтры образа, из которого он открывался.
При открытии образа в боковом или модальном окне в режиме просмотра:
- Если в открываемом образе есть виджет Фильтр, его можно применять
- В открываемом образе действуют предустановленные фильтры, если они заданы для виджетов в этом образе
- В открываемом образе можно использовать фильтр по клику, если для такого образа выбран режим фильтрации Единичный выбор. Чтобы отменить фильтр по клику, повторно нажмите на выбранное значение
При настройке действия по клику необходимо учитывать следующие особенности:
- Внутри образа невозможно отобразить этот же образ с помощью плейсхолдера
- Если скрипт возвращает в плейсхолдер пустой образ, такой плейсхолдер в режиме просмотра скрывается, но отображается в режиме редактирования
Пример открытия созданного образа
- В модель данных пространства добавлена таблица
case_table
, которая содержит информацию об обращениях в техподдержку компании. В колонкеrf_name
данной таблицы указывается название филиала. - Имеется дашборд с данными по обработке заявок, в котором находятся два образа: Обработка заявок и Детализация по филиалу.
- В образе Детализация по филиалу находится круговая диаграмма по типу взаимодействия с клиентом и входящее значение Филиал.
В значении по умолчанию используется формула:
any("case_table"."rf_name")
. - Для использования входящего значения в качестве фильтрации, на уровне образа добавляется фильтр с формулой
"case_table"."rf_name" = "inputs"."Филиал"
. При открытии образа ко всем виджетам в нем применяется эта фильтрация. - В образе Обработка заявок, который назначен домашним, находится столбиковая диаграмма с данными по средней длительности обработки и количеству обращений. В качестве разреза указан Филиал (формула
"case_table"."rf_name"
). Для разреза настроено действие по клику Открыть образ. - В качестве открываемого в боковом окне образа указан созданный образ Детализация по филиалу.
- Во входящем значении открываемого образа указан способ ввода Из колонки. Здесь выбрана колонка с названием филиала, по которому будут фильтроваться данные в открываемом образе.
- Чтобы в режиме просмотра действие по клику срабатывало сразу после нажатия на разрез, для столбиковой диаграммы отключена фильтрация.
- Опубликуем дашборд и нажмем на столбик одного из филиалов.
- Открывается отфильтрованный образ Детализация по филиалу с данными по выбранному филиалу.
Пример открытия генерируемого образа
В одном образе можно отображать компоненты из другого образа, даже если они находятся в другом дашборде. Например, это можно сделать с помощью образа, сгенерированного скриптом.
- Откроем дашборд с образом, который хотим использовать в качестве генерируемого.
- Перейдем в YAML-редактор и скопируем код образа.
- Откроем дашборд и добавим новый скрипт. Назовем его Генерируемый образ на YAML.
- Добавим в скрипт блок Ручной запуск и протестируем его.
- Добавим следующий блок — Вернуть данные. В блоке выберем формат запроса Текст, а в качестве возвращаемых данных — код образа на YAML. Протестируем блок.
- Блок возвращает код образа на YAML. Опубликуем скрипт и откроем дашборд, в котором будем использовать сгенерированный образ.
- Добавим в образ Плейсхолдер. Выберем для отображения Генерируемый образ на YAML.
- Видим, что в плейсхолдере отображается образ, код которого был скопирован ранее. Опубликуем дашборд.
- В режиме просмотра с компонентами генерируемого образа можно взаимодействовать как обычно, например применять фильтрацию.
Действие по клику в YAML
Чтобы добавить действие по клику (OPEN_VIEW
), используйте ключи, перечисленные в таблицах. Ключи указываются в блоке onClick
. Ключи для блока onClick
описаны на странице Действия по клику.
Ключ | Тип | Определение |
---|---|---|
mode | enum | Режим открытия образа:EMPTY — нетEXISTED_VIEW — созданный образGENERATED_BY_SCRIPT — генерируемый |
viewKey | string | Ключ образа Только для режима EXISTED_VIEW |
scriptKey | string | Ключ скрипта Только для режима GENERATED_BY_SCRIPT |
displayName | string | Название образа или отображаемое название генерируемого образа Только для режима GENERATED_BY_SCRIPT |
Если необходимо указать параметры образа или скрипта, добавьте блок parameters
. Внутри блока используются ключи name
и inputMethod
.
Ключ | Тип | Определение |
---|---|---|
parameters | — | Параметры скрипта |
name | string | Название параметра |
inputMethod | enum | Способ ввода значения |
Ключ openIn
отвечает за открытие образа при действии по клику. Внутри блока используются ключи, указанные ниже.
Ключ | Тип | Определение |
---|---|---|
openIn | enum | Параметр Открыть в |
mode | enum | Способ отображения образа: - WINDOW — в окне- DRAWER_WINDOW — в боковом окне- MODAL_WINDOW — в модальном окне- PLACEHOLDER — в плейсхолдере |
newWindow | boolean | Открыть в новом окне. Только при использовании варианта WINDOW |
actionButtons | boolean | Переключатель отображения кнопок действий. Только при использовании вариантов DRAWER_WINDOW и MODAL_WINDOW |
positionByClick | boolean | Переключатель В месте клика. Только при использовании варианта MODAL_WINDOW |
alignment | enum | Выравнивание:LEFT — слеваRIGHT — справаТолько для режима DRAWER_WINDOW |
placeholderName | string | Название плейсхолдера. Только для режима PLACEHOLDER |
Пример:
onClick:
- mode: EXISTED_VIEW
name: Открыть образ
viewKey: 488d8c5d-d61b-334e-befd-872892671b31
type: OPEN_VIEW
openIn: CURRENT_WINDOW
parameters:
- inputMethod: COLUMN
name: Филиал
columnName: rf_name
tableName: case_table
Была ли статья полезна?