# Фильтрация в справочниках

Last modified by vasilyev on 2024/09/23 23:00

#### Export

#### Office Formats

Export as PDF Export as ODT Export as RTF

#### Other Formats

Select the pages to export:

select all / none

Export as HTML

Многие справочники НПР содержат большое количество записей. Для более удобной и гибкой работы с такими данными эти справочники снабжены отдельной панелью Фильтр в верхней части формы.

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

В отличие от универсального фильтра грида входной фильтр может быть исполнен более гибко и имеет следующие преимущества:

- Возможно выполнение сложных условий фильтрации, по данным, отсутствующим в наборе. Например, OEM-код в справочнике Товары итд.
- Возможно использование произвольных элементов управления и логики. Например, Бренд для фильтрации в справочнике Производители ТГ поддерживает множественный выбор и указание условия И/ИЛИ.
- Входной фильтр справочника работает быстро на больших наборах, поскольку он имеет все возможности для оптимизации.

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

Общие элементы управления (кнопки)

Закрепить - если кнопка нажата, указанный фильтр сохраняется в модели формы.

Очистить - все элементы управления панели Фильтр очищаются, данные возвращаются без фильтрации.

Особенности

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

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

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

Внимание! При выборе значений, лежащих вне пределов фильтрации, запись исчезнет из списка после применения изменений. Например, фильтр справочника Производители ТГ имеет поле Специализация с мягким условием фильтрации. Вы можете ввести туда часть слова и список отфильтруется по вхождению в поле. Если перейти в режим модификации данных в гриде, поле Специализация останется доступным для редактирования. Но если введенный текст не будет удовлетворять вхождению введенного в фильтр шаблона, примененная запись визуально исчезнет. Введите подходящий шаблон в фильтр и вы увидите эту запись со всеми изменениями.

Tags:
Created by vasilyev on 2024/09/23 12:17

- Comments (0)
- Attachments (3)
- History
- Information

# Applications

XWiki 9.11.8