Модули интеграции¶
Модуль интеграции — код на стороне подключаемой системы, который реализует отправку, приём и подтверждение сообщений через REST API DataHUB. Ниже — платформо-независимые алгоритмы и готовая реализация для платформы 1С.
Общая методология¶
Платформо-независимые алгоритмы и требования, которые должен выполнять любой адаптер — независимо от технологического стека:
- Требования к адаптеру — минимальный контракт для подключения к DataHUB.
- Алгоритм отправки — регистрация изменений, формирование пакета, доставка в шину.
- Алгоритм приёма и подтверждения — получение сообщений, двухфазная обработка, ACK.
- Идентификация объектов — поиск локального объекта по многосистемному массиву ссылок.
- Отложенная обработка — зачем обработка выполняется асинхронно после подтверждения.
- Работа с файлами — передача файловых вложений через сообщение или внешнее хранилище.
- Обработка ошибок — ошибки транспорта и логика повторных попыток обработчиков.
Модуль для 1С¶
Реализация адаптера для конфигураций на платформе 1С 8.3:
- Обзор модуля — состав и архитектура подсистемы.
- Установка и Настройка — как подключить к конфигурации.
- Алгоритмы обмена — реализация отправки и приёма на языке 1С.
- Исходящие и входящие обработчики — как писать прикладную логику.
Полный список статей — в обзоре модуля 1С.
Разработка адаптера для другой платформы¶
Если вы разрабатываете адаптер для системы, не описанной в этом разделе, начните с Общей методологии. Все адаптеры взаимодействуют с шиной через единый Транспортный API.