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

В этой статье

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

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

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

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

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

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

Заметка

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Заметка

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Предупреждение

При продлении хранения новый срок заменяет оставшиеся дни, а не добавляется к ним.