Использование Camel DSL
Camel DSL в Citeck позволяет описывать и выполнять интеграционные маршруты Apache Camel в микросервисе ecos-integrations. Поддерживаются форматы YAML DSL и XML DSL. Компоненты Citeck дополняют стандартные средства Camel работой с Records API, событиями платформы, файлами и внешними системами.
Основная единица настройки — Camel-контекст: он содержит маршруты, бины и параметры их выполнения. Маршрут задаёт источник сообщений или данных, последовательность обработки и целевые конечные точки (endpoint-ы).
Основные сценарии применения:
интеграция Citeck с внешними системами через REST, JDBC, RabbitMQ и другие протоколы;
миграция и синхронизация данных между базами данных;
обработка событий и сообщений через подписки;
автоматизация импорта данных из файлов.
Начало работы
Откройте журнал Camel DSL в рабочем пространстве администратора:
v2/journals?journalId=ecos-camel-dsl&viewMode=table&ws=admin$workspace.Создайте или выберите контекст и задайте формат его содержимого — YAML или XML. Укажите тип запуска:
MANUALLY — запуск и остановка контекста действиями в журнале;
IMPORT_DATA — обработка файла через механизм импорта данных с созданием отдельного инстанса контекста.
Настройте подключения к внешним системам, учётные данные и маршрут. Пример работы с JDBC приведён в разделе Выборка из БД, чтения и записи данных Citeck — в справочнике конечных точек.
Для YAML-маршрута можно открыть просмотрщик Kaoto. По умолчанию схема служит для просмотра и навигации, а изменения вносятся в YAML. Визуальное редактирование схемы включается отдельно настройкой
app/integrations$camel-visual-editing-enabled.Сохраните контекст и запустите его выбранным способом. Для диагностики используйте действия и лог контекста, а для импорта данных — журнал инстансов.
Примечание
Для новых маршрутов записи данных через Records API используйте ecos-records-mutate. Описанный отдельно бин RecordsDaoEndpoint подавляет ошибки сохранения: успешное завершение его шага не гарантирует, что запись сохранена. Это нужно учитывать перед удалением исходных данных или отметкой об успешном импорте.
Справочники и примеры
Раздел включает настройку контекстов, справочники компонентов, конечных точек и процессоров, а также готовые сценарии интеграции. Набор доступных компонентов и параметры зависят от версии и состава поставки. Для встраивания Camel-контекстов в код микросервиса см. ecos-camel-core.
Camel-контексты, маршруты, компоненты Apache Camel и типы запуска в Citeck.
Просмотр Camel-маршрута в виде схемы рядом с YAML на базе Kaoto, навигация по схеме и включение полноценного визуального редактирования.
Настройка Credentials, источника данных и маршрута для выборки из БД через JDBC.
Старт, стоп контекста и просмотр лога последней синхронизации.
Отдельные запуски импорта данных с типом IMPORT_DATA, журнал инстансов и их состояния.
Настройка бина RecordsDaoEndpoint для обработки XML/CSV/текстовых файлов и ограничения обработки ошибок сохранения.
Простое удаление записей и удаление после выборки и обработки.
Подключение к очереди RabbitMQ и публикация события Citeck.
Подписка на события Citeck с фильтрацией по атрибутам, в том числе по смене статуса.
Чтение из RabbitMQ, роутинг по jsonPath и переотправка в Citeck Event.
Схемы URI компонентов Citeck, их роли потребителей и производителей и назначение.
Подробное описание endpoint-ов: URI, параметры, входные и выходные данные.
Чтение и запись CSV/Excel, преобразование данных, работа с контентом, сопоставление ассоциаций и другие процессоры.
Компоненты для переноса задач, комментариев, вложений, спринтов и связанных коммитов.
Пошаговая настройка синхронизации коммитов и MR из GitLab и импорта проекта из Jira в Project tracker: пример маршрута, маппинг значений и атрибутов, устранение неполадок.
Подключение библиотеки и создание Camel-контекстов в коде микросервиса; координаты зависимости и требования к поставке.
Импорт из Excel, синхронизация с Bitrix24 CRM, глобальный импорт данных и примеры маршрутов из репозитория ecos-camel.