Общие сведения

Настройка шаблона глобального фильтра (далее – фильтр) необходима при его создании. Также может быть настроен существующий фильтр.

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

Окно настройки состоит по умолчанию из полей:

  • «Название»;
  • «Ключ»;
  • «Расположение»;
  • «Тип фильтра»;
  • «Отображение»;
  • «Условие»;

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



Независимые поля фильтра

Название

Название фильтра должно быть уникальным между всеми пользователями.

Ключ

Ключ служит для идентификации фильтра на слое проекта при фильтрации виджетов или детализации (см. UGDASH для вашей версии, раздел "Интерактивная фильтрация компонентов").

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

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

Расположение

Расположение названия фильтра относительно его поля для установки значения.

Тип фильтра

Типом фильтра определяется способ фильтрации:

  • «Список» – фильтрация по единичному варианту, который выбирается из заранее заданного набора значений;
  • «Мультисписок» – фильтрация по множеству вариантов, которые выбираются из заранее заданного набора значений;
  • «Поиск» – фильтрация по произвольно задаваемой текстовой подстроке;
  • «Число» – фильтрация по произвольно задаваемому числу или диапазону чисел;
  • «Дата» – фильтрация по произвольно задаваемым отметкам времени или диапазону отметок.

—

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

Доступные значения зависимого поля определяются выбранным значением независимого поля.

Отображение

Отображение определяет способ установки значения фильтрации в проекте. Поле зависит от типа фильтра.

Условие

Условие фильтрации определяет способ применения значения фильтрации. Поле зависит от типа и отображения фильтра.

Значение по умолчанию

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

Настройка фильтра с типом «Список»

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

Отображение

Выберите способ отображения в поле «Отображение».



Для фильтра этого типа в выпадающем списке поля «Отображение» доступны варианты:

  • «Радиокнопки» – значение фильтрации устанавливается по нажатию радиокнопки;
  • «Список» – значение фильтрации устанавливается выбором варианта из выпадающего списка;
  • «Иерархия» – значение фильтрации устанавливается выбором варианта из выпадающего многоуровневого списка, таким образом фильтр «Список – иерархия» представляет собой реализацию нескольких связанных фильтров «Список – список».—

Настройка списка

Блок служит для определения набора значений. 

Выберите способ определения набора значений:

  • «Датасет» – набор значений определяется из колонки датасета;
  • «Ручная настройка» – набор значений определяется вручную.

Выбор способа определения доступен для отображений «Радиокнопки» и «Список». Для отображения «Иерархия» набор значений может быть определен только данными из датасета.

Настройка списка для отображений «Радиокнопки» и «Список» из датасета

Датасет

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

—

Отображаемое значение

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

Отображаемое значение – это значение, которое отображается в фильтре, а также используется как значение фильтрации, если для отображаемых значений не определены ключи (см. далее).

—

Ключ

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

Ключ – это значение, которое НЕ отображается в фильтре, но используется как значение фильтрации, когда выбрано соответствующее ему отображаемое значение (см. выше).

  • Использование отображаемого значения в сочетании с ключом может быть полезно в разных ситуациях, к примеру, когда требуется фильтрование по коду, но при этом нужно иметь человекочитаемые обозначения.
  • Если в датасете одному отображаемому значению соответствует более одного ключа, то при выборе значения в условии фильтрации будет использован первый в порядке возрастания ключ. Например: если для отображаемых значений используется колонка «Федеральный округ», а для ключей колонка «Субъект», то при выборе значения «Приволжский федеральный округ» в условии фильтрации будет использовано значение «Кировская область».
  • Если в датасете нескольким отображаемым значениям соответствует один ключ, то при выборе любого отображаемого значения в условии фильтрации будет использован соответствующий ключ. Например: если для отображаемых значений используется колонка «Субъект», а для ключей колонка «Федеральный округ», то при выборе значений «Кировская область», «Нижегородская область» или «Оренбургская область» в условии фильтрации будет использовано значение «Приволжский федеральный округ».

—

Сортировка

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

Фильтр

5. Вы можете применить расширенный фильтр к полю «Отображаемое значение». Подробнее о расширенной фильтрации см. Работа с расширенным фильтром.

Настройка списка для отображений «Радиокнопки» и «Список» вручную

При смене отображения, настройка списка автоматически сбрасывается к способу определения набора значений «Датасет», а заполненные поля очищаются. Пожалуйста, выбирайте отображение заранее.

Название столбца

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

Тип

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

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

Название столбца

3. Укажите название столбца ключей, которое будет использоваться при настройке фильтра в проекте. Название столбца аналогично названию колонки датасета.

Тип

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

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

Отображаемое значение

5. Укажите в поле «Отображаемое значение» отображаемое значение фильтрации.

Отображаемое значение – это значение, которое отображается в фильтре, а также используется как значение фильтрации, если для отображаемых значений не определены ключи (см. далее).

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

Ключ

6. Вы можете указать в поле «Ключ» значение ключа для отображаемого значения фильтрации.

Ключ – это значение, которое НЕ отображается в фильтре, но используется как значение фильтрации, когда выбрано соответствующее ему отображаемое значение (см. выше).

–

Настройка списка для отображения «Иерархия»

Датасет

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

–

Отображаемое значение

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

Отображаемое значение – это значение, которое отображается в фильтре, а также используется как значение фильтрации, если для отображаемых значений не определены ключи (см. далее).

—


Вы можете добавлять необходимое количество вкладываемых уровней списка, нажимая под самым нижним полем кнопку «Добавить уровень».

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


Сортировка

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

Ключ

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

Ключ – это значение, которое НЕ отображается в фильтре, но используется как значение фильтрации, когда выбрано соответствующее ему отображаемое значение (см. выше).

  • Использование отображаемого значения в сочетании с ключом может быть полезно в разных ситуациях, к примеру, когда требуется фильтрование по коду, но при этом нужно иметь человекочитаемые обозначения.
  • Если в датасете одному отображаемому значению соответствует более одного ключа, то при выборе значения в условии фильтрации будет использован первый в порядке возрастания ключ. Например: если для отображаемых значений используется колонка «Федеральный округ», а для ключей колонка «Субъект», то при выборе значения «Приволжский федеральный округ» в условии фильтрации будет использовано значение «Кировская область».
  • Если в датасете нескольким отображаемым значениям соответствует один ключ, то при выборе любого отображаемого значения в условии фильтрации будет использован соответствующий ключ. Например: если для отображаемых значений используется колонка «Субъект», а для ключей колонка «Федеральный округ», то при выборе значений «Кировская область», «Нижегородская область» или «Оренбургская область» в условии фильтрации будет использовано значение «Приволжский федеральный округ».

—

Фильтр

5. Вы можете применить расширенный фильтр к отображаемым значениям. Подробнее о расширенной фильтрации см. Работа с расширенным фильтром.

Условие

Выберите условие фильтрации.

Фильтр с типом «Список» обрабатывает условия:

  • равно – в результате применения фильтра остаются данные, соответствующие значению условия фильтрации;
  • не равно – в результате применения фильтра остаются данные, НЕ соответствующие значению условия фильтрации.

Значение по умолчанию

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

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

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

Настройка фильтра с типом «Мультисписок»

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

Отображение

Выберите способ отображения в поле «Отображение».



Для фильтра этого типа в выпадающем списке поля «Отображение» доступны варианты:

  • «Чекбоксы» – значения фильтрации устанавливаются по выбранным чекбоксам;
  • «Список» – значения фильтрации устанавливаются по выбранным чекбоксам из выпадающего списка.

–

Настройка списка

Блок служит для определения набора значений.

Выберите способ определения набора значений:

Выберите способ определения набора значений:

  • «Датасет» – набор значений определяется из колонки датасета;
  • «Ручная настройка» – набор значений определяется вручную.

Настройка списка из датасета

Датасет

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

–

Отображаемое значение

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

Отображаемое значение – это значение, которое отображается в фильтре, а также используется как значение фильтрации, если для отображаемых значений не определены ключи (см. далее).

–

Ключ

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

Ключ – это значение, которое НЕ отображается в фильтре, но используется в условии фильтрации, когда выбрано соответствующее ему отображаемое значение (см. выше).

  • Использование отображаемого значения в сочетании с ключом может быть полезно в разных ситуациях, к примеру, когда требуется фильтрование по коду, но при этом нужно иметь человекочитаемые обозначения.
  • Если в датасете одному отображаемому значению соответствует более одного ключа, то при выборе значения в условии фильтрации будет использован первый в порядке возрастания ключ. Например: если для отображаемых значений используется колонка «Федеральный округ», а для ключей колонка «Субъект», то при выборе значения «Приволжский федеральный округ» в условии фильтрации будет использовано значение «Кировская область».
  • Если в датасете нескольким отображаемым значениям соответствует один ключ, то при выборе любого отображаемого значения в условии фильтрации будет использован соответствующий ключ. Например: если для отображаемых значений используется колонка «Субъект», а для ключей колонка «Федеральный округ», то при выборе значений «Кировская область», «Нижегородская область» или «Оренбургская область» в условии фильтрации будет использовано значение «Приволжский федеральный округ».

–

Сортировка

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

Фильтр

5. Вы можете применить расширенный фильтр к полю «Отображаемое значение». Подробнее о расширенной фильтрации см. Работа с расширенным фильтром.

Настройка списка вручную

При смене отображения настройка списка автоматически сбрасывается к способу определения набора значений «Датасет», а заполненные поля очищаются. Пожалуйста, выбирайте отображение заранее.

Название столбца

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

Тип

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

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

Название столбца

3. Укажите название столбца ключей, которое будет использоваться при настройке фильтра в проекте. Название столбца аналогично названию колонки датасета.

Тип

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

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

Отображаемое значение

5. Укажите в поле «Отображаемое значение» отображаемое значение фильтрации.

Отображаемое значение – это значение, которое отображается в фильтре, а также используется в условии фильтрации, если для отображаемых значений не определены ключи (см. далее).

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

Ключ

6. Вы можете указать в поле «Ключ» значение ключа для отображаемого значения фильтрации.

Ключ – это значение, которое НЕ отображается в фильтре, но используется в условии фильтрации, когда выбрано соответствующее ему отображаемое значение (см. выше).

–

Условие

Выберите условие фильтрации.

Фильтр с типом «Мультисписок» обрабатывает условия:

  • «Принадлежит к множеству» – в результате применения фильтра остаются данные, соответствующие значениям фильтрации;
  • «Не принадлежит к множеству» – в результате применения фильтра остаются данные, НЕ соответствующие значениям фильтрации.

Значение по умолчанию

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

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

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

Настройка фильтра с типом «Поиск»

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


Отображение

Для фильтра этого типа в выпадающем списке поля «Отображение» доступен только вариант «Поле ввода».

Условие

Выберите условие фильтрации.

Фильтр с типом «Поиск» обрабатывает условия:

  • «Равно»;
  • «Не равно»;
  • «Содержит (с учетом регистра)»;
  • «Не содержит (с учетом регистра)»;
  • «Содержит (без учета регистра)»;
  • «Не содержит (без учета регистра)»;
  • «Начинается с (с учетом регистра)»;
  • «Начинается не с (с учетом регистра)»;
  • «Начинается с (без учета регистра)»;
  • «Начинается не с (без учета регистра)»;
  • «Заканчивается на (с учетом регистра)»;
  • «Заканчивается не на (с учетом регистра)»;
  • «Заканчивается на (без учета регистра)»;
  • «Заканчивается не на (без учета регистра)».

Значение по умолчанию

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

Настройка фильтра с типом «Число»

Фильтр с типом «Число» служит для фильтрации по произвольно задаваемому числу или диапазону чисел.


Отображение

Для фильтра этого типа в выпадающем списке поля «Отображение» доступны варианты:

  • «Число»;
  • «Диапазон чисел».

Условие

Выберите условие фильтрации.

Фильтр с типом «Число» обрабатывает условия для отображения «Число»:

  • «Равно»;
  • «Не равно»;
  • «Больше»;
  • «Больше или равно»;
  • «Меньше»;
  • «Меньше или равно»;

и условия для отображения «Диапазон чисел»:

  • «Входит в диапазон»;
  • «Не входит в диапазон».

Значение по умолчанию

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

Настройка фильтра с типом «Дата»

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


Отображение

Для фильтра этого типа в выпадающем списке поля «Отображение» доступны варианты:

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


При ручном вводе значение задается по маске dd.MM.yyyy.

Условие

Выберите условие фильтрации.

Фильтр с типом «Дата» обрабатывает условия для отображений «Поле ввода», «Поле ввода со временем», «Календарь»:

  • «Равно»;
  • «Не равно»;
  • «Больше»;
  • «Больше или равно»;
  • «Меньше»;
  • «Меньше или равно»;

и условия для отображений «Поле ввода с периодами», «Поле ввода с периодами со временем», «Календарь с периодами»:

  • «Входит в период»;
  • «Не входит в период».

Значение по умолчанию

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

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

Для смещения с протяженностью «Месяц», в случае, когда в рассчитанном месяце количество дней меньше, чем в текущем, правильной датой расчета считается последний день рассчитанного месяца до дня начала следующего месяца. Например:

  • для дат 29, 30 и 31 марта при смещении минус 1 месяц будет рассчитана дата 28 февраля;
  • для дат 29, 30 и 31 января при смещении плюс 1 месяц будет рассчитана дата 28 февраля.

—

Права доступа

Для настройки прав доступа к фильтру см. Права доступа к сущности приложения.