07 · 分析报表与自定义 UI(custom entity + RAP Query 完整实操)

📄 [教程] Day4 全天(Exercise 4 Part 1 建 CDS / 查询类 / 服务;Part 2 权限由 08 章接);Day4 PPT slide 9–18;原件 docs/12、SAP公有云开发培训/Day4_S4HC_Embedded Analytics_练习脚本.docx 🔗 [官方] RAP(ABAP Cloud)官方文档 · Custom Analytical Queries 应用 · BAS 连接 S/4HANA Cloud(destination + 信任) · 创建 SAP Fiori Dev Space · 用 BAS 开发自定义 UI 并部署回 S/4HANA Cloud

本章目标:学会公司报表主力形态(模式 B:custom entity + unmanaged query),在 ADT 里亲手做完一条完整链路——建 CDS 实体 → 写 if_rap_query_provider 实现类 → 服务定义/绑定 → Preview 出数;再(可选)用 BAS 把服务做成自定义 Fiori UI 并部署回 ABAP 仓库。做完能独立接一张"要计算逻辑"的报表需求。

本章产出(做完自查):

#

对象

类型

状态

1

z_material_stock_age

CDS custom entity(带参数 P_KEYDATE)

已激活

2

ZCL_MATERIAL_STOCK_AGE

查询实现类(if_rap_query_provider)

已激活,Preview 出数

3

ZSD_MATERIAL_AGING

Service Definition

已激活

4

ZSB_MATERIAL_AGING

Service Binding(OData V2 – UI)

Published,Preview 出数

5

zmaterialage / ZMATERIALAGE

BAS 生成的 Fiori Elements 应用(可选加强)

部署到 SAPUI5 ABAP Repository

6

ZMATERIALAGE_UI5R

Launchpad App Descriptor Item

包内可见,08 章发布用

✅ 衔接:本章在 01 章的 Eclipse ADT + ABAP Cloud Project、03/04 章的包 Z_Onlineshop 和同一个传输请求(TR)里做,不依赖 04 章的在线商店业务对象(报表取标准 released CDS 的数据)。从本章跳进来的,先确认 ADT 能打开包、能建对象并挂 TR(见 01 章、03 章)。

⚠️ 练习账号:开发租户用户要有业务角色模板 SAP_BR_ADMINISTRATOR、SAP_BR_DEVELOPER、SAP_BR_BPC_EXPERT、SAP_BR_EXTENSIBILITY_SPEC;BAS 线另需业务目录 SAP_CORE_BC_COM(通信管理)与 SAP_CORE_BC_EXT_UI(UI 开发)。


1. 先选型:报表三级火箭(选错级 = 白干)

级

形态

工具 / 入口

谁做

什么时候选它

本章

L1

分析视图 + 自助查询

Fiori「Custom Analytical Queries」、View Browser

Key User / 业务分析

数据源现成,只要聚合、过滤、排序、简单计算

速览(§6)

L2

CDS custom entity + 查询实现类

ADT(ABAP Cloud)

ABAP 开发

要 ABAP 算逻辑:账龄分桶、分摊、多表拼装、调接口取数

主线,全做

L3

自定义 Fiori UI

BAS + Fiori generator,部署回 ABAP 仓库

前端 / 全栈 ABAP

L2 注解版式满足不了:自定义布局、多服务拼装、特殊交互

可选加强(§5)

补充

分析建模 + SAC 故事

ADT 建分析型 CDS + SAC

分析建模顾问

企业级看板、跨系统分析

不展开

判断顺序:能不改代码就出数 → L1;要写 ABAP 计算 → L2(公司报表几乎全在这一级);连 L2 的 Fiori Elements 版式都不够用 → 才上 L3(多一套 BTP 环境、信任、部署管线要养,不是默认选项)。

📦 [现状] 四个导出包共 60 个 query 实体 + 59 个 if_rap_query_provider 实现类(FI 28 / MM 15 / SD 16);自定义 UI 侧以 uiad.json 版式适配和 smbc 维护 App 为主,BAS 自研部署的 App 很少(§7.1)。所以 L2 必须练熟,L3 会判断、能跑通一次即可。


2. 动手 1:建 CDS custom entity z_material_stock_age

需求:按"关键日期"看库存账龄——把当前库存拆进 0–30 天、30–60 天、>60 天三个桶(数量 + 金额),维度是公司代码 / 工厂 / 物料;三项必填,关键日期用户选。

为什么用 custom entity:它是"没有数据源、没有 SQL"的 CDS 实体,数据完全由 @ObjectModel.query.implementedBy 指向的 ABAP 类提供——这就是 unmanaged query。普通 CDS 视图只能下推数据库,算不了跨表分桶。

2.1 新建 Data Definition

步骤

操作

填什么 / 为什么

1

Project Explorer 右键包 Z_Onlineshop → New → Other ABAP Repository Object

所有 ABAP 仓库对象的统一入口

2

搜 data definition → Next

CDS DDL 对象(向导里在 Core Data Services 下)

3

Name:z_material_stock_age;Description:Material Aging report

小写 = OData 实体名;实体集叫 z_material_stock_ageSet(BAS 选主实体时用)

4

选 03 章那个包和 TR → Finish

云上对象变更必须挂 TR

5

删掉模板,粘贴 §2.2 源码;先 Ctrl+S 保存,暂不激活

实现类还没建,现在激活会报错(见 §2.4)

新建 Data Definition 向导 (📄 Day4 脚本 Step 1:右键包 → New → Other ABAP Repository Object → Data Definition;Name z_material_stock_age、Description Material Aging report)

2.2 完整源码(整段覆盖,不要留模板)

@EndUserText.label: 'Material Stock Age'
@ObjectModel.query.implementedBy: 'ABAP:ZCL_MATERIAL_STOCK_AGE'
@UI.headerInfo: { typeName: 'Inventory Aging' }
define custom entity z_material_stock_age
  with parameters
    //@Consumption.valueHelpDefinition: [{ entity: {name:'I_COMPANYCODEVH' ,element: 'CompanyCode' } }]
    //  p_bukrs : bukrs,
    //@Consumption.valueHelpDefinition: [{ entity: {name:'I_PlantStdVH' ,element: 'Plant' } }]
    //  p_plant : werks_d,
    //  p_lgort : zlgort,
    P_keydate : vdm_v_key_date
{
    @UI.selectionField: [{ position: 10 }]
    @Consumption.valueHelpDefinition: [{ entity: {name:'I_COMPANYCODEVH' ,element: 'CompanyCode' } }]
    @Consumption.filter:{mandatory: true}
//    @Consumption.defaultValue: '1310'
    key companycode : bukrs;

    @UI.lineItem :[{label:'Plant',position:10 ,importance: #HIGH }]
    @UI.selectionField: [{ position: 20 }]
    @Consumption.valueHelpDefinition: [{ entity: {name:'I_PlantStdVH' ,element: 'Plant' } }]
    @Consumption.filter:{mandatory: true}
//    @Consumption.defaultValue: '1310'
    key plant : werks_d;

    @UI.lineItem :[{label:'Material',position:30 ,importance: #HIGH }]
    @UI.selectionField: [{ position: 40 }]
    @Consumption.valueHelpDefinition: [{ entity: {name:'I_ProductPlantStdVH' ,element: 'Product' } }]
    @Consumption.valueHelpDefinition: [{additionalBinding: [{ element: 'Plant', localElement: 'plant' }]}]
    key material: matnr;

    @Semantics.quantity.unitOfMeasure:'meins'
    @UI.lineItem :[{label:'Current Stock Quantity',position:40 ,importance: #HIGH }]
    currentStock : abap.quan( 22, 2 );

    @Semantics.amount.currencyCode: 'waers'
    @UI.lineItem :[{label:'Current Stock Value',position:50 ,importance: #HIGH }]
    currentValue : abap.curr( 23, 2 );

    @Semantics.quantity.unitOfMeasure:'meins'
    @UI.lineItem :[{label:'0-30 days Quantity',position:60 ,importance: #HIGH }]
    period1 : abap.quan( 22, 2 );

    @Semantics.amount.currencyCode: 'waers'
    @UI.lineItem :[{label:'0-30 days Value',position:70 ,importance: #HIGH }]
    period1_v : abap.curr( 23, 2 );

    @Semantics.quantity.unitOfMeasure:'meins'
    @UI.lineItem :[{label:'30-60 days Quantity',position:80 ,importance: #HIGH }]
    period2 : abap.quan( 22, 2 );

    @Semantics.amount.currencyCode: 'waers'
    @UI.lineItem :[{label:'30-60 days Value',position:90 ,importance: #HIGH }]
    period2_v : abap.curr( 23, 2 );

    @Semantics.quantity.unitOfMeasure:'meins'
    @UI.lineItem :[{label:'Greater than 60 days Quantity',position:100 ,importance: #HIGH }]
    period3 : abap.quan( 22, 2 );

    @Semantics.amount.currencyCode: 'waers'
    @UI.lineItem :[{label:'Greater than 60 days Value',position:110 ,importance: #HIGH }]
    period3_v : abap.curr( 23, 2 );

    @UI.hidden: true
    meins: meins;

    @UI.hidden: true
    waers: waers;
}

2.3 每个设计点的意义

注解 / 写法

作用

@ObjectModel.query.implementedBy: 'ABAP:ZCL_MATERIAL_STOCK_AGE'

本实体不查表,数据由这个类提供——custom entity 的核心;类名全大写且与实现类一致

define custom entity + with parameters

声明无数据源实体,并带报表参数 P_keydate(关键日期,类型 vdm_v_key_date)

@UI.headerInfo: { typeName: 'Inventory Aging' }

列表页标题 Inventory Aging

@UI.selectionField: [{ position: N }]

进顶部筛选栏,position 决定顺序

@Consumption.filter:{mandatory: true}

筛选必填:不填查不了,避免"全公司全物料"的大查询

@Consumption.valueHelpDefinition

挂标准值帮助:I_CompanyCodeVH、I_PlantStdVH、I_ProductPlantStdVH

additionalBinding: [{ element: 'Plant', localElement: 'plant' }]

值帮助联动:选物料时把工厂一起带出/限定

key 修饰

维度字段。聚合出来的度量绝不能当 key,否则行会被合并错

@Semantics.quantity.unitOfMeasure:'meins' / @Semantics.amount.currencyCode: 'waers'

数量绑单位字段、金额绑币种字段(单位/币种必须作为字段存在)

@UI.lineItem

列表列:label 列名、position 列序、importance: #HIGH 优先展示

@UI.hidden: true

隐藏 meins / waers 技术字段,不单独占列

💡 源码里有一段注释掉的参数(p_bukrs / p_plant / p_lgort):教程最初想把这些做成参数,最后改成"必填筛选字段"(值帮助 + 必填对前端更友好)。注释保留不影响激活,不要删。

2.4 激活顺序与验证

  1. 先别激活:实现类不存在时激活会报"实现类不存在/不可用",属正常。

  2. 先按 §3 建好 ZCL_MATERIAL_STOCK_AGE 并激活,再回来激活本实体(Ctrl+F3)。

  3. 验证(三看):Problems 无红叉;Outline 里有参数 P_KEYDATE、三个 key(COMPANYCODE / PLANT / MATERIAL)、8 个度量(CURRENTSTOCK、CURRENTVALUE、PERIOD1/1_V/2/2_V/3/3_V)和 MEINS / WAERS;光标停在 @UI.lineItem 上按 F2 能弹出注解说明。

⚠️ 本机 release 与教程不一致时,i_materialstock_2 等标准视图字段可能改名/挪位,激活报"字段不存在"。在 ADT 里打开该视图(Ctrl+Shift+A 搜对象)核对实际字段后替换——不要凭记忆改。


3. 动手 2:实现查询类 ZCL_MATERIAL_STOCK_AGE

框架把 OData 请求打包成 io_request 交给 if_rap_query_provider~select,你负责把数据算好塞进 io_response——这就是 unmanaged query 的全部契约。

3.1 建类并加接口

步骤

操作

填什么 / 为什么

1

右键包 → New → ABAP Class

—

2

Name:ZCL_MATERIAL_STOCK_AGE;Description:Material Aging implementation

实现类与实体同名(大写),一眼对上

3

Interfaces 区域点 Add… → 搜 IF_RAP_QUERY_PROVIDER → 勾选

只需这一个接口,~select 方法由接口带出

4

选 TR → Finish,打开类

ADT 生成 DEFINITION(含接口)和空的 METHOD if_rap_query_provider~select

5

用 §3.2 整段(含 METHOD / ENDMETHOD)替换 ADT 生成的方法

只贴方法体的话,去掉首尾两行

新建类并添加接口 (📄 Day4 脚本 Step 1:New ABAP Class,Name ZCL_MATERIAL_STOCK_AGE,Interfaces 里加 IF_RAP_QUERY_PROVIDER)

3.2 if_rap_query_provider~select 完整源码

METHOD if_rap_query_provider~select.
  IF io_request->is_data_requested( ).
    TYPES BEGIN OF ty_value.
      TYPES: quantity TYPE i_stockquantitycurrentvalue_2-matlwrhsstkqtyinmatlbaseunit,
             value    TYPE i_stockquantitycurrentvalue_2-stockvalueindisplaycurrency.
    TYPES END OF ty_value.
    TYPES: BEGIN OF ty_range_option,
             sign   TYPE c LENGTH 1,
             option TYPE c LENGTH 2,
             low    TYPE string,
             high   TYPE string,
           END OF ty_range_option.
    DATA: lt_response        TYPE TABLE OF z_material_stock_age,
          ls_response        LIKE LINE OF lt_response,
          lt_responseout     LIKE lt_response,
          ls_responseout     LIKE LINE OF lt_responseout,
          lt_response_period TYPE TABLE OF z_material_stock_age,
          ls_response_period LIKE LINE OF lt_response_period,
          lt_value           TYPE TABLE OF ty_value,
          ls_value           TYPE ty_value,
          lv_price           TYPE p DECIMALS 2,
          lt_configr         TYPE TABLE OF ty_range_option,
          ls_configr         LIKE LINE OF lt_configr.
    DATA(lv_top)      = io_request->get_paging( )->get_page_size( ).
    DATA(lv_skip)     = io_request->get_paging( )->get_offset( ).
    DATA(lv_max_rows) = COND #( WHEN lv_top = if_rap_query_paging=>page_size_unlimited THEN 0
                                ELSE lv_top ).
    DATA(lt_clause)    = io_request->get_filter( )->get_as_ranges( ).
    DATA(lt_parameter) = io_request->get_parameters( ).
    DATA(lt_fields)    = io_request->get_requested_elements( ).
    DATA(lt_sort)      = io_request->get_sort_elements( ).
    TRY.
        DATA(lt_filter_cond) = io_request->get_filter( )->get_as_ranges( ).
      CATCH cx_rap_query_filter_no_range INTO DATA(lx_no_sel_option).
    ENDTRY.

****************************Data selection and business logics goes here*********************************
    LOOP AT lt_parameter ASSIGNING FIELD-SYMBOL(<fs_p>).
      CASE <fs_p>-parameter_name.
        WHEN 'P_KEYDATE'.
          DATA(p_keydate) = <fs_p>-value.
      ENDCASE.
    ENDLOOP.
    LOOP AT lt_filter_cond INTO DATA(ls_filter_cond).
      IF ls_filter_cond-name = 'MATERIAL'.
        DATA(lt_material) = ls_filter_cond-range[].
      ELSEIF ls_filter_cond-name = 'PLANT'.
        DATA(lt_plant) = ls_filter_cond-range[].
      ELSEIF ls_filter_cond-name = 'COMPANYCODE'.
        DATA(lt_bukrs) = ls_filter_cond-range[].
      ENDIF.
    ENDLOOP.

*get inventory information based on date
    SELECT *
      FROM i_materialstock_2
      WHERE material IN @lt_material
        AND matldoclatestpostgdate <= @p_keydate
        AND plant IN @lt_plant
        AND companycode IN @lt_bukrs
      INTO TABLE @DATA(lt_stock).
    LOOP AT lt_stock INTO DATA(ls_stock).
      ls_response-companycode  = ls_stock-companycode.
      ls_response-plant        = ls_stock-plant.
      ls_response-material     = ls_stock-material.
      ls_response-currentstock = ls_stock-matlwrhsstkqtyinmatlbaseunit.
      COLLECT ls_response INTO lt_response.
    ENDLOOP.

*period start date calculation
    DATA lv_30 TYPE d.
    DATA lv_60 TYPE d.
    DATA cd TYPE d.
    cd = p_keydate.
    lv_30 = cd - 30.
    lv_60 = cd - 60.

*get material movement history
    SELECT *
      FROM i_materialdocumentitem_2
      FOR ALL ENTRIES IN @lt_response
      WHERE postingdate <= @p_keydate
        AND plant IN @lt_plant
        AND companycode IN @lt_bukrs
        AND material = @lt_response-material
        AND goodsmovementtype IN @lt_configr
        AND goodsmovementiscancelled IS INITIAL
      INTO TABLE @DATA(lt_movement).
    DATA(lt_movement_reverse) = lt_movement[].
    LOOP AT lt_movement INTO DATA(ls_movement).
      READ TABLE lt_movement_reverse WITH KEY reversedmaterialdocumentyear = ls_movement-materialdocumentyear
                                              reversedmaterialdocument     = ls_movement-materialdocument
                                     TRANSPORTING NO FIELDS.
      IF sy-subrc = 0.
        DELETE lt_movement FROM ls_movement.
      ENDIF.
    ENDLOOP.
    LOOP AT lt_movement INTO ls_movement WHERE reversedmaterialdocument IS INITIAL.
      ls_response_period-companycode = ls_movement-companycode.
      ls_response_period-plant       = ls_movement-plant.
      ls_response_period-material    = ls_movement-material.
      ls_response_period-meins       = ls_movement-materialbaseunit.
      ls_response_period-waers       = ls_movement-companycodecurrency.
      IF ls_movement-postingdate > lv_30 AND ls_movement-postingdate <= cd.
        ls_response_period-period1 = ls_movement-quantityinbaseunit.
      ELSEIF ls_movement-postingdate > lv_60 AND ls_movement-postingdate <= lv_30.
        ls_response_period-period2 = ls_movement-quantityinbaseunit.
      ELSEIF ls_movement-postingdate <= lv_60.
        ls_response_period-period3 = ls_movement-quantityinbaseunit.
      ENDIF.
      COLLECT ls_response_period INTO lt_response_period.
      CLEAR ls_response_period.
    ENDLOOP.
    LOOP AT lt_response INTO ls_response.
      READ TABLE lt_response_period WITH KEY companycode = ls_response-companycode
                                              plant       = ls_response-plant
                                              material    = ls_response-material
                                     INTO ls_response_period.
*        ls_response-meins = ls_response_period-meins.
*        ls_response-waers = ls_response_period-waers.
      IF sy-subrc = 0.

* period 1 calculation with 30 days.
        IF ls_response-currentstock < ls_response_period-period1 AND ls_response_period-period1 > 0.
          ls_response-period1 = ls_response-currentstock.
        ELSE.
          ls_response-period1 = ls_response_period-period1.
        ENDIF.

* period 2 calculation between 30 days to 60 days.
        IF ( ls_response-currentstock - ls_response_period-period1 ) < 0.
          ls_response-period2 = 0.
        ELSEIF ( ls_response-currentstock - ls_response_period-period1 ) < ls_response_period-period2
           AND ls_response_period-period2 > 0.
          ls_response-period2 = ls_response-currentstock - ls_response_period-period1.
        ELSEIF ( ls_response-currentstock - ls_response_period-period1 ) >= ls_response_period-period2.
          ls_response-period2 = ls_response_period-period2.
        ENDIF.

* period 3 calculation more than 60 days
        IF ( ls_response-currentstock - ls_response_period-period1 - ls_response_period-period2 ) < 0.
          ls_response-period3 = 0.
        ELSEIF ( ls_response-currentstock - ls_response_period-period1 - ls_response_period-period2 ) < ls_response_period-period3
           AND ls_response_period-period3 > 0.
          ls_response-period3 = ls_response-currentstock - ls_response_period-period1 - ls_response_period-period2.
        ELSEIF ( ls_response-currentstock - ls_response_period-period1 - ls_response_period-period2 ) >= ls_response_period-period3.
          ls_response-period3 = ls_response_period-period3.
        ENDIF.
      ELSEIF sy-subrc > 0 AND ls_response-currentstock > 0.
        ls_response-period3 = ls_response-currentstock.
      ENDIF.

* getting price information
      SELECT SUM( matlwrhsstkqtyinmatlbaseunit ) AS quantity,
             SUM( stockvalueincccrcy )           AS value
        FROM i_stockquantitycurrentvalue_2( p_displaycurrency = 'CNY' )
        WHERE product = @ls_response-material
          AND plant = @ls_response-plant
          AND valuationareatype = 1
        GROUP BY product, plant, storagelocation
        INTO TABLE @lt_value.
      IF sy-subrc = 0.
        CLEAR: ls_value,
               lv_price.
        READ TABLE lt_value INTO ls_value INDEX 1.
        IF ls_value-quantity NE 0.
          lv_price = ls_value-value / ls_value-quantity.
        ENDIF.
      ENDIF.
* calculate value information
      ls_response-currentvalue = ls_response-currentstock * lv_price.
      ls_response-period1_v    = ls_response-period1 * lv_price.
      ls_response-period2_v    = ls_response-period2 * lv_price.
      ls_response-period3_v    = ls_response-period3 * lv_price.
      MODIFY lt_response FROM ls_response.
      CLEAR ls_response.
    ENDLOOP.

*paging way to return huge amount of data
    SORT lt_response BY material.
    lv_max_rows = lv_skip + lv_top.
    IF lv_skip > 0.
      lv_skip = lv_skip + 1.
    ENDIF.
    CLEAR lt_responseout.
    LOOP AT lt_response ASSIGNING FIELD-SYMBOL(<lfs_out_line_item>) FROM lv_skip TO lv_max_rows.
      ls_responseout = <lfs_out_line_item>.
      APPEND ls_responseout TO lt_responseout.
    ENDLOOP.
    io_response->set_total_number_of_records( lines( lt_response ) ).
    io_response->set_data( lt_responseout ).
  ENDIF.
ENDMETHOD.

3.3 代码怎么跑:五段结构

段

对应代码

干什么

① 取契约

DATA(lv_top/lv_skip/lv_max_rows/lt_clause/lt_parameter/lt_fields/lt_sort)

取分页、过滤、参数、排序——框架与你的全部契约;lt_clause / lt_fields / lt_sort 本实现取到后未直接用(§3.4)

② 参数与过滤

LOOP AT lt_parameter + CASE <fs_p>-parameter_name;LOOP AT lt_filter_cond + CASE ls_filter_cond-name

参数取成 p_keydate;三个必填筛选转成 range 表 lt_material / lt_plant / lt_bukrs 供 WHERE + IN 使用

③ 库存与收发历史

SELECT FROM i_materialstock_2;SELECT FROM i_materialdocumentitem_2 + 冲销剔除

取截至关键日期的库存与物料凭证行;先删"已被冲销的原单",再跳过"冲销单本身",净额才对

④ 三档账龄 + 金额

三段 IF/ELSEIF 算 period1/2/3;SELECT FROM i_stockquantitycurrentvalue_2( p_displaycurrency = 'CNY' )

用"先进先出近似"把当前库存依次扣进三档;用数量/金额合计求均价 lv_price 再乘出各档金额

⑤ 回填响应

SORT / 内存分页 / set_total_number_of_records / set_data

先报总条数再给"当页"数据;is_data_requested( ) 为假(前端只问总数)时不返回数据

3.4 这段教程代码的简化点(生产前必须知道)

  • 账龄是"按数量近似先进先出":只保证三档数量之和 ≤ 当前库存,不按批次/评估类细分,和实际批次账龄有差异;生产按业务口径补。

  • 收发历史不区分方向:101/201/… 都按"数量"进同一个桶,冲销靠反查剔除而非正负号;只适合"入库账龄"这类简化口径。

  • lt_configr(移动类型范围)没赋值:所以 goodsmovementtype IN @lt_configr 等于不过滤;要限定 101/501 等类型时自己 APPEND。

  • lv_price 只在取价成功时清零:某物料查不到评估价时会沿用上一条物料的价格;要严格就把 CLEAR: ls_value, lv_price. 挪到 SELECT 之前。

  • 分页是"全量拉进内表再切片":几万行内够用;更大要把排序/分页下推数据库(ORDER BY + UP TO)。

3.5 激活与验证

  1. Ctrl+F3 激活,Problems 无红叉。报"接口方法未实现/签名不符"多半是把 METHOD 行贴重复了。

  2. 回 §2.4 第 2 步激活实体。

  3. 本步没有独立界面,最终验证在服务 Publish 后的 Preview(§4.3);临时调试可以写日志,但别改 set_data 逻辑。


4. 动手 3:服务定义 + 服务绑定 → Publish → Preview 出数

custom entity 和普通 RAP 业务对象走同一套服务暴露机制:Definition 决定暴露什么,Binding 决定以什么协议给谁。

4.1 建 Service Definition ZSD_MATERIAL_AGING

步骤

操作

填什么

1

右键包 → New → Other ABAP Repository Object → 搜 service definition → Next

—

2

Name / Description → 选 TR → Finish

ZSD_MATERIAL_AGING / Material Aging

3

用下面源码覆盖模板 → Ctrl+F3 激活

—

@EndUserText.label: 'Material Aging'
service ZSD_MATERIAL_AGING {
  expose z_material_stock_age;
}

4.2 建 Service Binding ZSB_MATERIAL_AGING 并发布

步骤

操作

填什么 / 为什么

1

右键包 → New → Other ABAP Repository Object → 搜 service binding → Next

—

2

Name / Description

ZSB_MATERIAL_AGING / Service binding for material aging

3

Binding Type

OData V2 – UI(教程用 V2;公司查询类默认 V4,见 §7.1)

4

Service Definition

ZSD_MATERIAL_AGING

5

选 TR → Finish → 打开绑定 → Publish

Definition 激活 ≠ 服务可用,必须 Publish

包下的服务定义与绑定 (📄 Day4 脚本 Step 1:建完后包 Z_ONLINESHOP 的 Business Services 下可见 ZSD_MATERIAL_AGING、ZSD_ONLINE_SHOP、ZSB_MATERIAL_AGING、ZSB_ONLINE_SHOP)

4.3 Preview 验证(本章第一个"看得见"的成果)

  1. 在 Service Binding 页面展开 Entity Set → 找 z_material_stock_age → 点 Preview;

  2. 浏览器打开 Fiori Elements 列表页,标题 Inventory Aging,筛选栏有公司代码/工厂/物料(必填)+ 关键日期(参数 P_KEYDATE);

  3. 填一组真实存在的数据(例:公司代码 1310、一个有库存且你有权限的工厂+物料),关键日期选今天 → Go;

  4. 成功判据:列表出数且含三档数量/金额;三档数量之和 ≤ 当前库存;改关键日期再 Go 数据会变(证明参数进了实现类);金额列有值(证明算出 lv_price)。

💡 Preview 用的是开发者权限;业务用户要用必须走 08 章的 IAM App → 业务目录 → 业务角色。别把 Preview 当成"已发布给业务"。

现象

多半原因

怎么办

Preview 空白、无筛选栏

Binding 没 Publish 成功;实体没激活

重新 Publish;确认实体和类都激活

Go 之后 500

实现类运行时报错:标准视图字段与本机 release 不符、filter name 拼错、range 类型不匹配

核对 i_materialstock_2 / i_materialdocumentitem_2 字段;filter 名必须是 MATERIAL / PLANT / COMPANYCODE

报 cx_rap_query_filter_no_range

前端传了实现类没处理的筛选字段

在 LOOP AT lt_filter_cond 补分支,或忽略未知字段

改关键日期数据不变

参数没取到(名字大小写不符)

确认 WHEN 'P_KEYDATE' 与 CDS 参数名一致


5. 动手 4(可选加强):用 BAS 做自定义 UI 并部署回 ABAP 仓库

本节是 Day4 Exercise 4 Step 2–4。做完 §4 主线已验收;只有"注解版式不够用"时才需要往下走,没有 BTP 账号可跳过,不影响 08 章。IAM App / 业务目录 / 业务角色本节不做,统一留到 08 章。

它解决什么:在 BAS(Business Application Studio)用 Fiori generator 基于 ZSB_MATERIAL_AGING 生成完整 UI5 工程(Fiori Elements list report),改完版式部署回 SAP 的 SAPUI5 ABAP Repository——UI 代码住在 SAP 系统里、随 TR 传输,不额外跑 BTP 运行时。

门槛:BTP trial/客户账号 + BAS 订阅;BTP 子账户与 IdP 已有 SAML 信任;S/4HC 侧有 SAP_CORE_BC_COM 与 SAP_CORE_BC_EXT_UI 权限。这三段官方教程已写全细节:

阶段

做什么

官方教程

成功判据

① 连系统

BTP 建 HTTP destination 指向开发租户(Authentication: SAMLAssertion,属性 WebIDEEnabled=true、WebIDEUsage=odata_abap,dev_abap、HTML5.Timeout=60000),下载 BTP 证书到 S/4HC 建通信系统/配信任

abap-custom-ui-bas-connect-s4hc

destination Check Connection 成功;BAS 能列出系统服务

② 建 Dev Space

BAS → Create Dev Space → Name 如 Demo_Fiori → Application Type 选 SAP Fiori → Create,等 RUNNING

appstudio-devspace-fiori-create

Dev Space 状态 RUNNING,能打开 VS Code 式工作台

③ 生成 + 部署

工作台用 Fiori generator(命令面板搜 Fiori,入口名以本机 BAS 版本为准)生成 List Report → 填部署与 FLP 配置 → 部署回 ABAP 仓库

abap-custom-ui-bas-develop-s4hc

终端日志 Deployment Successful;ADT 包里出现 BSP 应用与 Launchpad App Descriptor Item

5.1 生成器三屏:数据源 / 实体 / 项目属性

生成器页面

你选/填什么

依据

Data Source and Service Selection

Data Source:Connect to a System;System:DEV (S4HC)(你建的 destination);Service:ZSB_MATERIAL_AGING (1) - OData V2

选的是 §4 发布的服务,不是 CDS 本体

Entity Selection

Main entity:z_material_stock_ageSet;Navigation entity:None;Table type:Responsive

实体集名 = 实体名 + Set;纯报表无导航

Project Attributes

Module name materialage;Application title material age;Minimum SAPUI5 version 1.130.9 (Source system version);Add deployment configuration = Yes;Add FLP configuration = Yes;其余默认/No

不勾 deployment 就没有部署目标;不勾 FLP 就没有磁贴语义对象

选服务 (📄 Day4 脚本 Step 4:Data Source = Connect to a System,System = DEV (S4HC),Service = ZSB_MATERIAL_AGING (1) - OData V2)

选主实体 (📄 Day4 脚本 Step 4:Main entity = z_material_stock_ageSet,Navigation entity = None,Table type = Responsive)

项目属性 (📄 Day4 脚本 Step 4:Module name materialage、Application title material age、Add deployment configuration 与 Add FLP configuration 都选 Yes)

5.2 部署配置 + FLP 配置

页面 / 字段

填什么

为什么

Deployment → Target

ABAP

部署回 ABAP 仓库(另一选项是 BTP/HTML5 repo)

Deployment → Destination

DEV (S4HC)(阶段①那个)

部署走同一个 destination

Deployment → SAPUI5 ABAP Repository

zmaterialage

系统里 BSP 应用名(全租户唯一)

Deployment → Package / Transport Request

都选 Choose from existing:你的包 Z_Onlineshop + 你的 TR

截图里是培训环境的 ZPARTNER / GBZK900031,换成你自己的

FLP → Semantic Object / Action

materialage / display

08 章挂 IAM/目录靠它定位

FLP → Title / Subtitle

Material Age Report / Display

磁贴标题(§5.4 按它搜)

部署配置 (📄 Day4 脚本 Step 4:Target=ABAP、SAPUI5 ABAP Repository=zmaterialage、Package/TR 选自己的)

FLP 配置 (📄 Day4 脚本 Step 4:Semantic Object materialage、Action display、Title Material Age Report、Subtitle Display)

5.3 部署:npm run deploy 与日志核对

项目根目录打开终端执行 npm run deploy,逐行对照下面的成功日志:

info  abap-deploy-task ZMATERIALAGE Updated LADIs for UI5 Repository ZMATERIALAGE, package Z_ONLINESHOP, transport GBZK900031
info  abap-deploy-task ZMATERIALAGE Launchpad App Descriptor Item ZMATERIALAGE_UI5R was created
info  abap-deploy-task ZMATERIALAGE SAPUI5 Application has been uploaded and registered successfully
info  abap-deploy-task ZMATERIALAGE App available at https://<你的租户>/sap/bc/ui5_ui5/sap/zmaterialage
info  abap-deploy-task ZMATERIALAGE Deployment Successful.

部署日志 (📄 Day4 脚本 Step 4:npm run deploy 终端日志,含 LADI/UI5 Repository、Launchpad App Descriptor Item、App URL、Deployment Successful)

验证:最后一行必须是 Deployment Successful.;把 App available at 的 URL 粘到浏览器,能看到同样的列表页并出数(仍是你的开发权限)。 常见失败:TR 已释放/锁定、包选错、destination 的 HTML5.Timeout 不够(部署 >30 秒会超时)、没有该包开发权限。

5.4 回 ADT 核对生成对象

包的什么位置

应看到

意义

BSP Library → BSP Applications

ZMATERIALAGE

UI5 静态资源(部署产物)

Fiori User Interface → Launchpad App Descriptor Items

ZMATERIALAGE_UI5R(Material Age Report)

磁贴描述项,08 章建 IAM App 要填它的 ID

Identity and Access Management → IAM Apps

新增 ZSB_MATERIAL_AGING_IWSG_IBS 等

RAP 服务 Publish 时自动生成的 IAM App

部署后包里的对象 (📄 Day4 脚本 Step 4:包 Z_ONLINESHOP 下出现 BSP Applications ZMATERIALAGE、Launchpad App Descriptor Item ZMATERIALAGE_UI5R,以及 IAM Apps)

📦 [代码] 这套部署产物在公司代码里就是 *.uiad.json(Launchpad App Descriptor),例如 docs/顾问开发的代码--现有线上代码/sap-fi-master/src/zzqueryfi026_ui5r.uiad.json:appType: ui5、appId: zzqueryfi026、semanticObject: zzqueryfi026 / action: display、tile 标题"金税红票开具"。看到 uiad.json 就知道这应用怎么部署回来的。

什么时候不上 BAS:只要列表+明细+筛选 → L2 注解 + 元数据扩展就够;只想调版式/加字段 → 用 Fiori Adapt UI(产出 uiad.json 适配),别重起 UI5 工程。我司现状正是"L2 为主 + uiad.json 适配 + smbc 维护类 App"。


6. L1 速览:Key User 的自助分析(会判断即可)

工具

能做什么

边界

Custom Analytical Queries(🔗 章首官方链接)

选分析视图做数据源 → 拖维度/度量 → 受限度量与计算度量 → 过滤器 → 预览 → 发布到业务目录

只能在现成分析视图上做,复杂 ABAP 口径做不了

View Browser

浏览已发布的 CDS 分析视图,找"能用哪个数据源"

只是浏览器,不改数据

Manage KPIs and Reports

KPI 磁贴 + 报表(嵌入式 SAC OEM 版)

实时数据、不能连外部数据源、不能做跨源关联(OEM 版限制)

Custom Catalog Extensions

把 L1 产物挂进业务目录(门① 发布链路)

与 08 章 IAM 链路是两条线,别混

💡 口诀:数据源现成 + 只要聚合 → L1;一旦要"按业务规则分桶/分摊/跨表拼装/调接口" → 掉到 L2,也就是本章。


7. 公司实践参考:模式 B 的真实形态(📦 照抄这套骨架)

7.1 规模与形态对照

  • 四个导出包:60 个 query 实体 + 59 个 if_rap_query_provider 实现类(FI 28 / MM 15 / SD 16)+ 41 个 unmanaged implementation 投影 BDEF;服务绑定 100 个 OData V4、仅 2 个 V2——公司查询类默认 V4(命名 ZUI_QUERY_xxx_O4),教程用 V2 UI,两者都能给 Fiori Elements 用。

  • 公司 query 实体 0 个用 with parameters,条件是必填筛选字段(@Consumption.filter.mandatory)——靠值帮助 + 必填把查询范围钉死。

维度

本章教程(Day4)

我司模式 B

实体

z_material_stock_age(小写)

ZC_QUERY_xxx / ZZC_QUERY_xxx(大写,部分 define root custom entity)

条件

CDS 参数 P_KEYDATE + 3 个必填筛选

纯必填筛选字段(无参数)

实现类

逻辑全写在一个 select 里

select 按 get_entity_id( ) 分发 → get_data → read_data 分层

过滤/排序/分页

手写(range 表 + 内存切片)

ZZCL_QUERY_UTILS 三件套统一处理

服务

OData V2 – UI

OData V4(ZUI_QUERY_xxx_O4),投影 BDEF 还挂业务 action(如 zpost / zreject)

UI

BAS 生成 UI5 工程

标准 Fiori Elements + uiad.json 版式适配 / smbc 维护配置

7.2 三件套 ZZCL_QUERY_UTILS(所有查询类的收尾动作)

" ① 按前端过滤条件再过滤(内存)
zzcl_query_utils=>filtering( EXPORTING io_filter = io_request->get_filter(  )
                             CHANGING  ct_data   = lt_result ).
" ② 报总数——必须在 paging 之前!paging 会改 ct_data,晚取总数就错了
IF io_request->is_total_numb_of_rec_requested(  ) .
  io_response->set_total_number_of_records( lines( lt_result ) ).
ENDIF.
" ③ 排序
zzcl_query_utils=>orderby( EXPORTING it_order = io_request->get_sort_elements(  )
                           CHANGING  ct_data  = lt_result ).
" ④ 分页(内存切片)
zzcl_query_utils=>paging( EXPORTING io_paging = io_request->get_paging(  )
                          CHANGING  ct_data   = lt_result ).
" ⑤ 返回
io_response->set_data( lt_result ).

⚠️ ZZCL_QUERY_UTILS 源码不在本地四个导出包里(属未导出的公共基础包),要读实现得找顾问要导出。它的 paging 是内存分页、不是数据库下推,大报表会成瓶颈(对照《销售订单明细报表》教程"方案 A vs 方案 B"的取舍)。

7.3 三个真实样本(关键段节选,完整代码见文件路径;读法:先看分层,再看收尾)

① zzcl_query_mm004.clas.abap(预留单查询,单类自包含):手工只解析关心的 filter,SELECT 把 range 带进 WHERE,最后三件套收尾。

LOOP AT lt_filters INTO DATA(ls_filter).
  TRANSLATE ls_filter-name TO UPPER CASE.
  CASE ls_filter-name.
    WHEN 'Reservation'.
      LOOP AT ls_filter-range INTO DATA(ls_range).
        rs_range-sign   = ls_range-sign.
        rs_range-option = ls_range-option.
        rs_range-low    = ls_range-low.
        rs_range-high   = ls_range-high.
        APPEND rs_range TO lr_Reservation.
        CLEAR rs_range.
      ENDLOOP.
  ENDCASE.
ENDLOOP.

SELECT DISTINCT a~Reservation,
       a~CreationDateTime,
       a~GoodsMovementType,
       a~IssuingOrReceivingPlant,
       a~IssuingOrReceivingStorageLoc,
       a~UserID,
       a~GoodsRecipientName,
       f~ztsxx,
       f~ztszt
  FROM I_ReservationDocumentHeader AS a
  LEFT JOIN ZZT_mm007 AS f ON a~Reservation = f~Reservation
  WHERE a~Reservation IN @lr_Reservation
    AND GoodsMovementType = '311'
  INTO CORRESPONDING FIELDS OF TABLE @lt_result.

zzcl_query_utils=>filtering( EXPORTING io_filter = io_request->get_filter(  ) CHANGING ct_data = lt_result ).
IF io_request->is_total_numb_of_rec_requested(  ) .
  io_response->set_total_number_of_records( lines( lt_result ) ).
ENDIF.
zzcl_query_utils=>orderby( EXPORTING it_order = io_request->get_sort_elements( ) CHANGING ct_data = lt_result ).
zzcl_query_utils=>paging( EXPORTING io_paging = io_request->get_paging(  ) CHANGING ct_data = lt_result ).
io_response->set_data( lt_result ).

② zzcl_query_fi026.clas.abap(金税红票开具):get_data 只做统一收尾,取数拆到 read_data,便于复用与单测。

METHOD get_data.
  DATA: lt_result TYPE TABLE OF zzc_query_fi026.
  TRY.
      DATA(lo_filter)  = io_request->get_filter(  ).
      DATA(lt_filters) = lo_filter->get_as_ranges(  ).
      me->read_data( EXPORTING it_filters = lt_filters
                     IMPORTING et_result  = lt_result ).
      zzcl_query_utils=>filtering( EXPORTING io_filter = io_request->get_filter(  ) CHANGING ct_data = lt_result ).
      IF io_request->is_total_numb_of_rec_requested(  ) .
        io_response->set_total_number_of_records( lines( lt_result ) ).
      ENDIF.
      zzcl_query_utils=>orderby( EXPORTING it_order = io_request->get_sort_elements( ) CHANGING ct_data = lt_result ).
      zzcl_query_utils=>paging( EXPORTING io_paging = io_request->get_paging(  ) CHANGING ct_data = lt_result ).
      io_response->set_data( lt_result ).
    CATCH cx_root INTO DATA(lr_root).
      DATA(lv_msg) = lr_root->get_longtext( ).
  ENDTRY.
ENDMETHOD.

read_data 里两个值得抄的手法:filter 值直接 CORRESPONDING #( ls_filter-range ) 转 range;用 ddcds_customer_domain_value_t( p_domain_name = 'ZZDSTATUSHP' ) 把域值翻成描述文本。

③ zzcl_fi008_head.clas.abap(回款认领报表):一个查询类里组合另一个查询类——先塞固定条件 FI008 = 'X',再调 zzcl_fi007_head 的 read_data 取明细。

APPEND VALUE #( low = 'X'  sign = 'I'  option = 'EQ' ) TO lt_range.
APPEND VALUE #( name = 'FI008'  range = lt_range ) TO lt_filters.
CREATE OBJECT lr_fi007.
CALL METHOD lr_fi007->read_data( EXPORTING it_filters = lt_filters
                                 IMPORTING et_result  = lt_result07 ).
MOVE-CORRESPONDING lt_result07 TO lt_result.

📦 [代码] 常用 released 数据源 TOP(写报表先翻这份,别急着找 SAP 要新视图):I_DELIVERYDOCUMENTITEM(54)、I_SALESDOCUMENT(36)、I_PRODUCT(30)、I_MATERIALDOCUMENTITEM_2(27)、I_BUSINESSPARTNER(19)、I_UNITOFMEASURETEXT、I_DELIVERYDOCUMENT、I_SALESDOCUMENTITEM、I_PLANT、I_BILLINGDOCUMENTITEM、I_EXCHANGERATERAWDATA、I_PURCHASEORDERAPI01、I_JOURNALENTRYITEM、I_ACCOUNTINGDOCUMENTJOURNAL。


8. 本章检查清单

  • z_material_stock_age 已激活,Outline 里参数 + 3 个 key + 8 个度量齐全

  • 能解释 custom entity 与普通 CDS 视图的本质差别(无数据源,implementedBy 委托给类)

  • ZCL_MATERIAL_STOCK_AGE 已激活,能说出 select 的五段结构

  • 能默写"取契约四件套 + set_data 两件套",并解释 is_data_requested( ) 的作用

  • Service Definition + Binding 已 Publish,Preview 出数、改关键日期数据会变

  • 能说出教程代码至少 3 个简化点(账龄近似/不区分方向/lt_configr 未赋值/价格沿用/内存分页)

  • 三件套能写出正确顺序,并解释"报总数为什么必须在 paging 之前"

  • (可选)BAS 部署成功,包里出现 ZMATERIALAGE + ZMATERIALAGE_UI5R,日志 Deployment Successful

  • 能按"数据源现成+简单聚合→L1;要 ABAP 计算→L2;版式不够→L3"做选型

  • 知道报表的 UI 发布要走 08 章(IAM App → Business Catalog → Business Role)


➡️ 下一步