启用节点扩展

ABAP RESTful 应用程序编程模型 › 扩展 › RAP 可扩展性启用 › 开发可扩展性启用 › 启用节点扩展

要允许扩展器将自己的扩展节点添加到数据模型,需要在原始业务对象中启用节点扩展。

所需的赋能步骤

扩展程序需要能够使用构成将其扩展节点从原始业务对象的根节点添加到扩展的 节点。因此,需要使用 CDS 视图 /DMO/R_AGENCYTP、/DMO/I_AGENCYTP 和 /DMO/C_AGENCYTP 中的相应 CDS 注释为新成分启用根节点。

由于扩展程序希望能够在其新节点中包含行为,因此需要在抬头部分中启用行为定义 /DMO/R_AGENCYTP。如果您遵循本指南之前的实施步骤,则您已将其作为启用非标准行为和字段相关行为章节的一部分完成。

在最后一步中,服务定义需要可扩展性启用,因为扩展节点需要公开以供服务使用。在使用 C0 合同发布服务定义之前,需要添加合适的供方合同。

前提条件

本指南假设您已为 启用标准行为扩展 中所述的标准行为启用业务对象。

为新成分启用 CDS 视图堆栈

  1. 在 CDS 视图 /DMO/R_AGENCYTP 中,将 CDS 注释 @AbapCatalog.extensibility.allowNewCompositions: true 添加到抬头部分中的现有 @AbapCatalog.extensibility 块。

    @AbapCatalog.extensibility: {
      extensible: true,
      elementSuffix: 'ZAG',
      allowNewDatasources: false,
      dataSources: ['_Extension'],
      quota: {
        maximumFields: 500,
        maximumBytes: 5000
      },
      allowNewCompositions: true
    }
    
  2. 在 CDS 视图 /DMO/I_AGENCYTP 中,将 CDS 注释 @AbapCatalog.extensibility.allowNewCompositions: true 添加到抬头部分中的现有 @AbapCatalog.extensibility 块。

    @AbapCatalog.extensibility: {
      extensible: true,
      dataSources: ['AGENCY'],
      elementSuffix: 'ZAG',
      quota: {
        maximumFields: 500,
        maximumBytes: 5000
      }, allowNewCompositions: true
    }
    

    备注

    建议添加 C1 发布合同,以指定此开发对象旨在作为稳定的使用数据源。

    出于维护原因,/DMO/ 参考内容的部件不会随定义的发布合同一起提供。

  3. 在 CDS 视图 /DMO/C_AGENCYTP 中,将 CDS 注释 @AbapCatalog.extensibility.allowNewCompositions: true 添加到抬头部分中的现有 @AbapCatalog.extensibility 块。

    @AbapCatalog.extensibility: {
      extensible: true,
      dataSources: ['Agency'],
      elementSuffix: 'ZAG',
      quota: {
        maximumFields: 500,
        maximumBytes: 5000
      }, allowNewCompositions: true
    }
    
  4. 在行为定义 /DMO/R_AGENCYTP 、 /DMO/I_AGENCYTP 和 /DMO/C_AGENCYTP 中,确保在标头部分指定关键字 extensible 。此外,确保在行为定义 /DMO/R_AGENCYTP 和 /DMO/C_AGENCYTP 中启用允许新成分的节点。

    如果您已遵循本指南的说明,则已在启用非标准行为和字段相关行为章节中完成所有操作。

  5. 在服务定义 /DMO/UI_AGENCY 中,将 CDS 注释 @AbapCatalog.extensibility.extensible: true 添加到抬头部分。此外,使用相应的供方合同将服务定义为 OData V2/V4 UI 服务。通过执行此操作,可确保只能添加与这些服务类型兼容的 CDS 视图。

    @EndUserText.label: 'Agency'
    @AbapCatalog.extensibility.extensible: true
    define service /DMO/UI_AGENCY
      provider contracts odata_v2_ui, odata_v4_ui {
      expose /DMO/C_AgencyTP as Agency;
    }
    

    备注

    我们建议您添加 C0 审批合同以指定此开发对象旨在作为稳定的扩展 API。

结果

现在,您已启用节点扩展的业务对象。

章节 Develop Node Extensions 显示如何基于实施的节点可扩展性启用使用现有节点扩展业务对象。

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

← 启用标准行为扩展 · RAP 扩展 →