节点扩展

ABAP RESTful 应用程序编程模型 › 扩展 › RAP 扩展 › 了解 RAP 扩展 › 节点扩展

通过节点可扩展性,您可以将附加业务对象实体添加到现有 RAP 业务对象。新节点包含自己的数据模型,该模型作为扩展实体集成到现有数据模型中。扩展实体的行为在 BDEF 扩展中定义。然后扩展 Service Definition 以在服务公开中包含新节点。

备注

  • 仅实施类型 managed 支持确定、验证、附加保存和清理的扩展。

节点可扩展性体系结构

扩展节点的数据模型

前提条件是您已定义一个附加节点,其中包含要包含在现有数据模型中的自有数据模型。如节点可扩展性的可扩展性启用中所述,必须为节点可扩展性启用原始业务对象。

此示例中用于说明目的的节点主要由具有键值字段 R_View_ExtNode 的视图 ID 和与要添加扩展节点的业务对象数据模型的根视图的 to-parent 关联组成。此关联建立了在行为扩展中添加行为所需的父子关系。映射视图 C_View_ExtNode 预测 R_View_ExtNode CDS 视图并将关联重定向到 _Root 到相应的投影 C_View。CDS 视图实体 I_View_ExtNode 预测 R_View_ExtNode CDS 视图并重定向到 I_View CDS 视图。

下图显示了此示例的 CDS 视图堆栈:。

在原始业务对象中包含扩展节点

扩展节点必须包含在现有数据模型中。与数据模型扩展一样,扩展节点必须包含在整个堆栈中。扩展 include 视图 R_View 通过强制成分关系扩展,该关系将 _ExtNode 定义为根视图实体的构成。使用关联 R_View_ExtNode 将相应的到父项关系建模为 association to parent R_View as _Root 的一部分。此相互关系将扩展节点定义为相关业务对象实体。然后,关联通过相应的重定向传播到 CDS 视图堆栈中。在此方面,扩展节点的建模方式与常规业务对象实体类似:

有关示例,请参阅将扩展节点添加到数据模型。

定义扩展节点的行为

扩展节点的行为在扩展 BDEF 中定义。扩展节点始终添加到父关系 - 因此权限和锁定行为始终建模为 dependent,行为派生自根节点。建议在扩展节点上使用 Etag master。您还可以指定用例所需的编号。在这种情况下,使用早期编号定义 ExtNode。此子节点为业务对象实体提供 update 和 delete 操作。创建操作通过 create by association 在具有 association _ExtNode{ create; with draft; } 的根节点上启用。ExtNode 还包含与 _Root 的反向关联。

在投影层上,C_View_BDEF 的 BDEF 扩展使用关键字 use 公开基础层中定义的行为。

有关示例,请参阅 扩展节点扩展的行为 和 将扩展节点添加到数据模型 。

祖先关联

如果将扩展节点添加到节点层次结构,您希望确保从此节点到相应权限和锁主数据的关联仍然有效,即使在原始业务对象中重新定义此主数据。为了灵活定义从扩展节点到相应主数据的关联,您需要在抬头部分中匿名定义相关性,并在节点层次结构中为上述每个节点提供所谓的上级关联,父节点除外。在运行时,框架将分别使用与所需主主数据的父级关联。

示例

业务对象层次结构:在此示例中,节点层次结构如下:根 - 子节点 - GrandChild (toParent) - ExtensionNode(扩展)

然后 ExtensionNode 的行为扩展定义如下:

示例代码

define behavior for ExtensionNode alias ExtNode using BO_Interface
persistent table perst_table
draft table table_d
etag master LastChangedAtTask
lock dependent
authorization dependent
...
{
  update;
  delete;

  field ( readonly ) ID;
  ...

  association _GrandChild { with draft; }
  ancestor association _ChildNode { with draft; }
  ancestor association _Root { with draft; }

}

有关语法的详细信息,请参阅 CDS BDL - 祖先关联(ABAP 关键字文档)。

在 OData 服务中包含扩展节点

当扩展节点已建模为数据模型和行为的一部分时,还需要将其作为 OData 服务的一部分包括在内。要包括扩展节点,必须为原始服务定义创建 Service Definition Extension。

有关示例,请参阅在服务公开中包含扩展节点。

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

← 行为扩展 · 开发 RAP 扩展 →