Metadata.allowExtensions 注解的一个实际使用例子

举报
汪子熙 发表于 2023/10/28 09:41:28 2023/10/28
【摘要】 @UI 注解随着 SAP 标准的 Fiori Elements 应用一起发布。如果 SAP 发布的标准 CDS view 包含了 @Metadata.allowExtensions:true 的注解,意味着 Partner 或者其他 Industry Solution 可以通过 Extension view 的方式来 override 标准 CDS view 里的 annotation,前提...

@UI 注解随着 SAP 标准的 Fiori Elements 应用一起发布。

如果 SAP 发布的标准 CDS view 包含了 @Metadata.allowExtensions:true 的注解,意味着 Partner 或者其他 Industry Solution 可以通过 Extension view 的方式来 override 标准 CDS view 里的 annotation,前提是这些 Extension 不能修改标准 CDS view 的 DDL.

下图是一个例子:

@Metadata.allowExtensions:true 是 SAP Fiori Elements 中的一个重要注解,用于允许合作伙伴或行业解决方案提供商通过扩展视图的方式,来覆盖标准的CDS(Core Data Services)视图中的注解内容,而不修改标准CDS视图的数据定义语言(DDL)。这个注解的作用非常关键,因为它允许了对Fiori Elements应用的定制化,使其适应各种不同的业务需求和行业标准。

在本文中,我将详细解释@Metadata.allowExtensions:true的作用、使用方法以及如何通过示例来说明其功能。

1. 了解@Metadata.allowExtensions:true

首先,让我们深入了解@Metadata.allowExtensions:true注解的关键方面:

  • 作用:该注解的主要作用是允许在标准CDS视图上创建扩展视图,并在扩展视图中覆盖标准CDS视图上的注解。这使得合作伙伴或行业解决方案提供商可以通过扩展定制化Fiori Elements应用,以满足不同的业务需求,而无需修改标准CDS视图的数据定义。

  • 限制:@Metadata.allowExtensions:true的使用有一些限制,其中最重要的是不能修改标准CDS视图的DDL。这意味着扩展视图可以改变标准CDS视图上的注解,但不能更改其表结构、字段定义或主键等关键元素。

  • 扩展视图:扩展视图是一种特殊的CDS视图,它通过继承标准CDS视图并应用@Metadata.allowExtensions:true注解来实现。扩展视图中可以添加、修改或删除标准CDS视图上的注解,以满足特定的需求。

  • 合作伙伴和行业解决方案提供商:这个功能主要针对SAP的合作伙伴和行业解决方案提供商,使他们能够为特定行业或客户提供高度定制化的Fiori Elements应用,而不会影响标准CDS视图的稳定性和兼容性。

2. 使用示例说明@Metadata.allowExtensions:true

为了更清晰地理解@Metadata.allowExtensions:true的功能,让我们通过一个示例来说明它的用法。

假设您是一个合作伙伴,您希望为标准的SAP销售订单Fiori Elements应用添加一些自定义功能,而不改变销售订单CDS视图的结构。以下是示例:

步骤1:创建标准CDS视图

首先,SAP提供了一个标准的CDS视图,表示销售订单数据。这个CDS视图包含一些默认的注解,用于定义显示和行为。

@AbapCatalog.sqlViewName: 'ZSALESORDER'
@AbapCatalog.compiler.compareFilter: true
@AccessControl.authorizationCheck: #CHECK
@EndUserText.label: 'Sales Order'
define view ZSalesOrder as select from sord as so {
  key so.salesOrder as SalesOrder,
  so.customer as Customer,
  so.orderDate as OrderDate
} where so.salesOrderType = 'OR'.

步骤2:创建扩展视图

接下来,您可以创建一个扩展视图,以覆盖标准CDS视图上的注解。在扩展视图上,您可以添加自定义的注解,以改变Fiori Elements应用的行为。请注意,这个扩展视图必须应用@Metadata.allowExtensions:true注解。

@Metadata.allowExtensions: true
extend view ZSalesOrder with {
  @UI.lineItem: [ { position: 10, importance: #HIGH } ]
  @UI.headerInfo: {
    typeName: '{i18n>ZSalesOrder.SalesOrderTypeName}',
    typeNamePlural: '{i18n>ZSalesOrder.SalesOrderTypeNamePlural}',
    title: '{i18n>ZSalesOrder.SalesOrderTitle}',
    description: '{i18n>ZSalesOrder.SalesOrderDescription}'
  }
  @UI.selectionField: [ { position: 20, importance: #HIGH } ]
  @UI.lineItem: [ { position: 30, importance: #HIGH, label: '{i18n>ZSalesOrder.Customer}' } ]
}

在这个扩展视图中,我们添加了一些自定义的UI注解,以改变销售订单Fiori Elements应用的外观和行为。例如,我们调整了行项目的位置、标题和描述,并指定了某些字段作为选择字段。

步骤3:使用扩展视图

现在,您可以在应用中使用扩展视图而不是标准CDS视图。Fiori Elements应用将根据扩展视图上的注解进行渲染,从而实现了个性化定制,而无需修改标准CDS视图。

<AnnotationTerm Term="Common.EntitySet" Qualifier="SalesOrderSet">
  <AnnotationPath Target="ZSalesOrder"/>
</AnnotationTerm>

在这个示例中,我们通过AnnotationPath将扩展视图应用于特定的实体集。

步骤4:实现个性化定制

现在,您可以在Fiori Elements应用中看到自定义的注解生效。例如,销售订单列表中的字段位置、标题和描述都会根据扩展视图上的注解进行调整,而不会影响标准CDS视图的结构。

这样,您就可以为您的客户提供一个高度定制化的Fiori Elements应用,以满足其特定的业务需求,同时仍然可以享受标准CDS视图的稳定性和升级性。

3. 总结

@Metadata.allowExtensions:true

是SAP Fiori Elements中的关键注解,允许合作伙伴和行业解决方案提供商通过扩展视图的方式对标准CDS视图进行注解覆盖,从而实现Fiori Elements应用的个性化定制,而无需修改标准CDS视图的DDL。这一功能非常重要,因为它保证了应用的稳定性和兼容性,同时允许根据具体业务需求进行灵活的定制化。

通过上述示例,我们详细说明了@Metadata.allowExtensions:true的作用和用法,以及如何创建扩展视图来实现个性化定制。这个功能使得SAP Fiori Elements应用更加灵活和适应不同行业和客户的需求,为企业提供了强大的工具来定制和扩展其应用。

【版权声明】本文为华为云社区用户原创内容,转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息, 否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。