CDS View-Part11 实例消费CDS View

本文演示了如何创建CDSView并通过Smart Business Service KPI Fiori应用配置KPI磁贴,无需编码,实现销售文档退货数量的分析。通过创建多个CDSView层级,实现了数据的聚合和参数化,最终发布为OData服务并在Fiori应用中展示。

原文:
https://sapyard.com/how-to-consume-cds-view-in-smart-business-service-kpi-fiori-apps/
尊重版权,仅供个人学习

CDS Annotation online help:
https://help.sap.com/viewer/cc0c305d2fab47bd808adcad3ca7ee9d/1709%20000/en-US/630ce9b386b84e80bfade96779fbaeec.html

本文主要是用一个实际的例子演示了如何创建和消费CDS View并且不需编写代码就可以配置出一个KPI 磁贴。

需求:创建一个分析应用程序,以分析用户输入的特定年份的销售文档行项目级别的退货数量,根据客户和周期(月)进行分组。

后台创建 CDS View并发布为OData

先整体说一下,免得后面看晕了

  1. 创建一个取明细数据的#BASIC 类型的View ‘ZGJZ_I_DEMO_CUST’,取的都是基础字段,包括字符串处理的MON 和 YYEAR。
  2. 在第一个view的基础上汇总数据,创建一个#COMPOSITE类型的view ‘ZGJZ_C_DEMO_CUSTCNT’,这时有了分组汇总字段。
  3. 使用第一个view做主数据源,Associate第二个View,再加上选择参数‘P_MJAHR’创建第三个#COMPOSITE类型的view ‘ZGJZ_C_DEMO_CUSTCOMB’,关联字段使用‘kunnr’ ‘MON’ ‘YYEAR’,此时要加入 @Aggregation.default: #SUM 声明了measure字段。
  4. 使用第三个View创建一个带参数的#CONSUMPTION类型的View ‘ZGJZ_C_DEMO_CUSTANA’,这里将其发布为OData,并且使用@Analytics.query: true将其分类,这是一个Query View。
    ADT提供了一个很好的工具可以直观看到对象的dependency关系,这在分析复杂的View时非常有用。
    在这里插入图片描述
    在这里插入图片描述
  • 创建CDS Basic View 'ZGJZ_I_DEMO_CUST' 分别从表VBAK/VBAP/TVAGT取销售订单头、行项目以及拒绝原因描述。
    参考代码
@AbapCatalog.sqlViewName: 'ZGJZIDEMOCUST'
@AbapCatalog.compiler.compareFilter: true
@AbapCatalog.preserveKey: true
@AccessControl.authorizationCheck: #NOT_REQUIRED
@VDM.viewType: #BASIC
@EndUserText.label: 'Basic View for customer rejection'
define view ZGJZ_I_DEMO_CUST
  as select from    vbak
    inner join      vbap  on  vbak.vbeln = vbap.vbeln
                          and vbap.abgru != ''
    left outer join tvagt on  vbap.abgru = tvagt.abgru
                          and spras      = 'E'
{
      @EndUserText.label: 'Sale Document No'
  key vbak.vbeln,
      @EndUserText.label: 'Line Item No'
      vbap.posnr,
      @EndUserText.label: 'Material'
      vbap.matnr,
      @EndUserText.label: 'Description'
      vbap.arktx,
      @EndUserText.label: 'Customer Number'
      vbak.kunnr,
      @EndUserText.label: 'Reason For Rejection'
      vbap.abgru,
      @EndUserText.label: 'Description'
      tvagt.bezei,
      @EndUserText.label: 'Document No Date'
      vbak.audat,
      @EndUserText.label: 'Month'
      substring(vbak.audat,5,2) as MON,
      @EndUserText.label: 'Year'
      substring(vbak.audat,1,4) as YYEAR
}

在这里插入图片描述

  1. annotation标签 @VDM.viewType: #BASIC 声明虚拟数据模型VDM的类型(VDM旨在由视图浏览器和其他基于虚拟数据模型的功能框架来解析。)。BASIC:没有数据冗余的形成核心数据基础的视图。
  2. 这里用了一个annotation标签 @EndUserText.label: 'xxx' 顾名思义,文本标签
  • 创建带参数CDS Composite View 'ZGJZ_C_DEMO_CUSTCNT'
    在这里插入图片描述
  1. @Analytics:{ dataCategory: #CUBE, dataExtraction.enabled: true},这两个属性可以参考分别对应了:Query通常构建在#CUBE类型的View之上,其中的数据是从facts表中复制的;标记适合进行数据复制的视图。
  2. @VDM.viewType: #COMPOSITE显式声明VDM View Type,COMPOSITE : 由基本视图派生和/或组成的数据视图。
  3. @EndUserText.label: 'Year'文本标签
  4. @Aggregation.default: #SUM这里将其声明为Measure
  • 组合CDS View创建分析数据集和复合虚拟数据模型(VDM)视图ZGJZ_C_DEMO_CUSTCOMB
@AbapCatalog.sqlViewName: 'ZGJZCDEMOCUSTCOM'
//@AbapCatalog.compiler.compareFilter: true
//@AbapCatalog.preserveKey: true
@AccessControl.authorizationCheck: #NOT_ALLOWED
@EndUserText.label: 'Customer Rejection Analysis'
@VDM.viewType: #COMPOSITE
@Analytics:{dataCategory: #CUBE, dataExtraction.enabled: true}
define view ZGJZ_C_DEMO_CUSTCOMB
  with parameters
    @EndUserText.label: 'Year'
    P_MJAHR : mjahr
  as select from ZGJZ_C_DEMO_CUSTCNT
                 (P_MJAHR :$parameters.P_MJAHR)
  association [1] to ZGJZ_I_DEMO_CUST as _DETAIL on  $projection.kunnr = _DETAIL.kunnr
                                                 and $projection.MON   = _DETAIL.MON
                                                 and $projection.YYEAR = _DETAIL.YYEAR
{
      @EndUserText.label: 'Customer Number'
  key kunnr,
      @EndUserText.label: 'Month'
      MON,
      @EndUserText.label: 'Fiscal Year'
      YYEAR,
      @EndUserText.label: 'No of Rejections'
      @Aggregation.default: #SUM
      cast(Reject as abap.curr( 4, 0 ) ) as reject,
      @EndUserText.label: 'Document No'
      _DETAIL.vbeln,
      @EndUserText.label: 'Line Item No'
      _DETAIL.posnr,
      @EndUserText.label: 'Material'
      _DETAIL.matnr,
      @EndUserText.label: 'Description'
      _DETAIL.arktx,
      @EndUserText.label: 'Reason For Rejecton'
      _DETAIL.abgru,
      @EndUserText.label: 'Reason Description'
      _DETAIL.bezei
}

在这里插入图片描述

  1. 还没有搞清楚的Annotation即使是模版带出来的也别乱用
  2. COPOSITE类型VDM View
  3. 这里使用$projection和view名是一样的
  4. 将字段声明为measure
  • 创建最终要被发布为OData的CONSUMPTION类型View 'ZGJZ_C_DEMO_CUSTANA'
@AbapCatalog.sqlViewName: 'ZGJZCDEMOCUSTANA'
@AbapCatalog.compiler.compareFilter: true
@AbapCatalog.preserveKey: true
@AccessControl.authorizationCheck: #NOT_ALLOWED
@EndUserText.label: 'Customer Rejection Analysis'
@VDM.viewType: #CONSUMPTION
@Analytics.query: true
@OData.publish: true
@Metadata.ignorePropagatedAnnotations: true
@Analytics.dataExtraction.enabled: true
define view ZGJZ_C_DEMO_CUSTANA
  with parameters
    @EndUserText.label: 'Year'
    P_MJAHR : mjahr
  as select from ZGJZ_C_DEMO_CUSTCOMB
                 (P_MJAHR : $parameters.P_MJAHR)
{
      @EndUserText.label: 'Customer Number'
  key kunnr,
      @EndUserText.label: 'Month'
      MON,
      @EndUserText.label: 'Year'
      YYEAR,
      @EndUserText.label: 'No of Rejections'
      @Aggregation.default: #SUM
      REJECT,
      @EndUserText.label: 'Document No'
      VBELN,
      @EndUserText.label: 'Line Item No'
      posnr,
      @EndUserText.label: 'Material'
      matnr,
      @EndUserText.label: 'Description'
      arktx,
      @EndUserText.label: 'Reason for Rejection'
      abgru,
      @EndUserText.label: 'Reason Description'
      bezei
}

在这里插入图片描述

  1. @VDM.viewType: #CONSUMPTION 是基于基本视图、复合视图或事务视图定义的消费类型视图
  2. @Analytics.query: true将其分类,说明这是一个Query View。
  3. @OData.publish: true 激活后自动发布为OData
  4. @Aggregation.default: #SUM 字段为measure字段

根据CDS View使用应用’Create KPI’创建磁贴应用

首先要将后台的服务添加到前台,TCODE:/IWFND/MAINT_SERVICE
在这里插入图片描述
在这里插入图片描述
在这里插入图片描述
测试服务,这时可以发现自动自成了两个EntitySets
在这里插入图片描述
尝试执行其中一个entityset时报错,no parameter provided,正常,忽略它先
在这里插入图片描述
打开 LPD,找到应用 ‘Create KPI’,如果没有从Fiori Libuary中找到按要求配置出来即可,这里就不介绍这个了。
在这里插入图片描述
填入标题和描述
在这里插入图片描述
选择视图和相应的OData服务以及EntitySet,使用F4填写很方便
在这里插入图片描述
如果这里没有正常搜到刚做的CDS View或是Odata服务,一定是CDS View创建的有问题,更正问题后记得刷新服务元数据 ,点击’激活并添加评估’按钮
在这里插入图片描述
填入评估描述
在这里插入图片描述
以及取值参数,然后点击’激活并配置磁贴’按钮
在这里插入图片描述
选择磁贴样式以及填写目录信息和语义对象信息,语义对象是通过TOCDE /ui2/semobj创建的,然后点击’保存并配置下钻’按钮
在这里插入图片描述
点击’配置’按钮
在这里插入图片描述
先配置一个summary视图,选择’Customer Number’ ‘Month’ ‘Year’三个字段,这也是最初的需求。
在这里插入图片描述
切换统计图的类型,默认应该是条形图,这里切换为’柱状图
在这里插入图片描述
再添加一个下钻
在这里插入图片描述
显示详细信息字段
在这里插入图片描述
切换统计图类型为’’,保存,此时磁贴会生成成功。
在这里插入图片描述
回到用户LPD,使用应用查找器找到这个磁贴,显示磁贴
在这里插入图片描述
以下是结果演示:
在这里插入图片描述
在这里插入图片描述
在这里插入图片描述

在这里插入图片描述
在这里插入图片描述

<think> 我们正在处理一个特定的错误:在SAP RAP PROJECTION VIEW使用QUERY时出现'Only CDS view entities or CDS DDIC-based views can be basis entities'报错。 根据错误信息,它表明作为基础实体(basis entity)的必须是CDS view entities(视图实体)或CDS DDIC-based views(基于DDIC的CDS视图)。 回顾引用内容: 引用[1]提到:CDS view entity(视图实体)是推荐形态,它允许从一个或多个数据源选择字段,支持计算、聚合、连接、联合等逻辑。 引用[2]提到:ABAP CDS View定义在应用服务器层,是用OPEN SQL写的,旨在支持ABAP应用程序的开发。并且,它分为两种类型:CDS view entities(新的)和DDIC-based views(传统的)。 引用[3]提到:在RAP开发中,要注意客户端列(MANDT)的命名约定,虽然不强制但遵循约定可以减少问题。 因此,这个错误通常是因为你在定义Projection View时,其数据源(即基础实体)既不是CDS view entity也不是CDS DDIC-based view。 解决步骤: 1. 检查你的Projection View定义中`from`后面的数据源是什么。 例如:`define view entity ZMyProjView as select from ...` 这里的数据源必须是一个CDS view entity(使用`define view entity`定义的)或者是一个DDIC-based CDS view(使用`define view`定义的,即传统的CDS视图)。 2. 如果是直接从一个数据库表(如`zmy_table`)选择,那么就会出现这个错误。因为数据库表不是CDS view entity或CDS DDIC-based view。 3. 在RAP模型中,通常的层次结构是: Database Table(数据库表)→ Data Definition View(数据定义视图,即基础接口视图)→ Projection View(投影视图) 所以,你应该有一个基础接口视图(Interface View)作为Projection View的数据源。 4. 创建一个基础接口视图(使用CDS view entity): 例如: ```abap define view entity ZMyBaseView as select from zmy_table { key id, name, ... } ``` 然后,在Projection View中从这个基础接口视图选择: ```abap @UI: { ... } define view entity ZMyProjView as select from ZMyBaseView { key id, name, ... } ``` 5. 如果已经有一个基础视图,请确认这个基础视图是使用`define view entity`(推荐)或`define view`(传统的DDIC-based)定义的。 6. 注意:在RAP中,Projection View本身必须是`define view entity`(因为RAP只支持基于CDS view entity的投影视图)。 7. 另外,检查所有涉及的CDS视图是否激活,激活状态是否正常。 8. 如果基础视图是传统的DDIC-based view(使用`define view`),那么它也是允许的。但是注意,SAP推荐使用新的CDS view entity(即`define view entity`)。 9. 如果错误仍然存在,检查是否有拼写错误,或者检查你的ABAP版本是否支持CDS view entity(需要ABAP版本>=7.52)。 10. 关于客户端处理:确保在基础视图中包含了客户端字段(MANDT)或者用注解@ClientHandling.type指定了客户端处理方式(如#AUTOMATED或#NOT_REQUIRED)。如果基础视图没有客户端字段,那么Projection View中需要做相应处理(但通常基础视图应该包含)。 总结:这个错误的根本原因是Projection View的数据源不是CDS视图实体或CDS DDIC视图。请确保你的Projection View的数据源是一个CDS视图(实体或DDIC类型),而不是直接使用数据库表。 下面是一个正确的例子: 基础接口视图(DDIC-based view): ```abap @AbapCatalog.sqlViewName: 'ZMYBASE' @AbapCatalog.compiler.compareFilter: true define view ZMyBaseView as select from zmy_table { key mandt, key id, name } ``` 或者使用view entity(推荐): ```abap define view entity ZMyBaseView as select from zmy_table { key mandt, key id, name } ``` 投影视图(Projection View): ```abap @AccessControl.authorizationCheck: #NOT_REQUIRED @EndUserText.label: 'Projection View' define view entity ZMyProjView as select from ZMyBaseView { key id, name } ``` 这样,Projection View的数据源(ZMyBaseView)是一个CDS视图,因此可以避免该错误。 如果问题仍未解决,请检查你的CDS视图的激活日志,看是否有其他问题。 希望这个解答能帮助你解决问题。 </think>### 解决 SAP RAP PROJECTION VIEW 使用 QUERY 时的报错:`Only CDS view entities or CDS DDIC-based views can be basis entities` #### 🔍 错误原因分析 根据引用内容[1][2]和报错信息,此错误是由于 **Projection View 的基础数据源不符合 RAP 框架要求** 导致的: 1. **无效的数据源类型** RAP 要求 Projection View 的 `FROM` 子句必须基于以下两种实体之一: - **CDS View Entity** (新语法:`define view entity`) - **CDS DDIC-based View** (传统语法:`define view`) 如果直接引用数据库表(如 `zmy_table`)或其他非 CDS 视图对象,会触发此错误[^1][^2]。 2. **客户端字段处理问题** 引用[3]指出,若基础视图中缺少标准客户端字段 `MANDT` 或未正确处理客户端依赖关系,也可能间接导致此报错[^3]。 --- #### ✅ 解决方案(分步操作) ##### 步骤 1: 检查并修正基础数据源 1. **创建合法的 CDS 基础视图** 确保 Projection View 基于合法的 CDS 视图实体(推荐)或 DDIC-based 视图: ```abap // ✅ 正确示例:CDS View Entity 作为基础数据源 define view entity ZI_BaseView as select from zmy_table { key mandt, // 必须包含客户端字段 key id, name, status } ``` 2. **在 Projection View 中引用合法视图** ```abap // ✅ 正确:Projection View 基于 CDS 视图实体 @UI: { ... } define view entity ZC_ProjectionView as select from ZI_BaseView { key id, name, @UI.hidden: true _status: status // 支持别名和注解 } ``` ##### 步骤 2: 处理客户端字段(关键!) - **显式包含 `MANDT` 字段**(引用[3]) 所有基础视图必须包含 `MANDT` 字段,确保客户端隔离: ```abap // 基础视图中必须声明 mandt define view entity ZI_BaseView as select from zmy_table { key mandt, // 必须作为第一关键字段 key id, ... } ``` - **或添加客户端注解** 若字段名非 `MANDT`(如 `client_id`),需通过注解声明: ```abap @ClientDependent: true @ObjectModel.clientField: 'client_id' // 指定自定义客户端字段 define view entity ZI_BaseView ... ``` ##### 步骤 3: 验证激活状态 1. 确保基础视图(`ZI_BaseView`)已激活 2. 重新激活 Projection View(`ZC_ProjectionView`) 3. 重新发布 Service Binding 中的服务 --- #### ⚠️ 常见错误场景排查 | 错误场景 | 错误示例 | 修正方案 | |----------|----------|----------| | **直接引用数据库表** | `FROM zmy_table` | 改为 `FROM 合法的 CDS 视图` | | **缺少客户端字段** | 未声明 `mandt` | 添加 `key mandt` 或客户端注解 | | **使用旧语法视图** | `define view Z_OldView` | 迁移到 `define view entity`[^1] | | **未激活依赖对象** | 基础视图未激活 | 激活所有关联 CDS 视图 | #### 💡 技术原理 - RAP 框架通过 CDS 视图实现**查询优化**,直接操作数据库表会绕过 Open SQL 转换层(引用[2])[^2]。 - 客户端字段 `MANDT` 是 ABAP 运行时**自动过滤多租户数据**的关键(引用[3])[^3]。 > 📌 **最佳实践**:始终使用 `define view entity` 作为基础视图类型(引用[1]),通过 `@UI` 和 `@ObjectModel` 注解控制 UI 行为。 [^1]: CDS view entity 是推荐形态,支持计算、聚合等逻辑。 [^2]: ABAP CDS View 定义在应用服务器层,用 OPEN SQL 编写。 [^3]: 客户端列遵循 `MANDT` 命名约定可减少兼容性问题。 --- ### 相关问题 1. 如何在 CDS View Entity 中正确声明客户端字段 `MANDT`? 2. RAP 中 Projection View 出现 `No suitable basis entity` 错误如何解决? 3. CDS View Entity 和 DDIC-based View 在性能上有何差异? 4. 如何将传统的 DDIC-based View 迁移到 CDS View Entity?
评论 1
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值