Открыть образLTS
С помощью этого действия в режиме просмотра можно открывать образ: пустой, созданный или генерируемый.
Образ текущего дашборда можно открывать в:
- Окне (выбрано по умолчанию. В текущем окне открывается выбранный образ вместо домашнего)
- Переключатель Открыть в новом окне (Образ открывается в новой вкладке браузера)
- В боковом окне
- Выравнивание (справа или слева на экране)
- Кнопки действий
- В модальном окне
- В месте клика (в режиме просмотра модальное окно с образом открывается рядом с местом последнего клика)
- Кнопки действий
- В плейсхолдере (образ открывается в выбранном плейсхолдере)
Для действия по клику Открыть образ необходимо настроить параметры для всех переменных типа Входящее значение, если они заданы в настройках открываемого образа.
При открытии генерируемого образа может понадобиться настроить параметры. Для настройки параметров используются способы ввода Из колонки, Из переменной, Задать формулой или Задать агрегацией.
- При выбранном способе ввода Задать формулой в параметр передается не сама формула, а ее вычисленное значение.
- Для способов ввода Задать формулой и Задать агрегацией используются формулы агрегации с лимитом значения равным
1. - В плейсхолдере при настройке параметров для генерируемого образа доступны только способы ввода Из переменной и Задать агрегацией.
При открытии образа во всех вариантах окон в режиме просмотра в него наследуются фильтры образа, из которого он открывался.
При открытии образа в боковом или модальном окне в режиме просмотра:
- Если в открываемом образе есть виджет Фильтр, его можно применять
- В открываемом образе действуют предустановленные фильтры, если они заданы для виджетов в этом образе
- В открываемом образе можно использовать фильтр по клику, если для такого образа выбран режим фильтрации Единичный выбор. Чтобы отменить фильтр по клику, повторно нажмите на выбранное значение
При настройке действия по клику необходимо учитывать следующие особенности:
- Внутри образа невозможно отобразить этот же образ с помощью плейсхолдера
- Если скрипт возвращает в плейсхолдер пустой образ, такой плейсхолдер в режиме просмотра скрывается, но отображается в режиме редактирования
Пример открытия созданного образа
- В модель данных пространства добавлена таблица
case_table, которая содержит информацию об обращениях в техподдержку компании. В колонкеrf_nameданной таблицы указывается название филиала. - Имеется дашборд с данными по обработке заявок, в котором находятся два образа: Обработка заявок и Детализация по филиалу.
- В образе Детализация по филиалу находится круговая диаграмма по типу взаимодействия с клиентом и входящее значение Филиал.
В значении по умолчанию используется формула:
any("case_table"."rf_name"). - Для использования входящего значения в качестве фильтрации, на уровне образа добавляется фильтр с формулой
"case_table"."rf_name" = ${Филиал}. При открытии образа ко всем виджетам в нем применяется эта фильтрация. - В образе Обработка заявок, который назначен домашним, находится столбиковая диаграмма с данными по средней длительности обработки и количеству обращений. В качестве разреза указан Филиал (формула
"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 |
Пример настройки действия по клику в YAML: по нажатию открывается образ с детализацией продаж по типу магазина. Ключ образа store-sales-by-type указан в viewKey.
Рекомендуем менять автоматически созданное название ключа на более понятное уникальное название в образе. Это упростит использование ключа при создании ссылок на образ и редактировании в YAML-редакторе.
onClick:
- mode: EXISTED_VIEW
name: Открыть образ
viewKey: store-sales-by-type
inheritFilter: true
type: OPEN_VIEW
openIn: DRAWER_WINDOW
alignment: RIGHT
parameters:
- dbDataType: String
inputMethod: COLUMN
name: Тип магазина
columnName: Тип магазина
tableName: store
Была ли статья полезна?