Термины и определения
Глоссарий понятий, используемых в документации DataHUB. Термины упорядочены по алфавиту.
Клиентский адаптер
Код на стороне интегрируемой системы, реализующий подключение к Серверу DataHUB: вызов транспортного REST API для отправки сообщений и публикация конечной точки для приёма входящих. Для 1С роль клиентского адаптера выполняет подсистема интеграции (см. ниже); для других систем разрабатывается интегратором.
Сервер DataHUB
Центральный серверный компонент платформы. Реализует транспортный REST API, управляет авторизацией интегрируемых систем и пользователей, автоматически конфигурирует RabbitMQ (точки обмена, очереди, привязки), маршрутизирует сообщения между системами и ведёт журнал событий обмена. В кодовой базе соответствует контейнеру backend.
Гарантированная доставка
Свойство платформы: сообщение хранится в шине до тех пор, пока получатель не подтвердит получение. Платформа обеспечивает хотя-бы-однократную обработку.
Журнал событий обмена
Последовательность зафиксированных статусов жизненного цикла каждого сообщения — от регистрации в системе-источнике до подтверждения получения системой-приёмником.
Информационная система (ИС)
Внешняя учётная или прикладная система, подключенная к платформе для обмена сообщениями. Конкретные ИС регистрируются в реестре платформы и обмениваются сообщениями через настроенные маршруты.
Класс сообщения
Тип передаваемой сущности, определяющий формат и состав полей сообщения. Регистрируется в реестре платформы и используется при настройке маршрутов.
Ключ маршрутизации
Поле в шапке сообщения, по которому платформа определяет, в какие очереди систем-приёмников оно должно попасть. Связан с маршрутом.
Контур
Изолированное окружение развертывания платформы и интегрируемых систем. Стандартные контуры — dev, test, prod.
Маршрут сообщения
Правило, связывающее класс сообщения и ключ маршрутизации с одним или несколькими системами-приёмниками. Маршруты редактируются в административном интерфейсе.
Обработчик
Код на стороне интегрируемой системы, который формирует исходящее сообщение из объектов учётной системы или применяет входящее сообщение к её данным. В подсистеме 1С обработчики пишутся на встроенном языке 1С.
Очередь
Структура в шине, хранящая сообщения для конкретной системы-приёмника до подтверждения получения. Реализуется через RabbitMQ.
Подписка на событие
Стандартный механизм 1С, через который подсистема DataHUB перехватывает изменения объектов конфигурации (документов, справочников) и регистрирует их для отправки.
Подсистема 1С
Модуль интеграции для 1С, реализующий регистрацию изменений, формирование исходящих сообщений и приём входящих. Встраивается в существующую конфигурацию одним из двух способов: по технологии поставки (как часть основной конфигурации) или через расширение конфигурации (без модификации основной).
Получатель
См. Система-приёмник.
Предопределённый элемент
Элемент справочника или плана видов характеристик 1С, заданный на уровне конфигурации. Платформа поддерживает сохранение ссылок на такие элементы при переносе обработчиков между контурами.
Регистрация объекта
Фиксация в очереди регистрации факта изменения объекта учётной системы. Выполняется быстрым неблокирующим кодом из подписки на событие, до фактического формирования сообщения обмена.
Реестр интегрируемых систем
Централизованный список ИС, подключенных к платформе. Содержит учётные данные, маршруты, классы сообщений и токены авторизации. Хранится в PostgreSQL, редактируется через административный интерфейс.
Сообщение обмена
Единица передачи в шине. Состоит из шапки (тип сущности, ключ маршрутизации, служебные поля) и тела (реквизиты передаваемого объекта). Формат — JSON.
Ссылочная целостность
Свойство передачи, при котором ссылки между объектами в системе-приёмнике остаются корректными — нет «битых ссылок» на ещё не переданные или удалённые объекты.
Система-источник
ИС, в которой возник передаваемый объект и которая отправляет сообщение в платформу.
Система-приёмник
ИС, которой адресовано сообщение и которая обрабатывает его на своей стороне.
Точка обмена
Промежуточный объект в шине, в который попадают входящие сообщения и из которого они распределяются в очереди систем-приёмников по ключу маршрутизации.
Транспортный API
REST API Сервера DataHUB, через который интегрируемые системы отправляют и получают сообщения. Авторизация — по JWT-токенам, привязанным к учётной записи системы в реестре.
Шапка сообщения
Часть сообщения обмена, содержащая метаданные: тип передаваемой сущности, ключ маршрутизации, служебные поля для маршрутизации и аудита.
Шина
Транспортный слой платформы — RabbitMQ с настроенными точками обмена и очередями систем-приёмников. Используется Сервером DataHUB как внутренний транспорт; объекты RabbitMQ создаются и поддерживаются Сервером автоматически.
AMQP
Стандартный протокол обмена сообщениями между Сервером DataHUB и шиной (RabbitMQ). Для интегратора неважен — все интегрируемые системы взаимодействуют с платформой через транспортный REST API, а не через AMQP напрямую.
JWT
Формат токенов, используемый платформой для авторизации систем и пользователей. Токен передаётся в каждом вызове транспортного REST API.
mTLS
Mutual TLS — двусторонняя проверка сертификатов между клиентом и сервером. Используется для защищённого взаимодействия между серверами платформы и узлами интегрируемых систем.
REST API
См. Транспортный API.
Что читать дальше
- Архитектура — компоненты, через которые работают эти понятия.
- Концепции — расширенное объяснение принципов обмена (маршрутизация, идемпотентность, гарантии доставки и т. д.).