服务定义
ABAP RESTful 应用程序编程模型 › 学习 › 业务对象 › RAP 业务对象最佳实践 › 业务对象建模 › 业务服务 › 服务定义
定义
业务服务定义(简短形式:服务定义)描述要公开数据模型的 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 的关联。

以下示例显示服务定义 /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 官方机器翻译