БИТ.Адаптер
БИТ.Адаптер — библиотека расширения для 1С:Предприятие, предназначенная для интеграции информационных систем на базе 1С с другими информационными системами (в т.ч. не 1С) с использованием RabbitMQ.
Архитектура
БИТ.Адаптер состоит из двух частей:
- Основная библиотека (
БИТАдаптер) — общий функционал для работы с RabbitMQ - Проектное расширение (
БИТАдаптерИнтеграцияПроектный) — переопределения для конкретных конфигураций
Установка
Добавление библиотеки
Добавьте submodule в репозиторий:
git submodule add <ссылка-на-проект-в-git> "src/cfe/bit-adapter"
Структура репозиториев
- Основная библиотека — общие изменения, которые влияют на адаптер
- Проектные расширения — переопределения для конфигураций хранятся в отдельном расширении для каждой конфигурации
Настройка проектного расширения
В отдельном расширении добавьте ОбщийМодуль.адаптер_ИнтеграцияПроектный с кодом:
#Область ПрограммныйИнтерфейс
Процедура ПриОпределенииМодулейСПодписками(МодулиСПодписками) Экспорт
МодулиСПодписками.Добавить(адаптерпроект_ИнтеграцияАдаптер);
КонецПроцедуры
#КонецОбласти
Это добавит ОбщийМодуль.адаптерпроект_ИнтеграцияАдаптер как модуль с подписками на расширение функционала адаптера.
Основные компоненты
Каталоги
- адаптер_ПараметрыПодключения — параметры подключения к RabbitMQ
- адаптер_ИсходящиеСообщения — исходящие сообщения для отправки
- адаптер_ВходящиеСообщения — входящие сообщения для обработки
- адаптер_СхемыДанных — схемы данных для обмена
- адаптер_ЗаписиРегистров — записи регистров для обмена
Обработки
- адаптер_КомпонентаRabbitMQ — компонента для работы с RabbitMQ
- адаптер_ГрупповаяВыгрузка — групповая выгрузка данных
- адаптер_RMQ_HTTP_REST — REST API для работы с RabbitMQ
Общие модули
Основные модули для работы с обменом:
адаптер_НастройкиОбмена— настройки обменаадаптер_ОбменДаннымиXDTO— обмен данными через XDTOадаптер_ОбработчикиСобытий— обработчики событий обменаадаптер_РаботаСДаннымиИБ— работа с данными информационной базы
Подписки на события
Модуль адаптерпроект_ИнтеграцияАдаптер может реализовывать следующие подписки:
ЗаполнитьВыгружаемыеОбъекты— определение объектов для выгрузкиПолучитьДанныеВыгружаемогоОбъекта— получение данных объекта для отправкиЗаписатьМассивДанных— запись входящих данных в информационную базуЗаполнитьСоставВыгружаемыхОбъектов— определение состава выгружаемых объектовЗаполнитьТекстыЗапросовУсловиями— добавление условий в запросы выгрузкиПолучитьИмяТекущейБазы— получение имени текущей базы для идентификации
Примеры подписок, весь список смотрите в основном коде адаптера.