Общая библиотека для обработки EDI событий ecos-edi-integration

Примечание

Доступно только в Enterprise версии.

Библиотека ecos-edi-integration обрабатывает унифицированные EDI-события в Citeck: вложения, подписи и пакеты документов. При запуске OSGi-бандла создаётся отдельный Camel-контекст с входной точкой direct-vm:ecosEventsReceiveVmRoute.

Исходный код: ecos-edi-integration.

Версия и совместимость

Описание сверено с версией 1.9.0. В её POM заданы Camel 3.11.2, ecos-osgi-loader 2.0.0 и ecos-edi-commons 2.15.0-SNAPSHOT. Эти зависимости имеют scope provided: необходимые API и компоненты должны быть доступны в принимающем окружении.

Важно

Перед установкой проверьте версии API, экспортируемые OSGi-пакеты и наличие компонента direct-vm на целевом стенде. Общая инструкция загрузки OSGi-бандлов описывает также окружение с Camel 4, где direct-vm удалён. Совместимость библиотеки 1.9.0 с таким окружением не подтверждена. Замена direct-vm на direct сама по себе не сохраняет обмен между отдельными Camel-контекстами.

Подключение событий

Запуск бандла создаёт обработчик, но получение событий у провайдера настраивается отдельно. В поле Camel endpoint отправляющей синхронизации укажите direct-vm:ecosEventsReceiveVmRoute. Пример настройки: получение событий из ящика Контур.Диадок.

В стандартной фабрике версии 1.9.0 зарегистрированы обработчики KONTUR, CORUS и SBIS. Наличие обработчика не означает поддержку всех возможностей API соответствующего провайдера.

Тело сообщения должно представлять унифицированное событие ru.citeck.ecos.domain.edi.dto.Event из совместимой версии ecos-edi-commons. Общий процессор проверяет:

  • наличие ediProviderType;

  • наличие зарегистрированного обработчика этого провайдера;

  • непустой идентификатор собственного ящика в ourId.attributes.boxId.

При нарушении этих условий процессор выбрасывает IllegalArgumentException. Исходные ответы провайдера необходимо преобразовать в унифицированное событие до передачи в этот маршрут.

Условия работы

Библиотека получает RecordsServiceFactory, RecordsService и EdiService из Spring-контекста принимающего приложения. В данной версии используются Alfresco-источники и модель данных: конфигурация EDI читается из alfresco/ с типом ediConfig:ecosConfig, а поиск контрагентов использует alfresco/counterpartyByBoxId. Эти сервисы, источники и используемые Alfresco-пути хранения должны быть доступны в окружении.

События проходят по цепочке:

direct-vm:ecosEventsReceiveVmRoute
    -> direct:ecosEventsRedistributesRoute
    -> direct:ecosCommonEventRoute

Доставка в маршрут не всегда приводит к обработке пакета. При inboundPackagesProcessing=BOX_ID внешнее событие без найденного контрагента пропускается с сообщением Skip event. Для внутреннего пакета эта проверка не блокирует обработку. При других значениях режима отсутствие контрагента само по себе не блокирует вызов процессора. Значение режима по умолчанию — ALL.

Порядок загрузки бандла описан в разделе Функционал загрузки OSGi-пакетов. Загрузку выполняйте от имени системного администратора после проверки совместимости окружения.