Evaluate
Evaluate — це блок для виконання виразів (Expression) та обчислень у флоу з подальшим збереженням результату. Використовується для математичних операцій, логіки, перевірок та трансформації даних.
Навігація
- Налаштування блоку
- Робота з виразами та збереження результату
- Приклади використання
HTTP Request + Evaluate
Evaluate + IF
Evaluate + Object Builder - FAQ
Налаштування блоку
─────────────────────────────────────────────────────────────-
Expression: основне поле для введення формули або логічного виразу. Працює виключно в режимі EXP.
Default value (if expression is null): значення, яке буде використане, якщо результат обчислення виявиться порожнім (null).
Save Result To: поле для збереження результату виконання Evaluate у Глобальну змінну. Працює виключно в режимі EXP.
Робота з виразами та збереження результату
─────────────────────────────────────────────────────────────-
1 -> режим EXP: Поля Expression та Save Result To не мають перемикача TXT/EXP, оскільки вони за замовчуванням обробляють вміст як вираз.
2 -> виклик зовнішньої функції: функція, що приймає аргументи та застосовується до переданих даних (наприклад, для обробки, перетворення або форматування).
3 -> змінні: динамічні значення, які можна підставляти у вирази та передавати як аргументи функціям.
4 -> синтаксичні оператори: можуть використовуватися різні оператори (не лише ділення) для побудови виразів, об’єднання частин, передачі значень або виконання інших операцій залежно від логіки виразу.
5 -> модифікатор-функція: спеціальний елемент, який застосовується до змінних або результатів виразів і дозволяє обробляти дані «на льоту», змінюючи або доповнюючи їхню поведінку без попереднього збереження значення.
6 -> формат збереження результату: для збереження значення використовуйте формат {{VARS}}['key_name'].
{{VARS}} - це обрана Глобальна змінна. Не додавайте фігурні дужки вручну.
['key_name'] - ключ змінної.
!!! Важливо !!!
Область видимості
Результат Evaluate доступний глобально, якщо збережений у VARS, і може бути використаний у наступних блоках. Але ви можете не вказувати поле Save Result To, результат буде доступний як результат виконання (Result) в наступних блоках.
Поведінка блоку: Evaluate не змінює вхідні дані, а лише повертає обчислений результат.
Приклади використання
─────────────────────────────────────────────────────────────-
- HTTP Request + Evaluate
Використовується для обчислення або трансформація даних з відповіді API (наприклад: сума, різниця, перевірка значення, перезбереження значень в іншу змінну)
Якщо API повертає дані в різних полях (наприклад, успіх у Body.data, а помилку в Body.error), Evaluate дозволяє перезберегти їх в одну змінну для приведення структури до єдиного формату.
- Evaluate + IF
Використовується для створення складної умови на основі обчисленого результату. Evaluate розраховує значення, після чого блок IF визначає подальший напрям виконання флоу.
Вданому прикладі в Evaluate робимо обчислення і зберігаємо у змінну, далі цю змінну використовуємо в IF для порівняння та визначення подальшої логіки виконання.
- Evaluate + Object Builder
Використовується для попередньої підготовки значень перед формуванням або редагуванням обʼєкта.
В даному прикладі Evaluate використовується для збереження значення у змінну, яку потім редагуємо і додаємо в неї інші дані.
FAQ
─────────────────────────────────────────────────────────────-
1. У якому режимі працює Evaluate?
Блок Evaluate працює виключно в режимі EXP.
2. Що відбудеться, якщо Expression поверне null?
Якщо заповнене поле Default value (if expression is null) — буде використане воно. Якщо ні — результат залишиться null.
3. Де можна додати блок Evaluate?
Блок доступний у таких Flow:
Input, Main Action, Output, Account Validation, Request Error, Custom
4. Чи обов'язково заповнювати Save Result To?
Ні. Якщо поле порожнє, результат буде доступний як Execution Result для наступного кроку.