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 包 /DMO/FLIGHT

Project Explorer 里能展开出 MANAGED、DRAFT、READONLY、UNMANAGED、LEGACY、REUSE 等子包,全部已激活

业务对象数据模型

/DMO/I_Travel_M、/DMO/I_Booking_M、/DMO/I_BookSuppl_M

接口 CDS 视图可预览数据,Travel → Booking → BookingSupplement 组成组合树

行为定义与实现

/DMO/I_Travel_M(BDEF)、/DMO/BP_Travel_M(实现类)

能看到 create / update / delete、acceptTravel、rejectTravel、copyTravel、validation、determination 的真实写法

服务定义与服务绑定

/DMO/UI_Travel_Processor_M、/DMO/UI_TRAVEL_PROC_M_O2

绑定已 Publish,浏览器里能打开 Fiori Elements 预览

演示数据

/DMO/TRAVEL_M 等表

列表页有几十条航班差旅记录,可以搜索、筛选、创建

一次自定义改造

新增 determination

新建 Travel 时留空 Description,保存后系统自动补上默认文案

跑通之后,你会在浏览器里看到一个 Fiori Elements 应用(List Report + Object Page),界面元素大致如下。请把它当作验收时的对照表,界面标签可能随 Fiori Elements 版本略有差异:

界面区域

应看到什么

列表标题与表头

Travels 列表,列包含 Travel ID、Agency、Customer、Begin Date、End Date、Booking Fee、Total Price、Status;Description 在明细页的 Identification 区

工具栏

Create、Copy Travel 等按钮;可搜索(Search)与筛选(Adapt Filters)

明细页(Object Page)

Travel 的基本信息区,以及关联的 Booking 清单;字段可编辑(Processor 服务)

审批服务

打开 Approver 的绑定后,明细页上有 Accept / Reject 类按钮(按钮文字由动作名 acceptTravel / rejectTravel 生成,不同版本可能显示为 Accept、Accept Travel 等)

状态变化

点 Accept 后 Status 变成 A(Accepted),点 Reject 后变成 X(Rejected,代码注释里也写作 Cancelled);重复点同一个动作不会一直可点(按钮会按 instance feature 置灰)

说明:官方仓库只公开展示了这一段业务流程的源码与 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 元数据渲染出来的,所以只要服务发布成功、注解齐全,预览页就能直接出现。

ABAP RESTful 应用程序编程模型的分层视图:业务服务暴露层里,UI 服务面向 SAP Fiori 和分析客户端提供 OData 与 SAP Information Access(InA),集成服务提供 OData、事件、HTTP、RFC、SQL;中间是域特定实现(CDS 实体、RAP 业务对象、CDS 分析提供者,以及 ABAP / CDS 业务逻辑),底层是 SAP HANA 数据库(SQL / SQLScript);右侧列出复用服务与库、内置质量(cloud-ready、extensibility 等)、基于 gCTS / abapGit 的生命周期管理和 ADT 等工具链(SAP 官方课程 S4D426 示意图,非本案例截图)

一次「新建 Travel」请求发生了什么

以 managed 场景的创建为例,请求进入 RAP 运行时之后依次经过:

  1. 权限与锁定:BDEF 里声明 authorization master ( none )、lock master,RAP 先做权限检查和实例锁。

  2. early numbering:BDEF 声明 early numbering,RAP 在创建阶段就调用 /DMO/BP_Travel_M 的 earlynumbering_create 方法,从号段对象 /DMO/TRV_M 取号,填好 travel_id。

  3. validation:validateCustomer、validateAgency、validateDates、validateStatus、validateCurrencyCode、validateBookingFee 分别在 save 前校验;不通过就返回错误消息,整单不会保存。

  4. determination:calculateTotalPrice 在 modify 时触发,调用内部 action recalcTotalPrice 汇总 booking fee 与预订价格,算出 total_price。

  5. 保存(save sequence):managed 场景由框架负责 INSERT/UPDATE;同时 BO 声明了 with additional save,框架会在保存后调用 saver 类 LCL_Save 的 save_modified 方法,把变更写入日志表 /DMO/LOG_TRAVEL。

  6. ETag 与并发:etag master last_changed_at 让前端在更新时带上 ETag,避免两个人同时改一条记录互相覆盖。

  7. 回读:保存成功后前端重新读取列表/明细,看到新记录和计算出来的总价。

记住这一条主线:BDEF 是「合同」,实现类是「履约」。BDEF 里出现的每个 validation、determination、action、association ... { create; },在 /DMO/BP_Travel_M 里都能找到同名方法;反过来,实现类里出现的每个处理类方法,也都能在 BDEF 里找到声明。RAP 报错「方法未实现 / 方法不存在」,十有八九是这两边对不上。

RAP 业务对象的接口分层:外部经 WEB API(基于 OData 的服务)、SAP Fiori UI(OData UI 服务)和事件消费业务服务,往下依次是服务绑定、服务定义、服务项目(业务对象映射视图与行为投影),最后落到原始业务对象的数据模型与行为;中间的 RAP BO INTERFACE 供其他服务复用,灰色「扩展」标记说明这些层大多可以扩展,右下方的两种用法是「打造新的业务服务」与「使用已审批的 RAP 业务对象接口」(SAP 官方课程 S4D426 示意图,非本案例截图)

仓库里的场景子包

导入 /DMO/FLIGHT 后会自动生成一批子包,每个子包是一套独立的教学场景。本教程只做 MANAGED 主线,其他子包可以作为后续练习:

子包

场景

说明

/DMO/FLIGHT_MANAGED

托管事务型(本教程主线)

增删改由框架托管,演示 validation、determination、action、additional save

/DMO/FLIGHT_DRAFT

带草稿的事务型

同时提供 OData V2 与 OData V4 绑定,演示草稿(draft)机制

/DMO/FLIGHT_UNMANAGED

非托管事务型

业务逻辑自己写 save,适合从旧代码迁移(brownfield)的理解

/DMO/FLIGHT_READONLY

只读列表报表

演示只读 RAP 应用与列表报表

/DMO/FLIGHT_LEGACY

旧式业务逻辑与演示数据

包含数据生成器 /DMO/CL_FLIGHT_DATA_GENERATOR(本教程第 6 步要用)

/DMO/FLIGHT_REUSE

可复用业务对象

Supplement、Carrier(多行内联编辑)、Agency(可扩展)等

/DMO/FLIGHT_HIERARCHY

层级数据

只读与可编辑树形视图

/DMO/FLIGHT_COLLDRAFT

协作草稿

多人协作编辑能力

/DMO/FLIGHT_ANA

分析场景

只读分析表,配合分析查询

/DMO/FLIGHT_REC

RAP 推荐

AI 推荐差旅描述、确定性推荐住宿

/DMO/FLIGHT_XBO

跨 BO 草稿

两个草稿 BO 通过 cross association 与 draft scope 组合

SAP 的三层扩展模型:第 1 层是基于 ABAP Cloud 的云就绪扩展(新建应用和扩展的默认选择),第 2 层通过云 API 启用,第 3 层是经典 ABAP 扩展(只在绝对必要时使用,并逐步缩减);图下方图例标出 on-stack(紧密耦合)与 side-by-side(松散耦合)两类部署。上表这些教学子包覆盖了从托管 RAP 到 LEGACY 旧式逻辑的不同写法,可以借此理解为什么教程主线只做 MANAGED(SAP 官方课程 S4D426 示意图,非本案例截图)

本教程会用到的关键对象

对象

类型

作用

/DMO/I_Travel_M

接口 CDS 视图 + 行为定义

根实体与行为「合同」

/DMO/I_Booking_M、/DMO/I_BookSuppl_M

接口 CDS 视图

组合子实体的数据模型

/DMO/C_Travel_Processor_M、/DMO/C_Booking_Processor_M、/DMO/C_BookSuppl_Processor_M

投影 CDS 视图

面向 Processor 服务的只读/可写视图,带 @UI 注解

/DMO/C_Travel_Approver_M、/DMO/C_Booking_Approver_M

投影 CDS 视图

面向 Approver 服务的审批视图

/DMO/BP_Travel_M、/DMO/BP_Booking_M、/DMO/BP_BookingSupplement_M

行为实现类

处理 validation、determination、action、numbering、save

/DMO/UI_Travel_Processor_M

服务定义

暴露 Travel/Booking/BookingSupplement 与值帮助

/DMO/UI_TRAVEL_PROC_M_O2

服务绑定(OData V2)

发布 Processor 服务,供 Fiori 预览与调用

/DMO/UI_Travel_Approver_M、/DMO/UI_TRAVEL_APPR_M_O2

服务定义 + 绑定

发布 Approver 服务,提供 acceptTravel / rejectTravel

/DMO/CL_FLIGHT_DATA_GENERATOR

可执行类

生成演示数据(含 managed/draft 等场景的表)

/DMO/TC_Travel_M、/DMO/TC_Travel_M_BO_Consumer、/DMO/TC_Travel_Proc_M_O2_OData

测试类

演示 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 的开发系统

同样使用 ABAP-platform-cloud 分支

权限方面:云环境通常需要开发角色(常见为 SAP_BR_DEVELOPER,实际授予名称以管理员配置为准)。登录语言务必用 English,官方 README 明确要求;非英文登录语言可能在 Fiori 预览、注解文本、abapGit 对象比较时出现额外问题。

开发者扩展(Developer Extensibility):SAP S/4HANA Cloud 的标准应用只通过公共接口与扩展交互,扩展代码用与 BTP ABAP 环境相同的 ABAP Cloud 开发模式编写(ABAP RESTful 应用程序编程模型、云优化 ABAP 语言、ABAP 核心数据服务、已发布的 SAP API 和扩展点),规则是明确区分 SAP 解决方案与扩展、只用稳定可靠的公共接口与已发布对象、不修改 SAP 对象(SAP 官方课程 S4D426 示意图,非本案例截图)

2. 要安装的工具

工具

用途

从哪来

Eclipse + ABAP Development Tools(ADT)

开发、建包、导入、激活、预览

SAP 官方工具页 tools.hana.ondemand.com(用最新版)

abapGit(ADT 插件)

把 GitHub 仓库拉进 ABAP 包

Eclipse 插件方式安装:Help → Install New Software,更新站点 http://eclipse.abapgit.org/updatesite/

浏览器

打开 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

建目标包 /DMO/FLIGHT

空包

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 分支。

怎么做:

  1. 确认环境:如果是 SAP BTP ABAP Environment,在 BTP Cockpit 里确认有可开发的 ABAP Environment 实例;如果是 S/4HANA Cloud Public Edition,确认自己拿到的是已开启 Developer Extensibility 的开发系统,并且 ADT 能连上。

  2. 确认分支:本文只用 ABAP-platform-cloud。仓库里还有其他分支,是给 S/4HANA 本地部署/私有云准备的,不属本手册范围,不要选。

  3. 在 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 包。

怎么装:

  1. 从 SAP 官方工具页下载并安装最新版 ABAP Development Tools(Eclipse 版),不要用太旧的 ADT,否则 Cloud 服务的 OData V4 / 服务绑定功能可能缺失。首次启动选择 workspace 时用本地普通磁盘目录,不要放网络盘或同步盘,避免大包导入/激活时卡顿。

  2. 启动 ADT,File → New → ABAP Cloud Project,按向导选择你的 ABAP Environment 服务实例(或输入系统 URL + 用户密码),创建项目。

  3. 确保登录语言是 EN(English):云环境在创建服务实例/项目时按管理员给的配置使用英文登录;建好后可在项目属性里核对语言设置,若不是英文,找管理员确认或重建项目。

  4. 安装 abapGit 插件:Help → Install New Software... → Add...,Location 填 http://eclipse.abapgit.org/updatesite/,勾选 abapGit 组件一路安装,最后重启 ADT。

  5. 添加 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。如果你把目标包写成别的名字,子包名会跟着变,后面步骤里按文档找子包、找对象就会对不上。名字取好后不要再改;要改就删包重来。

怎么做:

  1. Project Explorer 里右键你的 ABAP Cloud Project → New → ABAP Package。

  2. 按向导填写:

    • Name:/DMO/FLIGHT

    • Description:Flight Reference Scenario

    • Superpackage:/DMO/SAP(官方 README 的写法;如果你的环境向导里没有这一项或没有该父包,按向导实际可选项处理,包名仍保持 /DMO/FLIGHT)

    • Software Component:保持向导建议值(通常 HOME)

  3. 一路 Next,在传输请求步骤选择「新建传输请求」,描述写 SFlight demo content。这个传输请求只给本案例的演示内容用,不要和你的其他开发混在一起。

  4. Finish。

验证:

  • Project Explorer 里出现 /DMO/FLIGHT,右键 → Properties 能看到包名、父包和软件组件,应与计划一致。

  • 传输请求已创建:建包/克隆向导最后会显示请求号,记下来;云环境可在 ADT 的传输视图或请管理员确认。

注意:/DMO/ 是 SAP 保留给演示内容的命名空间。本教程第 10 步会为了练习临时修改演示对象,这属于「教学实验」;正式项目里不要把自己的业务对象放进 /DMO/,也不要在导入的包里建东西。

步骤 4:用 abapGit 克隆仓库到包里

做什么:把 ABAP-platform-cloud 分支源码拉进 /DMO/FLIGHT。这一步只「拉源码」,拉完对象还是未激活状态。

怎么做:

  1. 打开 abapGit Repositories 视图,点左上角 +(Clone abapGit Repository)。

  2. 填仓库地址(注意末尾 .git):

    https://github.com/SAP-samples/abap-platform-refscen-flight.git
    

    点 Next。

  3. 选择分支 ABAP-platform-cloud,Package 填 /DMO/FLIGHT,点 Next。

  4. 文件夹逻辑选 PREFIX(官方 README 第 6 步要求),点 Next。

  5. 选择或新建传输请求(建议就是步骤 3 建的那个 SFlight demo content),点 Finish。仓库会以 Linked 状态出现在视图里。

  6. 右键这个仓库 → pull,开始下载仓库内容。对象多,几分钟到十几分钟都正常,中途不要关 ADT,也不要同时对同一个包开第二个 abapGit 会话。

这几个输入项各自管什么,填错会怎样:

输入项

本案例的值

作用 / 填错的后果

Repository URL

https://github.com/SAP-samples/abap-platform-refscen-flight.git

指向仓库;少了 .git 或拼错会直接报仓库不可达

Branch

ABAP-platform-cloud

决定对象版本;选错分支会语法错误或激活失败

Package

/DMO/FLIGHT

对象落地位置;决定子包名前缀(见步骤 3 的说明)

Folder logic

PREFIX

文件夹 → 子包的映射规则;官方 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、生成运行时对象、注册服务。

怎么做:

  1. 在 ADT 工具栏点 Activate Inactive ABAP Development Objects(批量激活图标)。

  2. 对话框里会列出所有未激活对象;选中属于本案例传输请求的全部对象(一般直接全选),点 Activate。

  3. 等待。对象上千个,激活几分钟很正常;进度条不动时不要反复点,先看底部 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 负责按顺序调用它们。

怎么做:

  1. Project Explorer 展开 /DMO/FLIGHT_LEGACY → Source Code Library → Classes。

  2. 找到 /DMO/CL_FLIGHT_DATA_GENERATOR,双击打开。

  3. 按 F9(或右键 → Run As → ABAP Application (Console))执行。

  4. 在 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 里的写法

含义

实现类里对应的东西

managed implementation in class …

持久化由 RAP 框架托管

不需要写 save 方法(但本 BO 有 additional save,见 saver 类)

strict ( 2 )

严格模式,隐式行为被收紧,字段修改必须显式声明

编译期就会拦住很多「没声明字段却改字段」的写法

etag master last_changed_at

用最后修改时间做 ETag 并发控制

前端 update 时自动带 ETag

lock master

由 RAP 管理实例锁

不需要自己写 ENQUEUE/DEQUEUE

early numbering

创建阶段就分配编号

earlynumbering_create 方法,号段对象 /DMO/TRV_M

field ( mandatory ) …

创建时必须给值,UI 自动标必填

前端表单自动生效

action ( features : instance ) … result [1] $self

实例动作,返回值是自身;按钮是否可用由 feature 控制

set_status_accepted / set_status_rejected / get_features

internal action ReCalcTotalPrice

仅供内部(determination)调用的动作

recalctotalprice

factory action copyTravel [1]

工厂动作,一次复制生成一个新实例

copyTravel

validation … on save { create; field … }

保存前校验

validate_* 方法

determination … on modify { create; field … }

字段变化时自动计算

calculatetotalprice 方法

association _Booking { create … }

允许通过关联创建子实体

earlynumbering_cba_booking 等

(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_bookingfee

  • copyTravel、set_status_accepted、set_status_rejected、get_features

  • recalctotalprice(内部 action)、calculatetotalprice(determination)

  • earlynumbering_create、earlynumbering_cba_booking

  • 还有一个 lcl_save 类,重定义了 save_modified,把变更写进 /DMO/LOG_TRAVEL(这正是 BDEF 里 with additional save 的来源)

handler 方法有固定的签名模式,认准这几种就不会迷路:

处理类型

声明关键字

方法形状(简化)

说明

validation

FOR VALIDATE ON SAVE

IMPORTING keys FOR travel~validatecustomer

通过 failed-travel / reported-travel 返回错误消息;不改数据

determination

FOR DETERMINE ON MODIFY

IMPORTING keys FOR travel~calculatetotalprice

在事务缓冲里读数据、改数据,不能返回消息

action

FOR MODIFY … FOR ACTION travel~accepttravel

IMPORTING keys … RESULT result

执行动作并回传结果

numbering

FOR NUMBERING

IMPORTING entities FOR CREATE travel

负责 early numbering / 子实体编号

saver

继承 cl_abap_behavior_saver

重定义 save_modified

只在 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 能跑。

怎么做:

  1. Project Explorer 展开 /DMO/FLIGHT_MANAGED → Service Bindings → 双击 /DMO/UI_TRAVEL_PROC_M_O2(描述是 "UI service for processing travels (OData, version 2)")。

  2. 在编辑器右上角点 Publish(有的 ADT 版本叫 Publish Local Service Endpoint)。等状态变成已发布/生成完成。如果 Publish 按钮是灰的,先确认服务定义 /DMO/UI_Travel_Processor_M 已经是活动版本(回到步骤 5 检查激活),以及当前用户有该包的开发/传输权限。

  3. 点 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 服务里)

  1. 在预览页点 Create。如果按钮点了没反应,先看浏览器开发者工具里的网络请求和 ADT 日志里有没有 401/403,再怀疑对象本身。

  2. 按下面这张表填字段(值帮助用输入框右侧的 F4 / 值帮助图标选择):

字段

必填

怎么填 / 示例

说明

Travel ID

否

留空

early numbering 自动分配号段 /DMO/TRV_M

Agency ID

是

值帮助选一个已存在的代理

校验 validateAgency 会检查是否存在

Customer ID

是

值帮助选一个已存在的客户

校验 validateCustomer

Begin Date / End Date

是

例如「今天 + 30 天」/「今天 + 40 天」

validateDates 要求 End ≥ Begin,且 Begin 不能早于系统当天

Overall Status

是

值帮助里选 O(Open)

validateStatus 只接受 O / A / X 三个值

Booking Fee

是

例如 100

validateBookingFee 要求 ≥ 0

Currency Code

是

值帮助选一个已存在的币种(如 EUR)

validateCurrencyCode 要求必填且在 I_Currency 中存在

Description

否

留空

第 10 步的 determination 会用到这个字段

  1. 点 Save。保存成功后回到列表,多出一行。

保存失败时不用慌,对照实现类里六个 validation 方法的真实规则逐条排查(这些规则都来自 /DMO/BP_Travel_M 源码):

校验方法

代码里的规则

界面上表现为

validate_customer

customer_id 非空,且必须在 /DMO/CUSTOMER 中存在

提示客户不存在 / 未填客户

validate_agency

agency_id 非空,且必须在 /DMO/AGENCY 中存在

提示代理不存在 / 未填代理

validate_dates

end_date >= begin_date,且 begin_date 不早于系统日期

提示日期顺序错误,或开始日期早于今天

validate_travel_status

状态只能是 O(Open)、A(Accepted)、X(Cancelled)

提示状态无效

validate_currencycode

币种必填且必须存在于 I_Currency

提示币种为空 / 不存在

validate_bookingfee

booking_fee >= 0

提示 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

保存失败,提示日期顺序

validate_dates(begin_date_bef_end_date)

Begin Date 早于今天(例如昨天)

保存失败,提示开始日期太早

validate_dates(begin_date_on_or_bef_sysdate)

Booking Fee 填负数(例如 -1)

保存失败,提示费用无效

validate_bookingFee

不用值帮助、手敲一个不存在的 Customer ID

保存失败,提示客户不存在

validate_customer

把每个字段改回合法值后再 Save,应该成功——这说明失败的是数据校验,不是对象/服务坏掉。这正是 validation 与 determination 的区别:validation 负责「拦住错数据」,determination 负责「算对默认值/派生值」。

9.3 审批动作(Approver 服务里)

  1. 回到 ADT,打开 /DMO/FLIGHT_MANAGED → Service Bindings → /DMO/UI_TRAVEL_APPR_M_O2,同样先 Publish,再 Preview。

  2. 在列表里选中一条你新建的 Travel,打开明细页。

  3. 点审批按钮 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 验证列表查询能力

最后把「读」也验一遍:

  1. 在 Processor 列表页的搜索框里输入一条 Travel 的 ID 或 Agency,回车,列表应只剩匹配记录。

  2. 点 Adapt Filters(或筛选区),把 Status 加为筛选条件并选 O,列表应只显示 Open 的记录。

  3. 点某列列头排序(例如 Begin Date),确认升序/降序生效。

验证:搜索、筛选、排序都正常返回。列表查询最终执行的是投影视图和底层接口视图的 CDS 查询——投影视图上的 @Search.searchable: true 和字段上的 @Search.defaultSearchElement 注解,决定了哪些字段参与全文搜索。这一步能同时验证数据模型、服务层和 UI 注解三者是通的。

步骤 10:加一个 determination(真正动手)

做什么:给根实体加一个 determination,让「新建 Travel 时如果没填 Description,系统自动补一句默认说明」。这是最小、最安全、效果又可见的扩展练习。

为什么选 determination:RAP 里 determination 由框架在保存前自动调用,不需要在 UI 或 OData 层写逻辑;它适合做「默认值、派生值、汇总值」这类业务逻辑。对比一下:

机制

触发时机

典型用途

本案例例子

validation

保存前校验

拦截非法数据

validateDates

determination

字段变化(modify)时自动执行

补默认值、算派生值

calculateTotalPrice(已有),setDefaultDescription(我们要加)

action

用户/程序显式调用

改状态、复制等业务动作

acceptTravel、copyTravel

save(additional save)

框架落库后

写日志、触发外部处理

save_modified → /DMO/LOG_TRAVEL

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 激活并重新发布

  1. 先激活实现类 /DMO/BP_Travel_M,再确认 /DMO/I_Travel_M 也是已激活状态(两个对象有依赖,建议一起批量激活一次)。

  2. 回到 /DMO/UI_TRAVEL_PROC_M_O2,再点一次 Publish,确保运行时的行为元数据刷新。

激活失败通常就两类原因:方法没在 Local Types 里声明(报「方法未实现」类错误),或者方法名与 BDEF 里的 determination 名不一致(大小写无所谓,拼写必须一致)。看到错误不要急着删代码,先看错误消息指向哪个对象/哪一行。

10.5 验证

  1. 重新打开 Processor 预览(浏览器刷新即可),点 Create,Description 故意留空,其余字段按 9.1 填好,保存。

  2. 打开这条新记录的明细页,Description 应显示 Created by RAP determination。

  3. 再建一条、这次手填 Description(例如 My own text),保存后应保留你填的内容,不会被覆盖——这是 DELETE travels WHERE description IS NOT INITIAL 的作用。

  4. 数据层复核:/DMO/TRAVEL_M 的 Data Preview 里,新记录的 DESCRIPTION 列有值。

  5. 想确认 determination 真的被调用:在 /DMO/BP_Travel_M 的 setdefaultdescription 方法第一行打断点(双击行号左侧),回到预览页新建一条 Travel,执行到断点时调试器会停在方法里;按 F5/F6 观察 keys 和 travels 的内容,就能看到「读到了哪条、有没有被 DELETE 过滤」。这是排查 RAP 行为实现最有效的手段,比在 UI 上看结果猜原因快得多。

  6. 回归检查:打开一条修改前就已存在的旧记录,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 测试写法的好材料。这三个类分工不同:

测试类

测什么

学什么

/DMO/TC_Travel_M

BO 本身:创建/校验/动作/深层创建/编号/additional save

cl_cds_test_environment、cl_osql_test_environment 怎么造测试替身;deep_create_determination 测试深层创建时 determination 的触发

/DMO/TC_Travel_M_BO_Consumer

以「消费方」身份用 EML 调 BO

EML 语句的标准写法,以及 RAP BO 测试替身框架(test double framework)如何隔离依赖

/DMO/TC_Travel_Proc_M_O2_OData

OData 服务层

服务绑定的端到端测试思路

怎么做:

  1. 打开 /DMO/TC_Travel_M(managed 场景的 BO 测试类),右键 → Run As → ABAP Unit Test。

  2. 在 ABAP Unit 结果视图里看红/绿;红色条目双击可以跳到失败方法,看断言消息和调用栈。

  3. 同样方式跑 /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 语句片段

含义

modify entities of /dmo/i_travel_m

指定操作哪个 BO(用接口 BO 名,不是投影视图名)

entity travel

操作 BO 里的哪个实体(alias 来自 BDEF 的 define behavior … alias travel)

create from <itab>

按 BDEF 里的 create; 执行创建

execute acceptTravel from <itab>

按 BDEF 里的 action acceptTravel 执行动作

reported / failed / mapped / result

四个输出容器:消息、失败实例、映射结果、动作结果

再补一句 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 练习还会用到),但如果这个开发环境要回收,按下面处理:

  1. 打开两个服务绑定,点 Unpublish(或删除本地服务 endpoint),释放预览用的运行时服务。

  2. 如不再需要:Project Explorer 右键 /DMO/FLIGHT → Delete,勾选级联删除包内对象;确认传输请求里没有还要发布的东西。

  3. 在 abapGit Repositories 视图里删除仓库链接(右键 → Unlink),避免以后误 Pull。

  4. 如果只是本地练习、不打算把演示内容传到其他系统,传输请求保留不释放即可;需要跨系统传输时,按你们环境的传输流程处理(云上通常由管理员通过软件组件/传输机制统一管理,以实际配置为准)。

数据表里的演示记录不一定随包删除而清空(取决于表归属)。如果只是想让数据干净,用 /DMO/CL_FLIGHT_DATA_GENERATOR 重新生成即可;本案例不要求清数据。

常见问题

#

现象

可能原因

处理

1

Pull 完激活时出现大量语法错误、对象「不存在」

分支选错(没用 ABAP-platform-cloud),或分支已被改名

按步骤 1 选定 ABAP-platform-cloud;先 Unlink,再重新关联正确分支并 Pull;不要混用其他分支的对象

2

服务绑定 Preview 404 / 页面打不开

没有 Publish;对象未激活;服务定义激活失败

先批量激活,再在绑定里点 Publish(或 Publish Local Service Endpoint),然后 Preview

3

激活或服务绑定报 Failed to read the runtime table SRVD_RT_EXTENDS、An active version of the Service Definition … does not exist

服务定义没导入成功/没有活动版本

官方处理法:删除基于它的服务绑定 → 打开服务定义改一个字符后重新激活 → 重建服务绑定

4

预览列表是空的,但表里明明有数据

预览连的实体不对;数据没生成;或 CDS 视图/行为未激活

确认打开的是 /DMO/UI_TRAVEL_PROC_M_O2;运行 /DMO/CL_FLIGHT_DATA_GENERATOR;核对 /DMO/TRAVEL_M 与 /DMO/I_Travel_M 的 Data Preview

5

新建 Travel 保存时报错,提示日期/代理/客户/金额不合法

validation 拦截:Begin 必须早于 End 且不早于今天;代理、客户、币种必须存在;状态只能是 O/A/X;booking fee 不能为负

全部用值帮助(F4)选已有数据;日期用未来的合法区间;金额填非负数。错误消息里会带字段名,对照步骤 9.1 的表排查

6

审批按钮看不到或置灰

打开的是 Processor 绑定(不暴露审批);或当前状态已经是 A/X;或角色缺权限

换 /DMO/UI_TRAVEL_APPR_M_O2 预览;审批按钮按当前状态动态置灰属正常;确认用户有开发/审批所需角色

7

第 10 步的 determination 不生效

BDEF 没激活、方法没在 Local Types 声明、方法名与 determination 名不一致、或没重新 Publish

按 10.2 的 FOR DETERMINE ON MODIFY 声明检查;两个对象一起激活;绑定重新 Publish;再看 10.6 的还原步骤是否误删

8

Pull 中断/部分对象失败

网络、GitHub 凭据过期、仓库分支改名

重新 Pull(幂等);认证用 personal access token;必要时 Unlink 后重新关联分支

9

ADT 里找不到 abapGit 视图 / 无法连系统

插件没装成功、ADT 版本太旧、项目登录语言/网络配置问题

重装插件并重启 ADT;换最新版 ADT;检查项目登录语言为 English;检查项目连接配置与代理

10

改了 /DMO/ 对象后想回到原始状态

教学实验修改了演示内容

删除自己加的行/方法后重新激活;或重新 Pull 覆盖;也可以在干净环境重建包

官方原文(参考)

本教程是在官方仓库 cloud 分支 README 的 Download / Configuration 步骤基础上,补全了 ADT 菜单路径、字段值、验证点和排错,并加了一步 determination 动手练习。若官方步骤与本文有出入,以官方 README 当前版本为准。