Як створити перший скрипт в Afina#

У цьому гайді ви створите перший скрипт в Afina, відкриєте візуальний конструктор, додасте базові блоки та перевірите виконання через логи. Розділ «Скрипти» також дозволяє призначати гарячі клавіші, додавати скрипти в обране, групувати їх через теги та фільтри й запускати готову логіку на вибраному акаунті.

Перш ніж почати#

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

Створення скрипта#

1. Перейдіть у розділ Автоматизація.

2. Відкрийте вкладку «Скрипти».

3. Натисніть Створити скрипт.

4. У полі «Назва» введіть назву скрипта, наприклад test script. Назва обов'язкова і має містити від 3 до 25 символів.

5. Увімкніть чекбокс «Закривати вкладки», якщо після завершення сценарію потрібно автоматично закривати вкладки.

6. Увімкніть чекбокс «Закривати браузер», якщо після завершення сценарію потрібно автоматично закривати браузер.

7. У блоці режиму запуску виберіть «Звичайний режим», якщо створюєте перший тестовий скрипт.

8. У полі «Теги» додайте теги, якщо хочете згрупувати скрипт для подальшої фільтрації.

9. У полі «Додаткові аргументи запуску» введіть параметри лише за потреби. Це поле використовується для Chromium-аргументів, тому не додавайте туди випадкові значення.

10. Натисніть Створити.

На скріншоті нижче показано сторінку «Скрипти» з кнопкою створення та вікно «Додавання скрипта» з базовими полями.

Режими запуску

«Звичайний режим» використовуйте тоді, коли потрібно бачити браузер і візуально контролювати дії скрипта.

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

«Без браузера» використовуйте лише для сценаріїв, де не потрібна візуальна взаємодія з браузером. Такий режим підходить для обробки даних, обчислень або окремих on-chain дій без відкриття вікна браузера.

Гарячі клавіші та обране#

1. Знайдіть створений скрипт у таблиці.

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

На скріншоті нижче показано, де саме знаходиться іконка прив'язки клавіш у списку скриптів.

3. У вікні «Тестування зв'язування клавіш» натисніть потрібну комбінацію клавіш.

4. Натисніть Зберегти.

На наступному скріншоті показано вікно прив'язки клавіш із вибраною комбінацією та кнопкою збереження.

Гаряча клавіша потрібна для швидкого ручного запуску скрипта на вже відкритому акаунті без повернення в список скриптів.

5. Натисніть іконку додавання до обраного в рядку скрипта, якщо хочете швидко знаходити його через фільтри або запускати в інших робочих сценаріях.

На цьому скріншоті показано іконку додавання скрипта в обране.

6. Натисніть Фільтри і увімкніть чекбокс «Показати тільки обрані», якщо хочете швидко знайти додані в обране скрипти.

Відкриття конструктора#

1. Натисніть іконку відкриття візуального конструктора у рядку потрібного скрипта.

На скріншоті нижче показано іконку відкриття конструктора в списку скриптів.

2. Переконайтеся, що відкрився візуальний конструктор із панеллю компонентів ліворуч, полотном по центру та нижньою панеллю запуску.

На наступному скріншоті показано основні зони конструктора, з якими ви працюватимете далі.

Початківцю важливо спочатку зрозуміти саме ці чотири зони, а вже потім переходити до складної логіки.

Основні кнопки конструктора#

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

2. Знайдіть кнопку Швидкі команди, якщо потрібно подивитися доступні гарячі клавіші конструктора.

3. Знайдіть кнопку шестерні, якщо потрібно додати параметри Input, Select або Checkbox.

4. Натисніть Зберегти скрипт після змін на полотні.

5. Натискайте Оновити всі дані лише після збереження, якщо потрібно перезавантажити скрипт із бази.

На скріншоті нижче показано верхню праву панель конструктора зі службовими кнопками, збереженням і оновленням.

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

Швидкі команди конструктора#

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

• Ctrl (Command) + S - зберегти скрипт.
• Ctrl (Command) + F - знайти елемент.
• Ctrl (Command) + A - виділити всі компоненти на робочій області.
• Ctrl (Command) + Z - скасувати дію.
• Ctrl (Command) + Y - повторити дію.
• Ctrl (Command) + C - копіювати.
• Ctrl (Command) + V - вставити.
• Ctrl (Command) + B - вирівняти вибрані компоненти вертикально.
• Ctrl (Command) + H - вирівняти вибрані компоненти горизонтально.
• Ctrl (Command) + D - рівномірно розподілити вибрані компоненти по горизонталі та встановити однакову відстань між ними.
• Ctrl (Command) + E - рівномірно розподілити вибрані компоненти по вертикалі та встановити однаковий відступ між ними.

Кілька компонентів можна виділити рамкою мишею або додавати їх до виділення по одному, утримуючи Shift і натискаючи на потрібні блоки.

Додавання блоків#

1. На панелі компонентів знайдіть потрібний блок.

2. Перетягніть блок на полотно.

3. Перетягніть ще один блок на полотно, якщо хочете створити простий ланцюжок дій.

4. З'єднайте вихід першого блока з наступним блоком.

5. Натисніть клавішу Delete, якщо потрібно видалити зайвий блок.

На скріншоті нижче показано простий ланцюжок із кількох з'єднаних блоків на полотні конструктора.

6. Наведіть курсор на компонент у панелі компонентів.

7. Натисніть іконку серця, якщо хочете додати блок у обране для швидкого повторного використання.

На цьому скріншоті показано, як додати блок у обране на лівій панелі компонентів.

8. Увімкніть перемикач «Автоматичне підключення» на нижній панелі, якщо хочете швидше будувати прості послідовні схеми.

На наступному скріншоті показано нижню панель конструктора з увімкненням «Автоматичне підключення».

Параметри запуску скрипта#

1. Натисніть іконку шестерні у верхній частині конструктора.

2. Натисніть Input, якщо хочете додати текстовий параметр для ручного введення значення перед запуском.

3. Натисніть Select, якщо хочете додати список із наперед визначеними варіантами.

4. Натисніть Checkbox, якщо хочете додати параметр зі станами 1 або 0.

5. У полі назви параметра введіть назву змінної.

6. У полі значення за замовчуванням введіть стартове значення, якщо воно потрібне.

7. Перетягніть параметри мишею, якщо потрібно змінити їхній порядок у формі запуску.

8. Натисніть Зберегти.

На скріншоті нижче показано вікно «Налаштування» з додаванням параметрів Input, Select і Checkbox.

Як працюють Input, Select і Checkbox Input використовуйте, коли перед запуском потрібно вручну передати довільне значення в скрипт: посилання, число, текст або інший параметр. Ліворуч задається назва змінної, праворуч можна вказати значення за замовчуванням.

Приклади для Input:

• chatUrl -> https://afina.io/
• messageText -> Hello
• messagesCount -> 10

Select використовуйте, коли потрібно заздалегідь дати користувачу кілька варіантів на вибір. У такому параметрі ви задаєте назву змінної, список можливих значень і одне значення за замовчуванням.

У параметрі Select зліва зверху задається назва змінної, справа вибирається значення за замовчуванням, а всередині формується список доступних опцій.

Приклади для Select:

• mode = fixed / random
• network = Arbitrum / Base

Checkbox використовуйте для простого перемикача зі станами увімкнено або вимкнено. Якщо параметр активний, скрипт отримає значення 1, якщо вимкнений - 0.

Приклади для Checkbox:

• useRandom = 1/0
• debugLogs = 1/0

Такі параметри потрібні тоді, коли скрипт має запускатися з різними значеннями без редагування самої схеми.

Тестування скрипта#

1. Увімкніть перемикач «Покроковий режим» на нижній панелі, якщо хочете бачити поетапне виконання скрипта.

2. Увімкніть перемикач «Автопрокрутка», якщо хочете, щоб полотно автоматично переходило до активного блока під час запуску.

3. Увімкніть перемикач «Фоновий (headless) режим» лише тоді, коли сценарій не потребує видимого вікна браузера.

4. Увімкніть перемикач «Режим без браузера» лише для сценаріїв, які не взаємодіють із браузером.

5. Увімкніть перемикач «Режим розробника» лише за потреби, якщо потрібно запускати скрипт без перевірки підпису модулів і скриптів. Зазвичай він потрібен під час активного редагування власного JS-модуля, коли ви ще не хочете перепідписувати його після кожної зміни.

На скріншоті нижче показано нижню панель конструктора з режимами тестування, кнопкою запуску та вибором акаунта.

Корисні режими тестування У нижній панелі також корисно враховувати, що «Автоматичне підключення» прискорює збірку ланцюжків між блоками, «Фоновий (headless) режим» запускає сценарій без видимого вікна браузера, а «Режим без браузера» підходить лише для логіки без браузерної взаємодії.

Для першої перевірки найзручніше ввімкнути «Покроковий режим» і «Автопрокрутка». Так легше зрозуміти, на якому саме блоці виконується скрипт.

6. Відкрийте список акаунтів у нижньому правому куті конструктора.

7. Виберіть акаунт, на якому потрібно запустити скрипт.

8. Натисніть Запустити скрипт для цього акаунта.

На цьому скріншоті показано нижню праву частину конструктора з вибором акаунта, кнопкою запуску та кнопкою Логи.

Ліміти та типові помилки запуску#

• Максимальний час виконання скрипта в одному циклі - 1440 хвилин, тобто 24 години. Після перевищення цього ліміту процес буде примусово перервано.
• Якщо у блоках дій є червоні гілки помилки, підключайте їх до наступної логіки обробки. Інакше при збої, таймауті або відсутності елемента скрипт може зупинитися або піти хибним шляхом.
• Якщо після ручного редагування файлів модуля з'являється помилка підпису, перепідпишіть модуль або тимчасово використайте Режим розробника для тестування.

Змінні та логи#

1. Відкрийте панель «Змінні середовища», якщо потрібно перевірити, які значення реально потрапили в запуск.

2. Перегляньте список змінних у панелі.

3. Натисніть кнопку показу значення, якщо потрібно тимчасово відкрити приховані дані.

4. Натисніть кнопку копіювання, якщо потрібно скопіювати значення змінної.

На скріншоті нижче показано панель «Змінні середовища» зі списком значень, які використовуються під час виконання скрипта.

Панель «Змінні середовища» корисна тоді, коли скрипт працює не так, як ви очікували, і потрібно перевірити, які значення реально потрапили у виконання.

5. Натисніть Логи після запуску скрипта.

6. Натисніть Оновити, якщо потрібно підтягнути нові записи.

7. Натисніть Завантажити більше, якщо потрібно переглянути старіші записи.

8. Натисніть Відкрити файл логів, якщо потрібно відкрити повний лог окремо.

На наступному скріншоті показано вікно «Перегляд логу» зі списком записів виконання скрипта.

Для чого потрібні логи Через логи зручно перевіряти, до якого саме блока дійшов скрипт, і знаходити місце, де сталася помилка або зупинка виконання.

Організація схеми#

1. Розміщуйте пов'язані блоки поруч, щоб логіку було простіше читати.

2. Використовуйте палітру кольорів у конструкторі, якщо хочете візуально розділяти частини великої схеми.

3. Не розтягуйте полотно без потреби, якщо один сценарій можна зібрати компактніше.

4. Натискайте Зберегти скрипт після кожної серії змін.

5. Додавайте повторювані блоки в обране, якщо часто використовуєте їх у різних сценаріях.

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

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

Видалення скрипта#

1. Знайдіть потрібний скрипт у таблиці.

2. Натисніть іконку меню дій у рядку скрипта.

3. Виберіть Видалити скрипт.

4. Натисніть Підтвердити.

На скріншоті нижче показано меню дій скрипта з пунктом Видалити скрипт.

Після цього скрипт буде переміщено в кошик скриптів.

5. Натисніть Фільтри.

6. Увімкніть чекбокс «Показати тільки видалені», якщо хочете відкрити кошик скриптів.

На наступному скріншоті показано сторінку «Скрипти» з відкритими фільтрами та увімкненим показом видалених елементів.

7. Знайдіть потрібний скрипт у списку видалених елементів.

8. Натисніть іконку меню дій біля цього скрипта.

9. Виберіть Видалити без відновлення.

10. Натисніть Підтвердити.

Після цього скрипт буде видалено остаточно.

Якщо видалити папку зі скриптами, самі скрипти не видаляються. Вони залишаються в системі та повертаються до загального списку без цієї папки.

Оновлення хеша скрипта#

Дія «Оновити хеш» створює новий ідентифікатор версії скрипта. Використовуйте її обережно, особливо якщо цей скрипт уже підключений до інших сценаріїв.

Експорт і імпорт скриптів#

1. Перейдіть у розділ Автоматизація.

2. Відкрийте вкладку «Скрипти».

3. Позначте чекбоксами один або кілька скриптів, які потрібно зберегти або передати.

4. Натисніть Експорт.

5. Виберіть потрібний варіант експорту.

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

6. Натисніть Імпорт, якщо хочете завантажити скрипт назад у Afina.

7. Виберіть джерело імпорту.

8. Виберіть скрипт на вашому ПК або зі списку, якщо це імпорт з Google Drive.

9. Натисніть Імпортувати після вибору потрібного скрипта або архіву.

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

Результат#

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