Общие сведения
Настройка фильтра необходима при создании фильтра, а также может быть настроен существующий фильтр.
Чтобы перейти к настройке фильтра, начните создание нового фильтра (см. Создание фильтра) или нажмите в реестре фильтров кнопку «» для фильтра, который требуется настроить (см. Действия с фильтром).
Окно настройки состоит по умолчанию из полей:
- «Название»;
- «Ключ»;
- «Расположение»;
- «Тип фильтра»;
- «Отображение»;
- «Условие»;
а также отдельного блока «Права доступа». При установке в полях определённых значений отображаются дополнительные поля, см. далее.
Независимые параметры фильтра
Название
Название фильтра должно быть уникальным среди всех пользователей.
Ключ
Ключ служит для идентификации фильтра на слое проекта при детализации.
Ключи могут быть неуникальны среди всех фильтров. Ключ шаблона фильтра может быть переназначен для фильтра в проекте. В названии ключа допускается использование только символов латинского алфавита, а также цифр.
Расположение
Расположение для фильтра на слое проекта определяет расположение названия фильтра относительно его поля для установки значения.
Тип фильтра
Типом фильтра определяется способ фильтрации:
- «Список» – фильтрация по единичному варианту, который выбирается из заранее определенного набора значений;
- «Мультисписок» – фильтрация по множеству вариантов, которые выбираются из заранее определенного набора значений;
- «Поиск» – фильтрация по произвольно задаваемой текстовой подстроке;
- «Число» – фильтрация по произвольно задаваемому числу или диапазону чисел;
- «Дата» – фильтрация по произвольно задаваемым отметкам времени или диапазону отметок.
Зависимые параметры фильтра
Доступные значения зависимых параметров определяются выбранным значением связанных параметров.
Отображение
Отображением определяется способ установки значения фильтрации в проекте. Параметр зависит от типа фильтра.
Условие
Условием фильтрации определяется способ применения значения фильтрации. Параметр зависит от типа и отображения фильтра.
Значение по умолчанию
Значение фильтрации, выбираемое автоматически при открытии слоя и сбросе фильтров. Параметр зависит от условия фильтрации, а поле параметра отображается, когда условие фильтрации выбрано.
Настройка фильтра с типом «Список»
Фильтр с типом «Список» служит для фильтрации по единичному варианту, который выбирается из заранее определенного набора значений.
Отображение
Выберите способ отображения в поле «Отображение».
Для фильтра этого типа в выпадающем списке поля «Отображение» доступны варианты:
- «Радиокнопки» – значение фильтрации устанавливается по нажатию радиокнопки;
- «Список» – значение фильтрации устанавливается выбором варианта из выпадающего списка;
- «Иерархия» – значение фильтрации устанавливается выбором варианта из выпадающего многоуровневого списка, таким образом фильтр «Список – иерархия» представляет собой реализацию нескольких связанных фильтров «Список – список».
–
–
Настройка списка
Блок служит для определения набора значений.
Выберите способ определения набора значений:
- «Датасет» – набор значений определяется из колонки датасета;
- «Ручная настройка» – набор значений определяется вручную.
Выбор способа определения доступен для отображений «Радиокнопки» и «Список». Для отображения «Иерархия» набор значений может быть определён только данными из датасета.
Настройка списка для отображений «Радиокнопки» и «Список» из датасета
Датасет
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-запроса, значение по умолчанию необходимо переопределять вручную, иначе вместо значения отображается заглушка.
Вы можете выбрать в поле «Значение по умолчанию» значения фильтрации, выбираемые автоматически при открытии слоя и сбросе фильтров. В выпадающем списке поля доступны все отображаемые значения фильтра, заданные при настройке списка, с учетом локальной фильтрации (см. выше).
Настройка фильтра с типом «Поиск»
Фильтр с типом «Поиск» служит для фильтрации по произвольно задаваемой текстовой подстроке.
Отображение
Для фильтра этого типа в выпадающем списке поля «Отображение» доступен только вариант «Поле ввода».
Условие
Выберите условие фильтрации.
Фильтр с типом «Поиск» обрабатывает условия:
- «Равно»;
- «Не равно»;
- «Содержит (с учетом регистра)»;
- «Не содержит (с учетом регистра)»;
- «Содержит (без учета регистра)»;
- «Не содержит (без учета регистра)»;
- «Начинается с (с учетом регистра)»;
- «Начинается не с (с учетом регистра)»;
- «Начинается с (без учета регистра)»;
- «Начинается не с (без учета регистра)»;
- «Заканчивается на (с учетом регистра)»;
- «Заканчивается не на (с учетом регистра)»;
- «Заканчивается на (без учета регистра)»;
- «Заканчивается не на (без учета регистра)».
Значение по умолчанию
Вы можете задать в поле «Значение по умолчанию» значение фильтрации, устанавливаемое автоматически при открытии слоя и сбросе фильтров.
Настройка фильтра с типом «Число»
Фильтр с типом «Число» служит для фильтрации по произвольно задаваемому числу или диапазону чисел.
Отображение
Для фильтра этого типа в выпадающем списке поля «Отображение» доступны варианты:
- «Число»;
- «Диапазон чисел».
Условие
Выберите условие фильтрации.
Фильтр с типом «Число» обрабатывает условия для отображения «Число»:
- «Равно»;
- «Не равно»;
- «Больше»;
- «Больше или равно»;
- «Меньше»;
- «Меньше или равно»;
и условия для отображения «Диапазон чисел»:
- «Принадлежит к множеству»;
- «Не принадлежит к множеству».
Значение по умолчанию
Вы можете задать в поле «Значение по умолчанию» значение фильтрации, устанавливаемое автоматически при открытии слоя и сбросе фильтров. Поле допускает ввод только чисел, в том числе с десятичной запятой.
Настройка фильтра с типом «Дата»
Фильтр с типом «Дата» служит для фильтрации по произвольно задаваемым отметкам времени или диапазону отметок.
Отображение
Для фильтра этого типа в выпадающем списке поля «Отображение» доступны варианты:
- «Поле ввода» – фильтр с полем ввода и иконкой «Календарь» внутри, при нажатии на иконку отображается календарь;
- «Поле ввода со временем» – фильтр с полем ввода и иконкой «Календарь» внутри, при нажатии на иконку отображается календарь с часами;
- «Календарь» – фильтр в виде фиксированного календаря без поля ввода;
- «Поле ввода с периодами» – фильтр с двумя полями ввода, с иконками «Календарь» внутри, при нажатии на иконку отображается календарь;
- «Поле ввода с периодами со временем» – фильтр с двумя полями ввода, с иконками «Календарь» внутри, при нажатии на иконку отображается календарь с часами;
- «Календарь с периодами» – фильтр в виде двух фиксированных календарей без полей ввода.
Условие
Выберите условие фильтрации.
Фильтр с типом «Дата» обрабатывает условия для отображений «Поле ввода», «Поле ввода со временем», «Календарь»:
- «Равно»;
- «Не равно»;
- «Больше»;
- «Больше или равно»;
- «Меньше»;
- «Меньше или равно»;
и условия для отображений «Поле ввода с периодами», «Поле ввода с периодами со временем», «Календарь с периодами»:
- «Входит в период»;
- «Не входит в период».
Значение по умолчанию
Вы можете задать в поле «Значение по умолчанию» значение фильтрации, устанавливаемое автоматически при открытии слоя и сбросе фильтров.
Вы можете использовать параметр «Смещение от текущей даты» для автоматического расчета даты от текущей, с учетом заданного смещения. При включенном параметре поле «Значение по умолчанию» меняет вид на набор полей, в которых можно выбрать направление и расстояние протяженность смещения.
Обратите внимание.
- Для смещения с протяженностью «Месяц», в случае, когда в рассчитанном месяце количество дней меньше, чем в текущем, правильной датой расчета считается последний день рассчитанного месяца до дня начала следующего месяца. Например:
Для дат 29-е, 30-е и 31-е марта при смещении минус 1 месяц будет рассчитана дата 28-е февраля.
Для дат 29-е, 30-е и 31-е января при смещении плюс 1 месяц будет рассчитана дата 28-е февраля.
Права доступа
Для настройки прав доступа к фильтру обратитесь к разделу Права доступа к объекту приложения.