04 · 门② RAP 业务对象开发(从数据模型到能预览的 Fiori 应用)
📄 [教程] Day2 全天练习(Exercise 2 Part 1)+ PPT slide 14-18 🔗 [官方] ABAP RESTful Application Programming Model(ABAP Cloud) · RAP100 官方学习任务组 · RAP 入门博客合集
本章目标:在 03 章的数据模型上继续,亲手完成一个能预览、能建单的 RAP 应用——行为定义(BDEF)→ 行为池(自动订单号/日期)→ 编号范围 → 服务定义/绑定 → 浏览器预览;再对照我司"模式 A/B"读懂生产代码。
本章产出:
# |
对象 |
类型 |
作用 |
|---|---|---|---|
1 |
|
Behavior Definition(BDEF) |
声明业务对象能做什么(增删改、determination) |
2 |
|
行为池类(Behavior Pool) |
实现 determination:自动取订单号、补日期 |
3 |
|
编号范围对象(Number Range Object) |
生成订单号 1、2、3… |
4 |
|
Service Definition |
决定暴露哪些实体 |
5 |
|
Service Binding(OData V2 – UI) |
发布成 Fiori 可用的服务,Preview 建单 |
✅ 衔接:03 章结束时
ZONLINESHOP/ZI_ONLINE_SHOP/ZC_ONLINE_SHOP已建好并激活。本章 Step 1 不再重复建数据模型;若你是从本章跳进来的,请先回 03 章 §3–§5 做完。
0. RAP 是什么:一个公式
RAP 应用 = 数据模型(CDS,第 03 章) + 行为(BDEF + 行为池类) + 服务(Service Definition + Binding) + UI(注解驱动 Fiori Elements)
四层各自的意义:
层 |
对象 |
谁负责 |
|---|---|---|
数据模型 |
CDS 视图(03 章) |
查什么、字段是什么 |
行为 |
BDEF(声明)+ 行为池(实现) |
能增删改吗、校验/动作/编号怎么写 |
服务 |
Service Definition + Binding |
暴露哪些实体、以 OData V2/V4 给谁用 |
UI |
元数据扩展里的 |
列表/明细页长什么样,不写前端代码 |
managed vs unmanaged(选型第一决策):
managed:框架管增删改与持久化(映射到表),你只写"额外逻辑"——自建表的维护类应用首选(本章用这个);unmanaged:你全权管读写(实现 read/lock/save)——只读查询、特殊数据源时用(第 07 章报表即 unmanaged query)。
1. 完整实操(Day2 Exercise 2 Part 1 逐步还原)
场景:新员工在线下单买设备;订单号自动生成(编号范围)、创建日期自动填、交货日期默认 +10 天;发布后能在 Fiori 里建单、看列表。
步骤总览:
Step |
做什么 |
在哪个工具 |
产出 |
|---|---|---|---|
1 |
数据模型(表 + 根视图 + 元数据扩展) |
ADT |
见 03 章,已完成 |
2 |
建行为定义 BDEF |
ADT |
|
3 |
实现行为池 determination |
ADT |
自动订单号/日期 |
4 |
建编号范围对象 |
ADT |
号段定义 |
5 |
维护编号区间 |
Fiori(浏览器) |
可用的号段 |
6 |
建服务定义 |
ADT |
暴露实体 |
7 |
建服务绑定 |
ADT |
OData V2 服务 |
8 |
Preview 预览、建单验证 |
浏览器 |
跑通的 Fiori 应用 |
Step 1(03 章已完成):数据模型
对象 |
类型 |
在 03 章的位置 |
|---|---|---|
|
数据库表 |
§3 动手 1 |
|
CDS 根视图 |
§4 动手 2 |
|
元数据扩展( |
§5 动手 3 |
💡 本章所有对象都建在包
Z_Onlineshop里,用同一个传输请求。开始前确认三个对象都已是"已激活"状态(图标不带红叉)。
Step 2:建行为定义 BDEF
步骤 |
操作 |
为什么 |
|---|---|---|
1 |
右键数据定义 |
BDEF 必须挂在 BO 根视图上 |
2 |
Description: |
选 managed:框架代管持久化 |
3 |
选 TR → Finish |
— |
(📄 Day2 脚本:右键 ZI_ONLINE_SHOP → New Behavior Definition,Implementation Type 选 Managed)
完整源码(覆盖编辑器里的模板):
managed implementation in class zbp_i_online_shop unique;
strict ( 2 );
define behavior for ZI_ONLINE_SHOP alias Online_Shop
persistent table zonlineshop
lock master
authorization master ( instance )
{
field ( numbering : managed, readonly ) Order_Uuid;
field ( readonly ) Orderid, Creationdate;
determination calculate_order_id on modify { create; }
create;
update;
delete;
mapping for zonlineshop
{
Order_Uuid = order_uuid;
Orderid = order_id;
Material = material;
Quantity = quantity;
Creationdate = creationdate;
Deliverydate = deliverydate;
}
}
每一行的意义:
声明 |
意义 |
|---|---|
|
托管模式 + 唯一实现类(行为池) |
|
严格语法模式(新对象一律加,防未来不兼容) |
|
数据落哪张表 |
|
并发锁与权限由本 BO 主导(instance = 可按实例授权,见 08 章) |
|
技术主键由框架自动生成 UUID,且只读 |
|
界面不可改(由行为池自动填) |
|
确定逻辑:创建时自动填派生字段(订单号/日期) |
|
动作 = 界面按钮(本章练习没有自定义动作;需要时见第 07 章模式 B) |
|
CDS 字段 ↔ 表字段映射(托管模式必需) |
用 Quick Fix 生成行为池类:
把光标放在 BDEF 第 1 行
managed implementation in class zbp_i_online_shop unique;上;按 Ctrl+1 → 选 Create behavior implementation class zbp_i_online_shop;
向导里选 TR → Finish,系统自动生成
ZBP_I_ONLINE_SHOP(含lhc_Online_Shop局部类骨架)。
(📄 Day2 脚本:BDEF 首行 Ctrl+1 → 生成行为实现类)
激活 BDEF(Ctrl+F3),Problems 无红叉。
Step 3:实现行为池(determination 自动订单号)
打开包下 Source Code Library → Classes → ZBP_I_ONLINE_SHOP,在 Local Types 里找到以别名命名的 lhc_Online_Shop 类,把 determination 方法补全:
(📄 Day2 脚本:包 → Source Code Library → Classes → ZBP_I_ONLINE_SHOP)
CLASS lhc_Online_Shop DEFINITION INHERITING FROM cl_abap_behavior_handler.
PRIVATE SECTION.
METHODS calculate_order_id FOR DETERMINE ON MODIFY
IMPORTING keys FOR Online_Shop~calculate_order_id.
ENDCLASS.
CLASS lhc_Online_Shop IMPLEMENTATION.
METHOD calculate_order_id.
DATA: online_shops TYPE TABLE FOR UPDATE zi_online_shop,
online_shop TYPE STRUCTURE FOR UPDATE zi_online_shop.
" 1) EML 读自己(IN LOCAL MODE 绕过特性控制读全字段)
READ ENTITIES OF zi_online_shop IN LOCAL MODE
ENTITY Online_Shop ALL FIELDS WITH CORRESPONDING #( keys )
RESULT DATA(lt_result)
FAILED DATA(lt_failed)
REPORTED DATA(lt_reported).
DATA(today) = cl_abap_context_info=>get_system_date( ).
LOOP AT lt_result INTO DATA(ls_read).
online_shop = CORRESPONDING #( ls_read ).
IF online_shop-Orderid IS INITIAL.
" 2) 编号范围服务取号(复用组件,勿自写号码)
TRY.
CALL METHOD cl_numberrange_runtime=>number_get
EXPORTING
nr_range_nr = '01'
object = 'ZOSOID'
IMPORTING
number = DATA(lv_number)
returncode = DATA(lv_rc).
CATCH cx_nr_object_not_found. "对象没建/没区间
CATCH cx_number_ranges.
ENDTRY.
online_shop-Orderid = CONV int4( lv_number ).
online_shop-Creationdate = today.
IF online_shop-Deliverydate IS INITIAL.
online_shop-Deliverydate = today + 10. "默认交期 +10 天
ENDIF.
APPEND online_shop TO online_shops.
ENDIF.
ENDLOOP.
" 3) EML 写回自己(托管模式也要用 EML 更新,不能直接 UPDATE 表)
MODIFY ENTITIES OF zi_online_shop IN LOCAL MODE
ENTITY Online_Shop UPDATE SET FIELDS WITH online_shops
MAPPED DATA(ls_mapped)
FAILED DATA(ls_failed)
REPORTED DATA(ls_reported).
ENDMETHOD.
ENDCLASS.
三段式的意义:
EML 读:
READ ENTITIES ... IN LOCAL MODE是 RAP 内部自读的标准姿势(LOCAL MODE 跳过权限/特性检查);取号:
cl_numberrange_runtime是官方复用组件(Day2 PPT slide 19「Number range solution」)——号码对象ZOSOID要先在 ADT 建(下一步),再去 Fiori「Manage Number Range Intervals」建间隔01(1..9999);EML 写:即使托管模式,修改字段也走
MODIFY ENTITIES ... UPDATE SET FIELDS——业务对象是唯一写入通道,禁止绕过 BO 直接 UPDATE 表。
⚠️ 激活类(Ctrl+F3)后先别急着预览——编号范围对象和区间还没建,建单会取不到号(方法里异常被 catch 了,Orderid 会留空)。
Step 4:建编号范围对象 ZOSOID(ADT)
步骤 |
操作 |
填什么 |
|---|---|---|
1 |
右键包 |
— |
2 |
Name / Description |
|
3 |
Number Length Domain |
|
4 |
其他参数 |
Percent Warning |
5 |
选 TR → Finish |
— |

创建长度域(点 Number Length Domain 旁的创建按钮):
字段 |
值 |
|---|---|
Name |
|
Description |
|
Data Type |
|
Length |
|

最后分别激活域和编号范围对象(Ctrl+F3),Problems 无红叉。
Step 5:维护编号区间 01(Fiori,浏览器)
号码对象只是"定义",真正发号的区间在 Fiori 里维护:
步骤 |
操作 |
说明 |
|---|---|---|
1 |
浏览器打开 D 租户 Fiori Launchpad(与 ADT 同一套 SSO 账号) |
不用重登 |
2 |
打开应用 Export Customizing Transports,先建一个 Customizing 传输请求并记住编号 |
Fiori 侧配置变更要挂 TR,没有它下一步存不了 |
3 |
打开应用 Manage Number Range Intervals,搜索 |
— |
4 |
点 Create 新增区间:Interval Number |
订单号从 1 开始 |
5 |
保存(选第 2 步的 TR) |
区间生效 |

💡 检查点:回到 ADT,打开行为池类,确认
object = 'ZOSOID'、nr_range_nr = '01'与 Fiori 里建的一致——大小写/前导零错一个都取不到号。
Step 6:建服务定义 ZSD_ONLINE_SHOP
步骤 |
操作 |
填什么 |
|---|---|---|
1 |
右键包 → New → Other ABAP Repository Object → 搜索 Service Definition → Next |
— |
2 |
Name / Description |
|
3 |
选 TR → Finish |
— |

完整源码:
@EndUserText.label: 'Service Definition for online shop'
service ZSD_ONLINE_SHOP {
expose ZI_ONLINE_SHOP;
}
激活(Ctrl+F3)。意义:Definition 决定"暴露什么",Binding 决定"以什么协议给谁"。
Step 7:建服务绑定 ZSB_ONLINE_SHOP 并发布
步骤 |
操作 |
填什么 |
|---|---|---|
1 |
右键包 → New → Other ABAP Repository Object → 搜索 Service Binding → Next |
— |
2 |
Name / Description |
|
3 |
Binding Type |
OData V2 – UI |
4 |
Service Definition |
|
5 |
选 TR → Finish |
— |
6 |
打开绑定,点 Publish,等进度条完成 |
发布后才有 OData 服务 |

Step 8:Preview 预览、建单验证
在 Service Binding 页面展开 Entity Set(
ZI_ONLINE_SHOP),点 Preview。浏览器弹出 Fiori Elements 列表页,标题
ShopOrders,列:Order Id / Delivery Date / Material / Quantity / Creation Date。点 Create 建一条订单:Material 填
Test-01,Quantity 填10,Delivery Date 选一个日期 → Save。验证自动逻辑:
Order Id 自动出现(1、2、3…,来自编号范围);
Creation Date = 今天;
Delivery Date 留空时会自动补今天 +10 天。

💡 预览用的是你的开发权限,不需要配 IAM App/业务角色;正式要让业务用户用,走第 08 章发布链路。 ⚠️ Preview 打不开/列表空白:检查 Publish 是否成功、
@UI注解是否激活、BDEF 是否激活、浏览器是否拦截了弹窗。
Step 9(进阶可选):打印闭环
这一节是 Day2 Exercise 2 Part 2(打印),做完 Step 1–8 的应用已经验收;需要给业务单据加打印能力时再往下做。
💡 本节只给链路与代码骨架。打印 API 版(HTTP Service + 通信场景/安排 + Postman + 行为池
.xdp表单模板怎么从零做出来,见 05 章 §1.3。
链路:服务定义取数 → Adobe 渲染 → 打印队列。三件套:
取数据结构(XSD)与数据(XML)——
cl_fp_fdp_services:
DATA(lo_fdp_util) = cl_fp_fdp_services=>get_instance( 'ZSD_ONLINE_SHOP' ).
DATA(lv_schema) = lo_fdp_util->get_xsd( ). "给 Adobe Designer 当数据源
DATA(lt_keys) = lo_fdp_util->get_keys( ).
lt_keys[ name = 'ORDER_UUID' ]-value = lv_uuid.
DATA(lv_xml) = lo_fdp_util->read_to_xml( lt_keys ). "把 BO 实例读成 XML
Adobe LiveCycle Designer 里 New Data Connection → XML Schema(选上一步导出的
.xsd)→ 拖字段排版,存.xdp;模板存表(练习用
ZFORMTEMPLATE存二进制;也可改成 HTTP 上传);渲染并进打印队列:
cl_fp_ads_util=>render_4_pq( "ADS 渲染 PDF
EXPORTING iv_locale = 'en_US'
iv_pq_name = 'DEVTEST' "打印队列名
iv_xml_data = lv_xml
iv_xdp_layout = ls_form-form_binary
is_options = VALUE #( trace_level = 0 ) "生产用 0!
IMPORTING ev_pdl = DATA(lv_pdf) ).
cl_print_queue_utils=>create_queue_item_by_data( "队列项=打印任务
iv_qname = 'DEVTEST' iv_print_data = lv_pdf
iv_name_of_main_doc = |OnlieShopOrder_{ lv_uuid }| ).
前置条件(缺一不可):Adobe LiveCycle Designer、SAP Cloud Print Manager(pull 集成)、通信安排 SAP_COM_0466 + 通信用户、打印队列 DEVTEST。队列在 Fiori「Maintain Print Queues」可见,本地 Cloud Print Manager 拉取落地 PDF。完整截图见 Day2 练习脚本 Part 2(docs/12、SAP公有云开发培训/)。

2. EML 速查(Entity Manipulation Language)
📄 Day2 PPT slide 16-18:EML 让 ABAP 类型安全地操作(自己的或标准的)RAP BO——不经过 OData。
语句 |
用途 |
|---|---|
|
读 |
|
建 |
|
改 |
|
提交/回滚(保存时框架代管,独立调用时要显式) |
|
行为池内部绕过权限/特性 |
|
RAP 错误与消息的标准出口(配 |
调标准 BO 同一套语法——把 zi_online_shop 换成 released BO(如 i_journalentrytp 过账凭证),就是第 05 章的集成手段(我司 FI 在用)。
3. 草稿(Draft)机制要点
BDEF 加 with draft(或投影层 use draft):
自动生成草稿表(如
zdtpp003)——每个草稿表必须手工建(表结构=业务表+草稿管理字段);界面自动获得 Edit/Activate/Discard/Resume/Prepare 动作(我司 PP 的
zc_pp003.bdef投影里use action Edit; use action Activate; ...就是启用它们);etag master LocalLastChangedAt+lock master total etag LastChangedAt是并发与乐观锁的标配注解。
📦 [代码] 完整实例精读(维护类 App 的标准样板):sap-zzpp-master/src/zr_pp003.bdef.asbdef(managed+draft+early numbering)、sap-zzsd-master/src/zr_table_ztsd018.bdef.asbdef。
4. 我司模式 A / 模式 B 对照(学完立刻能读生产代码)
模式 A(维护类应用)= 本章 managed 全家桶 +
smbc(Fiori Elements 表格维护配置)+ MBC 目录。样板:PP 的 ZR_TABLE_ZTPP007、SD 的 ZR_TABLE_ZTSD018(多角贸易 STO 维护)。模式 B(查询报表)=
unmanaged投影 BDEF(readonly 字段 + 业务 action 按钮)+if_rap_query_provider实现类 +ZZCL_QUERY_UTILS三件套(filtering/orderby/paging)。样板:sap-zzmm-master/src/zzcl_query_mm004.clas.abap。详解在第 07 章。
两模式完整步骤清单见第 09 章速查卡。
5. 本章检查清单
能背 RAP 四层公式与 managed/unmanaged 选型
BDEF 每个关键字(strict/lock master/determination/mapping)能说出意义
独立完成"BDEF → Quick Fix 生成行为池 → determination + 编号范围 + EML 写回"全流程
编号范围对象
ZOSOID与区间01建好,建单能取到 1、2、3…服务定义 + OData V2 UI 绑定已发布,Preview 能建单、能看列表
理解
IN LOCAL MODE与 FAILED/REPORTED/MAPPED精读一个我司 bdef + 行为池(推荐 PP zr_pp003 链——注意其类源码未在导出中,可读 SD 的
zbp_r_table_ztsd018)
➡️ 下一步
下一章:05 · 门② 集成与 API——把本章的服务开放给外部系统,或反过来用 EML 调标准业务对象。
主线回顾:01 · 环境准备与开发工具 → 03 · 门② ABAP Cloud 基础与数据字典 → 04