#Фільтр-форма

#Вступ

Фільтр-форма дозволяє користувачам фільтрувати дані, заповнюючи поля форми. Її можна використовувати для фільтрації блоків таблиці, блоків діаграми, блоків списку тощо.

#Як використовувати

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

Кроки конфігурації наступні:

1. Увімкніть режим конфігурації, додайте на сторінку блок «Фільтр-форма» та «Блок таблиці».
2. Додайте поле «Нікнейм» у блок таблиці та блок фільтр-форми.
3. Тепер можна починати використання.

#Розширене використання

Блок фільтр-форми підтримує більше розширених конфігурацій, нижче наведено деякі поширені способи використання.

#Зв'язування кількох блоків

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

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

#Зв'язування блоків діаграм

Довідка: Фільтри сторінок та взаємодія

#Користувацькі поля

Окрім вибору полів із колекції, ви також можете створювати поля форми за допомогою «Користувацьких полів». Наприклад, можна створити поле випадаючого списку та налаштувати варіанти. Порядок дій наступний:

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

Наразі підтримуються такі типи полів:

• Текстове поле
• Число
• Дата
• Вибір
• Перемикач
• Прапорець
• Пов'язані записи

#Пов'язані записи (Користувацьке поле зв'язку)

«Пов'язані записи» підходять для сценаріїв «фільтрації за записами пов'язаної колекції». Наприклад, у списку замовлень фільтрація за «Клієнтом» або у списку завдань фільтрація за «Відповідальним».

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

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

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

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

#Оператор

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

#Згортання

Додайте кнопку згортання, щоб згортати та розгортати вміст фільтр-форми, заощаджуючи місце на сторінці.

Підтримуються такі конфігурації:

• Кількість рядків при згортанні: встановлює кількість рядків полів форми, що відображаються у згорнутому стані.
• Згорнуто за замовчуванням: після увімкнення фільтр-форма за замовчуванням відображатиметься у згорнутому стані.