RAP 可扩展性启用
ABAP RESTful 应用程序编程模型 › 扩展 › RAP 可扩展性启用
本部分介绍如何启用自定义 RAP BO 进行扩展开发的概念。
关于可扩展性启用
由于 RAP 可扩展性基于选择性加入方法,因此必须为 RAP BO 显式启用堆栈中所有可能的扩展点。
这意味着,必须先显式启用所有开发对象(如数据库表、CDS 视图、行为定义和行为预测)以实现可扩展性,然后才能由扩展提供者扩展相应的 RAP 业务对象。RAP BO 提供者可以完全控制 RAP 业务对象的哪些部分可扩展。唯一的例外是行为和字段相关行为扩展所需的 BO interfaces。除关键字 extensible 外,业务对象接口不需要任何特定的启用:它们仅用作基础业务对象的合并消耗视图,并始终反映基础层的扩展性启用级别。在扩展中使用业务对象接口时,基础 RAP BDEF 中节点的扩展行为将隐式添加到业务对象接口。有关业务对象接口隐式扩展的详细信息,请参阅业务对象接口。
含或不含草稿功能的不同实施类型的可扩展性启用
特定启用步骤取决于 RAP 业务对象的实施类型以及业务对象是否具有草稿功能。
托管和非托管 RAP 业务对象的启用步骤类似:
数据模型可扩展性启用:定义相应部件中的技术扩展点和扩展可能性,例如,通过在活动表和草稿表中添加
extension include,并通过扩展注释定义技术属性(例如可能的扩展以及最大可用字段数),为扩展准备数据库表。有关详细信息,请参阅 CDS 数据模型扩展的可扩展性启用。行为可扩展性启用:将 BDEF 定义为
extensible并指定可用于扩展提供者的行为扩展范围,例如validations on save、determinations on modify、determinations on save和additional save。有关详细信息,请参阅行为扩展的可扩展性启用。节点可扩展性启用:在堆栈的所有 CDS 视图实体中定义注释
@AbapCatalog.extensibility.allowNewCompositions,以便能够添加新的toParent/Child成分。将基本 BDEF 定义为extensible以允许添加扩展节点的行为。此外,将服务定义定义为extensible。如果要使用C0合同发布服务定义,请将供方合同添加到服务定义,以指定可能添加到服务的 CDS 视图的要求。当然,这些要求也适用于已属于服务的 CDS 视图。有关详细信息,请参阅节点可扩展性的可扩展性启用。发布
Extend (C0)发布合同:此发布合同通过扩展提供者和 RAP BO 使用者的附加检查确保扩展点的稳定性。此发布合同禁止对扩展点进行不兼容的更改。请注意,如果要为此发布合同发布开发对象,则必须使用最高可用的strict级别。备注
为
Extend(C0)发布合同发布 RAP BO 接口或 CDS 预测后,您无法随后对其进行草稿启用。在内部使用系统 (C1)(消费启用):所有打算在行为实施中使用或使用的开发对象均需要
C1发布合同。使用ABAP for Cloud Development,为Use System-Internally (C1)发布的开发对象只能使用针对同一发布合同发布的对象以及实施中的可见性。如果尝试访问未发布对象,则会出现语法错误。在Use System-Internally (C1)版本中,对进一步更改施加限制和检查以确保使用者的端到端稳定性:例如,您无法删除元素,或者无法添加可能导致不兼容更改和可能的升级问题的实施。
含审批合同概览的开发对象
下图概述了应用开发部件及其发布合同。如果要在业务对象中使用发布合同,这是对已发布的 RAP 业务对象也有效的推荐体系结构:

有关详细描述,请参阅可扩展性体系结构概览。
可扩展性启用目标概览
以下概览显示通用 RAP 业务对象堆栈中的可扩展性启用。描述的可扩展性启用模型为字段和行为扩展以及节点可扩展性启用 RAP BO。
数据模型:由数据库表和 CDS 视图组成的数据模型已启用可扩展性,具有所需的技术属性,并已针对
C0发布合同发布。这将启用字段可扩展性,并允许将扩展字段添加到数据库表。还允许使用扩展提供者端的字段和关联扩展 CDS 数据模型。有关扩展字段的数据模型的可扩展性启用的详细信息,请参阅 CDS 数据模型扩展的扩展性启用 。
行为:行为定义定义为
extensible,并定义指定可能的行为扩展的常规可扩展性范围。单个业务对象实体定义为extensible,以定义行为扩展范围可应用于哪些业务对象实体。为C0审批合同发布 BDEF,以确保定义的扩展点的稳定性。有关 RAP BO 行为的可扩展性启用的详细信息,请参阅行为扩展的可扩展性启用。
服务扩展:为了添加扩展业务对象实体,服务定义定义为
extensible(注释@AbapCatalog.extensibility.extensible: true),它具有指定的供方合同,并针对C0发布合同发布。节点可扩展性还需要在整个堆栈中启用可扩展性,以便在相应的扩展点添加所需的关联。有关节点可扩展性的可扩展性启用的详细信息,请参阅节点可扩展性的可扩展性启用。
来源:SAP Help Portal · 2025 FPS02 (Oct 2026) · 中文为 SAP 官方机器翻译
← 可扩展性体系结构概览 · 了解可扩展性启用 →