Фильтрация источника

Фильтрация источника позволяет использовать для графика объекты с заданными характеристиками. На виджете выводятся только отфильтрованные данные.

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

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

Настройки фильтрации выполняются при создании или редактировании виджета.

Место настройки в интерфейсе

Панель редактирования виджета → вкладка "Параметры" → блок "Источник".

Выполнение настройки

  1. После выбора источника нажмите иконку фильтрации , откроется форма настройки условий фильтрации.

  2. Выполните настройки фильтрации:

    • Выберите атрибут объекта-источника, по которому будет проводиться фильтрация списка.

      Доступны все атрибуты класса источника, за исключением:

      • Вычислимые атрибуты (как пользовательские, так и системные);
      • Системный атрибут "Пароль" (password) класса "Сотрудник" (employee).

      Особенности:

      • Если в условиях фильтрации в левой части выбран атрибут, добавленный на уровне типа, то в результирующий список попадут только объекты данного типа, удовлетворяющие условиям фильтрации.
      • Если в классе объектов или в одном из его типов у атрибута стоит метка Metadata, то такой атрибут не выводится в список выбора на форме настройки фильтрации источника (добавлено с версии 2.4, удалено с версии 3.6.3).

    • Выберите критерий фильтрации. Набор критериев зависит от типа атрибута.

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

      При использовании критерия: "равно атрибуту текущего объекта", "содержит атрибут текущего объекта" или "раньше/позже атрибута текущего объекта" в дереве выбора содержатся все атрибуты класса, на карточке которого расположен дашборд, и атрибуты вложенных в него типов за исключением вычислимых атрибутов.

    • Установите значение фильтра. Внешний вид поля выбора или ввода значения фильтра зависит от типа атрибута.

  3. Нажмите Сохранить.

Результат настройки

Для указанного источника настроены фильтры.

Настройка фильтрации источника по ссылочным атрибутам

Предварительная настройка источника

  • В классе/типе объектов источника добавьте группу атрибутов с кодом forDashAttrList. В группу добавьте атрибуты, которые будут доступны для выбора на форме настройки фильтрации источника.

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

  • Для ссылочных атрибутов на форме настройки фильтрации источника доступен выбор атрибутов класса, на который ссылается данный атрибут. Список доступных атрибутов также определяется группой атрибутов (по умолчанию группой атрибутов с кодом system).

Результат настройки

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

Сохранение и переиспользование фильтра

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

Сохранение настройки фильтрации

Чтобы сохранить настройки фильтрации, наведите курсор на название источника и нажмите иконку .

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

Выбор сохраненных фильтров

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