Як створити секцію сценарію?

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

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

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

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

  • Секція — логічний блок сценарію, який містить набір нод та має точки входу (Entry Point) та виходу (Exit Point).
  • Стартова секція — секція, з якої починається виконання сценарію при старті бота.
  • Entry Point — нода, яка позначає точку входу в секцію (може бути кілька Entry Point у одній секції).
  • Exit Point — нода, яка позначає точку виходу з секції (може бути кілька Exit Point у одній секції).

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

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

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

1. Відкрити панель секцій

  1. У редакторі сценарію знайдіть панель секцій зверху екрана.
  2. Панель відображає список всіх існуючих секцій сценарію.

2. Створити нову секцію

  1. У панелі секцій натисніть кнопку "Додати секцію" або "Створити секцію" (зазвичай це кнопка з іконкою "+").
  2. У модальному вікні введіть назву секції (наприклад, "Реєстрація користувача").
  3. Опційно додайте опис секції для кращого розуміння її призначення.
  4. Натисніть кнопку "Створити" — нова секція з'явиться у списку секцій.

3. Перейти до нової секції

  1. У списку секцій клацніть на назву нової секції.
  2. Рабочее полотно (canvas) автоматично оновиться та відобразить порожню секцію (або секцію з базовими нодами, якщо вони були створені автоматично).

4. Додати Entry Point (точку входу)

  1. На рабочее полотно (canvas) додайте ноду типу "Entry Point" (Точка входу в секцію).
  2. Ця нода позначає місце, з якого починається виконання секції.
  3. У секції може бути кілька Entry Point для різних точок входу.

5. Додати Exit Point (точку виходу)

  1. На рабочее полотно (canvas) додайте ноду типу "Exit Point" (Точка виходу з секції).
  2. Ця нода позначає місце, де завершується виконання секції.
  3. З'єднайте Exit Point з останньою нодою секції через edge.
  4. У секції може бути кілька Exit Point для різних варіантів завершення.

6. Побудувати логіку секції

  1. Додайте необхідні ноди між Entry Point та Exit Point:
    • Повідомлення для користувача.
    • Клавіатури з кнопками.
    • Очікування вводу даних.
    • Дії та інші елементи логіки.
  2. З'єднайте всі ноди через edges у правильній послідовності.

7. Встановити як стартову секцію (за потреби)

  1. Якщо нова секція повинна бути стартовою (точкою входу в сценарій):
    • У списку секцій знайдіть нову секцію.
    • Натисніть на іконку зірочки або виберіть опцію "Встановити як стартову".
    • Система автоматично встановить цю секцію як стартову.

8. Налаштувати переходи між секціями

  1. Щоб перейти з однієї секції в іншу:
    • У вихідній секції додайте Exit Point та з'єднайте його з останньою нодою.
    • У цільовій секції переконайтеся, що є Entry Point.
    • У налаштуваннях Exit Point виберіть цільову секцію та Entry Point для переходу.
  2. Альтернативно: у налаштуваннях кнопки клавіатури або дії виберіть цільову секцію та Entry Point.

9. Зберегти зміни

  1. Перевірте структуру секції на рабочее полотно (canvas).
  2. Натисніть кнопку "Зберегти" знизу екрана або використайте комбінацію клавіш Ctrl+S (або Cmd+S на Mac).
  3. Система збереже всі зміни у секції.

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

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

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

  • Перевірте, що секція з'явилася у списку секцій зверху екрана.
  • Переконайтеся, що Entry Point та Exit Point додані правильно.
  • Спробуйте перейти до іншої секції та повернутися назад — структура повинна зберегтися.
  • Перевірте переходи між секціями — вони повинні працювати коректно.

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