Як використати пошук з автодоповненням у 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")
  1. Збережіть зміни в блоці.

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

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

  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 повний запис стає доступним для використання в наступних блоках сценарію.

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

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

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