服务绑定

ABAP RESTful 应用程序编程模型 › 学习 › 业务服务 › 服务绑定

定义

业务服务绑定(简写形式:服务绑定)是一个 ABAP 资源库对象,用于将服务定义绑定到客户端-服务器通信协议,例如 OData。与任何其他资源库对象一样,服务绑定使用 ABAP 工作台的已验证基础架构,包括传输功能。

使用

如下图所示,服务绑定直接依赖于从基于 CDS 的基础数据模型派生的服务定义。根据单个服务定义,可以创建多个服务绑定。服务定义和服务绑定之间的分离使服务能够集成各种服务协议,而无需任何类型的重新实施。以这种方式实施的服务基于服务协议与实际业务逻辑的分离。

数据模型、服务定义和服务绑定之间的关系

参数

以下参数用于描述服务绑定的特征:

服务名称

定义服务的唯一系统名称,与服务绑定的名称相同。

绑定类型

绑定类型指定服务类型,以及使用服务绑定实施的特定协议。

CDS 数据模型可以使用以下协议公开:

  • OData 版本 2.0 (ODATA V2)

    有关详细信息,请参阅 https://www.odata.org/documentation/odata-version-2-0/ 在非 SAP 站点发布的信息。

    有关基于 OData V2 模型的 Fiori 元素应用的详细信息,请参阅 OData V2 模型。

    备注

    在 OData V2 服务中,单位和货币类型作为内置实体集自动添加到服务元数据。使用此功能,始终在 UI 上正确显示单位和货币值并验证有关小数的内容。

  • OData 版本 4.0 (ODATA V4)

    有关详细信息,请参阅 https://www.odata.org/documentation/ 在非 SAP 站点发布的信息。

    OData V4 服务的范围比 OData V2 服务的范围更广。尽可能将 OData V4 用于事务服务。

    备注

    仅针对已启用草稿的场景授予对基于 OData V4 服务的 Fiori 元素 UI 的完全支持。

    有关基于 OData V4 模型、OData V4 模型的 Fiori 元素应用的详细信息。

  • InA(信息访问)

    分析数据模型通过 InA 公开,以进行实时数据访问。

  • SQL

    使用开放式 SQL 访问已发布的 ABAP 管理数据库 API 对象。

记住

开放数据协议 (OData) 支持创建基于 HTTP 的服务,该服务允许使用统一资源标识符 (URI) 标识并在抽象数据模型中定义的资源由 Web 客户端使用 HTTP 消息进行发布和编辑。OData 用于公开和访问来自各种源的信息,包括但不限于关系数据库、文件系统、内容管理系统和传统网站。

此参数还确定向使用者提供服务的方式。有两个选项:

UI

UI 服务

UI 服务允许向服务添加 SAP Fiori 元素 UI 或其他 UI 客户端。

目前,OData 和 InA 服务支持 UI 服务。

Web API

作为 Web API 公开的服务

作为 Web API 公开的服务用于除 UI 之外的所有其他用例。未知使用者可以通过 OData 使用 Web API。可以扩展 Web API。

目前,OData 和 SQL 服务支持 Web API。

服务版本

服务的版本化由分配给服务绑定的版本编号进行。

通过将其他服务定义添加到现有服务绑定来创建下一个更高版本。通过此进一步服务定义,公开功能更改或扩展(与先前版本相比)。反之亦然,可以通过从服务绑定中移除服务定义来减少版本号。

发布

OData 服务的本地服务端点必须通过服务绑定编辑器中的发布按钮发布。这会触发多个任务清单以启用服务以供使用。通过发布服务绑定,该服务仅针对当前系统启用。不能从其他系统中使用。

备注

服务绑定需要处于活动状态才能发布。要激活服务绑定,请使用工具栏中的激活按钮。

服务 URL

派生的 URL(作为服务 URL 的一部分)用于从当前 ABAP 系统开始访问 OData 服务。它通过以下语法指定服务的虚拟目录:/sap/opu/odata/<service_binding_name>

预览

您可以直接从服务绑定启动 Fiori 元素预览。这样,您可以直接从 ABAP 系统测试 UI 相关功能。

OData 敞口比较

绑定到 OData 协议的业务服务因服务绑定中分别选择的类型和版本而异。下表概述了这些类型和版本之间的差异:

功能

WebAPI V2

WebAPI V4

UI 服务 V2

UI 服务 V4

UI 注释

元数据中不包含用户界面特定信息

元数据中不包含用户界面特定信息

元数据中包含的 UI 特定信息

元数据中包含的 UI 特定信息

值帮助

不可用

可用

副作用

不可用

可用

功能控制

未作为服务的一部分公开

作为服务的一部分公开

PDF 导出

不可用

可通过实体集获得

合同审批

C2 可能在 ADT   服务绑定   上下文菜单   API 状态 中。另请参阅: 发布开发对象

C1 可能在 ADT   服务绑定   上下文菜单   API 状态 中。另请参阅: 发布开发对象

Fiori 元素预览

不可用

在服务绑定中可用

计量单位/货币的代码清单

不可用

包含在服务组中

包含在实体集 SAP__Currencies 和 SAP__UnitsOfMeasure 中

包含在服务组中

货币代码格式的 ISO 转换

可用

不可用

计量单位的 ISO 转换

已为 SAP 单位禁用转换

ISO/SAP 单元验证

已为 SAP 单位禁用转换

ISO/SAP 单元验证

转换出口 CUNIT

已移除 ISO 计量单位属性

可用

开发 部分提供了业务对象业务服务公开的详细信息和示例。

服务传输

在企业预置系统中,您只能使用服务绑定在本地启用服务并在开发系统中对其进行测试。无法传输与本地生成的所有相关部件的服务绑定。要在资格或生产系统中启用业务服务,必须在本地系统中禁用该服务(取消发布按钮)。然后使用网关工具激活和维护服务。

有关详细信息,请参阅为 OData V2 场景激活服务 (SAP Gateway Foundation) 或针对 OData V4 场景激活中心系统中的服务开发 (V4) 。

服务错误

服务绑定显示与完整服务相关的错误。它们在创建服务绑定或在 ADT 中重新打开部件时显示。服务绑定中显示的错误也会显示在 ATC 检查中。