CDS 视图的可扩展性启用

ABAP RESTful 应用程序编程模型 › 扩展 › RAP 可扩展性启用 › 了解可扩展性启用 › CDS 数据模型扩展的扩展性启用 › CDS 视图的可扩展性启用

CDS 视图的可扩展性启用基于一种选择性加入方法,允许完全控制可能的扩展和扩展数量。通过使用注释,您可以定义是否允许添加新数据源或成分。

CDS 启用体系结构

下图显示了整个 CDS 数据模型的最佳实践体系结构,其中包含一个示例扩展字段,用于扩展含草稿的 RAP BO 的数据模型。

要为扩展开发强大的 CDS 体系结构,请使用扩展 include 视图。这会将 Extend (C0) 审批合同产生的约束限制为 E_View 和 R_View,而 R_View 下的 CDS 视图堆栈仍可灵活更改。扩展 include 视图 E_View 与原始 R_View 相关联,并绕过原始 R_View 下的视图堆栈从原始数据库中选择。

模型包含 CDS 视图 Draft_Query_View,因为业务对象已启用草稿。草稿查询视图在相应行为定义中使用,以直接从草稿表中读取内容。由于扩展包含文件结构包含在两个表中,因此必须扩展 E_View 和 Draft_Query_View 以将扩展字段添加到数据模型。

稍后使用扩展字段和关联扩展的每个 CDS 视图都必须通过相应的注释增强,然后才能为 Extend (C0) 发布 CDS 视图。然后,由扩展提供者使用扩展字段和关联将这些 CDS 视图扩展到整个堆栈。

有关语法的详细信息,请参阅 ABAP CDS - 扩展 CDS 视图(ABAP 关键字文档)。

含草稿的业务对象中的草稿查询视图

如果业务对象已启用草稿并且您想要将 Extend (C0) 用于 RAP BO,则必须在行为定义中指定草稿查询视图。

数据模型的基本可扩展性启用

数据模型需要使用可扩展性注释进行增强,这些注释定义了扩展提供者的可能扩展的类型和范围。如果要为 Extend (C0) 审批合同发布 CDS 视图,则这些注释是前提条件。

基本可扩展性启用

备注

如果注释根本未设置,则缺省情况下,CDS 视图实体被视为可扩展。

需要将 CDS 视图定义为可扩展以启用任何类型的扩展。注释 @AbapCatalog.extensibility.extensible 必须设置为 true。或者,对于 CDS 视图,还可以使用注释 @AbapCatalog.viewEnhancementCategory。对于节点可扩展性,注释 @AbapCatalog.extensibility.allowNewCompositions: true 是必需的前提条件。

在 UI 上显示扩展元素

您需要在 RAP 业务对象的投影层定义注释 @Metadata.allowExtensions: true,以便可以使用元数据扩展将扩展元素添加到 UI。

后缀启用

CDS 实体需要定义元素后缀,该后缀需要由扩展字段和关联使用。注释 @AbapCatalog.extensibility.elementSuffix 允许您定义后缀。如果扩展关联不使用后缀,则会出现语法错误。

配额支持

CDS 实体需要定义配额定义,用于指定扩展内容的容量。注释 @AbapCatalog.extensibility.quota.maximumFields 使您能够定义最大可能的扩展字段数,使用注释 @AbapCatalog.extensibility.quota.maximumBytes,您可以定义为扩展提供者保留的最大字节容量。如果要发布 C0 的数据源,则两个注释都是必需的。选择的最大字段数应高于在数据库级别指定的字段数,以便考虑非规范化或计算字段等。最大字节容量需要按照最大字段数的适当比例进行选择,例如 maximumBytes = maximumFields * 100。

稳定数据源启用

需要为原始 CDS 视图中包含的关联定义稳定的别名,以确保消费者的稳定性。审批合同的 CDS 视图发布后,无法更改别名。您可以使用注释 @AbapCatalog.extensibility.dataSources 定义相应的别名。

扩展数据源和构成

必须为新关联、新数据源和成分显式启用原始数据源。如果不是这种情况,则无法向数据模型引入新数据源或成分。注释 @AbapCatalog.extensibility.allowNewDatasources 允许您添加新数据源。这些数据源需要遵守相应的稳定性要求。

注释 @AbapCatalog.extensibility.allowNewCompositions 允许您为新成分启用数据模型。如果要启用节点可扩展性,则必须满足此要求。有关节点可扩展性启用的详细信息,请参阅节点可扩展性的可扩展性启用。

有关在引入扩展关联或构成时要考虑的内容的详细信息,请参阅 CDS 数据模型扩展。

审批合同

定义可能的扩展可能性以及可扩展性配额(如有必要)后,您可以在 Extend (C0) 审批合同的数据模型中发布 CDS 视图。

字段映射

需要在字段映射的扩展中映射扩展字段。因此,扩展字段需要字段映射启用。有关详细信息,请参阅行为扩展的可扩展性启用