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

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

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

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

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

Во вкладке редактирования вы можете:

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

Чтобы переименовать скрипт в режиме редактирования:

1. Кликните по значку с тремя точками и нажмите Переименовать скрипт.
2. В открывшемся окне введите новое имя скрипта.
3. Нажмите Сохранить.

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

При создании скрипта на холсте автоматически появляется блок «Выберите триггер» (настройте расписание запуска скрипта через планировщик или настройте трекер либо вебхук, чтобы запускать скрипт, когда приходят новые события. Также можно выбрать ручной запуск).

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

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

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

• SQL-запрос (Пространство, базы данных)
• добавить строки (Пространство, базы данных)
• обновить строки (Пространство, базы данных)
• отправить письмо (Почта)
• HTTP-запрос (HTTP)
• выполнить код (JavaScript)
• получить журнал работ задачи (Jira Software)
• найти задачи (Jira Software)
• получить журнал изменений (Jira Software)
• выбрать строки через SQL-запрос (Пространство, базы данных)
• получить схему таблицы (Пространство, базы данных)
• ожидать обработку данных (Синхронизатор)
• получить системную таблицу (Системные таблицы)
• вернуть данные (Другие скрипты)
• получить календари (Microsoft Exchange)
• получить события календаря (Microsoft Exchange)
• скачать содержимое файла (FTP, SFTP, SMB)
• получить список файлов (FTP, SFTP, SMB)
• удалить файл (FTP, SFTP, SMB)
• загрузить в каталог (FTP, SFTP, SMB)
• получить CSV (FTP, SFTP, SMB)
• сформировать CSV (Файл)
• архивировать (Файл)
• распаковать (Файл)

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

Поддерживаемые типы данных

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

Система позволяет работать с такими типами данных, как:

• строка (String)
• число (Integer)
• дробное число (Decimal)
• логический тип (Boolean type)
• дата и время (Date and Time)
• UUID
• массив строк (String array)
• массив чисел (Integer array)
• массив дробных чисел (Decimal array)
• логический массив (Boolean array)
• массив дат и времени (Date and Time array)

Система может читать, записывать и, в определенных случаях, конвертировать различные типы исходных данных из разных СУБД.

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

В настоящий момент конвертация поддерживается для блоков Добавить строки и Обновить строки в рамках подключения ClickHouse, частично для блока Получить CSV, а также для блоков, работающих с JSON.

При использовании блоков Добавить строки и Обновить строки с подключением ClickHouse, входные типы данных могут быть конвертированы в целевые типы колонок ClickHouse, в зависимости от возможностей и ограничений типов в ClickHouse. В блоке «Получить CSV» можно либо самостоятельно задать типы колонок, либо получить их, загрузив пример CSV. При запуске этого блока все данные типа String из файла .csv будут автоматически конвертироваться в указанный тип колонки. При использовании блоков, взаимодействующих с JSON (например, Вебхук, Ручной запуск, Трекер), массивы Json Array могут быть записаны в колонки с различными типами массивов, например, с типом Array(String) в ClickHouse.

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

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

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

Если блоки Разгруппировать массив и HTTP-запрос возвращают родительские объекты в выходных данных, эти объекты также становятся доступными в списке полей визуального маппинга, что позволяет другим блокам автоматизации обращаться к ним.

Подробная работа с визуальным маппингом представлена на странице Редактор SQL-запросов.

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

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

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

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

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

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

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

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

Особенности отображения выходных данных описаны в разделе Известные проблемы и ограничения.

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

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

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

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

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

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

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

• Ctrl+(+) и Ctrl+(-) – увеличение и уменьшение масштаба холста
• Shift+Delete – удаление активного блока
• Shift и ЛКМ – выделение нескольких блоков
• Space — перетаскивание холста зажатием клавиши (на Linux доступно только при использовании TrackPoint)

Версии скрипта

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

В открывшейся панели можно посмотреть номер версии скрипта, дату публикации, оставить комментарий и продлить срок хранения. Для редактирования доступен только черновик текущей версии, в остальных версиях внесение изменений недоступно, но можно скопировать выбранные блоки.

Чтобы открыть нужную версию, кликните по ней.

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

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

• нажать соответствующую кнопку в её профиле
• кликнуть по значку контекстного меню и выбрать Восстановить версию

Текущая версия скрипта хранится бессрочно. Максимальный срок хранения предыдущих версий составляет 30 дней. Вы можете продлить срок хранения выбранной версии, нажав значок контекстного меню и выбрав Продлить хранение.