01 · SFlight:导入并跑通 RAP 参考场景(完整教程)
目标:在自己的 ABAP Cloud 环境里用 abapGit 导入 SAP 官方 SFlight(ABAP Flight Reference Scenario,航班参考场景),跑通 managed RAP 业务对象的读取、创建、审批和 Fiori Elements 预览,最后动手加一个 determination,完成第一次 RAP 扩展。 预计:2–3 小时(首次批量激活对象可能额外 20–40 分钟) | 难度:中 | 前置课程:S4D400 / S4D401 / S4D430 / S4D426 适用环境:SAP BTP ABAP Environment 或 S/4HANA Cloud Public Edition(ABAP Cloud),仓库统一使用
ABAP-platform-cloud分支。 阅读说明:本案例官方仓库没有分步截图,本地也没有对应截图资产;正文另配了 4 张 SAP 官方课程 S4D426 的 RAP / 扩展架构示意图(图注已注明「非本案例截图」),操作步骤仍用完整的菜单路径、字段表、真实代码和每一步的验证点写细;照着点、照着填即可离线跑通。
你会做出什么
你会在自己的 ABAP Cloud 开发环境里得到一个可以打开、可以点、可以改的完整 RAP 参考应用,而不只是一堆导入的对象:
产物 |
位置 / 名称 |
跑通后的样子 |
|---|---|---|
演示包(含 11 个子包) |
ABAP 包 |
Project Explorer 里能展开出 MANAGED、DRAFT、READONLY、UNMANAGED、LEGACY、REUSE 等子包,全部已激活 |
业务对象数据模型 |
|
接口 CDS 视图可预览数据,Travel → Booking → BookingSupplement 组成组合树 |
行为定义与实现 |
|
能看到 create / update / delete、acceptTravel、rejectTravel、copyTravel、validation、determination 的真实写法 |
服务定义与服务绑定 |
|
绑定已 Publish,浏览器里能打开 Fiori Elements 预览 |
演示数据 |
|
列表页有几十条航班差旅记录,可以搜索、筛选、创建 |
一次自定义改造 |
新增 determination |
新建 Travel 时留空 Description,保存后系统自动补上默认文案 |
跑通之后,你会在浏览器里看到一个 Fiori Elements 应用(List Report + Object Page),界面元素大致如下。请把它当作验收时的对照表,界面标签可能随 Fiori Elements 版本略有差异:
界面区域 |
应看到什么 |
|---|---|
列表标题与表头 |
|
工具栏 |
|
明细页(Object Page) |
Travel 的基本信息区,以及关联的 |
审批服务 |
打开 Approver 的绑定后,明细页上有 Accept / Reject 类按钮(按钮文字由动作名 |
状态变化 |
点 Accept 后 Status 变成 |
说明:官方仓库只公开展示了这一段业务流程的源码与 README,没有提供逐步截图。本文因此把「每一步看到什么」写成可核对的文字验证点,不会把课程示意图当作本案例截图。
架构与原理
业务场景
SFlight 模拟一家航空公司的差旅管理:客户(Customer)通过代理(Agency)订机票,先建一张差旅单(Travel),再往差旅单里加预订(Booking),预订还可以挂附加服务(Booking Supplement)。基础主数据包括承运人(Carrier)、机场(Airport)、航班连接(Connection)和具体航班(Flight)。所以它是一个「一个根实体 + 两层组合子实体 + 多张主数据」的标准 RAP 事务型场景,足够用来练完 RAP 的核心机制。
技术分层:从浏览器到数据库
浏览器:Fiori Elements 应用(List Report / Object Page)
│ OData V2 请求
▼
服务绑定 /DMO/UI_TRAVEL_PROC_M_O2 ← 把服务发布成运行时可调用的 endpoint
│
服务定义 /DMO/UI_Travel_Processor_M ← 声明要暴露哪些实体、哪些值帮助
│
投影视图 /DMO/C_Travel_Processor_M(transactional_query)
│
接口 CDS 视图 /DMO/I_Travel_M + 行为定义 /DMO/I_Travel_M(BDEF)
│ 行为实现
▼
实现类 /DMO/BP_Travel_M(LHC_Travel、LCL_Save 等本地处理类)
│ managed 落库
▼
数据库表 /DMO/TRAVEL_M、/DMO/BOOKING_M、/DMO/BOOKSUPPL_M
这张链路就是 RAP 的分层思想:数据模型(CDS)→ 行为(BDEF + 实现类)→ 服务(服务定义 + 绑定)→ UI(Fiori Elements 自动生成)。UI 不是手写的,而是 Fiori Elements 根据投影视图上的 @UI 注解和 OData 元数据渲染出来的,所以只要服务发布成功、注解齐全,预览页就能直接出现。

一次「新建 Travel」请求发生了什么
以 managed 场景的创建为例,请求进入 RAP 运行时之后依次经过:
权限与锁定:BDEF 里声明
authorization master ( none )、lock master,RAP 先做权限检查和实例锁。early numbering:BDEF 声明
early numbering,RAP 在创建阶段就调用/DMO/BP_Travel_M的earlynumbering_create方法,从号段对象/DMO/TRV_M取号,填好travel_id。validation:
validateCustomer、validateAgency、validateDates、validateStatus、validateCurrencyCode、validateBookingFee分别在 save 前校验;不通过就返回错误消息,整单不会保存。determination:
calculateTotalPrice在modify时触发,调用内部 actionrecalcTotalPrice汇总 booking fee 与预订价格,算出total_price。保存(save sequence):managed 场景由框架负责 INSERT/UPDATE;同时 BO 声明了
with additional save,框架会在保存后调用 saver 类LCL_Save的save_modified方法,把变更写入日志表/DMO/LOG_TRAVEL。ETag 与并发:
etag master last_changed_at让前端在更新时带上 ETag,避免两个人同时改一条记录互相覆盖。回读:保存成功后前端重新读取列表/明细,看到新记录和计算出来的总价。
记住这一条主线:BDEF 是「合同」,实现类是「履约」。BDEF 里出现的每个
validation、determination、action、association ... { create; },在/DMO/BP_Travel_M里都能找到同名方法;反过来,实现类里出现的每个处理类方法,也都能在 BDEF 里找到声明。RAP 报错「方法未实现 / 方法不存在」,十有八九是这两边对不上。

仓库里的场景子包
导入 /DMO/FLIGHT 后会自动生成一批子包,每个子包是一套独立的教学场景。本教程只做 MANAGED 主线,其他子包可以作为后续练习:
子包 |
场景 |
说明 |
|---|---|---|
|
托管事务型(本教程主线) |
增删改由框架托管,演示 validation、determination、action、additional save |
|
带草稿的事务型 |
同时提供 OData V2 与 OData V4 绑定,演示草稿(draft)机制 |
|
非托管事务型 |
业务逻辑自己写 save,适合从旧代码迁移(brownfield)的理解 |
|
只读列表报表 |
演示只读 RAP 应用与列表报表 |
|
旧式业务逻辑与演示数据 |
包含数据生成器 |
|
可复用业务对象 |
Supplement、Carrier(多行内联编辑)、Agency(可扩展)等 |
|
层级数据 |
只读与可编辑树形视图 |
|
协作草稿 |
多人协作编辑能力 |
|
分析场景 |
只读分析表,配合分析查询 |
|
RAP 推荐 |
AI 推荐差旅描述、确定性推荐住宿 |
|
跨 BO 草稿 |
两个草稿 BO 通过 cross association 与 draft scope 组合 |

本教程会用到的关键对象
对象 |
类型 |
作用 |
|---|---|---|
|
接口 CDS 视图 + 行为定义 |
根实体与行为「合同」 |
|
接口 CDS 视图 |
组合子实体的数据模型 |
|
投影 CDS 视图 |
面向 Processor 服务的只读/可写视图,带 |
|
投影 CDS 视图 |
面向 Approver 服务的审批视图 |
|
行为实现类 |
处理 validation、determination、action、numbering、save |
|
服务定义 |
暴露 Travel/Booking/BookingSupplement 与值帮助 |
|
服务绑定(OData V2) |
发布 Processor 服务,供 Fiori 预览与调用 |
|
服务定义 + 绑定 |
发布 Approver 服务,提供 acceptTravel / rejectTravel |
|
可执行类 |
生成演示数据(含 managed/draft 等场景的表) |
|
测试类 |
演示 ABAP Unit 测试与 EML、OData 测试写法 |
一个容易忽略的事实:managed 场景的
/DMO/BP_Travel_M打开后,全局类定义只有一行CLASS /dmo/bp_travel_m DEFINITION PUBLIC ABSTRACT FINAL FOR BEHAVIOR OF /dmo/i_travel_m.,真正的lhc_travel、lcl_save等本地处理类在 Local Types / Local Implementations 两个页签里。第 10 步加 determination 时就是在这两个页签里改代码。
准备工作
1. 环境与账号
环境 |
要求 |
说明 |
|---|---|---|
SAP BTP ABAP Environment |
一个可开发的 ABAP Environment 实例(ADT 所需的服务密钥或通信配置已就绪) |
本手册的主线环境 |
S/4HANA Cloud Public Edition |
已启用 Developer Extensibility 的开发系统 |
同样使用 |
权限方面:云环境通常需要开发角色(常见为 SAP_BR_DEVELOPER,实际授予名称以管理员配置为准)。登录语言务必用 English,官方 README 明确要求;非英文登录语言可能在 Fiori 预览、注解文本、abapGit 对象比较时出现额外问题。

2. 要安装的工具
工具 |
用途 |
从哪来 |
|---|---|---|
Eclipse + ABAP Development Tools(ADT) |
开发、建包、导入、激活、预览 |
SAP 官方工具页 |
abapGit(ADT 插件) |
把 GitHub 仓库拉进 ABAP 包 |
Eclipse 插件方式安装: |
浏览器 |
打开 Fiori Elements 预览 |
Chrome / Edge 等现代浏览器 |
GitHub 账号(可选) |
公开仓库一般无需登录;若被要求认证,用 personal access token |
不要用账号密码(GitHub 已不支持密码方式拉取) |
3. 分支:只用 ABAP-platform-cloud
本仓库用于 ABAP Cloud 的分支是 ABAP-platform-cloud,本文所有步骤都基于这个分支,不需要做版本对照。仓库里的其他分支不在本手册范围内。
主分支 main 只放总 README(说明各分支怎么用),staging 是维护用的,两者都不要用来导入。
官方特别提醒:这个仓库的分支改过名。如果你之前已经把某个 ABAP 包关联到旧名字的分支,要先解除关联(Unlink),再按 cloud 分支 README 的 Download 步骤重新关联。老包和新分支混用会出现「对象已存在但版本对不上」之类的问题。
4. 开始前检查清单
能登录目标系统的开发用户,且登录语言是 English。
已安装最新版 ADT,能创建 ABAP Cloud Project 并成功在线。
已安装 abapGit 插件,ADT 里能看到
abapGit Repositories视图。已知使用
ABAP-platform-cloud分支,并把它记下来。有权限新建 ABAP 包,并准备好一个只用于本案例演示内容的传输请求。
网络能访问 GitHub;走代理的话 ADT 与 abapGit 都已配置。
浏览器可以打开系统域名(Fiori 预览要跳浏览器)。
预留 1 GB 左右本地磁盘给 Eclipse 工作区和日志(对象很多,别装到快满的盘)。
知道
/DMO/是演示内容专用命名空间:除导入内容外不要往里面放自己的业务对象。
操作步骤
整套流程大致这样安排:
步骤 |
做什么 |
产出 |
预计时间 |
|---|---|---|---|
1 |
确认环境、选定 cloud 分支 |
记下的分支名 |
5 分钟 |
2 |
安装 ADT / abapGit 并连接系统 |
在线的 ABAP Cloud 项目 |
20–40 分钟 |
3 |
建目标包 |
空包 |
5 分钟 |
4 |
abapGit 克隆仓库 |
未激活的全部对象 |
10–20 分钟 |
5 |
批量激活 |
全部对象可用 |
5–40 分钟 |
6 |
生成演示数据 |
有业务数据的表 |
5 分钟 |
7 |
读懂 managed 对象链 |
能对上 BDEF 与实现类 |
15 分钟 |
8 |
发布服务绑定、Fiori 预览 |
浏览器里的应用 |
10 分钟 |
9 |
创建 Travel、执行审批动作 |
跑通业务闭环 |
20 分钟 |
10 |
加一个 determination |
自动补 Description 的改造 |
30–40 分钟 |
11 |
(可选)跑 ABAP Unit |
测试通过 |
5 分钟 |
12 |
(可选)读懂 EML 调用 |
理解程序化调用方式 |
10 分钟 |
步骤 1:确认环境,选定 cloud 分支
做什么:确认自己的工作环境属于 ABAP Cloud 的两种情况之一,然后统一使用 ABAP-platform-cloud 分支。
怎么做:
确认环境:如果是 SAP BTP ABAP Environment,在 BTP Cockpit 里确认有可开发的 ABAP Environment 实例;如果是 S/4HANA Cloud Public Edition,确认自己拿到的是已开启 Developer Extensibility 的开发系统,并且 ADT 能连上。
确认分支:本文只用
ABAP-platform-cloud。仓库里还有其他分支,是给 S/4HANA 本地部署/私有云准备的,不属本手册范围,不要选。在 ADT 里记住项目类型:必须是 ABAP Cloud Project(Cloud 类型),不是普通的 ABAP Project。
验证:你写下「环境 = BTP ABAP Environment / S/4HANA Cloud Public,分支 = ABAP-platform-cloud」;ADT 里项目可以正常在线,后续步骤都基于它。
步骤 2:安装 ADT 与 abapGit 插件,创建 ABAP Cloud Project
做什么:把开发工具链准备好。ADT 是开发和导入的主战场,abapGit 插件负责把 GitHub 上的源码拉进 ABAP 包。
怎么装:
从 SAP 官方工具页下载并安装最新版 ABAP Development Tools(Eclipse 版),不要用太旧的 ADT,否则 Cloud 服务的 OData V4 / 服务绑定功能可能缺失。首次启动选择 workspace 时用本地普通磁盘目录,不要放网络盘或同步盘,避免大包导入/激活时卡顿。
启动 ADT,
File→New→ABAP Cloud Project,按向导选择你的 ABAP Environment 服务实例(或输入系统 URL + 用户密码),创建项目。确保登录语言是 EN(English):云环境在创建服务实例/项目时按管理员给的配置使用英文登录;建好后可在项目属性里核对语言设置,若不是英文,找管理员确认或重建项目。
安装 abapGit 插件:
Help→Install New Software...→Add...,Location 填http://eclipse.abapgit.org/updatesite/,勾选 abapGit 组件一路安装,最后重启 ADT。添加 abapGit 视图:菜单
Window→Show View→Other...,在对话框里选abapGit Repositories,点Open。
两个容易踩的坑:
项目类型选错:要的是
ABAP Cloud Project(通过 BTP 服务实例/通信配置连接,能用服务绑定、预览等 Cloud 能力)。类型选错时,有的视图会缺失,服务绑定的预览等功能根本不会出现。认证方式:GitHub 已不支持用账号密码做 Git 认证。若 abapGit 要求登录,先在 GitHub 上生成 personal access token,用户名填 GitHub 账号、密码填 token;公开仓库克隆一般不需要认证。
验证:Window → Show View → Other... 里能看到 abapGit Repositories;项目在 Project Explorer 里显示为在线(图标不带离线标记),双击任意 CDS 视图能打开。
步骤 3:创建目标包 /DMO/FLIGHT
做什么:abapGit 必须有一个「落地的包」,导入的对象全部放进这个包及其子包。
包名为什么必须叫 /DMO/FLIGHT:abapGit 的文件夹逻辑(PREFIX)会把仓库里的 src/managed、src/draft 等文件夹映射成「目标包名 + 文件夹后缀」的子包,也就是 /DMO/FLIGHT_MANAGED、/DMO/FLIGHT_DRAFT。如果你把目标包写成别的名字,子包名会跟着变,后面步骤里按文档找子包、找对象就会对不上。名字取好后不要再改;要改就删包重来。
怎么做:
Project Explorer 里右键你的 ABAP Cloud Project →
New→ABAP Package。按向导填写:
Name:/DMO/FLIGHTDescription:Flight Reference ScenarioSuperpackage:/DMO/SAP(官方 README 的写法;如果你的环境向导里没有这一项或没有该父包,按向导实际可选项处理,包名仍保持/DMO/FLIGHT)Software Component:保持向导建议值(通常HOME)
一路
Next,在传输请求步骤选择「新建传输请求」,描述写SFlight demo content。这个传输请求只给本案例的演示内容用,不要和你的其他开发混在一起。Finish。
验证:
Project Explorer 里出现
/DMO/FLIGHT,右键 →Properties能看到包名、父包和软件组件,应与计划一致。传输请求已创建:建包/克隆向导最后会显示请求号,记下来;云环境可在 ADT 的传输视图或请管理员确认。
注意:
/DMO/是 SAP 保留给演示内容的命名空间。本教程第 10 步会为了练习临时修改演示对象,这属于「教学实验」;正式项目里不要把自己的业务对象放进/DMO/,也不要在导入的包里建东西。
步骤 4:用 abapGit 克隆仓库到包里
做什么:把 ABAP-platform-cloud 分支源码拉进 /DMO/FLIGHT。这一步只「拉源码」,拉完对象还是未激活状态。
怎么做:
打开
abapGit Repositories视图,点左上角+(Clone abapGit Repository)。填仓库地址(注意末尾
.git):https://github.com/SAP-samples/abap-platform-refscen-flight.git
点
Next。选择分支
ABAP-platform-cloud,Package填/DMO/FLIGHT,点Next。文件夹逻辑选
PREFIX(官方 README 第 6 步要求),点Next。选择或新建传输请求(建议就是步骤 3 建的那个
SFlight demo content),点Finish。仓库会以Linked状态出现在视图里。右键这个仓库 →
pull,开始下载仓库内容。对象多,几分钟到十几分钟都正常,中途不要关 ADT,也不要同时对同一个包开第二个 abapGit 会话。
这几个输入项各自管什么,填错会怎样:
输入项 |
本案例的值 |
作用 / 填错的后果 |
|---|---|---|
Repository URL |
|
指向仓库;少了 |
Branch |
|
决定对象版本;选错分支会语法错误或激活失败 |
Package |
|
对象落地位置;决定子包名前缀(见步骤 3 的说明) |
Folder logic |
|
文件夹 → 子包的映射规则;官方 README 要求用 PREFIX |
Transport Request |
本案例专用的新请求 |
记录本次导入;与其他开发混用后很难单独发布/回滚 |
验证:
abapGit Repositories视图里状态从Linked变成Pulled Successfully(刷新视图可看进度)。Project Explorer 的
/DMO/FLIGHT下出现子包(应能看到FLIGHT_MANAGED、FLIGHT_DRAFT、FLIGHT_READONLY、FLIGHT_UNMANAGED、FLIGHT_LEGACY、FLIGHT_REUSE等)。随便打开一个 CDS 视图,编辑器会提示对象处于未激活(inactive)状态(对象图标带未激活标记),下一步才激活。
如果中间失败:重新右键
pull即可,abapGit 会跳过已一致的对象;Pull 本身是幂等的,不用怕重复点。
Pull 过程中你会看到视图状态变化:Linked → 拉取进度 → Pulled Successfully。如果状态停在中间,先看 ADT 右下角的 Progress 视图里有没有报错;网络超时、GitHub 凭据过期、分支被改名是三个最常见原因。公开仓库拉取一般不需要登录,如果被要求认证,用 GitHub personal access token,不要反复重试错误密码把账号锁掉。
分支改名提示:如果你把包关联到了旧名字的分支,先解除关联(Unlink)再按上面的步骤重新关联到新分支名,否则会出现对象版本与系统不匹配的报错。
步骤 5:批量激活所有对象
做什么:abapGit 拉下来的对象默认是未激活版本,必须激活才能被 RAP 运行时使用。激活会按依赖关系编译 CDS、生成运行时对象、注册服务。
怎么做:
在 ADT 工具栏点 Activate Inactive ABAP Development Objects(批量激活图标)。
对话框里会列出所有未激活对象;选中属于本案例传输请求的全部对象(一般直接全选),点
Activate。等待。对象上千个,激活几分钟很正常;进度条不动时不要反复点,先看底部 Console/Progress 视图。
激活不是「一次编译完」,而是按依赖顺序推进:先激活数据类型和数据库表,再激活 CDS 视图(接口视图 → 投影视图),然后是行为定义/行为实现类,最后才轮到服务定义和服务绑定。所以有时候你会看到个别对象报「依赖对象未激活」——等前一批激活完成后再激活一次即可,不必从头再来。如果一次性全选总是失败,可以按子包粗略分批:先 /DMO/FLIGHT_LEGACY 和 /DMO/FLIGHT_REUSE(数据类型、表、值帮助最多),再 MANAGED、DRAFT、READONLY、UNMANAGED 等场景包,最后服务绑定。
激活过程中你可能会看到官方 README 提前说明过的两种「正常但不影响」的情况:
警告:服务绑定提示
To enable activation of local service endpoint, generate service artifacts。这不是失败,意思是稍后要在服务绑定里点Publish生成运行工件(第 8 步做)。错误(部分环境出现):
Failed to read the runtime table SRVD_RT_EXTENDS for service …或An active version of the Service Definition … does not exist。说明某个服务定义没导入好,按官方处理办法:① 删除基于该服务定义的服务绑定;② 打开对应服务定义,随便改一个字符(touch)后重新激活;③ 重建刚才删除的服务绑定。
如果激活失败,不要靠猜:打开 ADT 的 Problems 视图(或激活结束后弹出的结果列表)逐条看错误;双击错误条目会跳到出错对象和行号。先修错误再重新激活,比全量重来省时间。最常见的失败原因是分支选错(比如误用了其他分支)和服务定义没有活动版本(见上面第二条)。
验证:
再点一次批量激活图标,对话框为空(或只剩与你自己无关的对象),说明全部已激活。
打开
/DMO/FLIGHT_MANAGED→Behavior Definitions→/DMO/I_Travel_M,能看到完整的 BDEF 源码。试开
/DMO/UI_TRAVEL_PROC_M_O2,编辑器能打开(还没 Publish,预览按钮暂时不可用)。/DMO/FLIGHT_LEGACY里的数据生成器类/DMO/CL_FLIGHT_DATA_GENERATOR能正常打开(步骤 6 会运行它)。Project Explorer 里本案例对象的图标不再带未激活标记;如果个别对象仍显示未激活,通常是它的依赖还没激活(例如先 CDS 后服务),单独选中它再激活一次即可。
步骤 6:生成演示数据
做什么:导入的只是源码和表结构,表里没有业务数据。官方提供了一个数据生成器类,跑一次就会把航班、客户、代理、Travel、Booking 等数据写进去,并重置相关号段。
这个生成器会写哪些表:它运行后会生成航班参考场景的主数据(承运人、机场、航班连接、航班)和业务数据(客户、代理、Travel 以及各场景对应的 Booking、Booking Supplement 表),managed 场景的 /DMO/TRAVEL_M、/DMO/BOOKING_M、/DMO/BOOKSUPPL_M 也在其中。原理是:不同场景子包以 BAdI 实现的形式各自注册了一段数据生成逻辑,/DMO/CL_FLIGHT_DATA_GENERATOR 负责按顺序调用它们。
怎么做:
Project Explorer 展开
/DMO/FLIGHT_LEGACY→Source Code Library→Classes。找到
/DMO/CL_FLIGHT_DATA_GENERATOR,双击打开。按
F9(或右键 →Run As→ABAP Application (Console))执行。在 Console 里看输出,等它跑完(几十秒级)。如果 Console 抛异常,先看第一条异常:生成器按 BAdI 注册顺序依次调用各场景的生成逻辑,后面的报错多半是第一条的连锁反应。
注意:这个类只负责「跑一遍所有场景已注册的数据生成 BAdI 实现」,
/DMO/FLIGHT_MANAGED、/DMO/FLIGHT_DRAFT等子包里的*_DATA_GENERATOR_*类并不直接运行。所以你一定是在/DMO/FLIGHT_LEGACY里运行CL_FLIGHT_DATA_GENERATOR,而不是运行 managed 子包里那个。
跑之前先确认两件事:一是步骤 5 已经全部激活(生成器要写表、要取号段,对象没激活会抛异常);二是你运行的是 if_oo_adt_classrun 可执行类,Console 里应出现类似「开始生成 / 已生成 N 条」的输出。生成器内部会重置号段并写入演示数据,所以跑完看到的 Travel ID 是它分配的,不是你手输的。
验证:
双击
/DMO/TRAVEL_M打开表编辑器,切到Data Preview页签(或按F8),能看到多条记录。右键
/DMO/I_Travel_M→Open With→Data Preview,数据与表一致;再试/DMO/I_Booking_M,确认子实体也有数据。打开
/DMO/TRAVEL(Legacy 旧表)对比:旧表和新表里的 Travel 数量、日期分布大致对应,说明生成器把旧场景数据也铺好了。如果表还是空的:确认步骤 5 已全部激活、执行的是 Legacy 包里的生成器、Console 没有报错;再跑一次通常能补齐(演示环境里数据重复不影响后续练习,清数据就重新生成或忽略重复行)。
步骤 7:对照源码读懂 managed 对象链
做什么:在跑 UI 之前先把「行为定义 ↔ 实现类」的关系看明白。这是 RAP 最容易糊涂的地方,也是本案例最大的学习价值。
怎么做:依次打开下面四个文件,对照着看:先看数据模型,再看行为「合同」,再看投影,最后看实现。
(0)接口 CDS 视图 /DMO/I_Travel_M:在 /DMO/FLIGHT_MANAGED 的 CDS 数据定义里打开(可以直接在 Project Explorer 里搜索 /DMO/I_Travel_M)。它定义数据模型,真实源码摘录如下:
@AccessControl.authorizationCheck: #NOT_REQUIRED
@EndUserText.label: 'Travel view - CDS data model'
define root view entity /DMO/I_Travel_M
as select from /dmo/travel_m as Travel -- the travel table is the data source for this view
composition [0..*] of /DMO/I_Booking_M as _Booking
association [0..1] to /DMO/I_Agency as _Agency on $projection.agency_id = _Agency.AgencyID
association [0..1] to /DMO/I_Customer as _Customer on $projection.customer_id = _Customer.CustomerID
association [0..1] to I_Currency as _Currency on $projection.currency_code = _Currency.Currency
association [1..1] to /DMO/I_Overall_Status_VH as _OverallStatus on $projection.overall_status = _OverallStatus.OverallStatus
{
key travel_id,
agency_id,
customer_id,
begin_date,
end_date,
@Semantics.amount.currencyCode: 'currency_code'
booking_fee,
@Semantics.amount.currencyCode: 'currency_code'
total_price,
currency_code,
overall_status,
description,
/* 省略部分审计字段(created_by、created_at 等),完整内容以源码为准 */
_Booking,
_Agency,
_Customer,
_OverallStatus
}
几个读法:
define root view entity声明这是 RAP BO 的根实体,key travel_id是语义主键。composition [0..*] of /DMO/I_Booking_M:Travel → Booking 是组合关系,子实体生命周期依附根实体,RAP 会自动维护层级;普通association只是引用(Agency、Customer、Currency、状态值帮助),不参与生命周期。数据源是
/DMO/TRAVEL_M表,@Semantics.amount.currencyCode注解告诉 UI「金额字段要和币种字段配对」,Fiori Elements 才能正确显示金额。@AccessControl.authorizationCheck: #NOT_REQUIRED表示演示内容没有配 DCL(数据控制语言)权限对象,所以不配权限也能预览;生产项目里应当补 DCL。
(1)接口行为定义 /DMO/I_Travel_M:在 /DMO/FLIGHT_MANAGED → Behavior Definitions 里打开。核心内容如下(摘自仓库源码,只摘录根实体 travel 部分,文件里还有 booking、booksuppl 两个实体的行为定义):
managed implementation in class /DMO/BP_TRAVEL_M unique;
strict ( 2 );
define behavior for /DMO/I_Travel_M alias travel
implementation in class /DMO/BP_TRAVEL_M unique
persistent table /dmo/travel_m
with additional save
etag master last_changed_at
lock master
early numbering
authorization master ( none )
{
// administrative fields: read only
field ( readonly ) last_changed_at, last_changed_by, created_at, created_by;
// mandatory fields that are required to create a travel
field ( mandatory ) agency_id, customer_id, begin_date, end_date, overall_status, booking_fee, currency_code;
// Semantic Key field, which is readonly for the consumer, value is assigned in early numbering
field ( readonly ) travel_id;
// mapping entity's field types with table field types
mapping for /dmo/travel_m corresponding;
// standard operations for travel entity
create;
update;
delete;
// instance action and dynamic action control
action ( features : instance ) acceptTravel result [1] $self;
action ( features : instance ) rejectTravel result [1] $self;
// internal action that is called by determinations
internal action ReCalcTotalPrice;
// instance factory action for copying travel instances
factory action copyTravel [1];
// validations
validation validateCustomer on save { create; field customer_id; }
validation validateAgency on save { create; field agency_id; }
validation validateDates on save { create; field begin_date, end_date; }
validation validateStatus on save { create; field overall_status; }
validation validateCurrencyCode on save { create; field currency_code; }
validation validateBookingFee on save { create; field booking_fee; }
determination calculateTotalPrice on modify { create; field booking_fee, currency_code; }
// create booking by association
association _Booking { create ( features : instance ); }
}
先看第一行和 { 之前的部分——它们是合同的前提,决定了「谁负责持久化、如何并发、如何编号」:
managed implementation in class /DMO/BP_TRAVEL_M unique;:managed 表示 CRUD 落库由 RAP 框架托管,实现类名字必须和下面implementation in class一致;unique表示这个实现类专属于该 BO(一个 BO 对应一个专属实现类,不与其他 BO 共享)。strict ( 2 );:严格模式 v2。字段修改必须在 BDEF 里显式声明(create;、update;、determination等),不允许隐式改数据;好处是编译期就能发现「没声明的副作用」,代价是写实现时要更严谨。persistent table /dmo/travel_m+mapping for /dmo/travel_m corresponding:告诉框架持久化到哪张表、实体字段和表字段如何对应。with additional save:除了框架的默认落库,还要执行额外的保存逻辑(saver 类LCL_Save,写/DMO/LOG_TRAVEL)。etag master last_changed_at、lock master、early numbering、authorization master ( none ):并发控制、锁、提前编号、权限策略。
{ ... } 里才是实体行为清单。逐行读法:
BDEF 里的写法 |
含义 |
实现类里对应的东西 |
|---|---|---|
|
持久化由 RAP 框架托管 |
不需要写 save 方法(但本 BO 有 additional save,见 saver 类) |
|
严格模式,隐式行为被收紧,字段修改必须显式声明 |
编译期就会拦住很多「没声明字段却改字段」的写法 |
|
用最后修改时间做 ETag 并发控制 |
前端 update 时自动带 ETag |
|
由 RAP 管理实例锁 |
不需要自己写 ENQUEUE/DEQUEUE |
|
创建阶段就分配编号 |
|
|
创建时必须给值,UI 自动标必填 |
前端表单自动生效 |
|
实例动作,返回值是自身;按钮是否可用由 feature 控制 |
|
|
仅供内部(determination)调用的动作 |
|
|
工厂动作,一次复制生成一个新实例 |
|
|
保存前校验 |
|
|
字段变化时自动计算 |
|
|
允许通过关联创建子实体 |
|
(2)投影行为定义 /DMO/C_Travel_Processor_M:这是「对外暴露什么」的合同,内容短得多(只摘录根实体部分):
projection;
strict(2);
define behavior for /DMO/C_Travel_Processor_M alias TravelProcessor
use etag
{
field ( readonly ) TotalPrice;
use create;
use update;
use delete;
use action copyTravel;
use association _BOOKING { create; }
}
它只 use(复用)了 copyTravel,没有暴露 acceptTravel / rejectTravel——所以 Processor 服务里看不到审批按钮。审批按钮在另一套投影 /DMO/C_Travel_Approver_M 和服务绑定 /DMO/UI_TRAVEL_APPR_M_O2 里,通过 use action acceptTravel; / use action rejectTravel; 暴露。这个「同一业务对象、两套投影、两个服务」的拆分,是 RAP 里非常典型的按角色划分服务的做法。
(3)行为实现类 /DMO/BP_Travel_M:打开后切到 Local Types 与 Local Implementations 页签。你会看到 lhc_travel 里成对出现的方法,例如:
validate_customer、validate_agency、validate_dates、validate_travel_status、validate_currencycode、validate_bookingfeecopyTravel、set_status_accepted、set_status_rejected、get_featuresrecalctotalprice(内部 action)、calculatetotalprice(determination)earlynumbering_create、earlynumbering_cba_booking还有一个
lcl_save类,重定义了save_modified,把变更写进/DMO/LOG_TRAVEL(这正是 BDEF 里with additional save的来源)
handler 方法有固定的签名模式,认准这几种就不会迷路:
处理类型 |
声明关键字 |
方法形状(简化) |
说明 |
|---|---|---|---|
validation |
|
|
通过 |
determination |
|
|
在事务缓冲里读数据、改数据,不能返回消息 |
action |
|
|
执行动作并回传结果 |
numbering |
|
|
负责 early numbering / 子实体编号 |
saver |
继承 |
重定义 |
只在 additional save 场景需要 |
方法参数里的 keys 是触发方传来的实例键(类型是「按实体生成的表类型」),%tky 是实例的事务键,%control 记录字段是否被修改。写自定义逻辑时最常用的套路就是:用 keys 读数据 → 在内存里判断/计算 → 用 MODIFY ENTITIES … IN LOCAL MODE 写回。第 10 步的 determination 就完全遵循这个套路。
(4)服务定义 /DMO/UI_Travel_Processor_M:它把投影视图和值帮助打包成一个服务,真实内容(节选):
@EndUserText.label: 'Service definition for managing travels'
@ObjectModel.leadingEntity.name: '/DMO/C_Travel_Processor_M'
define service /DMO/UI_Travel_Processor_M {
expose /DMO/C_Travel_Processor_M as Travel;
expose /DMO/C_Booking_Processor_M as Booking;
expose /DMO/C_BookSuppl_Processor_M as BookingSupplement;
expose /DMO/I_Supplement_StdVH as Supplement;
expose /DMO/I_Customer_StdVH as Passenger;
expose /DMO/I_Agency_StdVH as TravelAgency;
expose /DMO/I_Carrier_StdVH as Airline;
expose /DMO/I_Connection_StdVH as FlightConnection;
expose /DMO/I_Flight_StdVH as Flight;
expose /DMO/I_Airport_StdVH as Airport;
expose /DMO/I_Overall_Status_VH as OverallStatus;
expose /DMO/I_Booking_Status_VH as BookingStatus;
expose I_CurrencyStdVH as Currency;
expose I_CountryVH as Country;
}
读法:expose … as … 决定服务里实体和值帮助的对外名字;@ObjectModel.leadingEntity.name 声明服务的「主实体」(Fiori 预览默认打开它)。值帮助(_StdVH、_VH)也是通过这里暴露的,缺一个,UI 上对应字段的 F4 值帮助就出不来。这个服务定义再被 _O2 服务绑定按 OData V2 发布——「服务定义 = 暴露什么,服务绑定 = 用什么协议发布」就是 RAP 服务层的分工。
验证:在 /DMO/I_Travel_M 里 Ctrl+F 搜 acceptTravel,能在 /DMO/BP_Travel_M 的 Local Types 里搜到 set_status_accepted FOR MODIFY … FOR ACTION travel~accepttravel;反过来搜 determination,能找到 calculatetotalprice FOR DETERMINE ON MODIFY。两边能一一对应,说明你看懂了。
步骤 8:发布服务绑定,打开 Fiori Elements 预览
做什么:把服务定义「变成」运行时可调用的 OData endpoint,然后用 ADT 内置预览确认 UI 能跑。
怎么做:
Project Explorer 展开
/DMO/FLIGHT_MANAGED→Service Bindings→ 双击/DMO/UI_TRAVEL_PROC_M_O2(描述是 "UI service for processing travels (OData, version 2)")。在编辑器右上角点
Publish(有的 ADT 版本叫Publish Local Service Endpoint)。等状态变成已发布/生成完成。如果 Publish 按钮是灰的,先确认服务定义/DMO/UI_Travel_Processor_M已经是活动版本(回到步骤 5 检查激活),以及当前用户有该包的开发/传输权限。点
Preview(或Preview...)。ADT 会打开浏览器窗口,加载 Fiori Elements 的 List Report。
Publish 到底做了什么:服务绑定本身只是「声明把这个服务定义按 OData V2 暴露出去」,Publish 才会生成 OData 运行时需要的工件($metadata、模型、运行时注册),并激活本地服务 endpoint。所以「服务定义已激活」≠「服务可用」,中间差的就是这一步 Publish。编辑器里通常能看到服务 URL(形如 /sap/opu/odata/sap/...),点开或复制到浏览器能看到服务的 $metadata 文档——如果你能打开 $metadata 但预览页打不开,问题多半在前端/UI 注解,而不是服务本身。
为什么本案例用 OData V2 的绑定:managed 场景提供了 _O2(OData V2)绑定,Fiori Elements 预览支持成熟、界面最接近经典 List Report;仓库的 draft 场景还额外提供 _O4(OData V4)绑定,后面想学 V4 时可以直接打开那个绑定。选哪个绑定只影响协议版本,不影响业务对象本身。
验证:
浏览器里出现
Travels列表,且列表里有步骤 6 生成的数据行。地址栏是当前系统的预览地址(不需要额外的 communication arrangement;预览用的是本地服务 endpoint)。
打开服务 URL 能看到
$metadata(OData 元数据 XML),说明服务已真正发布;顺手记下这个 URL,后面用 EML/HTTP 客户端调试时会用到。如果预览是空白或 404:先回步骤 5 确认对象已全部激活,再确认本步骤第 2 步的 Publish 真的成功(编辑器里应有生成日志/状态提示)。
预览与正式发布是两件事:ADT 的 Preview 用本地 endpoint 方便开发调试;要让外部应用(例如 BTP 上的 Fiori 应用或集成流)调用,还需要在 ABAP 环境里配置 Communication Scenario / Communication Arrangement / 通信用户,这超出本案例范围,后续课程会讲。
步骤 9:跑通创建、校验与审批动作
做什么:把「读、写、动作」三条路都走一遍,这是本案例的验收核心。
9.1 新建一条 Travel(Processor 服务里)
在预览页点
Create。如果按钮点了没反应,先看浏览器开发者工具里的网络请求和 ADT 日志里有没有 401/403,再怀疑对象本身。按下面这张表填字段(值帮助用输入框右侧的
F4/ 值帮助图标选择):
字段 |
必填 |
怎么填 / 示例 |
说明 |
|---|---|---|---|
Travel ID |
否 |
留空 |
|
Agency ID |
是 |
值帮助选一个已存在的代理 |
校验 |
Customer ID |
是 |
值帮助选一个已存在的客户 |
校验 |
Begin Date / End Date |
是 |
例如「今天 + 30 天」/「今天 + 40 天」 |
|
Overall Status |
是 |
值帮助里选 |
|
Booking Fee |
是 |
例如 |
|
Currency Code |
是 |
值帮助选一个已存在的币种(如 EUR) |
|
Description |
否 |
留空 |
第 10 步的 determination 会用到这个字段 |
点
Save。保存成功后回到列表,多出一行。
保存失败时不用慌,对照实现类里六个 validation 方法的真实规则逐条排查(这些规则都来自 /DMO/BP_Travel_M 源码):
校验方法 |
代码里的规则 |
界面上表现为 |
|---|---|---|
|
|
提示客户不存在 / 未填客户 |
|
|
提示代理不存在 / 未填代理 |
|
|
提示日期顺序错误,或开始日期早于今天 |
|
状态只能是 |
提示状态无效 |
|
币种必填且必须存在于 |
提示币种为空 / 不存在 |
|
|
提示 booking fee 无效(负数) |
注意这些 validation 的声明是
on save { create; … },也就是只在创建时触发。所以「先建成合法数据、再改成非法」不会在本 BO 里被拦(这是演示内容的设定,不是 bug);负向测试要在 Create 流程里做。
验证:新行出现;打开明细页,Total Price 已经被 calculateTotalPrice 算出来(只有 booking fee、没有 booking 时,总价应等于 booking fee);Created By 是当前用户。这证明 managed 落库、early numbering、determination 三条机制都正常。
9.2 故意触发 validation(负向测试,都在 Create 里做)
依次试下面四种「坏数据」,每次点 Save 都应该被拦下:
试什么 |
预期结果 |
对应校验 |
|---|---|---|
Begin Date 晚于 End Date |
保存失败,提示日期顺序 |
|
Begin Date 早于今天(例如昨天) |
保存失败,提示开始日期太早 |
|
Booking Fee 填负数(例如 |
保存失败,提示费用无效 |
|
不用值帮助、手敲一个不存在的 Customer ID |
保存失败,提示客户不存在 |
|
把每个字段改回合法值后再 Save,应该成功——这说明失败的是数据校验,不是对象/服务坏掉。这正是 validation 与 determination 的区别:validation 负责「拦住错数据」,determination 负责「算对默认值/派生值」。
9.3 审批动作(Approver 服务里)
回到 ADT,打开
/DMO/FLIGHT_MANAGED→Service Bindings→/DMO/UI_TRAVEL_APPR_M_O2,同样先Publish,再Preview。在列表里选中一条你新建的 Travel,打开明细页。
点审批按钮
Accept(按钮标签由动作名生成,可能显示为Accept或Accept Travel)。
本案例的状态值是固定的三个:O = Open、A = Accepted、X = Cancelled(实现里 set_status_accepted 写 A,set_status_rejected 写 X;validate_travel_status 也只接受这三个值)。
验证:状态变成 A(Accepted)。再点一次,按钮会置灰——这是 get_features 方法按当前 overall_status 动态控制 acceptTravel / rejectTravel 的可用性(已 Accepted 就不能再 Accept,已 Rejected 就不能再 Reject)。换另一条记录点 Reject,状态变成 X(Cancelled/Rejected)。再打开刚才 Accepted 的那条记录,确认 Reject 按钮仍然可用(get_features 只禁用「已达成」的那个动作)。
9.4 复制动作(Processor 服务里)
回到 Processor 预览,在列表里选中一条记录,点 Copy Travel。
验证:生成一条新的 Travel(factory action 的典型用法),主键由号段重新分配。实现类里的 copyTravel 还做了几件值得注意的事:复制时排除 travel_id,把新单的 begin_date 设为系统当天、end_date 设为 30 天后、状态重置为 O(Open),并通过 CREATE BY \_Booking / CREATE BY \_BookSupplement 把原单的预订和附加服务一起复制成子实体。这正好演示了 EML 的「带关联创建」(create-by-association)。
9.5 验证 additional save 的副作用(推荐做)
第 7 步提过 /DMO/BP_Travel_M 里有 save_modified,把变更写进 /DMO/LOG_TRAVEL。做一次实测:新建一条 Travel(触发 CREATE 日志)→ 在 Approver 预览里 Accept 它(触发 overall_status 变更日志)→ 回到 ADT 双击 /DMO/LOG_TRAVEL 看 Data Preview,应能看到 changing_operation、changed_field_name、changed_value、created_at 等列,而且记录和你刚才的操作对得上。
验证:日志表里出现你刚做的变更记录。这证明 managed BO 的「additional save」确实在保存序列里执行了,也说明 determination/action 改的字段最终是通过 save sequence 落库、落日志的。如果一条都看不到,先检查步骤 5 是否把 /DMO/FLIGHT_MANAGED 激活完整。
9.6 验证列表查询能力
最后把「读」也验一遍:
在 Processor 列表页的搜索框里输入一条 Travel 的 ID 或 Agency,回车,列表应只剩匹配记录。
点
Adapt Filters(或筛选区),把 Status 加为筛选条件并选O,列表应只显示 Open 的记录。点某列列头排序(例如 Begin Date),确认升序/降序生效。
验证:搜索、筛选、排序都正常返回。列表查询最终执行的是投影视图和底层接口视图的 CDS 查询——投影视图上的 @Search.searchable: true 和字段上的 @Search.defaultSearchElement 注解,决定了哪些字段参与全文搜索。这一步能同时验证数据模型、服务层和 UI 注解三者是通的。
步骤 10:加一个 determination(真正动手)
做什么:给根实体加一个 determination,让「新建 Travel 时如果没填 Description,系统自动补一句默认说明」。这是最小、最安全、效果又可见的扩展练习。
为什么选 determination:RAP 里 determination 由框架在保存前自动调用,不需要在 UI 或 OData 层写逻辑;它适合做「默认值、派生值、汇总值」这类业务逻辑。对比一下:
机制 |
触发时机 |
典型用途 |
本案例例子 |
|---|---|---|---|
validation |
保存前校验 |
拦截非法数据 |
|
determination |
字段变化(modify)时自动执行 |
补默认值、算派生值 |
|
action |
用户/程序显式调用 |
改状态、复制等业务动作 |
|
save(additional save) |
框架落库后 |
写日志、触发外部处理 |
|
10.1 修改行为定义 /DMO/I_Travel_M
在 BDEF 里找到已有的 determination 那一行,在它下面加一行:
determination calculateTotalPrice on modify { create; field booking_fee, currency_code; }
determination setDefaultDescription on modify { create; }
含义:创建时执行 setDefaultDescription。on modify { create; } 里的触发器列表决定它什么时候跑——这里只有 create,所以只在新建实例时执行;如果你写成 { create; update; },更新时也会跑(但会带来重复执行的开销,本练习不需要)。保存并激活这个 BDEF(工具栏 Activate,快捷键 Ctrl+F3)。
顺便说明:BDEF 里只写「什么时候触发、触发哪个方法」,具体逻辑全在实现类里;RAP 会在激活时做一致性检查——如果 BDEF 里声明了 determination 但实现类里没有对应方法,激活就会报错。所以 10.1 和 10.2/10.3 必须成对完成。
10.2 在实现类里声明方法
打开 /DMO/BP_Travel_M,切到 Local Types 页签,在 CLASS lhc_travel DEFINITION … 的 PRIVATE SECTION 里、已有 determination 方法(calculatetotalprice FOR DETERMINE ON MODIFY)旁边加:
METHODS setdefaultdescription FOR DETERMINE ON MODIFY
IMPORTING keys FOR travel~setdefaultdescription.
10.3 写实现
切到 Local Implementations 页签,在 CLASS lhc_travel IMPLEMENTATION. 里加方法实现:
METHOD setdefaultdescription.
" 读取本次被创建/修改的实例的 description 字段
READ ENTITIES OF /DMO/I_Travel_M IN LOCAL MODE
ENTITY travel
FIELDS ( description )
WITH CORRESPONDING #( keys )
RESULT DATA(travels).
" 用户已经填了描述的就不要覆盖
DELETE travels WHERE description IS NOT INITIAL.
IF travels IS NOT INITIAL.
MODIFY ENTITIES OF /DMO/I_Travel_M IN LOCAL MODE
ENTITY travel
UPDATE FIELDS ( description )
WITH VALUE #( FOR travel IN travels
( %tky = travel-%tky
description = 'Created by RAP determination' ) ).
ENDIF.
ENDMETHOD.
几个要点:
IN LOCAL MODE表示绕过权限检查、直接在本地事务缓冲里读写,这是 determination/validation 实现里的标准写法(仓库里calculateTotalPrice、validate_customer都是这个模式)。READ ENTITIES … WITH CORRESPONDING #( keys )用触发方传来的 keys 定位实例,然后只读需要的字段。为什么不直接按 keys 写默认值?因为用户可能在 UI 上自己填了 Description,直接覆盖会丢用户输入;先读再判断才是幂等的。写回时用
%tky(事务键)匹配实例,只改description一个字段。%tky是 RAP 生成的事务键(包含 key 字段和草稿标识等),比手拼 key 字段可靠。方法名与 BDEF 里的 determination 名对应(ABAP 大小写不敏感,仓库风格是全小写方法名)。
方法里不要写
COMMIT WORK/COMMIT ENTITIES:determination 运行在 RAP 的事务缓冲里,提交由框架统一处理;自己提交会破坏整个 RAP 保存序列。determination 的职责是「改数据」;需要拦住并报错的场景用 validation(用
reported/failed返回消息)。这两类机制不要混用。
10.4 激活并重新发布
先激活实现类
/DMO/BP_Travel_M,再确认/DMO/I_Travel_M也是已激活状态(两个对象有依赖,建议一起批量激活一次)。回到
/DMO/UI_TRAVEL_PROC_M_O2,再点一次Publish,确保运行时的行为元数据刷新。
激活失败通常就两类原因:方法没在 Local Types 里声明(报「方法未实现」类错误),或者方法名与 BDEF 里的 determination 名不一致(大小写无所谓,拼写必须一致)。看到错误不要急着删代码,先看错误消息指向哪个对象/哪一行。
10.5 验证
重新打开 Processor 预览(浏览器刷新即可),点
Create,Description 故意留空,其余字段按 9.1 填好,保存。打开这条新记录的明细页,Description 应显示
Created by RAP determination。再建一条、这次手填 Description(例如
My own text),保存后应保留你填的内容,不会被覆盖——这是DELETE travels WHERE description IS NOT INITIAL的作用。数据层复核:
/DMO/TRAVEL_M的 Data Preview 里,新记录的DESCRIPTION列有值。想确认 determination 真的被调用:在
/DMO/BP_Travel_M的setdefaultdescription方法第一行打断点(双击行号左侧),回到预览页新建一条 Travel,执行到断点时调试器会停在方法里;按F5/F6观察keys和travels的内容,就能看到「读到了哪条、有没有被 DELETE 过滤」。这是排查 RAP 行为实现最有效的手段,比在 UI 上看结果猜原因快得多。回归检查:打开一条修改前就已存在的旧记录,Description 应保持原样(determination 只在 create 触发,不会批量改旧数据)。
10.6 还原与 Clean Core 提醒
还原步骤(按顺序):删掉 10.1 加的那行 BDEF → 删掉 10.2 的方法声明 → 删掉 10.3 的方法实现 → 两个对象一起激活 → 重新 Publish 并刷新预览。还原后建议再新建一条 Travel 验证 Description 不再被自动填充,同时确认旧记录没被改掉。
也可以重新
pull一次仓库覆盖演示内容。这是「教学实验」:
/DMO/是 SAP 演示命名空间,正式项目不要这么改。这个改动会挂在你的传输请求上,如果这个开发系统之后要复用,记得按上面的步骤还原。正确的扩展姿势(Clean Core):
在自己的
Z命名空间/包里新建自己的 RAP 业务对象(数据源可以复用/DMO/的表或视图),把 determination 写在自己的 BO 里;如果目标 BO 是 extensibility-enabled 的(官方 README 提到
/DMO/FLIGHT_REUSE_AGENCY里的 Agency BO 就是示例),用 RAP 扩展(Behavior Extension / 扩展视图)而不是改源码;通过服务/API 集成,而不是直接修改 SAP 交付内容。
为什么 determination 能直接生效:managed 场景里框架在保存序列里自动调用它,UI 不需要任何改动;这也是 RAP「行为与 UI 解耦」的体现。
10.7 对比一下:同一需求换成 validation 会怎样
如果需求是「Description 必须填」,就该用 validation:它在保存前检查并返回消息,不会替你补值,用户会被拦下来手动填写。判断标准很简单:
你想干什么 |
用哪个机制 |
|---|---|
数据不合法就拒绝保存 |
validation |
自动补默认值、算派生值 |
determination |
用户点按钮才执行 |
action |
落库后写日志/触发后续处理 |
save(additional save) |
可选加练:给 validate_bookingfee 再加一条「booking fee 不能超过 1000」的规则。打开 /DMO/BP_Travel_M 的 Local Implementations,把 validate_bookingfee 里的循环条件改成:
LOOP AT travels INTO DATA(travel) WHERE booking_fee < 0
OR booking_fee > 1000.
激活后新建一条 fee = 2000 的 Travel,应被 validation 拦下;验证完记得把条件改回去、重新激活。这个练习和 10.1~10.6 正好是「拦」与「补」两种机制的对照。
步骤 11(可选):跑一下官方测试类
做什么:仓库自带 ABAP Unit 测试,用来验证你的环境里 BO 行为是否正常,也是学习 RAP 测试写法的好材料。这三个类分工不同:
测试类 |
测什么 |
学什么 |
|---|---|---|
|
BO 本身:创建/校验/动作/深层创建/编号/additional save |
|
|
以「消费方」身份用 EML 调 BO |
EML 语句的标准写法,以及 RAP BO 测试替身框架(test double framework)如何隔离依赖 |
|
OData 服务层 |
服务绑定的端到端测试思路 |
怎么做:
打开
/DMO/TC_Travel_M(managed 场景的 BO 测试类),右键 →Run As→ABAP Unit Test。在 ABAP Unit 结果视图里看红/绿;红色条目双击可以跳到失败方法,看断言消息和调用栈。
同样方式跑
/DMO/TC_Travel_M_BO_Consumer和/DMO/TC_Travel_Proc_M_O2_OData。
验证:所有测试变绿(通过)。如果只有一个测试类失败,先看它测的是哪个机制(例如 deep_create_determination 测深层创建时的 determination),对照步骤 7 的表格定位。注意:如果你在第 10 步改了 determination/BDEF 但还没还原,个别测试可能因为行为变化而失败,这是预期内的,恢复改动后应重新变绿。想看测试替身框架的完整演示,可以再跑 /DMO/TC_BOTD_Travel_M_Demos。
步骤 12(可选):读懂 EML —— RAP 的第二种用法
做什么:前面的操作都是通过 Fiori 页面调用服务;RAP BO 也可以被 ABAP 程序用 EML(Entity Manipulation Language,实体操作语言)直接调用,这在批量处理、集成和测试里非常常用。仓库把这类用法集中放在 /DMO/TC_Travel_M_BO_Consumer 里,读它的方法就是最好的入门。
怎么做:打开 /DMO/TC_Travel_M_BO_Consumer,看下面两个方法(摘自仓库源码,略有删减):
method create_travel.
modify entities of /dmo/i_travel_m
entity travel
create from travel
reported reported
failed failed
mapped mapped.
endmethod.
METHOD ACCEPT_TRAVEL_ACTION.
modify entities of /dmo/i_travel_m
entity travel
execute acceptTravel from accept_travel_input
result result
mapped mapped
failed failed
reported reported.
ENDMETHOD.
逐句对照 BDEF:
EML 语句片段 |
含义 |
|---|---|
|
指定操作哪个 BO(用接口 BO 名,不是投影视图名) |
|
操作 BO 里的哪个实体(alias 来自 BDEF 的 |
|
按 BDEF 里的 |
|
按 BDEF 里的 |
|
四个输出容器:消息、失败实例、映射结果、动作结果 |
再补一句 READ ENTITIES 的读法:READ ENTITIES OF /DMO/I_Travel_M ENTITY travel ALL FIELDS WITH CORRESPONDING #( keys ) RESULT DATA(travels) 是 EML 读取的标准写法,FIELDS ( … ) 可以只取需要的字段,RESULT 拿结果、FAILED / REPORTED 拿失败实例与消息。和 SQL 不同,EML 读取会经过 BO 的行为定义与权限检查,读的是「业务对象」而不是裸表——这是 RAP 与传统 ABAP 开发最大的思维差异之一。
验证:你能自己解释「为什么 Fiori 页面上的 Create 和这段 EML 最终走的是同一套 RAP 运行时」——页面走 OData → 服务绑定 → BO;EML 直接调 BO,两者都在 BDEF 的同一份合同之下。注意:在 RAP BO 实现内部不要写 COMMIT ENTITIES;在普通应用代码里用 EML 修改数据后,需要 COMMIT ENTITIES 才会提交(BO 测试类里的提交由测试框架处理)。这一条和第 10 步「不要自己 COMMIT」是同一件事的两个方向。
想自己动手试一次 EML:在你自己的 Z 包里新建一个实现 if_oo_adt_classrun 的类,按 9.1 的字段值用 MODIFY ENTITIES OF /dmo/i_travel_m 创建一条 Travel,再 COMMIT ENTITIES 提交,最后 READ ENTITIES 回读并用 out->write( ) 打印结果。注意用值帮助里真实存在的 Agency/Customer/币种;如果 failed 容器不为空,里面的消息就是 BO 拒绝创建的原因。这个练习能把「OData 页面 → 服务 → BO」和「程序 → EML → BO」两条路彻底打通。
验收与清理
验收清单
全部勾上,才算真正跑通这个案例:
/DMO/FLIGHT包存在,且 11 个子包(MANAGED/DRAFT/READONLY/UNMANAGED/LEGACY/REUSE 等)都在。批量激活对话框里没有本案例的未激活对象。
/DMO/TRAVEL_M、/DMO/TRAVEL等表里能看到演示数据。/DMO/I_Travel_M、/DMO/C_Travel_Processor_M的 Data Preview 正常。/DMO/UI_TRAVEL_PROC_M_O2已 Publish,Preview 能打开 Fiori Elements 列表。能新建一条 Travel,保存后列表可见、明细可打开。
Total Price由 determination 算出(仅 booking fee 时等于 booking fee)。在 Create 里把 Begin Date 填得晚于 End Date(或早于今天),会被 validation 拦住并给出错误消息。
Approver 服务能 Publish 和 Preview,Accept/Reject 后状态分别变为
A/X,重复动作按钮置灰。Copy Travel 能生成新记录。
第 10 步的 determination 生效:留空 Description 会被自动填充,手填的不会被覆盖。
能用自己的话解释 BDEF 里
managed implementation、etag、lock、early numbering、validation、determination、action、additional save各是什么意思,以及它们在实现类里对应哪个方法。
清理
演示内容可以保留(后续 RAP 练习还会用到),但如果这个开发环境要回收,按下面处理:
打开两个服务绑定,点
Unpublish(或删除本地服务 endpoint),释放预览用的运行时服务。如不再需要:Project Explorer 右键
/DMO/FLIGHT→Delete,勾选级联删除包内对象;确认传输请求里没有还要发布的东西。在 abapGit Repositories 视图里删除仓库链接(右键 →
Unlink),避免以后误 Pull。如果只是本地练习、不打算把演示内容传到其他系统,传输请求保留不释放即可;需要跨系统传输时,按你们环境的传输流程处理(云上通常由管理员通过软件组件/传输机制统一管理,以实际配置为准)。
数据表里的演示记录不一定随包删除而清空(取决于表归属)。如果只是想让数据干净,用
/DMO/CL_FLIGHT_DATA_GENERATOR重新生成即可;本案例不要求清数据。
常见问题
# |
现象 |
可能原因 |
处理 |
|---|---|---|---|
1 |
Pull 完激活时出现大量语法错误、对象「不存在」 |
分支选错(没用 |
按步骤 1 选定 |
2 |
服务绑定 Preview 404 / 页面打不开 |
没有 Publish;对象未激活;服务定义激活失败 |
先批量激活,再在绑定里点 |
3 |
激活或服务绑定报 |
服务定义没导入成功/没有活动版本 |
官方处理法:删除基于它的服务绑定 → 打开服务定义改一个字符后重新激活 → 重建服务绑定 |
4 |
预览列表是空的,但表里明明有数据 |
预览连的实体不对;数据没生成;或 CDS 视图/行为未激活 |
确认打开的是 |
5 |
新建 Travel 保存时报错,提示日期/代理/客户/金额不合法 |
validation 拦截:Begin 必须早于 End 且不早于今天;代理、客户、币种必须存在;状态只能是 O/A/X;booking fee 不能为负 |
全部用值帮助(F4)选已有数据;日期用未来的合法区间;金额填非负数。错误消息里会带字段名,对照步骤 9.1 的表排查 |
6 |
审批按钮看不到或置灰 |
打开的是 Processor 绑定(不暴露审批);或当前状态已经是 A/X;或角色缺权限 |
换 |
7 |
第 10 步的 determination 不生效 |
BDEF 没激活、方法没在 Local Types 声明、方法名与 determination 名不一致、或没重新 Publish |
按 10.2 的 |
8 |
Pull 中断/部分对象失败 |
网络、GitHub 凭据过期、仓库分支改名 |
重新 Pull(幂等);认证用 personal access token;必要时 Unlink 后重新关联分支 |
9 |
ADT 里找不到 abapGit 视图 / 无法连系统 |
插件没装成功、ADT 版本太旧、项目登录语言/网络配置问题 |
重装插件并重启 ADT;换最新版 ADT;检查项目登录语言为 English;检查项目连接配置与代理 |
10 |
改了 |
教学实验修改了演示内容 |
删除自己加的行/方法后重新激活;或重新 Pull 覆盖;也可以在干净环境重建包 |
官方原文(参考)
本教程是在官方仓库 cloud 分支 README 的 Download / Configuration 步骤基础上,补全了 ADT 菜单路径、字段值、验证点和排错,并加了一步 determination 动手练习。若官方步骤与本文有出入,以官方 README 当前版本为准。
云分支 README(权威步骤):ABAP-platform-cloud/README.md
SAP Help:下载 ABAP Flight Reference Scenario(云版本):https://help.sap.com/docs/abap-cloud/abap-rap/downloading-abap-flight-reference-scenario?locale=en-US
abapGit 文档:https://docs.abapgit.org/
截图说明:官方仓库没有分步截图,本篇没有使用任何本案例操作截图;另配 4 张 SAP 官方课程 S4D426 的 RAP / 扩展架构示意图(图注已注明来源、非本案例截图);操作界面请以你系统中 ADT / Fiori Elements 的实际版本为准。