Открыть образ

В этой статье

Открыть образ

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

Образ текущего дашборда можно открывать в различных окнах:

В новом окне (выбрано по умолчанию. Образ открывается в новой вкладке браузера)
В текущем окне (в текущем окне открывается выбранный образ вместо домашнего)
В боковом окне (справа или слева на экране в зависимости от выбранного выравнивания)
В модальном окне
В плейсхолдере (образ открывается в выбранном плейсхолдере)

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

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

Заметка

При выбранном способе ввода Задать формулой в параметр передается не сама формула, а ее вычисленное значение.
Для способов ввода Задать формулой и Задать агрегацией используются формулы агрегации с лимитом значения равным 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	Способ отображения образа: `NEW_WINDOW` — в новом окне `CURRENT_WINDOW` — в текущем окне `DRAWER_WINDOW` — в боковом окне `MODAL_WINDOW` — в модальном окне `PLACEHOLDER` — в плейсхолдере
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

Была ли статья полезна?

Да

Нет

Выполнить скрипт

Обновить переменную