Перейти к содержанию

Фильтры для проверки

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

Назначение фильтров

Фильтры определяют условия отбора данных (например, Год = 2023 И Регион = 'Центральный'). Они используются для:

  • Тестирования и проверки корректности данных в витринах
  • Ограничения данных при предпросмотре
  • Создания сценариев проверок

Сохраненный фильтр можно выбрать в поле «Фильтр для проверки» при проверке показателя. См. страницу «Проверка показателей».

Управление списком фильтров

Для каждого созданного фильтра отображается:

Колонка Описание
«Название фильтра» Название фильтра, с предупреждающим значком при наличии ошибки в условиях
«Описание фильтра» Описание фильтра
«Условия фильтра» Условия, в которых вместо идентификаторов отображаются названия элементов
«Действия» Редактирование, создание копии, удаление

Список выводится страницами, по умолчанию 10 записей на страницу.

Доступные действия:

  • Редактировать: Изменить параметры существующего фильтра
  • Создать копию: Создает дубликат фильтра. Название копии предлагается автоматически, с суффиксом «Копия», и может быть изменено перед сохранением
  • Удалить: Удаляет фильтр после подтверждения: «Вы уверены, что хотите удалить фильтр для проверки?»

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

Создание фильтра

Нажмите «Добавить фильтр» и заполните параметры:

Параметр Требования
Название фильтра Обязательно. Уникально в рамках области видимости фильтра. Регистрозависимое. 1–64 символа. Допустимы буквы, цифры, пробел, ., -, _. Не может начинаться со специального символа.
Описание фильтра Необязательно. До 255 символов.
Условия фильтра Обязательно. Требуется как минимум одно условие.

Формирование условий

Условия собираются построчно. Кнопка «Добавить условие» добавляет строку, а кнопка удаления в конце строки убирает ее. Каждая строка состоит из трех частей:

Часть Описание
«Выберите поле» Элемент, к которому применяется условие. В списке предлагаются факты и измерения таблицы фактов, включая измерения ее справочников. Для глобального фильтра предлагаются все элементы, используемые в версии проекта
«Выберите операцию» Оператор сравнения
Значение Значение или значения для сравнения

Доступные операторы: =, <, >, <=, >=, <>, IN, NOT IN, BETWEEN, NOT BETWEEN, LIKE, NOT LIKE, IS NULL, IS NOT NULL.

Поля ввода значения зависят от оператора:

  • IS NULL и IS NOT NULL не требуют значения
  • BETWEEN и NOT BETWEEN требуют два значения, вводимых в поля «От» и «До»
  • IN и NOT IN принимают список значений; кнопка «Добавить значение» добавляет очередную запись
  • Остальные операторы принимают одно значение

Значения проверяются при вводе:

Сообщение Значение
«Необходимо вводить текст в одинарных кавычках» Текстовые значения нужно заключать в одинарные кавычки
«Неверный формат числа. Ввод текста допустим в одинарных кавычках» Значение не является ни корректным числом, ни текстом в кавычках
«Необходимо использовать десятичную точку» В качестве десятичного разделителя введен не точка
«Неверный формат даты. Используйте ГГГГ-ММ-ДД формат. Ввод текста допустим в одинарных кавычках» Дата не соответствует требуемому формату
«Недействительный год», «Недействительный месяц», «Недействительный день» Части даты выходят за допустимый диапазон

Условия одного фильтра объединяются оператором AND.

Области видимости фильтров

Область Видимость Создание
Фильтр таблицы фактов Только в контексте этой таблицы фактов Через вкладку «Фильтры для проверки» таблицы фактов
Глобальный фильтр Для всей версии проекта, включая показатели, не привязанные ни к одной таблице фактов Через каталог фильтров на странице «Модель данных», если поле таблицы фактов оставлено пустым

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

Ошибки в условиях

Фильтр, условия которого больше не удается разрешить, помечается предупреждающим значком с подсказкой «Ошибка настройки фильтра». Это происходит, если элемент, на который ссылается условие:

  • имеет статус «В работе» или «Архивный» в РПИ
  • имеет название, встречающееся в версии проекта более одного раза, из-за чего ссылка неоднозначна
  • больше не входит в таблицу фактов этого фильтра, а для глобального фильтра — ни в одну таблицу фактов версии
  • больше не существует

В форме формирования условий такая ссылка отображается неактивной с предупреждающим значком и подсказкой «Неопределенное поле: {название}» либо «Измерение было удалено», если элемент был удален.

Фильтр с ошибкой сохраняется, но выбрать его в поле «Фильтр для проверки» нельзя до исправления условий.

Особенности работы

  • Область действия: Фильтры сохраняются для конкретной таблицы фактов в ее версии проекта либо глобально для версии. Фильтры разных таблиц фактов независимы
  • Копирование: При копировании версии проекта или клонировании всего проекта фильтры копируются вместе со своей таблицей фактов
  • Права доступа: Создание, редактирование, копирование и удаление фильтров требуют уровня доступа Разработчик или выше в проекте и действующей лицензии. Остальные роли могут просматривать список