Документация
Команды
Команды — это шаги сценария. Каждая команда принимает данные, обрабатывает и передаёт дальше.
Получение данных
Записи → Получить (Rows → Get)
Возвращает список записей из таблицы.
На выход: Список записей
Пример: Получить все заказы из таблицы «Заказы».
Записи → Найти (Rows → Find)
Применяет фильтр к списку записей.
На вход: Список записей
На выход: Список записей
Пример: Найти все заказы, где статус = «Новый».
Записи → Сортировать (Rows → Sort)
Сортирует список записей по заданным правилам.
На вход: Список записей
На выход: Список записей
Пример: Отсортировать товары по цене — от дорогих к дешёвым.
Записи → Срез (Rows → Slice)
Вырезает часть списка записей. Параметры могут быть выражениями с переменными.
На вход: Список записей
На выход: Список записей
Пример: Взять только первые 10 записей из списка.
Выборка таблицы → Получить (Table selection → Get)
Получает список с одной записью, которая выделена в таблице. Если сценарий выполняется в редакторе — берётся первая запись. Если запущен из таблицы без выбора — ошибка.
На выход: Список записей
Пример: Получить выбранную запись товара для обработки в сценарии.
Изменение данных
Записи → Добавить (Rows → Add)
Создаёт запись в таблице. Возвращает список с одной созданной записью.
На выход: Список записей
Пример: Создать новую запись в таблице «Продажи» с текущей датой и товаром.
Поддерживаются формулы: Days = <Days (ms)> * 30
Записи → Обновить (Rows → Update)
Обновляет записи, пришедшие на вход.
На вход: Список записей
На выход: Список записей
Пример: Обновить поле «Дата доставки» у найденных заказов.
При выполнении внутри циклов (Rows → For each) может замедлить сценарий.
Записи → Удалить (Rows → Delete)
Удаляет записи из таблицы.
На вход: Список записей
Пример: Удалить все записи со статусом «Архив».
Таблица → Запросить коммит (Table → Request commit)
Запрашивает сохранение данных в указанной таблице.
Изменения сохранятся только после подтверждения пользователем.
Таблица → Запросить коммит всего (Table → Request commit all)
Запрашивает сохранение во всех изменённых таблицах.
Изменения сохранятся только после подтверждения пользователем.
Переменные
Записать (Set)
Сохраняет данные в переменную. Можно переопределить тип.
На вход: Любой тип данных
На выход: Входной тип или Указанный тип
Пример: Сохранить список товаров в переменную all_products для использования позже.
Получить (Get)
Выводит значение из переменной.
На выход: Сохранённый тип данных
Пример: Получить значение переменной total_sum для отображения.
Переменные → Математика (Vars → Math)
Выполняет математическое выражение с переменными.
На выход: Число
Пример: Посчитать price * quantity и сохранить результат.
Записи → Значение → Получить (Rows → Value → Get)
Достаёт значение из первой записи в списке.
На вход: Список записей
На выход: Тип данных колонки
Пример: Получить значение колонки «Имя» из первой записи списка клиентов.
Записи → Значения → Записать переменные (Rows → Values → Set vars)
Достаёт первую запись и записывает значения колонок в переменные.
На вход: Список записей
На выход: Список записей
Пример: Записать значения «Имя» и «Email» в переменные из выбранного клиента.
Вычисления и группировка
Записи → Математика (Rows → Math)
Применяет математическую функцию к списку записей.
На вход: Список записей
На выход: Число
Пример: Посчитать сумму всех заказов за месяц.
Записи → Группировать (Rows → Group)
Группирует записи по колонкам и выполняет агрегацию (сумма, среднее и т.д.).
На вход: Список записей
На выход: Список записей
Пример: Сгруппировать продажи по категориям и посчитать сумму в каждой.
Тип → В число (Type → To Number)
Преобразует входные данные в число, если возможно.
На вход: Любой тип
На выход: Число
Пример: Преобразовать строку «123» в число 123.
Число → Округлить (Number → Round)
Округляет число.
На вход: Число
На выход: Число
Пример: Округлить среднюю цену до 2 знаков после запятой.
Тип → Определить (Type → Define)
Переопределяет тип данных. Не все комбинации работают корректно.
На вход: Любой тип
На выход: Указанный тип
Пример: Преобразовать число в строку для объединения с текстом.
Логика и управление
Когда (When)
Выполняет вложенный сценарий, если условия истинны.
Пример: Если total > 10000, отправить уведомление.
Записи → Для каждой (Rows → For each)
Выполняет вложенный сценарий для каждой записи. На вход подаётся список с текущей записью.
На вход: Список записей
Пример: Для каждого товара в заказе проверить остаток на складе.
Выход (Exit)
Завершает выполнение сценария.
Пример: Остановить сценарий, если обязательное поле пустое.
Функция → Определить (Function → Define)
Определяет функцию для переиспользования. Используйте Type → Expect для ожиданий по входным данным.
Функция → Вызвать (Function → Call)
Вызывает определённую функцию.
На вход: Ожидаемый тип
На выход: Тип последней команды в функции
Пример: Вызвать функцию расчёта скидки.
Сценарий → Использовать (Flow → Use)
Выполняет другой сценарий, передавая контекст и данные. Переменные из вложенного сценария доступны в основном.
На вход: Ожидаемый тип
На выход: Тип последней команды
Пример: Переиспользовать сценарий расчёта налогов.
Условие → Определить (Condition → Define)
Определяет фильтр и сохраняет в переменную для переиспользования.
Пример: Сохранить сложный фильтр «активные клиенты с заказами за последний месяц» в переменную.
JSON
JSON → Записать переменные (JSON → Set vars)
Извлекает значения из JSON по путям (JSPath) и сохраняет в переменные.
На вход: JSON-строка
На выход: Входные данные
Пример: Извлечь data.user.name из ответа API.
JSON → Получить (JSON → Get)
Извлекает значение из JSON по пути (JSPath).
На вход: JSON-строка
На выход: Строка
Пример: Получить items[0].price из JSON-ответа.
JSON → Для каждого значения (JSON → For each)
Выполняет сценарий для каждого элемента массива или пары ключ-значение объекта.
На вход: JSON-строка
Пример: Обработать каждый товар в JSON-массиве из внешнего API.
JSON → Обновить (JSON → Update)
Обновляет значения в JSON по путям.
На вход: JSON-строка
На выход: JSON-строка
Пример: Заменить значение status на «processed» в JSON.
Вспомогательные
Передать пред. (Print prev)
Возвращает входные данные без изменений.
Пример: Пробросить данные через промежуточный шаг без изменений.
Сообщение (Message)
Выводит сообщение после выполнения сценария. Можно использовать переменные.
Пример: Вывести «Обработано {{count}} записей».
Комментарий (Comment)
Добавляет визуальный блок с текстом в редакторе.
На вход: Любые данные
На выход: Входные данные
Пример: Добавить комментарий «Блок фильтрации» для навигации в сценарии.
Вывод текста (Text output)
Выводит указанный текст.
На выход: Строка
Пример: Сформировать заголовок для отчёта.
Тип → Ожидать (Type → Expect)
Определяет ожидаемый тип входных данных. Возвращает их при совпадении.
На вход: Ожидаемый тип
На выход: Входные данные
Пример: Убедиться, что на вход пришёл список записей.
Контекст токенов → Ожидать (Tokens context → Expect)
Определяет ожидаемый контекст: набор переменных и функций. Полезно для вложенных сценариев.
Внешние запросы
Сетевой запрос (Fetch Request)
Выполняет запрос на внешний ресурс и записывает результат в переменные.
На вход: Любые данные
На выход: Входные данные
Пример: Получить курсы валют из внешнего API. Подробнее →
📌 Следующий шаг: Сценарии →
📌 Также может быть полезно: HTTP запросы | JSPATH