Использование ODataConnector или SAPODataConnector
Соединители ODataConnector и SAPOData предоставляют конечные точки для наборов сущностей, функций и действий согласно спецификации OData. Поддерживаются все четыре версии OData. Подробную информацию см. в соглашениях по URL-адресам в доступной документации OData:
http://www.odata.org/documentation/.
Соглашения о конечных точках
При создании сервиса отображаются только конечные точки, на которые ссылается набор сущностей.
Для отображения конечных точек OData использовались следующие соглашения:
• GET - запрос на получение
• CREATE - запрос на отправку
• NAVIGATE - запрос свойств навигации. В более ранних версиях OData взаимосвязь свойства навигации называли ассоциацией.
• Действие/команда - функция для сущностей
Для конечных точек, которые возвращают определенную сущность или выполняются в контексте определенной сущности (связанные функция/действие или навигация), параметры будут создаваться на основе ключевых атрибутов этой сущности (как определено в спецификации OData).
Спецификация OData поддерживает системные опции запросов, и эти параметры создаются для применимых конечных точек. Для любых конечных точек запроса get будет создаваться параметр
$select и также будет создаваться параметр
$expand, если сущность ответа будет содержать встроенные атрибуты навигации. Для конечных точек запросов GET, у которых ответ представляет набор сущностей, создаются параметры
$filter,
$top и
$skip. Для получения дополнительной информации о поведении этих параметров см. документ
OData Version 4.0. Part 2: URL Conventions, Query Options (OData версии 4.0. Часть 2. Соглашения об URL-адресах. Опции запросов) (на английском языке).
Специфические особенности SAP
Учтите следующие сведения о SAPODataConnector:
• Чтобы получить конечные точки для SAPODataConnector, необходимо сконфигурировать SAP NetWeaver для вашего экземпляра SAP.
• SAPODataConnector ищет сервисы в каталоге SAP. Если сервис недействителен или неактивен, регистрируется исключение в
Журнале приложения. Дополнительные сведения см. в разделе
Журналы.
Соединитель SAP поддерживает сервисы поиска в каталоге SAP. Некоторые из этих сервисов могут быть недействительными или неактивными. В IntegrationRuntime это приводит к исключению HTTP 500 при запросе URL-адреса $metadata. Такие исключения регистрируются в IR и игнорируются. Вызов GetEndpointList() должен также записывать в журнал сообщение для каждого сервиса, который является недействительным или неактивным, чтобы эта информация была доступна с сервера ThingWorx. Журналы должны отображаться в журнале приложений Composer.