SuperAPI AI 工具集

sap-fiori-analytical-chart

前端与建站

查看项目

更新于 10-15 19:47

技能介绍

用途:在 SAP Fiori Elements 的 List Report 中加入分析图表(图表与表格混合视图),以聚合数据形式展示。支持 CAP 与 ABAP RAP(OData V4)。

前提:CAP 可用 VS Code 或 SAP Business Application Studio(Fiori MCP Server 仅 VS Code 需要);ABAP RAP 仅支持 VS Code,并需 ABAP Development Tools 扩展与 Fiori MCP Server。实施前必须先向用户确认实体、维度字段、度量字段、聚合方式、图表类型(Bar、Column、Line、Pie、HeatMap、Waterfall、HorizontalWaterfall)和显示模式(独立标签页或混合视图)。

主要能力与用法:

  • CAP:在 CDS 中启用聚合(@Aggregation.ApplySupported,Transformations 含 aggregate、groupby),用 Analytics.AggregatedProperty 定义聚合属性,AggregationMethod 必须为小写字符串(sum、min、max、average、countdistinct),再定义 UI.Chart 与 UI.PresentationVariant(ChartView、TableView),使用 DynamicMeasures。
  • ABAP RAP:三步加 manifest 配置,禁止编辑只读的 metadata.xml。投影视图(ZC_*,TRANSACTIONAL_QUERY 契约)必须加 @OData.applySupportedForAggregation: #FULL,度量字段加 @Aggregation.default: #AVG/#SUM/#MIN/#MAX;元数据扩展(DDLX)在实体头级添加 @UI.chart 与 @UI.presentationVariant(不可放在字段上);DDLS 与 DDLX 是两个独立对象,需分别激活。
  • Manifest:混合视图用 primary/secondary 与 defaultPath: both;多标签页用 views.paths 指向 PresentationVariant。

验证:检查激活输出,并在服务 URL 的 $metadata 中确认 UI.Chart 与 UI.PresentationVariant 注解存在。测试可用 npm start 获取实时元数据,通常无需重新发布服务绑定。

限制与排错:常见问题包括缺少 @OData.applySupportedForAggregation(应用无法加载)、注解放错视图、度量字段非数值、manifest 限定符不匹配、缺少 @Aggregation.default、DDLX 未激活(控制台提示 Annotation Path 未找到)以及聚合方式错误导致数据不符。建议使用 1 个维度与 1–2 个度量,并优先选用 Column/Bar 图表。具体平台支持与操作细节以官方资料为准,未提供的收费或价格信息暂未提供。