Редактирование скрипта

В профиле скрипта во вкладке Схема можно включить скрипт или перейти в режим редактирования. Чтобы включить скрипт, нажмите Активировать. Чтобы перейти к редактированию скрипта, нажмите Изменить.

Во вкладке Журнал можно посмотреть выполнения данного скрипта. Журнал в профиле скрипта аналогичен разделу «Журнал выполнения» за исключением фильтрации, поля поиска, колонок «Пространство» и «Скрипт».

Во вкладке Версии можно посмотреть номер версии скрипта, дату публикации, оставить комментарий и продлить хранение. Максимальный срок хранения – 30 дней.

Версию можно открыть 2 способами:

• кликнуть на версию;
• кликнуть на многоточие и выбрать Посмотреть.

Чтобы восстановить версию, нажмите на соответствующую кнопку в её профиле.

Во вкладке Основное можно изменить название скрипта и его описание. Также в этой вкладке отображаются пространство, в котором скрипт создан и его состояние, если скрипт запускался: активирован или отключен.

Чтобы перейти к редактированию скрипта, откройте его и нажмите Изменить.

Добавление блоков

При создании скрипта на холсте автоматически появляется два блока:

• выберите триггер (настройте расписание запуска скрипта через планировщик или настройте трекер или вебхук, чтобы запускать скрипт, когда приходят новые события);
• выберите действие (первый блок, в котором укажите подключение и действие).

На холст можно добавлять и другие блоки. Сделать это можно двумя способами:

1. Через знак + внизу существующего блока;
2. Нажать правой кнопкой мыши на линию связи и выбрать Добавить блок.

Добавление блоков состоит из двух уровней. На первом уровне отображается список доступных пакетов (системные и пользовательские) в алфавитном порядке и делится на «Рекомендованные» и «Все приложения». На втором уровне необходимо выбрать тип блока:

• SQL-запрос (Пространство, базы данных);
• добавить строку (Пространство, базы данных);
• обновить строки (Пространство, базы данных);
• отправить письмо (Почта);
• HTTP-запрос (HTTP);
• получить журнал работ задачи (Jira Software);
• найти задачи (Jira Software);
• получить журнал изменений (Jira Software);
• прочитать данные из CSV (Файл).

У каждого блока есть свои параметры. Они отображаются на левой панели:

1. У SQL-запроса обязательными параметрами являются запрос и подключение (при обращении к БД). Подробнее примеры SQL-запросов, использующихся в системе, можно посмотреть на странице Типовые SQL-запросы.
2. Обязательные параметры в Добавить строку:
   • подключение (при обращении к БД);
   • таблица;
   • колонки (название, значение).
   Через редактор таблиц на левой панели вы можете изменять, добавлять и удалять колонки. Изменения влияют на таблицы в пространстве. Также можно:
   • создать новую талицу;
   • создать таблицу из выходных данных. При выборе этого параметра отметьте колонки, которые должны войти в таблицу, укажите название таблицы, при необходимости партиционирование и сортировку.
3. Обязательные параметры в Обновить строки:
   • подключение (при обращении к БД);
   • таблица;
   • колонка-ключ (указывается колонка, по которой будут сравниваться значения);
   • значение ключа (указывается значение колонки-ключа);
   • новые значения колонок.
   Колонка-ключ и значение ключа помогают найти строки, которые нужно обновить. Если нужная строка не была найдена, но вы хотите добавить ее в таблицу, активируйте переключатель Добавить ненайденные строки.
4. Отправить письмо:
   • подключение (выбор существующего подключения или добавление нового);
   • адрес получателя;
   • тема письма;
   • сообщение (выберите формат: Текст или HTML);
   • вложение;
   • копия;
   • скрытая копия.
   
5. HTTP-запрос:
   • подключение (выбор существующего подключения или добавление нового);
   • url;
   • метод (GET, POST);
   • заголовок (ключ и значение);
   • тело запроса (при методе POST);
   • пакетная обработка (при методе POST, позволяет ускоренно отправлять данные).
   
6. Получить журнал работ задачи:
   • подключение (выбор существующего подключения или добавление нового);
   • JQL-запрос (Jira Query Language).
   
7. Найти задачи:
   • подключение (выбор существующего подключения или добавление нового);
   • JQL-запрос (Jira Query Language).
   
8. Получить журнал изменений:
   • подключение (выбор существующего подключения или добавление нового);
   • JQL-запрос (Jira Query Language).
   
9. Прочитать данные из CSV:
   • путь к файлу;
   • разделитель (запятая, точка с запятой).
   Важно: при работе с этим блоком все типы данных читаются как String.
10. Выбрать строки через SQL:
    • SQL-запрос (инструкции выбора SELECT);
    • Limit;
    • Offset;
    • Order by.
    
11. SQL-запрос:
    • SQL-запрос (инструкции DML и DDL).
    
12. Получить схему таблицы:
    • Таблица (выбор из списка таблиц, которые хранятся в базе данных).
    

Визуальный маппинг

Каждый блок предоставляет доступ к некоторым полям и может обращаться к полям предшествующих блоков. Эта информация отображается через визуальный маппинг. Чтобы визуальный маппинг отразился на левой панели, необходимо запустить предыдущий блок.

На этой панели вы можете редактировать поля, к которым обращается блок.

Подробная информация представлена на странице Визуальный маппинг.

Добавление и удаление связей между блоками

Порядок выполнения скрипта определяется через создание соединений между блоками.

Чтобы добавить связь, нажмите на блок, выберите точку входа или выхода и протяните связь к нужному действию.

Если перетащить блок поверх другого, между ними также построится связь.

Примечания:

1. У блока может быть несколько выходов и один вход.
2. У блока обязательно должна быть хотя бы одна связь.

Чтобы удалить связь, нажмите по ней правой кнопкой мыши и выберите соответствующее действие.

Действия с блоками

На левой панели расположено меню настроек блока. Здесь вы можете:

1. Переименовать блок;
2. Изменить настройки блока;
3. Просмотреть выходные данные блока и запустить блок.

Важно:

• Если колонки таблицы названы одинаково до точки (пример: col.id, col.employee), в выходных данных в скрипте эти колонки отобразятся как вложенные (col: id, employee).

Дополнительные действия с блоками

При нажатии правой кнопкой мыши по блоку открывается список дополнительных действий с блоками:

• добавить действие;
• дублировать;
• заменить;
• вырезать;
• копировать;
• вставить;
• удалить.

Увеличить/уменьшить масштаб холста с блоками можно с помощью колёсика мыши или кнопок подогнать размер, +, - в правом нижнем углу.

Когда скрипт готов, его можно проверить, а затем опубликовать.

Горячие клавиши и сочетания

В режиме редактирования скрипта можно использовать горячие клавиши и сочетания:

• Ctrl+(+) и Ctrl+(-) – увеличение и уменьшение масштаба холста;
• Shift+Delete – удаление активного блока;
• Shift и ЛКМ – выделение нескольких блоков.