派生的业务事件

ABAP RESTful 应用程序编程模型 › 开发 › 开发业务事件 › 派生的业务事件

上下文

开发 RAP 业务事件涉及其有效负载的定义及其实施。如果要使用具有不同有效负载的已实施事件,则可以使用派生事件。派生事件是参考已实施的事件定义的,并允许定义偏离参考事件的有效负载。

使用 CDS 实体重新定义有效负载。要建模派生事件,输入参数必须满足以下要求:

  • 输入参数必须是没有任何关联的 CDS 视图实体。

  • 派生事件的输入参数必须为扁平。

  • 用作输入参数的视图实体的键值字段必须与为其定义参考事件的实体的键值字段匹配。

引发此参考事件时,派生事件也会与其自定义有效负载一起引发。派生事件可以在行为定义和行为定义扩展中定义。遵循此声明性方法,无需在行为池中进行附加实施。

有关详细信息,请参阅 RAP 事件(ABAP 关键字文档)

过程

开发派生事件包括事件有效负载的 CDS 视图的定义,以及行为定义或行为定义扩展中派生事件本身的定义。派生事件的有效负载的键值字段需要匹配为其定义参考事件的实体的关键字段。

扩展中派生事件的前提条件

如果在行为定义扩展中定义派生事件,则以下前提条件适用于原始业务对象:

  • 包含派生事件参考的事件的业务对象需要启用可扩展性,如 RAP 可扩展性启用中所述。

  • 派生事件引用的事件需要在 C0 和 C1 发布的 RAP BO 接口中公开。如果引用的事件已添加到行为扩展中,则会在 RAP BO 接口中隐式公开。

  • 需要发布用作派生事件有效负载的数据源的 CDS 视图实体。

示例

以下示例的基础是可扩展性数据模型,如数据建模和行为中所述。在此示例中,为在 Agency 业务对象(包 /DMO/FLIGHT_REUSE_AGENCY_REV_D)的节点扩展中引发的事件 /DMO/AgencyReviewCreated 定义具有自定义有效负载的派生事件。

  1. 为从 CDS 视图实体 /DMO/ZZ_P_AGENCYREVIEW_CONTACT 中选择的 CDS 视图实体 /DMO/I_Agency 创建数据定义。将关键字段 AgencyID 以及字段 Name 和 PhoneNumber 添加到选择列表中。创建的 CDS 视图实体将为派生的事件提供有效负载。

    备注

    请记住,此 CDS 视图实体用于数据选择。如果未选择数据,则不会引发事件。在删除与视图具有相同源的数据后引发事件时,这一点很重要。

    @EndUserText.label: 'Agency Extension: Derived Event'
    @AccessControl.authorizationCheck: #NOT_REQUIRED
    define view entity /DMO/ZZ_P_AgencyReview_Contact
      as select from /DMO/I_Agency
    {
      key AgencyID,
          Name,
          PhoneNumber
    }
    
  2. 在行为定义的上下文菜单中 /DMO/R_AGENCYTP,选择选项新建行为扩展。

  3. 在 BDEF 扩展创建对话框中,输入要存储 BDEF 扩展的包的名称以及名称 /DMO/ZZ_X_REV_CNTCT_R_AGENCYTP、描述和 BO 接口 /DMO/I_AGENCYTP。

  4. 从生成的行为定义扩展中移除关键字 implementation in class...。

    生成的 BDEF 扩展如下所示:

    extension using interface /dmo/i_agencytp;
    
  5. 添加关键字 extend behavior for /DMO/Agency { }。现在可以在花括号中定义派生的事件。

    extension using interface /dmo/i_agencytp;
    
    extend behavior for /DMO/Agency
    {
    
    }
    
  6. 参考现有事件 /DMO/AgencyReviewCreatedCntct 定义名称为 /DMO/AgencyReviewCreated 的派生事件。将 CDS 视图实体 /DMO/ZZ_P_AgencyReview_Contact; 定义为派生事件的有效负载。

    extension using interface /dmo/i_agencytp;
    
    extend behavior for /DMO/Agency
    {
      managed event /DMO/AgencyReviewCreatedCntct on /DMO/AgencyReviewCreated parameter /DMO/ZZ_P_AgencyReview_Contact;
    }
    

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

← 业务事件 · 开发 API →