#Форма фильтрации

#Введение

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

#Как использовать

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

Шаги настройки:

1. Включите режим конфигурации, добавьте на страницу блок «Форма фильтрации» и блок «Таблица».
2. Добавьте поле «Никнейм» в блок таблицы и блок формы фильтрации.
3. Теперь она готова к использованию.

#Высокоуровневое использование

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

#Связывание нескольких блоков

Одно поле формы может одновременно фильтровать данные в нескольких блоках. Порядок действий следующий:

1. Нажмите на пункт конфигурации «Connect fields» для поля.
2. Добавьте целевые блоки, которые необходимо связать, здесь мы выбираем блок списка на странице.
3. Выберите одно или несколько полей в блоке списка для связи. Здесь мы выбираем поле «Никнейм».
4. Нажмите кнопку сохранения, чтобы завершить настройку, результат показан ниже:

#Связывание блоков диаграмм

Справочно: Фильтры страницы и связь

#Пользовательские поля

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

1. Нажмите на опцию «Пользовательские поля», появится интерфейс конфигурации.
2. Заполните заголовок поля, выберите «Выбор» в «Типе поля» и настройте параметры.
3. Вновь добавленные пользовательские поля необходимо вручную связать с полями целевого блока:
4. Настройка завершена, результат показан ниже:

В настоящее время поддерживаются следующие типы полей:

• Текстовое поле
• Число
• Дата
• Выбор
• Переключатель (Radio)
• Флажок (Checkbox)
• Связанная запись (Association)

#Связанная запись (пользовательское поле связи)

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

Описание параметров конфигурации:

• Целевая таблица данных: указывает, из какой таблицы данных (коллекции) загружать доступные для выбора записи.
• Поле заголовка: используется в качестве отображаемого текста в выпадающем списке и выбранных тегах (например, имя, заголовок).
• Поле значения: используется в качестве фактического значения, отправляемого при фильтрации, обычно выбирается поле первичного ключа (например, id).
• Разрешить множественный выбор: после включения можно выбрать несколько записей одновременно.
• Оператор: определяет, как сопоставляются условия фильтрации (см. описание «Оператор» ниже).

Рекомендуемая конфигурация:

1. Для Поля заголовка выбирайте поле с высокой читаемостью (например, «Имя»), чтобы избежать использования чистых ID, влияющих на удобство использования.
2. Для Поля значения отдавайте приоритет полю первичного ключа, чтобы обеспечить стабильность и уникальность фильтрации.
3. В сценариях одиночного выбора обычно отключайте Разрешить множественный выбор, а в сценариях множественного выбора — включайте и используйте подходящий Оператор.

#Оператор

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

#Сворачивание

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

Поддерживаются следующие конфигурации:

• Количество строк при сворачивании: устанавливает количество строк полей формы, отображаемых в свернутом состоянии.
• Свернуто по умолчанию: если включено, форма фильтрации по умолчанию отображается в свернутом состоянии.