聚合注释的 OData V2 解释
ABAP RESTful 应用程序编程模型 › 开发 › 开发通用功能 › 在 SAP Fiori 应用中使用汇总数据 › 聚合注释的 OData V2 解释
以下部分提供 OData 中聚合实体最突出功能的概览。
具有聚合注释的数据模型由 OData 视为聚合实体。这些聚合 OData 实体的行为与非聚合实体不同。
OData 注释
根据您在 CDS 中用于数据模型的聚合注释,为 OData 实体提供多个注释。下图显示了处理销售订单项目的聚合实体的元数据。特定于聚合的注释将突出显示并标记。下面介绍了 OData 中注释的更多说明。

聚合的 OData 实体
使用聚合注释 @Aggregation.Default: #<AGGR_FUNCTION> 注释 CDS 视图中的一个元素后,OData 实体就会使用 sap:semantics= "aggregate" 进行注释。因此,OData 实体标识为聚合实体。
在上面的屏幕截图中,可在元数据提取的第一行中找到此 OData 注释。
度量
聚合实体以度量和维度为特征。度量是使用与 CDS 中聚合数据相关的注释注释的属性。为“措施”提供 OData 注释 sap:aggregation-role="measure"。
在上面的屏幕截图中,有六个属性标记为度量:ConvertedGrossAmount、GrossAmount、NetAmount、TaxAmount、AllItems 和 DistinctProducts。
维度
维是指既未标记为度量也未标记为特性的所有属性。为维度提供 OData 注释 sap:aggregation-role="dimension"。
在上面的屏幕截图中,有六个 OData 属性被标记为维:SalesOrderID、ItemPosition、Customer ID、Product、CurrencyCode 和 TargetCurrency。
每个维最多只能有一个文本属性。文本属性是在 CDS 中定义为文本元素的元素,如使用文本元素中所述。具有文本属性的维由 OData 通过 sap:text="<TEXT_PROPERTY>" 进行注释。
在上面的屏幕截图中,维 Product 具有文本属性。
属性
维可以具有特性。属性是使用注释 @Consumption.groupWithElement: 'ElementRef' 注释的元素。特性始终被视为对其相应维的补充。属性由 OData 通过 sap:attribute-for="<DIMENSION>" 进行注释。
在上面的屏幕截图中,维 CustomerID 具有特性 CompanyName,维 Product 具有特性 ProductCategory。
聚合 OData 实体的已生成标识
为聚合 OData 实体提供已生成标识的附加属性 (<Property Name="ID"/>)。为聚合实体生成的标识唯一标识每个记录,以便给定标识的每个实体请求始终返回相同的值。
在上面的屏幕截图中,可以在列表中找到已生成标识的 属性作为第一个属性。
首次请求时,还会为每个组记录生成标识。之后,您可以在其他请求中使用此标识。
示例
此行为由提供上述元数据的实体上的请求来举例说明。检索销售订单项目。以下请求选择生成的标识( ID )、维 Product 以及与选定维相关的某些聚合度量。
.../sap/opu/odata/SAP/<service_name>/ZDEMO_C_SOI_ANLY?$select=ID,Product,GrossAmount,NetAmount,TaxAmount,AllProducts
此请求检索以下结果:

每个组记录都有其自己的生成标识,用于在再次请求时检索相同的结果。基于此组标识,您还可以执行其他请求,如 /sap/opu/odata/SAP/<service_name>/ZDEMO_C_SOI_ANLY('.4~HT%26c1002.6~USD')?$select=AllProducts,后者将仅检索此组的计数,即 9。
从聚合实体请求数据
从聚合实体请求数据的结果取决于您在 OData 请求中选择的元素。分组和聚合均由您在实体集查询中使用参数 $select 请求的元素驱动。查询结果由具有所请求维度属性的不同值的聚合实体组成,并且请求的度量使用聚合函数进行聚合,其中度量元素在 CDS 中进行注释。
如果请求了特性,则结果按其相应的维分组,在该组中,结果按特性本身分组。
备注
如果使用 SAP Fiori 应用,OData 请求的
$select语句直接取决于您在清单报表应用中选择的列。还可以通过在 Fiori 应用中选择相应的列来管理使用 OData 请求数据的以下描述。
包含所有主键元素的请求
如果请求的 CDS 实体的所有主键元素都包含在查询选项 $select 中,则无法执行分组,因为每条记录都是唯一的。因此,具有所有关键元素的 OData 请求的行为就像非聚合实体一样。因此,不计算聚合数据。
不包含所有主键元素的请求
如果并非所有关键元素都包含在 OData 请求中,则会对请求的维进行分组,并根据其带注释的聚合函数聚合请求的度量。对于维度值的每个不同组合(评估 $filter 后),结果包括具有请求度量聚合值的聚合实体。
备注
每个组记录都有其自己的生成标识,可以在请求中重用以检索相同的结果。
仅当未请求维度和属性时,结果才会显示整个实体集的度量聚合数据。
您仍然可以对分组的请求执行其它查询选项,例如 $filter 或 $orderby。过滤在分组之前执行,以便在过滤后根据可用记录创建组。排序在分组后执行,这意味着组中的记录根据 查询选项进行排序。
备注
您可以过滤未选择的属性,但由于上述查询选项的执行顺序,无法按未包含在 $select 中的属性进行排序。
从组记录导航和展开
您可以直接从组记录导航到组中包含的其中一个属性,例如之前选择的属性。
示例
假设您具有销售订单项目的聚合实体,并按产品对其进行分组。如果关联存在于 CDS 中,则可以从此组记录直接导航到产品的关联实体。
对于查询选项 $expand 也是如此。只能展开所选属性。
备注
如果基础数据模型也进行聚合,则导航或展开的目标实体也会获得聚合标识。