Общая информация

Когда необходимо предоставить пользователям возможность исследовать детали данных при нажатии на строки таблиц или другие элементы визуализации на дашборде, то для реализации данной интерактивности следует использовать механизм Drilldown (детализация).

Как работает детализация

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

Типы детализации

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

Переход к целевому объекту

Детализация позволяет связывать дашборд с внешним целевым объектом, который открывается при нажатии пользователем. Целью может быть поисковый запрос, другой дашборд, либо веб-сайт.

Интерактивное поведение

Детализация также позволяет активировать интерактивное поведение внутри дашборда.

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

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

Значения токенов можно передать в поисковый запрос, дашборд или URL, настроив детализацию для установки токенов в целевом объекте на захваченные исходные значения. Такая установка значений токенов позволяет отображать в целевом объекте настраиваемый контент.

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

Доступ к токенам в детализации

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

Разновидность токенов

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

Структура	Описание	Применение
$dashboardToken$	Значение фильтра на дашборде	Большинство фильтров.
$timeToken$	Значение временного фильтра. Доступны следующие функции: $timeToken.start$ - левая граница временного периода. $timeToken.end$ - правая граница временного периода. $timeToken.isPaused$ - флаг включения автообновления. $timeToken.refreshInterval$ - период автообновления.	Тип фильтра Время.
$click.value[X|Y]$	Значение на оси X или Y диаграммы.	Визуализации с двумя измерениями X и Y (Круговая, столбчатая, линейная).
$click.name[X|Y]$	Название оси X или Y диаграммы.
$row.columnName$	Значение ячейки в таблице.	Тип визуализации Таблица.
$data.fieldName$	Значение поля в результатах.	Тип визуализации HTML.

События взаимодействия с фильтрами

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

Для определения имени токена для фильтра дашборда следует проверить исходный код JSON для этого поля.

Выбор поведения при детализации

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

Действие	Тип действия	Поведение и настройка
Поисковый запрос	Переход к целевому объекту	При нажатии на элемент происходит открытие страницы с заданным поисковым запросом.
Произвольная ссылка	Переход к целевому объекту	При нажатии на элемент происходит открытие заданного веб-сайта или иной сущности в системе. Значения токенов из источника в URL передаются в качестве параметров строки запроса.
Управление токенами	Интерактивное поведение	Вместо перехода к другой странице, используются изменения значений токенов для настройки интерактивного поведения на том же дашборде.

Доступ к редактору детализации

Редактор детализации позволяет активировать и настраивать действия детализации. Изменения можно осуществлять через визуальный интерфейс или JSON-редактор.

Шаги

1. На дашборде, где требуется настроить детализацию, нажать Редактировать.
2. Выбрать панель, где настраивается детализация и нажать на иконку настройки.
3. Использовать редактор для включения и настройки действий детализации.