ODATA

OData — это открытый веб-протокол для запроса и обновления данных, основанный на HTTP. Он позволяет работать с ресурсами, выполняя стандартные HTTP-команды и получая ответы в форматах XML или JSON. В интеграционной платформе Entaxy модуль OData доступен как расширение, обеспечивающее удобную и стандартизированную работу с данными из различных систем, их агрегацию и маршрутизацию без необходимости разработки индивидуальных API.

https://www.odata.org/documentation/ - Официальная документация протокола odata.

Использование модуля OData для интеграции разрозненных систем

Задача: Портал с личным кабинетом заказчика должен отображать данные из различных информационных систем, обеспечивая их удобный и гибкий доступ.

Для решения этой задачи была выбрана спецификация OData.

Используемый сценарий:

OData – отдельный модуль интеграционной платформы Entaxy ION.
Модуль содержит:
- OData-сервис — точка входа для OData-запросов;
- OData Engine — сбор и консолидация метаинформации, маршрутизация запросов;
- OData-адаптер — помогает подключиться к системе-поставщику;
В Incomand: универсальный портлет OData, обеспечивающий динамическое отображение данных.

Портал не взаимодействует напрямую с целевыми системами. Данные агрегируются через сервисную шину Entaxy, где OData Engine собирает их из различных источников, а OData-адаптер преобразует в формат OData.

Порядок действий

На портале уже настроен портлет с данными из системы документооборота Тезис.

Отправляем GET-запрос через Postman для получения метаданных. Они содержат информацию о доступных сущностях, которые обрабатывает OData Engine. В ответе видим сущности Contract, Contractor, Currency, каждая из которых включает набор свойств.
Добавление нового источника данных (PostgreSQL)
- На платформе Entaxy ION создаем профиль системы PostgreSQL.
- К созданному профилю добавляем выходной JDBC-коннектор.
- Подключаем OData-адаптер к JDBC-коннектору.
  - В настройках подключения указываем путь к файлу метаданных.
Выполняем повторный запрос метаданных:

В ответе появилась новая сущность Agreement, подтверждая успешное подключение PostgreSQL.
Настройка отображения новых данных на портале
- Открываем конфигурацию личного кабинета Incomand.
- Выбираем сущность Agreement из списка.
- Настраиваем отображаемые поля.
- Видим новый портлет с данными из PostgreSQL.

Использование OData в Entaxy упрощает интеграцию разрозненных систем, позволяя гибко подключать новые источники данных и стандартизировать их доступ без изменения логики взаимодействия.