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

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

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

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

Значение в поле Ключ генерируется автоматически при создании и дублировании скрипта, но его можно изменить: укажите в поле от 1 до 40 любых символов и нажмите Сохранить в верхней панели. Обратите внимание, что значение должно быть уникальным.

Ключ сохраняется при экспорте и импорте скрипта.

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

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

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

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

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

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

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

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

• Планировщик
• Блоки Новые события и Системные события из пакета Трекер
• Новое событие из пакета Вебхук
• Новое событие из пакета Обработка событий
• Ручной запуск

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

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

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

• Установлено — при наличии пользовательских блоков
• Базы данных — для работы с таблицами в пространстве или базах данных
• Хранилища — для работы с файлами
• Сервисы — для работы с календарями, почтой, HTTP-запросами и JS-кодом
• Инструменты — для работы с нейросетью и системными таблицами, а также вспомогательные блоки для составления скриптов

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

Доступные блоки:

• SQL-запрос (Пространство, базы данных)
• Выбрать строки через SQL-запрос (Пространство, базы данных)
• Добавить строки (Пространство, базы данных)
• Обновить строки (Пространство, базы данных)
• Получить схему таблицы (Пространство, базы данных)
• Создать таблицу (Пространство)
• Удалить таблицу (Пространство)
• Переименовать таблицу (Пространство)
• Очистить таблицу (Пространство)
• Получить системную таблицу (Системные таблицы)
• Отправить письмо (Почта, SMTP)
• Отправить запрос (HTTP)
• Выполнить код (JavaScript)
• Выполнить скрипт (Скрипты)
• Вернуть данные (Скрипты)
• Фильтр
• Синхронизатор
• Разгруппировать массив
• Получить календари (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.

При использовании блоков Добавить строки и Обновить строки не поддерживается конвертация типов Decimal (ClickHouse) и Numeric (PostgreSQL). Рекомендуется выполнять предварительную обработку таких данных или использовать совместимые типы.

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

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

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

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

1. Нажмите Выбрать из выходных полей.
2. Выберите блок, выходные данные которого необходимо использовать, и нажмите Добавить.
3. Колонки добавлены. Завершите создание таблицы.

Чтобы автоматически подставить поля маппинга в уже созданную таблицу:

1. Выберите нужную таблицу.
2. Нажмите Автозаполнение полей выходными данными.
3. Выберите поля, которые необходимо подставить в колонки таблицы, и нажмите Применить.
4. Поля маппинга автоматически подставлены в соответствующие колонки.

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

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

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

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

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

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

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

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

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

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

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

• Переименовать блок
• Изменить настройки блока
• Просмотреть выходные данные блока и запустить блок
• Выполнить поиск по выходным данным блока с помощью горячих клавиш Ctrl+F и Enter

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

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

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

• Добавить действие
• Дублировать
• Заменить
• Вырезать
• Копировать
• Вставить
• Удалить

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Перейти из версий скрипта обратно в черновик текущей версии можно 2 способами:

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