使用统计图可视化数据

ABAP RESTful 应用程序编程模型 › 开发 › 开发 UI 特定 › 定义元数据驱动的 UI 的 CDS 注释 › 对象页面 › 使用统计图可视化数据

使用图表可视化对象页面中的数据。

快捷信息

备注

对于 OData V2 服务,可以在 CDS 视图实体中建模图表。OData V4 仅限于微型统计图。有关微型图表的详细信息,请参阅微型图表构面在 SAP 网站上发布的信息

注释语法

@UI.facet: [ { id: '…', label: '…', position: <value>, purpose: #STANDARD, targetElement: '…', targetQualifier: '…', type: #CHART_REFERENCE, hidden: '…' } ]

描述

在对象页面上定义统计图的构面。

使用

置于代码的构面定义节中。

注释语法

@Aggregation.default: #…

描述

汇总给定元素的数据。

使用

要放置在 CDS 视图中,位于要聚合的元素上方。

备注

必须聚合数据,否则统计图不会显示有意义的数据,即将仅显示一个实例的数据。有关汇总数据的详细信息,请参阅在 SAP Fiori 应用中使用汇总数据。

注释语法

@UI.Chart: [ { title: '…', qualifier: '…', chartType: '…', dimensions: '…', measures: '…',measureAttributes: [ { measure: '…', role: #… } ], dimensionAttributes: [ { dimension: '…', role: #… } ], description: '…'} ]

描述

定义统计图本身。

使用

放置在 targetElement 或 @UI.facet 注释的相应元数据扩展中。

Fiori UI 上的预览

对象页面上的图表

在上下文中使用

要在对象页面上成功实施图表,您需要:

  1. 在父 CDS 视图中为图表定义构面

  2. 使用 @Aggregate.default 注释聚合数据。

  3. 使用 @UI.chart 注释定义图表本身。

为统计图定义构面

必须为统计图定义构面,以定义统计图在对象页面上的点和统计图的数据源。有关如何定义统计图构面的详细信息,请参阅以下示例代码。

annotate view Z_UI_TRAVEL with
{
...
@UI.facet: [
              { id:              'Chart1-ID',
                label:           'Chart facet',
                position:        10,
                purpose:         #STANDARD,
                type:            #CHART_REFERENCE,
                targetQualifier: 'Chart1',
                targetElement:   '_Booking'
              }
           ]
...
}

子注释语法

描述

id

定义构面的唯一标识符,可以自由选择。

label

定义构面的名称。如果未定义标签,则构面在 UI 上将不具有名称。

position

定义构面的位置。

purpose: #STANDARD

定义构面的用途。大多数情况下可以省略。

type: #CHART_REFERENCE

定义构面的类型。统计图只能在 type: #CHART_REFERENCE 的构面中显示。

targetQualifier

唯一标识符。由 qualifier 中 @UI.chart 注释的子注释 targetElement 引用。

targetElement

指定从中检索图表数据的位置。

备注

统计图只能在具有 purpose: #STANDARD 的构面中显示。具有 purpose: #HEADER 的构面不支持统计图。

聚合图表数据

要聚合数据,必须使用 @Aggregation.default 注释。在我们的示例中,我们使用此注释聚合所有航班价格并进行相应转换。我们还使用 注释聚合不同预订的数量。有关汇总数据的详细信息,请参阅在 SAP Fiori 应用中使用汇总数据。

define view Z_C_BOOKING_R
  as select from /dmo/booking as Booking
...
      @Semantics.amount.currencyCode: 'TargetCurrency'
      @Aggregation.default: #SUM
      CURRENCY_CONVERSION(
      amount             => Booking.flight_price,
      source_currency    => Booking.currency_code,
      target_currency    => cast( 'EUR' as abap.cuky ),
      exchange_rate_date => cast( '20200420' as abap.dats ),
      error_handling     => 'SET_TO_NULL' )                   as ConvertedFlightPrice,

      _Customer.CountryCode as CountryCode,

      @Aggregation.referenceElement: ['BookingID']
      @Aggregation.default: #COUNT_DISTINCT
      cast( 1 as abap.int4 )                                  as DistinctBookings,
...

备注

元数据扩展中不允许 @Aggregation 注释。因此,您必须将这些注释直接放置到 CDS 视图中。

定义统计图本身

请参阅以下示例代码,以更好地了解如何定义图表本身。请注意,您必须将此注释置于先前由 targetElement 指定的实体或其相应的元数据扩展中。

@UI.chart: [{
    qualifier: 'Chart1',   //refers to targetQualifier defined in chart facet in Z_C_TRAVEL_UI
    title: 'Flight Prices of this Travel by Airline',
    chartType: #COMBINATION_DUAL,
    dimensions: [ 'AirlineID'],
    measures: [ 'ConvertedFlightPrice', 'DistinctBookings'],
    measureAttributes: [ {measure: 'ConvertedFlightPrice', role: #AXIS_1},
                         {measure: 'DistinctBookings', role: #AXIS_2} ],
    dimensionAttributes: [ {dimension: 'AirlineID', role: #SERIES} ],
    description: 'Chart shows flight prices of travel by the airlines used per each booking.'
    }
]
...
annotate view Z_UI_BOOKING_U with {
...

子注释语法

描述

title

定义图表的标题。

qualifier

引用我们在 构面中设置的 targetQualifier。

chartType

定义统计图的类型。有多种可用的统计图类型。有关图表类型的详细信息,请参阅图表类型。

dimensions

定义图表的维度。不同的统计图类型需要不同数量的维。有关维度和相应图表类型的详细信息,请参阅图表类型。

measures

定义图表的度量。不同的统计图类型需要不同数量的度量。有关度量和相应图表类型的详细信息,请参阅图表类型。

measureAttributes

定义哪个度量将显示在哪个轴上。#AXIS_1 是左轴,#AXIS_2 是右轴。

dimensionAttributes

定义哪个维将成为 UI 上的主要维。#CATEGORY 是主维,#CATEGORY2 是次级维。请注意,在本示例中不使用 dimensionAttributes,因为我们仅使用一个维度。

description

图表的内部描述。

来源:SAP Help Portal · 2025 FPS02 (Oct 2026) · 中文为 SAP 官方机器翻译

← 在对象页面上动态隐藏字段 · 图表类型 →