Declare Variable

Declare Variable — це інструмент для створення (ініціалізації) нових змінних усередині вашого флоу. Він дозволяє зарезервувати ім'я для даних, які ви плануєте використовувати, обчислювати або накопичувати в наступних кроках. Це «фундамент» для зберігання проміжних результатів, числових лічильників або текстових значень.  

Навігація

1. Налаштування блоку.
2. Режими поля Value: TXT vs EXP.
3. Оголошення порожніх змінних.
4. Практичні сценарії використання.
5. FAQ.
   
   

Налаштування блоку

─────────────────────────────────────────────────────────────-

1 -> Name: Назва вашої змінної. За цим ім'ям ви можете звертатися до неї в наступних блоках як динамічне значення.

2 -> Value: Початкове значення, яке буде присвоєне змінній на момент виконання блоку. Тут можна вказати статичний текст, число, іншу змінну або результат виразу (підтримує перемикання режимів TXT / EXP). Також ви можете залишити її порожню.

Режими поля Value: TXT vs EXP

─────────────────────────────────────────────────────────────-

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

1. TXT (Text Mode) — Текстовий режим

Використовується для статичних значень та простих рядків.

• Особливість: Будь-яке значення (навіть формула або число) буде збережено як String (текст).
• Ризик: Якщо написати функцію TO_NUMBER(100) у режимі TXT, змінна отримає текстове значення "TO_NUMBER(100)". Якщо наступний блок очікує математичне число, розрахунок буде невірний.

2. EXP (Expression Mode) — Режим виразів

Перетворює поле на функціональний редактор, де працюють оператори та функції.
Цей режим використовується, коли значення змінної повинно формуватись динамічно або мати конкретний тип (число, boolean, масив тощо). Режим EXP дозволяє конвертувати типи та обробляти дані «на льоту».

Можливості EXP:

• Математика та Логіка: Обчислення значень та порівняння (>, <, ==, &&).
• Трансформація даних: Зміна регістру, пошук/заміна тексту, форматування дат.
• Робота з типами: Конвертація у числа (TO_NUMBER), булеві значення (TO_BOOL) або масиви.
• Умови: Перевірка на порожнечу (EMPTY()) або існування ключа через (ISSET()).

1 -> Режим поля TXT: значення або змінні будуть оброблені як текст.

2 -> Режим поля EXP: вміст поля буде оброблено як вираз із застосуванням функцій, операторів, модифікаторів.

3 ->  Змінні: динамічні значення, які можна підставляти та передавати як аргументи функціям або як звичайні значення для полів.

4 -> Виклик зовнішньої функції: функція, що приймає аргументи та застосовується до переданих даних (наприклад, для обробки, перетворення або форматування).

5 -> Зовнішні функції та оператори: стають доступними коли режим поля EXP.

6 -> Модифікатор-функція: спеціальний елемент, який застосовується до змінних або результатів виразів і дозволяє обробляти дані «на льоту», змінюючи або доповнюючи їхню поведінку без попереднього збереження значення.

Оголошення порожніх змінних

─────────────────────────────────────────────────────────────-

Ви можете оголосити змінну, заповнивши лише поле Name і залишивши Value порожнім.

• Навіщо це потрібно: Це створює «контейнер», який буде наповнюватися даними пізніше за логікою сценарію (наприклад, усередині циклу Loop або блоку Object Builder).
• Результат: Змінна ініціалізується зі значенням null або порожнім рядком, що дозволяє уникнути помилок у наступних блоках.

Практичні сценарії використання

─────────────────────────────────────────────────────────────-

Створення лічильника: Оголосіть змінну count із початковим значенням 0. Далі у флоу ви зможете додавати до неї значення на кожній ітерації.  

Зберігання проміжних обчислень: Якщо вам потрібно виконати складну математичну операцію через Evaluate, результат зручно зберегти в іменовану змінну для легкого доступу.  

Формування значень для HTTP-запитів
Підготовка параметрів, заголовків або тіла запиту перед виконанням HTTP.  

Підготовка «заглушки» для об'єкта: Оголосіть порожню змінну request_body, щоб пізніше в блоці Object Builder наповнити її властивостями залежно від умов IF.  

FAQ

─────────────────────────────────────────────────────────────-

1. Як звернутися до оголошеної змінної далі по флоу?
Ви знайдете створену змінну у списку глобальних Globals змінних (VARS) під тим іменем, яке вказали в полі Name.

2. Чи можна змінити значення змінної пізніше?
Так. Блок Declare Variable лише створює (ініціалізує) її. Для зміни вмісту використовуйте блоки Object Builder або Evaluate.

3. Чи підтримує поле Name динамічні назви?
Ні, поле Name має містити статичну назву ключа для стабільної роботи посилань у наступних блоках.

4. Що буде, якщо я залишу Value порожнім?
Змінна буде створена із порожнім значенням. Це корисно для перевірок ISSET() або подальшого наповнення даними.