Як створити й підтримувати дію в ActionJail (Адміністратор)

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

Коли стане в пригоді

  • Треба додати бізнес-правило або інтеграцію без зміни основного коду.
  • Потрібно оновити логіку існуючої дії після зміни процесу.
  • Є типова дія, яку швидше скопіювати та адаптувати.

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

  • Action — JS-скрипт із власним системним ID (action_*), конфігурацією та UI-схемою для параметрів.
  • Майстер дії — 5 кроків: Інформація → Код → JSON-конфіг → UI схема → Документація.
  • Системний ID — не змінюється після створення; використовується в сценаріях.

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

  • Ви маєте роль з доступом до Apps → ActionJail.
  • Під рукою опис логіки дії та потрібні параметри.
  • Визначено, хто використовуватиме дію у сценаріях (для назви й опису).

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

  1. Відкрийте Apps → ActionJail і натисніть Додати нову дію — відкриється майстер.
  2. Інформація про дію: вкажіть відображуване ім’я, перевірте системний ID (action_*), додайте короткий опис призначення.
  3. Код: вставте або напишіть JS-логіку; за потреби використайте AI-генерацію для чернетки.
  4. JSON-конфіг: задайте параметри запуску (ключі, дефолтні значення), щоб сценарії могли передавати дані.
  5. UI схема: додайте поля вводу (назва, тип, обов’язковість, підказка, дефолт); це бачать користувачі сценарію.
  6. Документація: коротко опишіть, що робить дія, які параметри очікує та приклад запуску.
  7. Натисніть Завершити — дія з’явиться у списку. Для правок відкрийте дію зі списку, змініть поля і натисніть Зберегти.
  8. Щоб клонувати, оберіть дію → Зробити копію — перевірте новий системний ID і збережіть.
  9. Щоб видалити, оберіть дію → Видалити дію → підтвердьте.

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

  • Нова або оновлена дія доступна у списку та може використовуватись у сценаріях.
  • Клон створюється з новим системним ID, оригінал не змінюється.

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

  • Дія відображається у бібліотеці та відкривається без помилок.
  • Системний ID унікальний і не змінюється під час редагування.
  • Поля UI-схеми видно в формі параметрів дії у сценарії.

Інші способи

  • Клонування замість створення з нуля — швидше для подібних дій.
  • AI-генерація коду/конфіга/документації — для чернеток, але перевіряйте вручну.

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