在 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'] |
引用用于不同计数的元素。
备注
只能与 @Aggregation.Default: #COUNT_DISTINCT 结合使用。 |
一个元素上只能使用一个聚合函数。无法显示同一元素的不同聚合值。
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
}
备注
聚合函数仅考虑具有相同语义的值。这意味着,如果您拥有使用聚合注释注释的不同货币的价格,则会收到每种货币的聚合数据。
下图显示与相应货币相关的最大税额。
