Фильтр
Документация
Главная

Фильтр

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

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

Виджет «Фильтр» с двумя разрезами и примененным значением

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

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

Для настройки виджета нажмите кнопку + Разрез и выберите вариант:

  • Колонку или показатель, по которому фильтруются данные
  • Фильтр по формуле
  • Иерархию

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

Настройки разреза виджета «Фильтр»: фильтры, скрытие пустых значений, режим и сортировка

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

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

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

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

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

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

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

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

Для виджета доступны стандартные настройки фильтрации. Режим Отключено задается на уровне образа — во вкладке «Настройки фильтрации». При глобальном отключении фильтрации в виджете отображается плейсхолдер вместо пустой области.

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

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

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

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

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

Множественный выбор значений из списка

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

Выбор значений из календаря

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

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

Панель фильтров

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

Изменение параметра фильтра

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

Применение нового фильтра

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

2 фильтра с одинаковым разрезом

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

Поиск в виджете с иерархическим разрезом

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

Поиск в виджете с иерархическим разрезом

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

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

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

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

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

Фильтр

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

Фильтр

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

Фильтр

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

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

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

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

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

КлючТипОпределение
titlestringЗаголовок
showMarkdownbooleanОписание
markdownTextstringТекст описания
markdownMeasuresМера в описании
dimensionsРазрезы
sortingСортировка

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

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

КлючТипОпределение
namestringНазвание разреза
valueФормула разреза
dbDataTypeenumТип данных разреза
formatenumФормат
formattingenumФорматирование
formattingTemplatestringСобственное форматирование
Только для форматирования CUSTOM (Настроить)
hideEmptyValuesbooleanСкрыть пустые значения
hierarchyDimensionsИерархический разрез
Иерархический разрез в YAML (ключ hierarchyDimensions)

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

КлючТипОпределение
namestringНазвание разреза
valueФормула разреза
dbDataTypeenumТип данных разреза
formatenumФормат
formattingenumФорматирование
formattingTemplatestringСобственное форматирование
Только для форматирования CUSTOM (Настроить)
hideEmptyValuesbooleanСкрыть пустые значения

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

КлючТипОпределение
paddingsstringОтступы по сторонам
titleSizenumberРазмер заголовка
titleColorЦвет заголовка:
- AUTO — авто
- BASE — базовый
titleWeightenumТолщина заголовка:
- NORMAL — обычная
- BOLD — большая
markdownTextSizenumberТекст описания
В параметре указывается размер текста описания в Markdown. Параметр доступен, если активен переключатель Описание
textSizenumberРазмер текста
dimensionLimitnumberЛимит разреза

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

КлючТипОпределение
filterModeenumРежим фильтрации:
- DEFAULT — базовый
- SINGLE — единичный выбор
ignoreFiltersbooleanИгнорировать фильтры
filtersФильтры
aggregateFiltersАгрегатные фильтры
stateNamestringСостояние

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

widgets:
  - key: filter (1)
    apiVersion: "17"
    type: FILTER
    settings:
      titleColor:
        mode: AUTO
      titleSize: 14
      paddings: 8
      titleWeight: NORMAL
      textSize: 12
      filterMode: DEFAULT
      ignoreFilters: false
      stateName: null
      title: ""
      showMarkdown: false
      markdownMeasures: []
      markdownText: ""
      markdownTextSize: 14
      dimensionLimit: 50
      dimensions:
        - name: Данные
          value:
            mode: FORMULA
            formula: '"nested_2"."Данные"'
          dbDataType: Array(String)
          hideEmptyValues: false
          format:
            value: STRING
            mode: BASE
          formatting:
            value: AUTO
            mode: BASE
          arrayNesting: true
      filters: []
      displayType: SELECT
    localApiVersion: "2"

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

Предыдущая
Панель с показателями
Следующая
Фильтр-таблица
430006, Саранск,
Северо-восточное шоссе, д. 3
ОКВЭД 62.01
ИНН 1328​909857
Код вида деятельности
в области ИТ 15.02 и 17.01
Языки программирования