行为扩展

ABAP RESTful 应用程序编程模型 › 扩展 › RAP 扩展 › 了解 RAP 扩展 › 行为扩展

行为扩展体系结构

备注

  • 只能在投影级别定义行为扩展,不需要实施类。

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

行为扩展允许您向原始 RAP 业务对象或已发布的 RAP 业务对象添加附加行为。本章仅涵盖现有 BO 实体的行为扩展。要添加具有自身行为和数据模型的新 BO 实体,请参阅节点扩展。

前提条件

行为扩展的前提条件是所需行为的可扩展性启用。仅当验证和确定在基础业务对象中显式定义为启用可扩展性时,才能定义验证和确定以及附加保存。有关行为扩展所需的可扩展性启用的详细信息,请参阅行为扩展的可扩展性启用。

行为扩展与业务对象接口之间的关系

您可以使用 RAP BO 基础和投影级别的扩展行为扩展业务对象的行为。在基础级别,您可以添加需要实施(如验证、确定或操作和函数)的行为。在投影级别,只能添加不需要实施的行为扩展。

行为扩展存储在 Behavior Definitions Extension 中,其标头必须始终使用 BO 接口。有关开发对象及其定义的详细信息,请参阅 CDS BDL - BDEF 扩展(ABAP - 关键字文档)。

BDEF 扩展只能参考业务对象接口中公开的实体 - 如果业务对象接口仅包含基础数据模型的业务对象实体的子集,则只能使用扩展行为丰富公开的实体。业务对象接口还决定向扩展公开哪些其他功能,例如草稿功能。即使基础数据模型本身已启用草稿,但业务对象接口未显式公开草稿行为,行为扩展也只能在其实施中访问活动实例,并且无法使用 %is_draft 标识。

对于此示例,按如下方式生成 implementation_class 的类定义:

示例代码

CLASS implementation_class DEFINITION INHERITING FROM cl_abap_behavior_handler.

    METHODS get_instance_features FOR INSTANCE FEATURES
      IMPORTING keys REQUEST requested_features FOR Root RESULT result.

    METHODS ext_val FOR VALIDATE ON SAVE
      IMPORTING keys FOR Root~ext_val.

    METHODS get_instance_authorizations FOR INSTANCE AUTHORIZATION
      IMPORTING keys REQUEST requested_authorizations FOR Root RESULT result.

    METHODS ext_action FOR MODIFY
      IMPORTING keys FOR ACTION Root~ext_action RESULT result.

ENDCLASS.

基础级别的行为扩展

基础级别的 BDEF 扩展包含您要添加到数据业务对象的实际新行为。您拥有在原始业务对象上启用的所有行为选项。示例扩展定义了扩展操作 ext_action,其中在 CDS 数据模型扩展中添加了实例功能控件和扩展字段 ext_field validation on save。BDEF 扩展从原始业务对象继承其基本特征,例如编号和权限。草稿功能、etag 处理和严格版本继承自使用的业务对象接口。

如果使用 authorization(global, instance) 定义原始业务对象,则使用实施出口 FOR INSTANCE AUTHORIZATION 和 FOR GLOBAL AUTHORIZATION 生成 BDEF 扩展的行为池。在示例中,仅定义实例权限,因此仅生成实施出口 FOR INSTANCE AUTHORIZATION。您可以通过在 BDEF 扩展中定义操作权限来否决基础业务对象权限主数据中的权限控制定义。权限实施出口的派生类型减少为 BDEF 扩展中的元素 - 无法为基本业务对象中的元素定义附加权限。BDEF 扩展继承了业务对象接口 I_View_BDEF 中公开的草稿功能(具有 use draft;)和 strict(2) 的属性。

在示例中,确定操作 PREPARE 通过附加验证 ext_val 进行扩展,以确保正确处理来自此验证的状态消息。

备注

为了扩展字段映射信息,如果扩展存储在与原始业务对象不同的软件组件中,请使用关键字 extend mapping for。

预测级别的行为扩展

投影级别的 BDEF 扩展公开在基础业务对象级别定义的扩展行为。在此示例中,BDEF 扩展公开操作 ext_action 以将其在 OData 服务中公开。

行为扩展中的编号

关键字段的编号行为继承自原始业务对象实体,无法在行为扩展中更改。有关编号的更多信息,请参阅编号。

行为扩展中的权限

备注

无法扩展预检查,但可以在实施中实施自己的预检查。

通常,权限继承自基础 RAP BO,并在运行时调用相应的实施以进行全局权限和标准操作。除操作外,无法在扩展实施中重新定义在原始业务对象中定义的权限实施。

备注

如果使用扩展操作扩展业务对象行为,则必须始终为这些操作定义权限控制。您可以使用基础业务对象的权限主数据中定义的相同权限控制,也可以定义其他权限并替换操作的权限主数据的权限控制。这样可以实现扩展操作权限的一致性。

您可以在行为定义扩展的行为池中为扩展元素定义附加权限,例如,针对已在行为定义扩展中添加的扩展操作或功能。

有关权限的详细信息,请参阅权限控制。

行为扩展中的并发控制

BDEF 扩展的并发控制处理由业务对象接口确定。如果原始 BO 使用 etag 处理,并且 BO 接口通过 use etag 公开 etag 处理,则原始 BO 中定义的 etag 处理也将应用于 BDEF 扩展中的行为。有关更多信息,请参阅乐观并发控制。如果业务对象接口公开草稿处理,则始终应用总计 Etag。

如果 ETag 处理未由 BO 接口公开,则缺省应用悲观并发控制。有关详细信息,请参阅悲观并发控制(锁定)。

草稿特定扩展行为

在草稿操作中,只有确定操作 PREPARE 可扩展。您可以添加已在 BDEF 扩展中定义的确定和验证,以确定扩展中的操作 PREPARE。建议确保正确处理消息。

通常,如果业务对象接口已启用草稿,则只能在扩展中扩展或定义操作。有关更多信息,请参阅草稿。

关于行为扩展中的行为和操作

扩展中的标准操作

业务对象实体的标准操作定义为原始业务对象的一部分。如果原始业务对象未将 Delete 操作定义为其行为的一部分,则无法在 BDEF 扩展中添加此操作。有关标准操作的详细信息,请参阅标准操作。

扩展中的操作和函数

操作和功能遵循与非扩展用例中相同的规则。有关详细信息,请参阅非标准工序。

行为扩展中的验证和确定

仅当为验证和确定启用原始业务对象时,才能使用其触发条件定义验证和确定,否则会导致 BDEF 扩展中出现语法错误。

扩展验证或确定可以使用扩展字段或原始字段作为其触发条件的一部分,但在实施中,字段在运行时的处理方式不同。有关详细信息,请参阅扩展中的 in local mode。

有关所需启用,请参阅行为扩展的可扩展性启用。

备注

如果将扩展字段定义为 mandatory 且基本业务对象未针对 validations on save 启用扩展,则无法在扩展中实施检查来强化 mandatory 属性,并且只能在用户界面上用作使用者提示。

行为扩展中的静态和动态功能控制

在行为定义扩展中,只能为扩展元素定义附加静态和动态功能控件。无法为原始业务对象的元素重新定义功能控制。在映射视图的扩展中,您只能定义扩展字段的静态功能控制。无法定义动态功能控制。

有关功能控制的详细信息,请参阅功能控制。

行为扩展中的保存选项

可用保存选项遵循与非扩展用例中相同的规则。您可以在扩展中定义 addtional save 和 unmanaged save。Addtional save 仅适用于管理的实施类型。

有关更多信息,请参阅保存选项。

消息和 EML 特定的扩展行为

扩展中的消息

扩展消息由基本业务对象的业务对象提供者框架处理,并且相同的指导原则适用于状态和转换消息之间的区别。

备注

建议在扩展中使用与原始业务对象中定义的字符串不同的不同 %state_area 字符串。如果使用相同的 %state_area,则属于相应 state_area 的所有状态消息将同时失效。

有关消息的详细信息,请参阅消息。

扩展中的 in local mode

从使用者的角度来看,您无法区分是使用扩展的一部分还是原始基础业务对象的一部分。但是,根据元素属于扩展还是原始业务对象,隐式框架行为会有所不同。

如果在扩展的行为池中使用 in local mode,则行为会有所不同。通常,in local mode 用于规避权限和功能控制检查。对于属于扩展的所有元素,此操作按预期工作。如果在具有附加项 in local mode 的原始 BO 元素的扩展实施中执行 EML 修改,则无论如何都会执行原始业务对象的权限和功能控制检查,即使指定了 in local mode 也无法在实施中绕过。

在 UI 上公开扩展行为

如果不仅要在 OData 服务中包含类似行为的操作,还希望在 UI 上包括类似行为的操作,则必须使用相应的 UI 注释使操作或其他行为在 UI 上可见。

有关 UI 注释的详细信息,请参阅 CDS 注释。

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

← CDS 数据模型扩展 · 节点扩展 →