在 CDS 中对聚合函数进行注释

ABAP RESTful 应用程序编程模型 › 开发 › 开发通用功能 › 在 SAP Fiori 应用中使用汇总数据 › 在 CDS 中对聚合函数进行注释

要在 SAP Fiori 应用中显示聚合数据的元素必须在 CDS 实体中使用聚合函数的相关注释进行注释。

聚合的元数据

注释 @Aggregation.Default: #<AGGR_FUNCTION> 启用注释元素值的聚合。

只有度量可以使用聚合注释进行注释。度量是表示数值的元素,这意味着可以求和、求平均值,也可以进行数学操作。通常,度量是表示某事物的大小、金额或程度的单位,例如价格。此外,具有日期值的元素也可以相互比较以确定最大值或最小值。这意味着日期值也可以是用于计算最小值或最大值的度量。

CDS 实体中的其他元素称为维度。维度提供有关其他无序数字度量的结构化标签信息。它们与 Fiori 应用中元素的分组和顺序相关。

SADL 框架支持以下度量聚合功能。只要使用其中一个注释注释一个元素,就会将 CDS 实体视为分析实体。

备注

只有具有数字数据类型的元素才能使用 @Aggregation 注释进行注释。

注释和值

影响

@Aggregation.Default: #SUM

计算注释元素值的总和。

@Aggregation.Default: #MAX

计算注释元素值的最大值。

您还可以使用此注释使用日期类型注释元素。

@Aggregation.Default: #MIN

计算注释元素值的最小值。

您还可以使用此注释使用日期类型注释元素。

@Aggregation.Default: #AVG

计算注释元素值的平均值。

@Aggregation.Default: #COUNT_DISTINCT

计算注释元素非重复值的数量。

结合注释 @Aggregation.ReferenceElement: ['elementRef'],您可以计算所引用另一元素的非重复值数量。

@Aggregation.ReferenceElement: ['elementRef']

引用用于不同计数的元素。

一个元素上只能使用一个聚合函数。无法显示同一元素的不同聚合值。

Fiori 元素 UI 中的聚合

在 Fiori 元素 UI 中,记录始终按 OData 请求中 $select 选择的维度进行分组。OData 请求中 $select 的元素是在 Fiori UI 中选择的列元素。

如果在 Fiori UI 中选择关键元素,则记录按这些关键元素分组,这意味着没有分组,因为没有可以按同一关键元素分组的记录。如果未请求所有关键元素,则会按请求的维度对记录进行分组,并根据组聚合所选度量。

如果要禁止行为,在未选择所有关键元素的情况下自动分组记录,则可以使用 @UI 注释,该注释触发始终隐式选择关键元素。

注释和值

影响

@UI.presentationVariant:
	[{requestAtLeast: ['<TECHNICAL_KEY>']}]

定义在不需要分组的情况下,必须始终包含在已查询集合的结果中的属性。

UI 提供显式分组选项。在 UI 上,转到设置并定义分组依据的维度,或单击维度列并选择组。

有关分组的更多信息,请参阅 聚合注释的 OData V2 解释 。

示例

以下列表显示了一个使用分析操作所有必要注释的 CDS 实体。此视图描述销售订单以及相关产品和客户信息。

展开以下代码示例以查看源代码

示例代码

define view entity ZDEMO_C_SOI_ANLY
  as select from <data source> as Item

  association [0..1] to SEPM_I_Product_E as _Product    on $projection.Product = _Product.Product
  association [0..1] to ZDEMO_C_SO_ANLY  as _SalesOrder on $projection.SalesOrderID = _SalesOrder.SalesOrder

{
  key SalesOrder                                                    as SalesOrderID,

  key SalesOrderItem                                                as ItemPosition,

      Item._SalesOrder.Customer                                     as CustomerID,

      Item._SalesOrder._Customer.CompanyName                        as CompanyName,

      @ObjectModel.foreignKey.association: '_Product'
      Product                                                       as Product,

      _Product.ProductCategory                                      as ProductCategory,

      @Semantics.currencyCode: true
      TransactionCurrency                                           as CurrencyCode,

      @Semantics.currencyCode: true
      cast( 'EUR' as abap.cuky )                                    as TargetCurrency,

      @Aggregation.Default: #SUM
      @Semantics.amount.currencyCode: 'TargetCurrency'
      CURRENCY_CONVERSION(
      amount             => Item.GrossAmountInTransacCurrency,
      source_currency    => Item.TransactionCurrency,
      target_currency    => cast( 'EUR' as abap.cuky ),
        exchange_rate_date => cast( '20180315' as abap.dats ),
        error_handling     => 'SET_TO_NULL' )                       as ConvertedGrossAmount,

      @Semantics.amount.currencyCode: 'CurrencyCode'
      @Aggregation.Default: #AVG
      GrossAmountInTransacCurrency                                  as GrossAmount,

      @Semantics.amount.currencyCode: 'CurrencyCode'
      @Aggregation.Default: #MIN
      NetAmountInTransactionCurrency                                as NetAmount,

      @Semantics.amount.currencyCode: 'CurrencyCode'
      @Aggregation.Default: #MAX
      TaxAmountInTransactionCurrency                                as TaxAmount,

      @Aggregation.referenceElement: ['Product']
      @Aggregation.Default: #COUNT_DISTINCT
      cast( 15 as abap.int4 )                                       as DistinctProducts,

      _SalesOrder,
      _Product
}

备注

聚合函数仅考虑具有相同语义的值。这意味着,如果您拥有使用聚合注释注释的不同货币的价格,则会收到每种货币的聚合数据。

下图显示与相应货币相关的最大税额。

聚合不同货币的数据