Як використати пошук з автодоповненням у Custom Data?

Пошук з автодоповненням дозволяє користувачам швидко знаходити потрібні записи, обираючи з унікальних значень, які зберігаються в базі. Користувач обирає з унікальних значень, які зберігаються в його константу.

Коли знадобиться

• Потрібно дозволити користувачам вибирати значення з існуючих записів у таблиці.
• Треба створити каскадний пошук (кожен наступний вибір залежить від попереднього).
• Потрібно спростити введення даних, запропонувавши готові варіанти.

Що важливо знати

• Пошук з автодоповненням — блок пошуку, який показує унікальні значення з колонки моделі.
• Користувач обирає з унікальних значень, які зберігаються в його константу.
• Можна використовувати кілька блоків пошуку послідовно — кожен наступний враховує вибір у попередньому.
• Після вибору всіх значень використайте дію custom_modules__get для отримання запису.

Перед початком

• Ви увійшли в систему з правами інтегратора або адміністратора.
• У системі є створена модель Custom Data з записами та унікальними значеннями.
• Ви маєте доступ до конструктора сценаріїв.

Покрокова інструкція

Налаштування блоку пошуку

1. Перейдіть у конструктор сценаріїв бота.
2. Додайте блок "Пошук з автодоповненням" (або аналогічний блок для пошуку в Custom Data).
3. У налаштуваннях блоку вкажіть конфігурацію (JSON):

{
  "module_name": "textile",
  "field": "collection"
}

• module_name — назва моделі (наприклад, "textile", "product", "customer")
• field — назва колонки, з якої вибираються унікальні значення (наприклад, "collection", "category", "brand")

4. Збережіть зміни в блоці.

Каскадний пошук (кілька блоків послідовно)

Якщо потрібно використати кілька блоків пошуку послідовно:

1. Додайте перший блок пошуку з полем першого рівня (наприклад, "collection").
2. Додайте другий блок пошуку з полем другого рівня (наприклад, "color").
3. Кожен наступний блок автоматично враховує вибір у попередньому, фільтруючи доступні варіанти.
4. Після вибору всіх значень додайте блок "Дія" з функцією custom_modules__get для отримання повного запису.

Отримання запису після пошуку

1. Після вибору значень у блоках пошуку додайте блок "Дія".
2. Оберіть функцію custom_modules__get.
3. Налаштуйте параметри для отримання запису (див. інструкцію "Як використати дію custom_modules__get").

Приклад використання

Сценарій каскадного пошуку:

1. Блок пошуку → module_name: "textile", field: "collection" → користувач обирає колекцію
2. Блок пошуку → module_name: "textile", field: "color" → користувач обирає колір (враховується вибрана колекція)
3. Блок "Дія" з custom_modules__get → отримує повний запис з усіма полями

Що відбувається після

Після вибору значень у блоках пошуку вибрані значення зберігаються в константи користувача. Після використання custom_modules__get повний запис стає доступним для використання в наступних блоках сценарію.

Як переконатися, що все вдалось

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

Пов'язані матеріали

• Використати дію custom_modules__get
• Використати дію custom_modules__set
• Створити модель