Использование Camel DSL

Camel DSL в Citeck позволяет описывать и выполнять интеграционные маршруты Apache Camel в микросервисе ecos-integrations. Поддерживаются форматы YAML DSL и XML DSL. Компоненты Citeck дополняют стандартные средства Camel работой с Records API, событиями платформы, файлами и внешними системами.

Основная единица настройки — Camel-контекст: он содержит маршруты, бины и параметры их выполнения. Маршрут задаёт источник сообщений или данных, последовательность обработки и целевые конечные точки (endpoint-ы).

Основные сценарии применения:

  • интеграция Citeck с внешними системами через REST, JDBC, RabbitMQ и другие протоколы;

  • миграция и синхронизация данных между базами данных;

  • обработка событий и сообщений через подписки;

  • автоматизация импорта данных из файлов.

Начало работы

  1. Откройте журнал Camel DSL в рабочем пространстве администратора: v2/journals?journalId=ecos-camel-dsl&viewMode=table&ws=admin$workspace.

  2. Создайте или выберите контекст и задайте формат его содержимого — YAML или XML. Укажите тип запуска:

    • MANUALLY — запуск и остановка контекста действиями в журнале;

    • IMPORT_DATA — обработка файла через механизм импорта данных с созданием отдельного инстанса контекста.

  3. Настройте подключения к внешним системам, учётные данные и маршрут. Пример работы с JDBC приведён в разделе Выборка из БД, чтения и записи данных Citeck — в справочнике конечных точек.

  4. Для YAML-маршрута можно открыть просмотрщик Kaoto. По умолчанию схема служит для просмотра и навигации, а изменения вносятся в YAML. Визуальное редактирование схемы включается отдельно настройкой app/integrations$camel-visual-editing-enabled.

  5. Сохраните контекст и запустите его выбранным способом. Для диагностики используйте действия и лог контекста, а для импорта данных — журнал инстансов.

Примечание

Для новых маршрутов записи данных через Records API используйте ecos-records-mutate. Описанный отдельно бин RecordsDaoEndpoint подавляет ошибки сохранения: успешное завершение его шага не гарантирует, что запись сохранена. Это нужно учитывать перед удалением исходных данных или отметкой об успешном импорте.

Справочники и примеры

Раздел включает настройку контекстов, справочники компонентов, конечных точек и процессоров, а также готовые сценарии интеграции. Набор доступных компонентов и параметры зависят от версии и состава поставки. Для встраивания Camel-контекстов в код микросервиса см. ecos-camel-core.

Общая информация

Camel-контексты, маршруты, компоненты Apache Camel и типы запуска в Citeck.

Общая информация
Визуальный просмотрщик маршрутов (Kaoto)

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

Визуальный просмотрщик маршрутов (Kaoto)
Выборка из БД

Настройка Credentials, источника данных и маршрута для выборки из БД через JDBC.

Выборка из БД
Действия, доступные с Camel DSL

Старт, стоп контекста и просмотр лога последней синхронизации.

Действия, доступные с Camel DSL
Инстансы контекста Camel DSL

Отдельные запуски импорта данных с типом IMPORT_DATA, журнал инстансов и их состояния.

Инстансы контекста Camel DSL
Подключение RecordsDaoEndpoint

Настройка бина RecordsDaoEndpoint для обработки XML/CSV/текстовых файлов и ограничения обработки ошибок сохранения.

Подключение RecordsDaoEndpoint
Удаление данных из БД

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

Удаление данных из БД
Получение сообщений из RabbitMQ

Подключение к очереди RabbitMQ и публикация события Citeck.

Получение сообщений из RabbitMQ и отправка события Citeck
Подписка на событие Citeck

Подписка на события Citeck с фильтрацией по атрибутам, в том числе по смене статуса.

Подписка на событие Citeck
Роутинг из RabbitMQ

Чтение из RabbitMQ, роутинг по jsonPath и переотправка в Citeck Event.

Чтение из RabbitMQ, роутинг по jsonPath и переотправка в Citeck Event
Компоненты

Схемы URI компонентов Citeck, их роли потребителей и производителей и назначение.

Компоненты
Конечные точки

Подробное описание endpoint-ов: URI, параметры, входные и выходные данные.

Конечные точки
Процессоры

Чтение и запись CSV/Excel, преобразование данных, работа с контентом, сопоставление ассоциаций и другие процессоры.

Процессоры
Импорт из Jira и GitLab

Компоненты для переноса задач, комментариев, вложений, спринтов и связанных коммитов.

Импорт из Jira и GitLab
Настройка импорта проектов из Jira

Пошаговая настройка синхронизации коммитов и MR из GitLab и импорта проекта из Jira в Project tracker: пример маршрута, маппинг значений и атрибутов, устранение неполадок.

Настройка импорта проектов из Jira
Библиотека ecos-camel-core

Подключение библиотеки и создание Camel-контекстов в коде микросервиса; координаты зависимости и требования к поставке.

Библиотека ecos-camel-core
Примеры реализации

Импорт из Excel, синхронизация с Bitrix24 CRM, глобальный импорт данных и примеры маршрутов из репозитория ecos-camel.

Примеры реализации