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 |
|
CDS custom entity(带参数 |
已激活 |
2 |
|
查询实现类( |
已激活,Preview 出数 |
3 |
|
Service Definition |
已激活 |
4 |
|
Service Binding(OData V2 – UI) |
Published,Preview 出数 |
5 |
|
BAS 生成的 Fiori Elements 应用(可选加强) |
部署到 SAPUI5 ABAP Repository |
6 |
|
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 右键包 |
所有 ABAP 仓库对象的统一入口 |
2 |
搜 data definition → Next |
CDS DDL 对象(向导里在 Core Data Services 下) |
3 |
Name: |
小写 = OData 实体名;实体集叫 |
4 |
选 03 章那个包和 TR → Finish |
云上对象变更必须挂 TR |
5 |
删掉模板,粘贴 §2.2 源码;先 Ctrl+S 保存,暂不激活 |
实现类还没建,现在激活会报错(见 §2.4) |
(📄 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 每个设计点的意义
注解 / 写法 |
作用 |
|---|---|
|
本实体不查表,数据由这个类提供——custom entity 的核心;类名全大写且与实现类一致 |
|
声明无数据源实体,并带报表参数 |
|
列表页标题 |
|
进顶部筛选栏,position 决定顺序 |
|
筛选必填:不填查不了,避免"全公司全物料"的大查询 |
|
挂标准值帮助: |
|
值帮助联动:选物料时把工厂一起带出/限定 |
|
维度字段。聚合出来的度量绝不能当 key,否则行会被合并错 |
|
数量绑单位字段、金额绑币种字段(单位/币种必须作为字段存在) |
|
列表列: |
|
隐藏 |
💡 源码里有一段注释掉的参数(
p_bukrs / p_plant / p_lgort):教程最初想把这些做成参数,最后改成"必填筛选字段"(值帮助 + 必填对前端更友好)。注释保留不影响激活,不要删。
2.4 激活顺序与验证
先别激活:实现类不存在时激活会报"实现类不存在/不可用",属正常。
先按 §3 建好
ZCL_MATERIAL_STOCK_AGE并激活,再回来激活本实体(Ctrl+F3)。验证(三看):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: |
实现类与实体同名(大写),一眼对上 |
3 |
Interfaces 区域点 Add… → 搜 |
只需这一个接口, |
4 |
选 TR → Finish,打开类 |
ADT 生成 |
5 |
用 §3.2 整段(含 |
只贴方法体的话,去掉首尾两行 |
(📄 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 代码怎么跑:五段结构
段 |
对应代码 |
干什么 |
|---|---|---|
① 取契约 |
|
取分页、过滤、参数、排序——框架与你的全部契约; |
② 参数与过滤 |
|
参数取成 |
③ 库存与收发历史 |
|
取截至关键日期的库存与物料凭证行;先删"已被冲销的原单",再跳过"冲销单本身",净额才对 |
④ 三档账龄 + 金额 |
三段 |
用"先进先出近似"把当前库存依次扣进三档;用数量/金额合计求均价 |
⑤ 回填响应 |
|
先报总条数再给"当页"数据; |
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 激活与验证
Ctrl+F3 激活,Problems 无红叉。报"接口方法未实现/签名不符"多半是把
METHOD行贴重复了。回 §2.4 第 2 步激活实体。
本步没有独立界面,最终验证在服务 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 |
|
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 |
|
3 |
Binding Type |
OData V2 – UI(教程用 V2;公司查询类默认 V4,见 §7.1) |
4 |
Service Definition |
|
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 验证(本章第一个"看得见"的成果)
在 Service Binding 页面展开 Entity Set → 找
z_material_stock_age→ 点 Preview;浏览器打开 Fiori Elements 列表页,标题 Inventory Aging,筛选栏有公司代码/工厂/物料(必填)+ 关键日期(参数
P_KEYDATE);填一组真实存在的数据(例:公司代码
1310、一个有库存且你有权限的工厂+物料),关键日期选今天 → Go;成功判据:列表出数且含三档数量/金额;三档数量之和 ≤ 当前库存;改关键日期再 Go 数据会变(证明参数进了实现类);金额列有值(证明算出
lv_price)。
💡 Preview 用的是开发者权限;业务用户要用必须走 08 章的 IAM App → 业务目录 → 业务角色。别把 Preview 当成"已发布给业务"。
现象 |
多半原因 |
怎么办 |
|---|---|---|
Preview 空白、无筛选栏 |
Binding 没 Publish 成功;实体没激活 |
重新 Publish;确认实体和类都激活 |
Go 之后 500 |
实现类运行时报错:标准视图字段与本机 release 不符、filter name 拼错、range 类型不匹配 |
核对 |
报 |
前端传了实现类没处理的筛选字段 |
在 |
改关键日期数据不变 |
参数没取到(名字大小写不符) |
确认 |
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 指向开发租户( |
destination Check Connection 成功;BAS 能列出系统服务 |
|
② 建 Dev Space |
BAS → Create Dev Space → Name 如 |
Dev Space 状态 RUNNING,能打开 VS Code 式工作台 |
|
③ 生成 + 部署 |
工作台用 Fiori generator(命令面板搜 |
终端日志 |
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: |
实体集名 = 实体名 + |
Project Attributes |
Module name |
不勾 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 仓库(另一选项是 BTP/HTML5 repo) |
Deployment → Destination |
|
部署走同一个 destination |
Deployment → SAPUI5 ABAP Repository |
|
系统里 BSP 应用名(全租户唯一) |
Deployment → Package / Transport Request |
都选 Choose from existing:你的包 |
截图里是培训环境的 |
FLP → Semantic Object / Action |
|
08 章挂 IAM/目录靠它定位 |
FLP → Title / Subtitle |
|
磁贴标题(§5.4 按它搜) |
(📄 Day4 脚本 Step 4:Target=ABAP、SAPUI5 ABAP Repository=zmaterialage、Package/TR 选自己的)
(📄 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 核对生成对象
包的什么位置 |
应看到 |
意义 |
|---|---|---|
|
|
UI5 静态资源(部署产物) |
|
|
磁贴描述项,08 章建 IAM App 要填它的 ID |
|
新增 |
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 |
|---|---|---|
实体 |
|
|
条件 |
CDS 参数 |
纯必填筛选字段(无参数) |
实现类 |
逻辑全写在一个 |
|
过滤/排序/分页 |
手写(range 表 + 内存切片) |
|
服务 |
OData V2 – UI |
OData V4( |
UI |
BAS 生成 UI5 工程 |
标准 Fiori Elements + |
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)
➡️ 下一步
下一章:08 · 权限配置与应用发布——把本章的
ZSB_MATERIAL_AGING/ZMATERIALAGE_UI5R挂成 IAM App → Business Catalog → Business Role,让业务用户真正看到报表。主线回顾:01 · 环境准备与开发工具 → 03 · 门② ABAP Cloud 基础与数据字典 → 04 · 门② RAP 业务对象开发