Система Corta предоставляет удобные и мощные инструменты для автоматизации, которые позволяют реализовывать индивидуальную бизнес-логику. Это помогает расширить функциональность платформы и адаптировать её под конкретные задачи вашего бизнеса.

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

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

Когда автоматизация взаимодействует с системой Corta, она может запускать дополнительные автоматизации.

Например, если автоматизация выполняется перед обновлением записи и вызывает обновление той же записи, это может привести к бесконечному циклу выполнения (см. схему ниже).

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

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

Схема 1. На диаграмме показан пример бесконечного цикла выполнения, где явное обновление возвращается к шагу запроса обновления.

Автоматизация может выполняться синхронно или асинхронно.

При выполнении автоматизации система Corta проверяет права доступа от имени пользователя, вызвавшего автоматизацию.

• Если пользователь имеет доступ к ресурсу, автоматизация также сможет получить доступ к этому ресурсу.

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

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

Система Corta предоставляет два основных инструмента для настройки автоматизации: скрипты автоматизации и рабочие процессы.

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

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

Когда компонент Corta получает запрос на взаимодействие с ресурсом, он может сгенерировать серию событий (обычно два: событие "до" и "после"), которые описывают, что должно произойти, и текущий контекст.

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

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

Автоматизация наследует права доступа инициирующего пользователя (пользователя, вызвавшего выполнение автоматизации). Если рабочий процесс пытается выполнить действия (например, получить доступ к конфиденциальным данным), для которых у инициирующего пользователя недостаточно прав, выполнение завершится с ошибкой.

Инициирующий пользователь может быть переопределён вручную с помощью явной установки контекста безопасности (параметр runAs).

После завершения автоматизации система возвращает результат выполнения. Этот результат может повлиять на исходную операцию.

Краткое описание влияния результата выполнения на исходную операцию:

• Если автоматизация выполняется асинхронно, результат выполнения игнорируется и не влияет на исходную операцию.

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

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

• Если автоматизация завершилась без ошибок и возвращает ненулевое значение, это значение используется для замены исходного значения, если операция это позволяет.

Компоненты Corta отправляют события в шину событий, когда система собирается взаимодействовать с ресурсами компонентов. Это позволяет обнаруживать определённые операции и дополнять стандартный процесс, например:

• Создавать записи в журнале аудита,

• Отправлять приветственные письма при регистрации нового пользователя,

• Отменять операцию, если что-то идёт не так, с помощью генерации ошибок.

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

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

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

Corta позволяет выполнять автоматизацию при получении запроса на определённую конечную точку HTTP API. Это позволяет создавать пользовательские API и вебхуки для интеграции со сторонними сервисами.

Для обработки API-запросов используется событие onRequest для ресурса System Sink. Например, вы можете задать маршрут для обработки запросов POST /system/sink/api/request-demo, чтобы собирать потенциальных клиентов, отправляемых с лендинговой страницы.

Corta позволяет выполнять автоматизацию при получении или отправке email-сообщений системой.

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

Для создания явных триггеров используется событие onManual. Обычно явная автоматизация представлена в виде кнопки в пользовательском интерфейсе Corta, например, внутри автоматизации или на странице списка записей.

Примеры автоматизации:

• Автоматическое заполнение недостающих значений в новой записи,

• Создание записи в журнале аудита при изменении определённых значений записи,

• Отправка email-сообщения при добавлении нового пользователя в систему,

• Ежемесячная отправка отчёта руководству.

1. Чтобы глубже понять порядок выполнения и внутреннюю логику работы, изучите раздел о деталях выполнения.
2. Ознакомьтесь с разделами о рабочих процессах и скриптах автоматизации, чтобы узнать больше о двух системах автоматизации.
3. Для примеров реального использования ознакомьтесь с нашими готовыми приложениями. Вы можете использовать их рабочие процессы как основу для создания собственных решений.