服务定义

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

定义

业务服务定义(简短形式:服务定义)描述要公开数据模型的 CDS 实体,以便可以启用特定业务服务,例如销售订单处理。它是描述数据模型上使用者特定但协议无关透视图的 ABAP 资源库对象。它可以直接访问标准 ABAP 工作台功能,例如传输、语法检查、元素信息和激活。其传输类型为 SRVD。

使用

服务定义表示通常从基于 CDS 的基础数据模型派生的服务模型。

使用服务定义,定义使用一个或多个服务绑定将哪些数据公开为业务服务。服务定义本身独立于用于业务服务的协议的版本或类型。

记住

当将数据模型公开为服务时,您只能将服务定义与至少一个服务绑定结合使用。

备注

无法公开包含 Web API 或 UI 服务的抽象实体的 OData 服务。您可以在服务定义中公开抽象实体,但前提是使用 OData 客户端代理工具创建抽象实体(服务使用用例)。通过服务绑定发布服务会导致转储错误。

有关定义服务的语法的详细信息,请参阅 CDS SDL - DEFINE SERVICE(ABAP 关键字文档)

解释

实际服务定义的源代码前面是可选 CDS 注释 @EndUserText.label,可用于可包含 CDS 注释的所有对象。注释值是最多 60 个字符的字符串。指定的 text 值应由有意义的短文本组成,该短文本使用源代码的原始语言描述服务。

根据场景的需要,可以指定更多可选注释 @<Annotation_1> ... @<Annotation_n>。如果为服务公开具有多个 CDS 实体的完整业务对象结构,则可以使用注释 @ObjectModel.leadingEntity.name: 定义业务服务的根实体,从而定义业务服务的主要入口点。注释导致该实体在服务绑定编辑器的实体树中标记,并显示为列表中的第一个实体。

服务定义使用 DEFINE SERVICE 关键字启动,后跟服务定义的名称。

服务定义的源代码在单个括号 { ... } 中创建,用于对作为单个服务的一部分公开的所有相关 CDS 实体(包括其与相关实体的关联)进行分组。

要公开的每个单个 CDS 实体的名称都在 EXPOSE 关键字之后。后跟可选别名,由 AS 关键字启动。别名定义要公开的 CDS 实体的备选名称。因此,访问服务时,将使用别名而不是当前实体名称。因此,您可以选择在服务定义中分配语法统一标识符,从而将服务语义与数据定义产生的具体技术名称解耦。

与 CDS 语法规则类似,每个语句都用分号完成。

示例

/DMO/Travel,定义与实体 /DMO/Customer 和 /DMO/Agency 的关联。此外,必须包括与实体 I_Currency 和 I_Country 的关联。

TRAVEL 服务的数据模型

以下示例显示服务定义 /DMO/TRAVEL 的相应源代码。以此方式定义的差旅管理服务包括来自根实体 /DMO/I_TRAVEL 的所有相关性。

@EndUserText.label: 'Service for managing travels'
@ObjectModel.leadingEntity.name: '/DMO/I_TRAVEL'
define service /DMO/TRAVEL
{
expose /DMO/I_TRAVEL       as Travel;
expose /DMO/I_AGENCY       as TravelAgency;
expose /DMO/I_CUSTOMER     as Passenger;
expose I_Currency          as Currency;
expose I_Country           as Country;
}

备注

在此示例中,服务定义基于源自不同命名空间的 CDS 实体。

服务定义扩展

RAP Service Definition Extension 扩展了现有服务定义以在服务绑定中包含扩展节点。

Service Definition Extension 包含要在服务绑定中公开的扩展节点。如果将新的扩展业务对象节点添加到 RAP 业务对象,则必须扩展现有 Service Definition 以将新的业务对象实体公开给服务绑定中的使用者。有关创建扩展节点的详细信息,请参阅节点扩展。

来源:SAP Help Portal · 2025 FPS02 (Oct 2026) · 中文为 SAP 官方机器翻译

← 投影行为定义 · 服务定义扩展 →