Секції редактора дій ActionJail

Майстер створення/редагування дії в ActionJail складається з п'яти секцій (акордеонів). Кожна секція відповідає за певний аспект дії та має прямий зв'язок з тим, як дія відображається в Конструкторі сценаріїв.

Редагування коду, JSON і документації

Коли ви відкриваєте секції Код реалізації, JSON конфігурація або Документація, текст редагується в нижній панелі редактора. У верхній частині залишаються назва секції, підказки та кнопки (зокрема AI-генерація). Так зручніше працювати з довгим кодом: прокрутка колесом миші рухає саме текст у редакторі, а не всю сторінку.

На секції Код реалізації у заголовку нижньої панелі (поруч із AI-генерацією) є кнопка Відкрити код на весь екран. Вона відкриває той самий код у великому вікні; зміни одразу відображаються в нижній панелі. На секціях JSON конфігурація та Документація цієї кнопки немає — там текст редагується лише в нижній панелі.

На секціях без текстового редактора — Основна інформація, UI схема та Тестування — нижня панель не показується, і форма займає всю висоту вікна. У майстрі створення нової дії нижня панель з’являється на кроках з кодом, JSON і документацією; на кроках з формами вона прихована.

1. Інформація про дію

Що заповнювати:

• Відображуване ім'я — назва, яку бачать користувачі при виборі дії в сценарії.
• Системний ID — унікальний ідентифікатор (action_*), не змінюється після створення.
• Опис — коротке пояснення призначення дії.
• Група — категорія для групування дій у бібліотеці.

Де видно в Scenario Builder:

• Відображуване ім'я — у списку дій при додаванні блоку Action, у назві обраної дії.
• Група — у фільтрі «Оберіть action групу» у сайдбарі блоку Action.

2. Код реалізації

Що заповнювати:

• JavaScript-функція, яка виконує логіку дії.
• Функція має починатися з action_ і експортуватися через module.exports.
• Використовуйте this.getCurrentNodeParamsJSON() для отримання параметрів з JSON-конфігу.
• Використовуйте this.getCurrentConstJSON() для доступу до констант сценарію.

Де видно в Scenario Builder:

• Код не відображається в UI — він виконується на бекенді при проходженні сценарію через блок Action.

AI-генерація: Кнопка «Швидка генерація» / «Згенерувати код» — генерує чернетку коду за описом. Потрібно налаштований OpenAI-токен для обраного процесу (бота).

Повноекранний режим: доступний лише в цій секції — див. Редагування коду, JSON і документації вище.

3. JSON конфігурація

Що заповнювати:

• Схема параметрів: parameters — масив об'єктів з полями name, type, required, description, defaultValue тощо.
• ui — групування полів для форми (accordion, groups).
• json_example — приклад валідного JSON.
• events_schema — можливі значення return для роутингу.

Де видно в Scenario Builder:

• У блоці Action у режимі Form — кожен параметр з parameters стає полем форми (input, select, textarea тощо).
• Групи з ui.groups відображаються як секції акордеону.
• У режимі JSON — користувач вводить значення напряму в JSON; структура береться з parameters і json_example.

AI-генерація: «Згенерувати з коду» — аналізує код і витягує параметри з getCurrentNodeParamsJSON() у JSON-схему.

4. UI схема

Що заповнювати:

• Ті самі параметри, що й у JSON-конфігу, але у вигляді візуального списку полів.
• Для кожного поля: key, type, label, placeholder, required, description, default, validation, options, dataSource тощо.

Де видно в Scenario Builder:

• UI-схема визначає, як саме відображаються поля в режимі Form:
  • тип поля: текст, число, перемикач (так/ні), список вибору;
  • підпис, підказка в полі, додаткові пояснення;
  • групування (accordion) з ui.groups.

Зв'язок: UI-схема — це представлення json_config.parameters та json_config.ui. Зміни в одному місці синхронізуються з іншим.

5. Документація

Що заповнювати:

• Markdown-текст: опис дії, параметри, приклад використання, значення return.

Де видно в Scenario Builder:

• Документація не відображається безпосередньо в блоці Action.
• Вона використовується в довідниках, підказках та для інтеграторів (Actions Reference).

AI-генерація: «Згенерувати документацію» — створює Markdown за назвою дії, кодом та параметрами.

Зв'язок полів ActionJail → Scenario Builder (Form mode)

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

• Про те, як дані з Action Jail потрапляють у Scenario Builder
• Як створити кастомну дію
• Налаштування AI-генератора
• Actions Reference