Фильтр

В этой статье

Фильтр

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

Настройки виджета

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

Настройка данных

Для виджета доступны стандартные настройки данных.

Настройка отображения

Помимо общих настроек отображения, у виджета есть уникальные.

Размер текста

Регулирует размер текста в строках виджета.

Лимит разреза

Лимит разреза отвечает за количество отображаемых строк в списке.

Вид

В зависимости от вида (таблица или список), меняется визуальное представление виджета. Лимит количества строк при отображении полного списка – 200.

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

Настройка фильтрации

Для виджета доступны стандартные настройки фильтрации. Фильтр, настроенный в виджете, невозможно удалить в режиме просмотра.

Подробнее о виджете Фильтр в видеокурсе.

Действие фильтра в режиме просмотра

В режиме просмотра доступен множественный выбор значений.

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

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

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

Чтобы изменить примененное значение фильтра, кликните по нему на панели фильтров.

В зависимости от типа данных в фильтре (строка, дата и пр.) в виджете доступны различные типы фильтрации.

Укажите новое значение фильтра и кликните Применить.

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

Зависимость примененных фильтров

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

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

Пример влияния примененного фильтра на соседний

В образ добавлены два фильтра: можно выбрать тип компонента и его подтип.

В фильтре Тип выбран пункт Аппаратное обеспечение. Тогда в фильтре Подтип доступны значения, применимые только для аппаратного обеспечения.

При этом пункт Аппаратное обеспечение, выбранный в фильтре Тип, не влияет на сам фильтр Тип. Все значения фильтра Тип остаются доступны.

Ограничение выбора доступных дат

Тип данных Дата:
- При задании фильтра по дате выбор ограничивается минимальным и максимальным значениями дат в таблице
Тип данных Дата и время:
- При задании фильтра по дате и времени выбор ограничивается минимальным и максимальным значениями дат в таблице
- Ограничений по значениям времени нет
- Окно календаря всегда открывается на последнем доступном месяце

Настройка виджета в YAML

Виджет можно редактировать не только в образе, но и в YAML-редакторе. В таблице ниже представлены ключи и значения, которые можно использовать для настройки. Подробнее о том, как работать с ключом value, описано на странице Значения разрезов и мер в YAML. Форматы данных, которые можно использовать, описаны на соответствующей странице.

Настройки данных в YAML

Ключ	Тип	Определение
title	string	Заголовок
showMarkdown	boolean	Описание
markdownText	string	Текст описания
markdownMeasures	—	Мера в описании
dimensions	—	Разрезы
sorting	—	Сортировка

Разрезы в YAML (ключ dimensions)

Чтобы добавить разрез, используйте блок dimensions. В блоке используются следующие ключи:

Ключ	Тип	Определение
name	string	Название разреза
value	—	Формула разреза
dbDataType	enum	Тип данных разреза
format	enum	Формат
formatting	enum	Форматирование
formattingTemplate	string	Собственное форматирование Только для форматирования `CUSTOM` (Настроить)
hideEmptyValues	boolean	Скрыть пустые значения
hierarchyDimensions	—	Иерархический разрез

Иерархический разрез в YAML (ключ hierarchyDimensions)

Чтобы добавить иерархический разрез, в блоке dimensions используйте блок hierarchyDimensions. В блоке используются следующие ключи:

Ключ	Тип	Определение
name	string	Название разреза
value	—	Формула разреза
dbDataType	enum	Тип данных разреза
format	enum	Формат
formatting	enum	Форматирование
formattingTemplate	string	Собственное форматирование Только для форматирования `CUSTOM` (Настроить)
hideEmptyValues	boolean	Скрыть пустые значения

Настройки отображения в YAML

Ключ	Тип	Определение
paddings	string	Отступы по сторонам
titleSize	number	Размер заголовка
titleColor	—	Цвет заголовка: - `AUTO` — авто - `BASE` — базовый
titleWeight	enum	Толщина заголовка: - `NORMAL` — обычная - `BOLD` — большая
markdownTextSize	number	Текст описания В параметре указывается размер текста описания в Markdown. Параметр доступен, если активен переключатель Описание
textSize	number	Размер текста
dimensionLimit	number	Лимит разреза
displaySign	enum	Вид: - `SELECT` — в виде списка - `TABLE` — в виде таблицы

Настройки фильтрации в YAML

Ключ	Тип	Определение
filterMode	enum	Режим фильтрации: - `DEFAULT` — базовый - `SINGLE` — единичный выбор - `DISABLED` — отключено
ignoreFilters	boolean	Игнорировать фильтры
filters	—	Фильтры
aggregateFilters	—	Агрегатные фильтры
stateName	string	Состояние

Пример настроенного виджета в YAML-редакторе

- key: FILTER
  apiVersion: "16"
  type: FILTER
  settings:
    displayCondition:
      mode: DISABLED
    textSize: 12
    ignoreFilters: false
    filters: []
    filterMode: DEFAULT
    sorting: []
    dimensionLimit: 50
    dimensions:
      - dbDataType: DATE
        name: Дата (Дата)
        format: DATE
        value:
          mode: TEMPLATE
          templateName: date
          dbType: CH
          tableName: sale
          columnName: Дата
        formatting: AUTO
    title: ""
    titleSize: 14
    stateName: null
    displaySign: SELECT
    titleColor:
      mode: AUTO
    titleWeight: NORMAL
    showMarkdown: false
    markdownMeasures: []
    markdownText: ""

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

Да

Нет

Панель с показателями

Параметр