Перейти к содержимому

Документация Corta

Как включить и настроить межсистемное взаимодействие (интеграцию данных) в Corta

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

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

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

Как работает межсистемное взаимодействие Corta: основные понятия

Интеграционный узел — это экземпляр Corta с активированной функцией межсистемного взаимодействия.

Узел может:

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

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

Как устанавливается интеграционное соединение между узлами в Corta

Этапы настройки соединения:

  1. Исходный узел (source) регистрирует новый интеграционный узел-получатель (destination).
  2. Исходный узел отправляет приглашение подключаемому узлу.
  3. Подключаемый узел принимает приглашение (через email или другой способ).
  4. Исходный узел подтверждает поступивший от подключаемого узла запрос соединения (handshake).

Запустить процесс соединения можно с любого из узлов.

Как зарегистрировать новый интеграционный узел:

  1. Откройте админ-панель Corta.
  2. В левом меню выберите Межсистемное взаимодействие → Узлы.
  3. Нажмите Добавить узел.
  4. Заполните информацию о подключаемом узле.
  5. Нажмите Сохранить.

Как отправить приглашение другому узлу:

  1. В панели администратора снова выберите Межсистемное взаимодействие → Узлы.
  2. Откройте нужный узел.
  3. Нажмите Сгенерировать ссылку для подключения.
  4. Скопируйте ссылку для вручную отправки или введите e-mail контактного лица интегрируемой системы.

Важно:

Сгенерированная ссылка содержит защищённый токен доступа. Используйте только надёжные каналы передачи.

Как принять приглашение по электронной почте:

  1. Перейдите по кнопке Подключить интеграционный узел.
  2. Вставьте полученную ссылку и подтвердите соединение.

Настройка не завершится, пока приглашение не принято и не подтверждено соединение с обеих сторон.

Как принять приглашение без email:

  1. В админ-панели выберите Межсистемное взаимодействие → Узлы.
  2. Найдите нужный узел, выберите Изменить.
  3. Вставьте полученную ссылку и сохраните.

Как подтвердить запрос соединения между системами:

  1. Откройте Межсистемное взаимодействие → Узлы.
  2. Перейдите в нужный узел, подтвердите запрос (иконка с предупреждением).

Данный шаг всегда выполняется на исходящем сервере Corta, который инициировал интеграцию.

Как синхронизировать данные между интеграционными узлами Corta

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

Модули для обмена данными (shared modules) создаются автоматически и управляются через раздел интеграции Corta.

Такие модули нельзя самостоятельно удалять или редактировать стандартными средствами.

Как предоставить доступ к данным другому узлу в Corta

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

  1. Перейдите в приложение Low-Code.
  2. Откройте администрирование нужного пространства (namespace).
  3. Зайдите во вкладку Модули.
  4. Около нужного модуля нажмите Редактировать.
  5. Перейдите на вкладку Настройки взаимодействия.
  6. Выберите подменю Открыть доступ.
  7. Укажите, для какого подключенного узла нужно открыть модуль.
  8. Выберите необходимые поля для передачи.
  9. Сохраните изменения.

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

Как принимать и использовать данные с другого интеграционного узла в Corta

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

  1. Перейдите в приложение Low-Code.
  2. Откройте администрирование нужного пространства.
  3. Откройте вкладку Модули.
  4. Нажмите Редактировать у нужного модуля.
  5. Перейдите на вкладку Настройки взаимодействия.
  6. Откройте раздел Сопоставление полей.
  7. Укажите, от какого узла будет поступать информация.
  8. Настройте сопоставление полей: определите, какие значения исходного модуля будут соответствовать вашим полям.
  9. Сохраните изменения.


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