02 · RAP630 开发者扩展实战工作坊:完整图文教程
目标:在 SAP BTP ABAP Environment / SAP S/4HANA Cloud Public Edition 的 ABAP 环境里完成一次开发者扩展(Developer Extensibility):先用已发布 API 生成一个能跑的 Fiori elements 应用,再对一个可扩展 RAP 业务对象做行为扩展、数据模型扩展与动作扩展。 预计:4–6 小时 | 难度:中高 | 前置课程:S4D426 前置条件:已安装 ADT(ABAP Development Tools for Eclipse);有一个可用的 ABAP 系统;系统中已导入开源的 RAP Generator(Trial 系统已预装)。
这篇教程对应 SAP 官方动手工作坊 RAP630 – Use ABAP Cloud for developer extensibility,把仓库里 exercises/ex0–ex4 的说明与截图按「准备 → 练习 1 → 练习 2 → 练习 3 → 练习 4」重排成一条可以离线照做的路径。你不需要边做题边回看原版页面:每一步都写清「做什么、怎么点、怎么填、看到什么算成功」,截图紧跟在该步操作之后。
你会做出什么
完成本教程后,你手上会有两个可以演示的成果。
成果一(练习 1):一个基于已发布 API 的银行维护应用。 你没有写业务代码,而是用 ADT 里的 RAP Generator(OData UI Service 生成器)在已发布的 RAP 业务对象接口 I_BankTP 之上,一键生成 CDS 投影视图、投影行为定义、元数据扩展、服务定义和服务绑定。发布服务绑定后,ADT 里直接打开 Fiori elements 预览,就能创建银行主数据。附带的可选练习会让你写一个 if_oo_adt_classrun 测试类,用 EML(Entity Manipulation Language)调用同一个 API,从而亲眼看到「应用授权」和「特权访问(privileged mode)」的区别。

成果二(练习 2–4):一个被完整扩展过的 Shop 业务对象。 基础业务对象 ZRAP630R_ShopTP_###(### 是你的组号)是工作坊生成器为你单独生成的、启用了可扩展性的托管 RAP BO。你要在不修改基础对象的前提下,通过扩展给它加上:
扩展内容 |
练习 |
用户可见效果 |
|---|---|---|
校验(validation) |
ex2.1 |
新建订单时若交货日期为空,保存被拦下并提示错误 |
确定(determination) |
ex2.2 |
选好物料后,按产品价格自动回写订单价格与审批状态 |
副作用(side effect) |
ex2.3 |
在草稿状态下换物料,价格与审批状态立即刷新,不必等保存 |
新字段 Feedback |
ex3 |
列表页和对象页多出一列可编辑的「Feedback」 |
动作 Update feedback |
ex4 |
工具栏多出一个按钮,弹窗输入反馈并写回该字段 |

架构与原理
开发者扩展到底是什么
按 SAP 的定义,开发者扩展基本上只包含两类活动,这也是整篇教程的两条主线:
编写自己的 ABAP Cloud 代码,并在其中使用 SAP 已发布(released)的 API。 你可以在 ABAP Cloud 开发模型里新建包、类、CDS 视图、服务,调用 SAP 以 C1 合同发布的对象。练习 1 就是这一类:把已发布的 RAP BO 接口
I_BankTP变成自己的 OData UI 服务,以及在类里用 EML 调用它。扩展现有的、已经启用可扩展性(extensible)的 RAP 业务对象。 这类对象通常由 SAP 或合作伙伴在另一个软件组件中交付。你通过扩展点(extension point)加字段、加行为,而不是改它的源代码。练习 2、3、4 属于这一类。

两条主线的调用链路
理解链路,后面每一步点在哪里、为什么顺序不能乱就清楚了。
主线一(练习 1)的链路:
层 |
对象 |
作用 |
|---|---|---|
已发布 API |
|
SAP 交付的银行 RAP BO 接口,允许在 ABAP Cloud 中被使用 |
生成层 |
CDS 投影视图 |
把接口视图投影成可被 OData 暴露的消费视图 |
服务层 |
服务定义 |
生成 OData V4 UI 服务并发布 |
消费层 |
Fiori elements 预览 |
列表页 / 对象页 + 创建流程 |
数据层 |
CDS 实体 |
真正的银行主数据存储; |
授权层 |
授权对象 |
控制「能不能建」和「能不能看」 |
主线二(练习 2–4)的链路:
Fiori elements(服务绑定 ZRAP630UI_SHOP_O4_###)
↓
C 层:消费/投影视图 ZRAP630C_ShopTP_### + 投影 BDEF ZRAP630C_ShopTP_###(及其扩展)
↓
I 层:接口视图 ZRAP630I_ShopTP_###(EML 用它寻址)
↓
R 层:受限基础视图 ZRAP630R_ShopTP_### + BDEF ZRAP630R_ShopTP_###(行为定义,练习 2 扩展它)
↓
E 层:扩展包含视图 ZRAP630E_Shop_###(从扩展后的活动表读)
↓
扩展包含结构 ZRAP630SSHOP_### + 追加结构 ZAPD_ZRAP630SSHOP_###(练习 3 在这里加字段)
↓
活动表 / 草稿表(draft)
为什么可扩展 RAP BO 会多出三个对象
普通 RAP 业务对象只需要 CDS 视图栈、行为定义、行为实现类、服务定义和服务绑定。一个启用了可扩展性的 RAP 业务对象,还要为每个实体额外提供三个仓库对象,否则外部无法安全地往里加东西:
扩展包含结构(Extension include structure):基础 BO 预留的「插槽」结构,客户追加结构挂在这里,字段才会同时落到活动表和草稿表;
扩展包含视图(Extension include view):从(扩展后的)活动表读取,供 R 视图继续向上引用;
草稿查询视图(Draft query view):让新增字段在草稿(draft)状态下同样可见。

行为扩展与数据模型扩展的差别
这两件事的工作量完全不同,先建立正确预期:
行为扩展只需要在 R 层(必要时加投影层)创建一个行为定义扩展(BDEF extension),再在行为实现类的本地类(local class)里写方法。快、轻、只影响行为。
数据模型扩展要沿着整个 CDS 视图栈自下而上扩展,因为每一层都从下一层选字段:追加结构 → E 视图 → R 视图 → C/I 视图 → 草稿查询视图。漏任何一层,字段都不会出现在 UI 上。


扩展顺序与依赖
练习 3 要扩展的 6 个对象彼此有严格的读取依赖,方向是「自下而上」;练习 4 又必须排在练习 3 之后,因为通过可扩展性添加的动作只能落在同样通过可扩展性添加的字段上——没有练习 3 加的 ZZFEEDBACKZAA 字段,就没有地方放练习 4 的 Feedback 动作。

Clean Core 的边界在哪里
这个工作坊真正想教会你的,不是某几个事务码,而是边界:
可以做:使用已发布 API(C1 合同)、扩展已释放的扩展点、在
Z命名空间里创建自己的对象、在自己的包里实现行为方法。不能做:修改 SAP 标准对象;在 ABAP Cloud 开发模型里使用未发布对象(例如直接用表
BNKA、函数模块BAPI_BANK_CREATE,编译期就会被拒);把本应并行扩展(side-by-side)的场景硬塞进应用内扩展。拿不准时:先查对象的发布状态与后继对象(ADT 的 Properties、Knowledge Transfer Document、Cloudification Repository),再决定用哪个 API。
应用内扩展还是并行扩展
Clean Core 真正难的不是写代码,而是选对扩展方式。这个工作坊练的是左边一列,但你要知道右边一列什么时候更合适:
维度 |
开发者扩展(应用内,本教程) |
并行扩展(side-by-side) |
|---|---|---|
代码跑在哪 |
同一个 ABAP 系统内(ABAP Cloud 开发模型) |
BTP 上的 CAP、Java、Node.js 等独立应用 |
能碰到什么 |
已发布 API、已释放的扩展点、自己的 |
标准 OData API、事件、BTP 服务,不碰标准对象内部 |
事务与时延 |
同事务、同数据库,强一致 |
跨系统调用,要自己处理最终一致性与重试 |
典型场景 |
加字段、加校验、加动作、紧耦合的业务增强 |
新应用、长流程、非 ABAP 技术栈、需要独立发布节奏 |
升级影响 |
跟随 ABAP 系统升级,扩展点由 SAP 保证稳定 |
与 ABAP 系统升级解耦,但要维护接口兼容 |
一句话判断:增强已有业务对象的内部行为 → 开发者扩展;围绕标准系统做新应用或新流程 → 并行扩展。两者可以组合,但不能互相替代。
术语速查(读代码时对照)
缩写/术语 |
含义 |
在本教程里出现在哪 |
|---|---|---|
RAP |
ABAP RESTful Application Programming Model |
两条主线都基于它 |
RAP BO |
RAP 业务对象:CDS 视图栈 + 行为定义 + 实现类 + 服务 |
|
BDEF |
Behavior Definition,行为定义 |
声明 CRUD、validation、determination、action |
行为扩展 |
Behavior Extension,用 |
练习 2、练习 4 |
EML |
Entity Manipulation Language,ABAP 里读写 RAP BO 的语句 |
|
C1 合同 |
已发布 API 的使用合同,允许在 ABAP Cloud 开发中使用 |
|
DCL |
Data Control Language,CDS 视图的授权控制 |
|
draft |
草稿,未保存的编辑态数据,存在草稿表里 |
练习 2 的验证与副作用都涉及草稿 |
扩展包含结构 |
Extension include structure,基础 BO 预留的「插槽」结构 |
|
追加结构 |
Append structure,在他人结构上追加字段的机制 |
|
KTD |
Knowledge Transfer Document,已发布 API 的说明文档 |
查授权与代码示例 |
RAP Generator |
开源生成器( |
练习 1、练习 3 向导 |
准备工作
1. 准备一个受支持的 ABAP 系统
工作坊支持的系统只有两类:SAP BTP ABAP Environment(含 Trial)和 SAP S/4HANA Cloud, Public Edition。三条实践路径任选一条:
路径 |
适用场景 |
你需要做什么 |
|---|---|---|
方式 1:SAP 主办的手把手工作坊 |
TechEd、CodeJam、用户组活动等 |
讲师会提供专用系统和演示用户,练习包 |
方式 2:在 SAP BTP ABAP Trial 中自学(本教程默认路径) |
个人学习 |
启动 Trial 系统,用生成器类 |
方式 3:在自己的 BTP ABAP 环境中自学 |
企业内部开发 |
自行创建 ABAP Cloud 项目并导入 RAP Generator;包由你自建 |
本教程按 SAP BTP ABAP Environment / S/4HANA Cloud Public Edition(ABAP Cloud,≥ 2408) 编写:使用仓库
main分支,练习 3 走扩展字段向导(步骤 26)。
2. 安装并配置工具
清单如下,缺一项后面就会卡住:
Eclipse + ADT:最新版 Eclipse 平台,加最新版 ABAP Development Tools 插件。
ABAP Cloud 项目:在 ADT 里创建指向目标系统的 ABAP Cloud 项目,并能登录(
Project Explorer里能看到系统节点)。RAP Generator:开源项目
cloud-abap-rap,必须导入到你的系统里。Trial 系统已经预装;如果找不到类ZDMO_GEN_RAP630_SINGLE,说明 RAP Generator 没导入。abapGit:只有需要导入官方解决方案包(步骤 4,可选)时才用到。
3. 权限与角色
你的开发用户需要有创建
Z命名空间对象、创建/使用传输请求、运行 ABAP 类(F9)的开发者权限。Trial 的默认开发用户通常已具备。练习 1 会故意撞上一次授权失败:创建银行需要授权对象
F_BNKA_MAO(银行主数据)和F_BNKA_INT(内部银行)的相应权限。不要提前绕过它,这正是练习的一部分——你会先看到报错,再通过 IAM 应用 / 业务目录 / 角色把权限补齐。练习 2–4 用的是你自己的
Z包和生成的业务对象,一般不需要额外授权。
4. 分支与仓库
官方工作坊仓库:
SAP-samples/abap-platform-rap630,本环境使用main分支。扩展项目的解决方案代码在另一个仓库:
SAP-samples/abap-platform-rap630-ext(技术原因拆成两个仓库)。仓库目录按练习组织:
exercises/ex0–ex4,每个练习一个 README 和截图。本教程不要求你克隆仓库,但导入解决方案包时需要仓库地址。
5. 常用快捷键与操作约定
整套练习几乎只用 ADT,把下面几个快捷键练熟能省掉大量鼠标操作(以你 ADT 版本的实际绑定为准):
快捷键 |
作用 |
在本教程里什么时候用 |
|---|---|---|
|
查找 / 替换 |
把代码块里的 |
|
Open ABAP Development Object,按名称跳转对象 |
打开 |
|
内容辅助 / 快速修复 |
生成行为实现类、补出缺失的处理器方法 |
|
激活当前对象 |
每个对象改完都要激活 |
|
以 ABAP Application (Console) 运行 |
运行生成器类与测试类 |
|
保存 |
改完代码先保存再激活 |
6. 对照表:原版练习与本教程步骤
如果你手里同时开着官方仓库的 exercises/exN/README.md,可以用这张表来回跳转:
官方练习 |
内容 |
本教程步骤 |
|---|---|---|
ex0 入门 |
系统、ADT、RAP Generator、生成练习包、组号 |
步骤 1–4 |
ex1.1 |
基于 |
步骤 5–11 |
ex1.2(可选) |
在类里用 EML 调用已发布 API,理解 |
步骤 12–13 |
ex1.3(可选) |
未发布对象与后继对象( |
步骤 14 |
ex2.1 |
用 validation 扩展行为 |
步骤 15–19 |
ex2.2 |
用 determination 扩展行为 |
步骤 20 |
ex2.3 |
用 side effect 扩展行为 |
步骤 21 |
ex3(手动) |
手动扩展 6 个对象加字段 |
步骤 22–25、27 |
ex3(向导) |
用扩展字段向导一次生成 |
步骤 22、26、27 |
ex4 |
用 action 扩展行为(Update feedback) |
步骤 28–32 |
官方原文抓取版把 16 篇文档合并成了一页,其中 ex1.2 的部分内容与 ex1.3 整体位于 HTML 注释里;本教程保留了其中仍然有教学价值的部分(授权实验与后继对象对照),并按步骤顺序补全了操作说明。
7. 开始前的检查清单
ADT 能登录目标系统,
Project Explorer能展开。能创建 ABAP 类并在控制台(Console)里看到
out->write输出。系统里能搜到
ZDMO_GEN_RAP630_SINGLE(或你已有讲师提供的ZRAP630_###两个包)。你记下了自己的组号
###(两位或三位都行,Trial 生成器会分配)。你知道怎么在 ADT 里按
Ctrl+F做 Replace All(后面要把文档里的###一次性替换掉)。准备好一个可以复用的传输请求(如果没有,向导里可以现场新建)。
操作步骤
下面把整个工作坊拆成 32 步,分五个阶段。约定:
文中所有
###都是你的组号占位符,操作时替换成真实值;ADT 编辑器里可以用Ctrl+F→ Replace All 批量替换。每一步的「验证」都给出可观察的成功标志,没看到就不要往下走。
练习 1 里的 1.2 / 1.3 是可选内容(偏原理验证),时间紧可以只做 1.1;但练习 2→3→4 是硬依赖,不能跳。
阶段 |
内容 |
对应步骤 |
|---|---|---|
A |
练习 0:入门准备、生成练习包 |
步骤 1–4 |
B |
练习 1:基于已发布 API 生成银行应用(含可选的 EML 授权实验) |
步骤 5–14 |
C |
练习 2:行为扩展(validation / determination / side effect) |
步骤 15–21 |
D |
练习 3:数据模型扩展(手动路径与向导路径二选一) |
步骤 22–27 |
E |
练习 4:动作扩展(Update feedback) |
步骤 28–32 |
建议节奏(按 5 小时估算):练习 0 约 30–45 分钟(生成练习包最耗时);练习 1 约 60–90 分钟(含授权排查);练习 2 约 90 分钟;练习 3 约 45–60 分钟(走扩展字段向导);练习 4 约 45 分钟。第一次做建议不要跳步;做完后有时间再回头试手动路径(路径 A),对照理解两者的等价关系。
步骤 1:确认系统、工具与权限,选定实践路径
做什么:先把「我在哪个系统上做、用哪种方式拿练习包」定下来,避免做到一半发现系统不支持。三种方式见「准备工作」第 1 节;本教程默认 方式 2(Trial 自学),同时兼容方式 1/3——差别只在练习包怎么来,后面的操作完全一样。
怎么确认:
在 ADT 里登录系统,确认是 ABAP Cloud 项目(不是普通 on-prem 项目)。
确认能找到 RAP Generator。Trial 系统里应能搜到
ZDMO_GEN_RAP630_SINGLE;若搜不到,先按仓库 README 导入cloud-abap-rap。若是 SAP 主办活动,先向讲师确认你的演示用户后缀
###(讲师会现场提供账号),练习包已经预生成,可直接跳到步骤 3。
验证:你能明确回答三个问题——系统是 BTP ABAP Environment 还是 S/4HANA Cloud Public Edition?练习包是已预生成还是要自己生成?练习 3 走手动路径还是向导路径?
步骤 2:在 Trial 系统里生成两个练习包
做什么:Trial 系统里不会为你预生成练习包,需要运行辅助类 ZDMO_GEN_RAP630_SINGLE。它会创建两个包,并生成一个启用可扩展性的托管业务对象(实体 Shop,带 CRUD 通用事务行为)。后续练习 2–4 都在它上面做扩展。
怎么点/怎么填:
在
Project Explorer里右键单击 Favorite Objects → Add Object。搜索
ZDMO_GEN_RAP630_SINGLE,选中后 OK。右键单击这个类 → Run As → ABAP Application (Console) F9。

等待生成。这个过程需要几分钟,请耐心看 ABAP 控制台的输出,不要重复点击运行。

生成结束后,在
Project Explorer里右键 Favorite Packages → Add Package...,输入ZRAP630_###,在候选列表里同时选中两个包ZRAP630_###与ZRAP630_###_EXT,然后 OK。

验证:Favorite Packages 下出现 ZRAP630_###(里面是基础 RAP BO,练习 2–4 要扩展它)和 ZRAP630_###_EXT(空包,练习 1–4 你创建的对象都放这里)。控制台没有报错。
为什么必须自己生成:工作坊有多个练习者,如果大家共用同一个可扩展 BO,并行扩展会互相干扰;生成器为每个人生成独立的 BO,并用组号区分。这个 BO 已经是「启用可扩展性 + 带 draft」的托管对象,正是练习 2–4 的舞台。
步骤 3:记下组号 ###,并建立替换占位符的习惯
做什么:整个工作坊的对象名都带组号后缀,比如 ZRAP630R_ShopTP_02A。每次复制代码或填写对象名时都要把 ### 换掉,否则激活会报「对象不存在」。
怎么点/怎么填:
把组号记在便签上。Trial 生成器选定的后缀会体现在两个包名里。
在 ADT 编辑器里用
Ctrl+F打开查找替换,把代码块里的###一次性替换成你的组号(Replace All)。

验证:随手打开一个对象名,形如 ZRAP630R_ShopTP_xxx 里的 xxx 与你的包名后缀一致;后续所有新建对象都用同一个后缀。
步骤 4:(可选)用 abapGit 导入官方解决方案包
做什么:如果你想直接看「做对了应该长什么样」,可以把官方解决方案包导入系统对照。Trial 系统已预装这两个包,不需要重复安装;只有方式 2 之外的自建系统才需要。
怎么点/怎么填:
新建包
ZRAP630_SOL,父包(superpackage)用ZLOCAL。把该包与仓库
SAP-samples/abap-platform-rap630关联(abapGit → Link/Import),分支选main。拉取变更(Pull changes),然后对导入的对象做批量激活(mass activation)。
发布服务绑定
ZRAP630UI_SHOP_O4_SOL,这样你就能预览到基础 Shop 应用。扩展项目的解决方案在另一个仓库
SAP-samples/abap-platform-rap630-ext,包名ZRAP630_SOL_EXT,同样用 abapGit 导入。
验证:ZRAP630_SOL / ZRAP630_SOL_EXT 下的对象全部激活,服务绑定 ZRAP630UI_SHOP_O4_SOL 处于已发布状态,预览能打开 Shop 列表。
步骤 5:在 Released Objects 里找到已发布的 I_BankTP
做什么:练习 1 的第一步不是写代码,而是找到正确的 API。ADT 的 Released Objects 树按合同类型列出系统里所有已发布对象,这是 ABAP Cloud 开发时最重要的一个入口。
怎么点/怎么填:
在
Project Explorer中展开 Released Objects 树。展开节点 USE_IN_CLOUD_DEVELOPMENT(表示「允许在 ABAP Cloud 开发中使用」)。
依次展开 Core Data Services → Behavior Definitions。
找到以 C1 合同发布的业务对象接口
I_BankTP(描述为Bank Business Object)。

验证:你能看到 I_BankTP;同时注意树里还有 EXTEND_IN_CLOUD_DEVELOPMENT 节点——那是「允许被扩展」的对象,练习 2–4 的 ZRAP630R_ShopTP_### 属于这一类。
小贴士:
I_BankTP是接口,不是表。真正落库的是 CDS 实体I_Bank_2背后的表BNKA,但BNKA已被标记为不可直接用,必须走I_Bank_2/I_BankTP。
步骤 6:启动 RAP Generator,选择 OData UI Service
做什么:调用 ADT 内置的生成器,在已发布接口之上生成一整套 UI 服务对象。这个生成器就是 Generate ABAP Repository Objects,后面练习 3 的扩展字段向导也走同一个入口。
怎么点/怎么填:
右键单击
I_BankTP→ Generate ABAP Repository Objects。

在 Select Generator 屏幕里展开 ABAP RESTful Application Programming Model,选择 OData UI Service,单击 Next。

验证:窗口底部 Referenced Object 显示 I_BANKTP;右侧说明文字写明了会生成「CDS 投影视图、CDS 投影行为定义、CDS 元数据扩展」等对象。
步骤 7:选择扩展包,设置工件后缀
做什么:把生成的对象放进你自己的扩展包(不要放进 SAP 交付的包,否则会因命名空间限制报错),并用组号作为后缀,避免和其他同事/其他练习冲突。
怎么点/怎么填:
在 Enter Package(或生成器首屏)用 Browse 选择包
ZRAP630_###_EXT,单击 Next。

在 Configure Generator 屏幕的 Artifacts Suffix 字段里输入你的组号
###。左侧树列出了将要生成的四个条目:Service Projection Entities、Service Projection Behavior、Service Definition、Service Binding,选中它们可以看到生成器建议的对象名(生成器会保证名称唯一,保持建议值即可)。

验证:左侧树里各条目的名称末尾带上了你的后缀(例如服务定义/服务绑定形如 ZUI_BANKTP_###)。
步骤 8:检查生成清单,选择传输请求并完成
做什么:生成器在真正落盘前会列出「要创建/修改哪些仓库对象」,这是最后一道检查关口。
怎么点/怎么填:
单击 Next,来到 ABAP Artifacts Generation/Modification List。列表包含:服务定义与服务绑定(Business Service Layer)、多个 Data Definition(投影视图
ZC_BANKTP###、ZC_BANKADDRESSTP###、ZC_BANKSCRIPTEDADDRESSTP###)、对应的元数据扩展、投影行为定义ZC_BANKTP###,以及行为实现类ZBP_C_BANKTP###。下方 Preview 区可以直接看到服务定义的源代码。

单击 Next,选择一个已有传输请求或新建一个,单击 Finish。

验证:弹出成功提示,询问是否打开生成的服务绑定编辑器,单击 Open。

步骤 9:发布服务绑定,确认生成结果
做什么:服务绑定生成后默认是未发布状态,必须 Publish 才能对外提供 OData 服务。
怎么点/怎么填:
生成完成后 ADT 会打开服务绑定编辑器。此时 Local Service Endpoint 还是
Unpublished,而左侧Project Explorer里已经能看到生成的全部对象。

单击 Publish,在本系统内发布服务绑定。
验证:服务绑定的 Local Service Endpoint 从 Unpublished 变为 Published;服务 URL 形如 /sap/opu/odata4/sap/zui_banktp_###/srvd/...。
步骤 10:在 Fiori elements 预览里创建第一家银行
做什么:不写任何 UI 代码,直接验证生成的服务能读能写。此步也是整个练习 1 的「跑通」标志。
怎么点/怎么填:
在服务绑定编辑器的 Service Version Details 区域,展开 Entity Set and Association,选中实体集 Bank,单击右侧 Preview(或直接双击实体集
Bank)。

应用打开后,在列表页工具栏单击 Create。

在 New Object 对话框里填写:Bank Country/Region =
CZ,Bank Key =1234,单击 Continue。

进入对象页,补齐必填字段:Bank Name 填
Test Bank,Bank number 填1234(这两项带*的字段必须填),单击 Create。

验证:保存成功,列表里出现刚才创建的银行记录(CZ / 1234 / Test Bank)。如果此时报授权错误,不要慌,下一步就是处理它。
观察点:整个列表页、对象页、字段校验都是生成器根据消费视图上的注解自动拼出来的,你一行 UI 代码都没写。以后要调整界面(加列、改标签、换布局),改的是 CDS 注解或元数据扩展,而不是前端代码。
步骤 11:读懂授权报错,并知道正确的修复姿势
做什么:练习 1 有意让开发用户缺权限,好让你体会「RAP BO 的授权检查发生在哪一层」。你要学会从报错反查到授权对象,而不是靠猜。
你会看到的现象:创建时弹出错误 You are not authorized to create bank data for country/region CZ.

怎么查:
打开
I_BankTP的 Knowledge Transfer Document(KTD)。两种方式:按Ctrl+Shift+A输入I_BankTP;或在Project Explorer里沿 Released Objects → USE_IN_CLOUD_DEVELOPMENT → Core Data Services → Behavior Definitions → I_BankTP → Documentation 找到I_BankTP文档。

在 KTD 里查看 Authorization 一节。它明确写出这个业务对象检查两个授权对象:
F_BNKA_MAO与F_BNKA_INT,并说明各活动(ACVTV)对应的读写含义。

分别查看两个授权对象的字段结构,确认你要建的银行落在哪个国家/地区键值范围里。


怎么修:正确做法是「建 IAM 应用 → 加授权对象并维护实例值 → 挂到业务目录 → 分配给角色 → 把角色分配给用户」。在 BTP ABAP Environment 里通常在 Maintain IAM App / 业务目录 / 角色维护应用里完成;S/4HANA Cloud 则在对应的 IAM 相关应用里完成。授权实例(Authorization 0001)里要把 BBANKS 的授权值改成覆盖你的目标国家/地区(例如从 AD-YY 扩展到包含 CZ),具体以你系统的授权维护界面为准。
验证:重新打开预览创建同一家银行,不再报授权错误,记录成功保存。
这里失败是设计好的。练习 1.2 会演示另一种「不建 IAM 应用也能跑」的变通办法——特权模式(PRIVILEGED),但它只适合后台作业这类受控场景,不能拿来替代正式授权。
步骤 12:(可选)在扩展包里新建测试类
做什么:练习 1.2 演示「已发布 API 出现在你自己的代码里」的典型场景:一个由应用程序作业(application job)调用的类。这种场景下,执行用户往往没有对应的应用授权,因此需要理解 EML 调用与授权的关系。
怎么点/怎么填:
右键包
ZRAP630_###_EXT→ New → ABAP Class。

在 New ABAP Class 对话框里填写:Name =
zcl_test_abap_cloud_###,Description =Test ABAP Cloud Governance;单击 Interfaces 右侧的 Add...,选择IF_OO_ADT_CLASSRUN,OK;单击 Next。

创建完成后,项目资源管理器里的 ABAP 类就是下面这个图标(便于和接口、CDS 对象区分):

选择一个传输请求,单击 Finish。
验证:类编辑器打开,方法 if_oo_adt_classrun~main( ) 里已有 out->write( 'Hello World' ) 之类的骨架代码。
步骤 13:(可选)用 EML 调用 I_BankTP,观察授权检查与 PRIVILEGED 模式
做什么:在类里用 EML 的 MODIFY ENTITIES 创建一家银行,再读回来。先把「不加特权」的版本跑一遍,确认授权检查真的生效;再加 PRIVILEGED 和 WITH PRIVILEGED ACCESS,看它们分别跳过了什么。
怎么填:把 if_oo_adt_classrun~main( ) 的方法体替换为下面代码。注意把 '####' 换成只含数字的字符串(用你系统里还没用过的编号)。
METHOD if_oo_adt_classrun~main.
DATA create_bank TYPE STRUCTURE FOR CREATE i_banktp.
DATA bank_id_number TYPE i_banktp-BankInternalID VALUE '8035'.
SELECT SINGLE *
FROM I_Bank_2
* WITH
* PRIVILEGED ACCESS
WHERE BankInternalID = @bank_id_number
INTO @DATA(my_bank).
IF sy-subrc = 0.
out->write( |my new bank { my_bank-BankName } { my_bank-BankInternalID } already exists.| ).
EXIT.
ENDIF.
create_bank = VALUE #( BankCountry = 'ZW'
BankInternalID = bank_id_number
LongBankName = 'Bank name'
LongBankBranch = 'Bank branch'
BankNumber = bank_id_number
BankCategory = ''
BankNetworkGrouping = ''
SWIFTCode = 'SABMGB2LACP'
IsMarkedForDeletion = '' ).
MODIFY ENTITIES OF i_banktp
* PRIVILEGED
ENTITY bank
CREATE FIELDS ( bankcountry
bankinternalid
longbankname
longbankbranch
banknumber
bankcategory
banknetworkgrouping
swiftcode
IsMarkedForDeletion )
WITH VALUE #( ( %cid = 'cid1'
BankCountry = create_bank-BankCountry
BankInternalID = create_bank-BankInternalID
LongBankName = create_bank-LongBankName
LongBankBranch = create_bank-LongBankBranch
BankNumber = create_bank-BankNumber
BankCategory = create_bank-BankCategory
BankNetworkGrouping = create_bank-BankNetworkGrouping
SWIFTCode = create_bank-SWIFTCode
IsMarkedForDeletion = create_bank-IsMarkedForDeletion ) )
MAPPED DATA(mapped)
REPORTED DATA(reported)
" TODO: variable is assigned but never used (ABAP cleaner)
FAILED DATA(failed).
LOOP AT mapped-bank INTO DATA(mapped_success).
out->write( |mapped key { mapped_success-%key-BankInternalID }| ).
ENDLOOP.
LOOP AT reported-bank INTO DATA(reported_error_1).
DATA(exc_create_bank) = cl_message_helper=>get_longtext_for_message( text = reported_error_1-%msg ).
out->write( |error EML { exc_create_bank } | ).
ENDLOOP.
IF reported-bank IS NOT INITIAL.
EXIT.
ENDIF.
COMMIT ENTITIES
RESPONSE OF i_banktp
" TODO: variable is assigned but never used (ABAP cleaner)
FAILED DATA(failed_commit)
REPORTED DATA(reported_commit).
LOOP AT reported_commit-bank INTO DATA(reported_error_2).
DATA(exc_create_bank2) = cl_message_helper=>get_longtext_for_message( text = reported_error_2-%msg ).
out->write( |error commit entities { exc_create_bank2 } | ).
ENDLOOP.
IF reported_commit-bank IS NOT INITIAL.
EXIT.
ENDIF.
COMMIT WORK.
SELECT SINGLE *
FROM I_Bank_2
* WITH
* PRIVILEGED ACCESS
WHERE BankInternalID = @bank_id_number
INTO @my_bank.
IF sy-subrc = 0.
out->write( |my new bank { my_bank-BankName } { my_bank-BankInternalID }| ).
ELSE.
out->write( |my new bank { my_bank-BankName } does not exist| ).
ENDIF.
ENDMETHOD.
代码说明:response 参数是 EML 语句的响应容器——MAPPED 拿到键映射(新建对象的主键),REPORTED 拿到返回的消息,FAILED 拿到无法处理的操作。
运行与观察:
按
Ctrl+F3激活,再按F9运行。第一次运行应看到:
error You are not authorized to create bank data for country/region ZW.。原因是你的用户角色只允许某些国家/地区代码的银行,而代码里写的是ZW。

现在做对照实验:把
MODIFY ENTITIES OF i_banktp下面那一行PRIVILEGED的注释去掉(让PRIVILEGED真正生效),再运行。
MODIFY ENTITIES OF i_banktp
PRIVILEGED
ENTITY bank
CREATE FIELDS ( bankcountry
bankinternalid
longbankname
...
PRIVILEGED 的意思是:跳过该 RAP BO 的授权检查。它跳过的具体范围由 BDEF 里的授权上下文决定。可以用 Ctrl+Shift+A 打开行为定义 R_BankTP 查看:
managed with unmanaged save implementation in class bp_r_banktp unique;
strict ( 2 );
with draft;
extensible
{
with additional save;
with determinations on modify;
with determinations on save;
with validations on save;
}
with privileged mode disabling NoCheckWhenPrivileged;
//NoCheckWhenPrivileged
define authorization context NoCheckWhenPrivileged
{
'F_BNKA_MAO';
'F_BNKA_INT';
}
这里定义了两个授权上下文:Own authorization context 列出 RAP BO 实现中使用的所有授权对象;NoCheckWhenPrivileged 列出「特权使用方可以跳过」的授权对象。所以加了 PRIVILEGED 后,创建确实成功了——但你会看到输出类似:
mapped key ####
my new bank does not exist
能建、却读不到,因为第二条 SELECT 走的是 ABAP SQL,受另一层保护:底层 CDS 实体 I_Bank_2 上有 DCL(Data Control Language),它会检查授权对象 F_BNKA_MAO 的字段 BBANKS。查看 DCL 的方法:按 Ctrl+Shift+A 输入 I_Bank_2,在候选里选择 Access Control(不是 Data Definition)。


最后一步:给类里的两条 ABAP SQL 都加上
WITH PRIVILEGED ACCESS,强制跳过 DCL 的授权检查。
METHOD if_oo_adt_classrun~main.
"...
SELECT SINGLE *
FROM I_Bank_2
WITH
PRIVILEGED ACCESS
WHERE BankInternalID = @bank_id_number
INTO @DATA(my_bank).
"...
SELECT SINGLE *
FROM I_Bank_2
WITH
PRIVILEGED ACCESS
WHERE BankInternalID = @bank_id_number
INTO @my_bank.
"...
ENDMETHOD.
再按
F9运行。
验证:控制台先输出 mapped key 8035 之类的键映射,最后输出 my new bank Bank name 8035,说明数据既能创建也能读取。

三条经验:① 授权检查分两层——RAP BO 层(EML 的
PRIVILEGED)和 ABAP SQL/DCL 层(WITH PRIVILEGED ACCESS);②PRIVILEGED是给受控后台场景用的,不是绕过授权的通用手段;③ 遇到「建成功但读不到」,先查 DCL,而不是怀疑数据没写进去。
另外两个典型报错(原文档列出的「其他潜在问题」):
error ISO code GB 与 SWIFT code SABMGB2LACP 不匹配,对于国家/地区 US 来说不正确:I_BankTP会校验 SWIFT/BIC 第 5–6 位与国家/地区 ISO 代码是否一致。上例SABMGB2LACP对应 GB,若 BankCountry 填US就会报错。处理:让 BankCountry 与 SWIFT 代码匹配,或清空 SWIFT 代码。error 银行 CZ 8888 已存在:主键重复。换一个还没用过的 BankInternalID 即可。
步骤 14:(可选)对照实验——ABAP Cloud 如何拦住旧对象
做什么:理解「不可用对象 → 后继对象」的机制。把旧写法贴进同一个类,故意让它编译失败,比看文档印象深得多。看完请把这些语句注释或删掉,否则类无法激活。
怎么填:在方法里插入下面片段(原文档中的对照示例):
"... the code with the EML statement
DATA bank_address TYPE bapi1011_address.
DATA bank_ctry TYPE banks .
CALL FUNCTION 'BAPI_BANK_CREATE'
EXPORTING
bank_ctry = bank_ctry
bank_address = bank_address
" IMPORTING
" return =
" bankcountry =
" bankkey =
.
SELECT * FROM bnka WHERE bankl = '0010001516' INTO TABLE @DATA(my_banks).
验证:因为类使用的是 ABAP Cloud 开发模型(语言版本 ABAP for Cloud Development),会得到类似下面的语法错误(行号以你类里的实际位置为准):
第 103 行:不允许使用表 BAPI1011_ADDRESS;
第 104 行:不允许使用数据元素 BANKS;
第 106 行:不允许使用函数模块 BAPI_BANK_CREATE,但它已有后继对象,即行为定义
I_BANKTP;第 116 行:不允许使用表 BNKA,请改用 CDS 实体 I_BANK_2。
把这些语句注释掉后类恢复激活。以后遇到「Use of
步骤 15:练习 2 开场——创建行为扩展(BDEF extension)
做什么:练习 2 只扩展行为,不动数据模型。做法是在 R 层的行为定义 ZRAP630R_ShopTP_### 上创建一个扩展(而不是直接改它),然后在扩展里加 validation / determination / side effect。
怎么点/怎么填:
右键单击行为定义
ZRAP630R_ShopTP_###→ New Behavior Extension。

在 Create Behavior Extension 对话框里填写(务必把包改成
ZRAP630_###_EXT):Package:
ZRAP630_###_EXT(⚠ 默认会建议基础 BO 所在的包;如果包由 SAP 交付,Finish 时会报「不允许在 SAP 命名空间创建对象」)Name:
ZRAP630R_EXT_SHOPTP_###Description:
Extension for ZRAP630R_ShopTP_###Behavior Definition:
ZRAP630R_SHOPTP_###BO Interface:
ZRAP630I_SHOPTP_###

选择一个传输请求,单击 Finish。
验证:编辑器打开,内容形如:
extension using interface zrap630i_shoptp_###
implementation in class zbp_rap630r_ext_shoptp_### unique;
extend behavior for Shop
{
}
步骤 16:在扩展里声明一个交货日期校验(validation)
做什么:创建一个在保存时触发的校验:交货日期不能为空。校验挂在 create 事件和字段 DeliveryDate 上,并加入草稿的 Prepare 确定动作,这样草稿保存时也会被检查。
怎么填:把扩展代码改成:
extension using interface zrap630i_shoptp_###
implementation in class zbp_rap630r_ext_shoptp_### unique;
extend behavior for Shop
{
validation zz_validateDeliverydate on save { create; field DeliveryDate; }
extend draft determine action Prepare
{
validation zz_validateDeliveryDate;
}
}
按 Ctrl+F3 激活。
验证:激活无语法错误;extend draft determine action Prepare 块被接受(说明基础 BO 的草稿确定动作可按扩展方式挂校验)。
步骤 17:生成行为实现类,并切到 Local Types
做什么:BDEF 扩展里声明的每个行为都要有实现方法。ADT 可以基于声明自动生成实现类的骨架。
怎么点/怎么填:
在扩展代码里单击实现类名
zbp_rap630r_ext_shoptp_###(1),按Ctrl+1打开内容辅助,在建议列表里选择 Create behavior implementation class ... (2),单击 Next (3)。

选择传输请求,单击 Finish。
实现类的编辑器打开后,切换到 Local Types 选项卡——行为的实现都写在本地类里。

验证:Local Types 里能看到 lhc_shop 类的定义与实现骨架,且 zz_validateDeliverydate 方法已声明。
步骤 18:实现校验方法
做什么:把校验逻辑写进本地类 lhc_shop。用 EML 的 READ ENTITIES ... IN LOCAL MODE 读出受影响订单的交货日期;为空就把该实例放进 failed-shop(触发失败)并往 reported-shop 追加错误消息。
怎么填:把下面代码加入 Local Types(覆盖/补全 lhc_shop 的定义与实现):
CLASS lhc_shop DEFINITION INHERITING FROM cl_abap_behavior_handler.
PUBLIC SECTION.
CONSTANTS state_area_check_delivery_date TYPE string VALUE 'CHECK_DELIVERYDATE' ##NO_TEXT.
PRIVATE SECTION.
METHODS zz_validateDeliverydate FOR VALIDATE ON SAVE
IMPORTING keys FOR Shop~zz_validateDeliverydate.
ENDCLASS.
CLASS lhc_shop IMPLEMENTATION.
METHOD zz_validateDeliverydate.
READ ENTITIES OF ZRAP630i_ShopTP_### IN LOCAL MODE
ENTITY Shop
FIELDS ( DeliveryDate OverallStatus )
WITH CORRESPONDING #( keys )
RESULT DATA(onlineorders).
LOOP AT onlineorders INTO DATA(onlineorder).
APPEND VALUE #( %tky = onlineorder-%tky
%state_area = state_area_check_delivery_date )
TO reported-shop.
DATA(deliverydate) = onlineorder-DeliveryDate - cl_abap_context_info=>get_system_date( ).
IF onlineorder-deliverydate IS INITIAL .
APPEND VALUE #( %tky = onlineorder-%tky ) TO failed-shop.
APPEND VALUE #( %tky = onlineorder-%tky
%state_area = state_area_check_delivery_date
%msg = new_message_with_text(
severity = if_abap_behv_message=>severity-error
text = 'delivery period cannot be initial'
) )
TO reported-shop.
ENDIF.
ENDLOOP.
ENDMETHOD.
ENDCLASS.
按 Ctrl+F3 激活。
验证:激活成功,没有「方法未实现」的报错。
步骤 19:在 Fiori 预览里验证校验生效
做什么:不填交货日期直接创建订单,确认校验拦住保存。
怎么点/怎么填:
打开基础 BO 的服务绑定
ZRAP630UI_SHOP_O4_###,双击实体 Shop,启动 ADT 预览。

在列表页单击 Create。
在 New : Shop 对象页里为 OrderedItem 选择一个产品,但故意不选 Delivery Date。
单击 Create。
验证:页面顶部出现红色提示 The object contains error messages,错误面板里列出两条:Resolve data inconsistencies to save changes. 与 delivery period cannot be initial。说明扩展的校验已生效。
两条消息的来源不同:第一条是框架对「保存失败」的统一提示,第二条才是你在
reported-shop里追加的业务消息(%state_area决定它归属哪个检查区域)。这也是 RAP 校验的典型写法——先标记failed,再补一条可读的消息。

如果这里没有报错,先确认 BDEF 扩展和行为实现类都已激活,再刷新预览。
步骤 20:用确定(determination)自动回写价格与审批状态
做什么:当用户修改 OrderedItem 时,自动读取产品价格,回写订单价格、货币和审批状态(价格 > 1000 欧元 → Awaiting approval,否则 Automatically approved)。
怎么填:
在 BDEF 扩展里加一条 determination(放在 validation 之后):
determination ZZ_setOverallStatus on modify { field OrderedItem; }
改完后扩展代码应是:
extension using interface zrap630i_shoptp_###
implementation in class zbp_rap630r_ext_shoptp_### unique;
extend behavior for Shop
{
validation zz_validateDeliverydate on save { create; field DeliveryDate; }
extend draft determine action Prepare
{
validation zz_validateDeliveryDate;
}
determination ZZ_setOverallStatus on modify { field OrderedItem; }
}
按
Ctrl+1在Shop实体上调用内容辅助,生成对应方法的声明(然后到 Local Types 里实现)。把下面的实现加入方法
ZZ_setOverallStatus。
METHOD ZZ_setOverallStatus.
DATA update_bo TYPE TABLE FOR UPDATE ZRAP630i_ShopTP_###\Shop.
DATA update_bo_line TYPE STRUCTURE FOR UPDATE ZRAP630i_ShopTP_###\Shop .
READ ENTITIES OF ZRAP630I_ShopTP_### IN LOCAL MODE
ENTITY Shop
ALL FIELDS " ( OrderItemPrice OrderID )
WITH CORRESPONDING #( keys )
RESULT DATA(OnlineOrders)
FAILED DATA(onlineorders_failed)
REPORTED DATA(onlineorders_reported).
DATA(product_value_help) = NEW zrap630_cl_vh_product_###( ).
data(products) = product_value_help->get_products( ).
LOOP AT onlineorders INTO DATA(onlineorder).
update_bo_line-%tky = onlineorder-%tky.
SELECT SINGLE * FROM @products as hugo
WHERE Product = @onlineorder-OrderedItem INTO @data(product).
update_bo_line-OrderItemPrice = product-Price.
update_bo_line-CurrencyCode = product-Currency.
IF product-Price > 1000.
update_bo_line-OverallStatus = 'Awaiting approval'.
ELSE.
update_bo_line-OverallStatus = 'Automatically approved'.
ENDIF.
APPEND update_bo_line TO update_bo.
ENDLOOP.
MODIFY ENTITIES OF zrap630i_shoptp_### IN LOCAL MODE
ENTITY Shop
UPDATE FIELDS (
OverallStatus
CurrencyCode
OrderItemPrice
)
WITH update_bo
REPORTED DATA(update_reported).
reported = CORRESPONDING #( DEEP update_reported ).
ENDMETHOD.
激活(
Ctrl+F3)。
验证:回到预览,新建一个订单或修改已有订单的 OrderedItem,然后先不要保存。
你会看到:草稿里物料项名称更新了,但价格与审批状态不会立刻变;只有保存后才会在 UI 刷新。这不是 bug,而是缺少「副作用」——下一步解决。
报错提示:如果激活时看到 The entity "SHOP" does not have a determination "ZZ_SETOVERALLSTATUS",通常是你还没激活 BDEF 扩展(声明先于实现生效),先激活 BDEF 再激活类。
步骤 21:用副作用(side effect)让草稿即时刷新
做什么:告诉 UI「OrderedItem 变化会影响 OrderItemPrice、CurrencyCode、OverallStatus 这三个字段」,框架就会在字段变化后自动重取这些字段,草稿状态下也能立刻看到新价格和状态。
注意:只有基础 BO 的行为投影/接口投影里预先写了 use side effects 语句,才能通过扩展添加副作用;这条语句本身无法通过扩展补上,必须由基础 BO 的开发者在设计时预留(本工作坊的生成对象已预留)。
怎么填:
按
Ctrl+Shift+A打开行为扩展ZRAP630R_Ext_ShopTP_###。在 determination 语句后面加一行:
side effects { field OrderedItem affects field OrderItemPrice , field CurrencyCode , field OverallStatus ; }
改完后扩展代码应类似:
extension using interface zrap630i_shoptp_###
implementation in class zbp_rap630r_ext_shoptp_### unique;
extend behavior for Shop
{
validation zz_validateDeliverydate on save { create; field DeliveryDate; }
extend draft determine action Prepare
{
validation zz_validateDeliveryDate;
}
determination ZZ_setOverallStatus on modify { field OrderedItem; }
side effects { field OrderedItem affects field OrderItemPrice , field CurrencyCode , field OverallStatus ; }
}
激活,回到预览:新建订单并指定交货日期,或打开已有订单切换编辑模式,然后选择一个(新的)产品。
验证:SAP Fiori UI 里所选产品的价格与审批状态立即自动更新;若价格从低于 1000 欧元变成高于 1000 欧元(或反之),审批状态同步切换。这说明 determination + side effect 的组合生效了。
运行机制:determination 在
on modify时把新值写进草稿的瞬时状态;side effect 则告诉框架「这些字段在OrderedItem变化后需要重新从后端取」,于是框架发出一次只取受影响字段的读取请求,UI 随后刷新。缺了 side effect,值其实也算出来了,只是 UI 不知道要重新取。

步骤 22:练习 3 开场——认清要扩展的 6 个对象与两条路径
做什么:练习 3 扩展数据模型,给 Shop 实体加一个可编辑字段 ZZFEEDBACKZAA(界面标签 Feedback)。前面说过,数据模型扩展要沿 CDS 视图栈自下而上做,一共 6 个对象。
顺序 |
基础对象 |
名称 |
说明 |
|---|---|---|---|
1 |
|
扩展包含结构(Extension include) |
用追加结构给活动表和草稿表加字段 |
2 |
|
扩展包含视图(Extension include view) |
从(扩展后的)活动表读取 |
3 |
|
受限基础视图(Restricted base view) |
从 (2) 读取 |
4 |
|
CDS 投影视图(Projection/Consumer view) |
从 (3) 读取,并加 UI 注解 |
5 |
|
接口视图(Interface view) |
从 (3) 读取 |
6 |
|
草稿查询视图(Draft query view) |
从(扩展后的)草稿表读取 |
先选路径(本环境已确定):
本手册的环境是 SAP BTP ABAP Environment / S/4HANA Cloud Public Edition(ABAP Cloud,≥ 2408):主线走 路径 B(扩展字段向导),一次生成全部 6 个扩展对象(步骤 26)。
路径 A(手动扩展,步骤 23–25)作为等价对照保留,第一次可先跳过,做完主线后再回看。
两条路径最终产物一样,只走一条;另一条当作对照学习。
前提:基础 RAP BO 必须按官方帮助启用可扩展性支持(本工作坊的生成对象已满足)。
步骤 23:路径 A(手动)——用追加结构给扩展包含结构加字段
做什么:扩展包含结构是基础 BO 预留的「插槽」,字段必须通过**追加结构(append structure)**挂进去,才会同时落到活动表和草稿表。
怎么点/怎么填:
右键单击扩展包含结构
ZRAP630SSHOP_###→ New Append Structure。

在 New Append Structure 对话框里填写(⚠ 包必须改成扩展包):
Package:
ZRAP630_###_EXTName:
ZAPD_ZRAP630SSHOP_###Description:
Extend Extension Include Structure
单击 Next。
选择传输请求,单击 Finish。
在编辑器里输入字段定义:
@EndUserText.label : 'extend ZRAP630SSHOP_###'
@AbapCatalog.enhancement.category : #NOT_EXTENSIBLE
extend type zrap630sshop_### with zapd_zrap630sshop_### {
zzfeedbackzaa : text100;
}
激活。
验证:追加结构激活成功。以后 ZRAP630SSHOP_### 的结构里就多了 ZZFEEDBACKZAA(类型 TEXT100)。
步骤 24:路径 A(手动)——扩展扩展包含视图
做什么:E 视图从(扩展后的)活动表读数据,所以它是 R 视图的下一环。ADT 在这里用「Data Definition + Extend View Entity 模板」的方式创建扩展视图。
怎么点/怎么填:
右键单击要扩展的 CDS 视图
ZRAP630E_Shop_###。

在上下文菜单选择 New Data Definition。
在 New Data Definition 屏幕输入:
Package:
ZRAP630_###_EXT(⚠ ADT 会默认建议基础 BO 的包,必须改)Name:
ZX_ZRAP630E_SHOP_###Description:
Extension for Extension Include View
单击 Next。

选择传输请求,单击 Next(不要按 Finish,下一步要选模板)。
在模板列表里选择 Extend View Entity,单击 Finish。

编辑器打开后,把模板占位符替换成真实内容:
extend view entity ZRAP630E_Shop_### with {
Shop.zz_feedback_zaa as zz_feedback_zaa
}

激活。
验证:扩展视图 ZX_ZRAP630E_SHOP_### 激活成功。注意字段名要与步骤 23 追加结构里的一致(本工作坊原文此处写作 zz_feedback_zaa,而追加结构里是 zzfeedbackzaa;ABAP CDS 标识符不区分大小写但不忽略下划线,激活报「字段不存在」时以你系统里的实际元素名为准,二者统一即可)。
E 视图这一层只负责「把字段读出来」,不负责显示。什么时候显示、显示在哪,由后面 C 视图扩展里的
@UI注解决定:dataFieldDefault控制对象页字段,identification控制对象页表头区,lineItem控制列表页列。
步骤 25:路径 A(手动)——按顺序扩展其余 4 个视图
做什么:其余视图的操作与步骤 24 完全一样(都是 New Data Definition → 选 Extend View Entity 模板 → 填代码 → 激活),只是对象名和数据源别名不同。顺序很重要:E → R → C/I → 草稿查询视图。
怎么填:依次创建下列 4 个扩展视图,包统一用 ZRAP630_###_EXT。
(1)R-CDS 视图的扩展
Name:
ZX_ZRAP630R_SHOPTP_###Description:
Extension for R-CDS view
extend view entity ZRAP630R_SHOPTP_### with
{
@EndUserText.label: 'Feedback'
_EXTENSION.ZZFEEDBACKZAA as ZZFEEDBACKZAA
}
注意:R 视图的代码从
_EXTENSION关联里取数据,其他视图都从别名Shop取数据。
(2)C-CDS 视图的扩展(这一层要同时加 UI 注解,否则 UI 上看不到字段)
Name:
ZX_ZRAP630C_SHOPTP_###Description:
Extension for P-CDS view
extend view entity ZRAP630C_SHOPTP_### with
{
@EndUserText.label: 'Feedback'
@UI.dataFieldDefault: [{hidden: false}]
@UI.identification: [{hidden: false}]
@UI.lineItem: [{hidden: false}]
SHOP.ZZFEEDBACKZAA as ZZFEEDBACKZAA
}
(3)I-CDS 视图的扩展
Name:
ZX_ZRAP630I_SHOPTP_###Description:
Extension for interface view
extend view entity ZRAP630I_SHOPTP_### with
{
@EndUserText.label: 'Feedback'
SHOP.ZZFEEDBACKZAA as ZZFEEDBACKZAA
}
(4)草稿查询视图的扩展
Name:
ZX_ZRAP630R_SHOP_D_###Description:
Extension for draft query view
extend view entity ZRAP630R_SHOP_D_### with
{
SHOP.ZZFEEDBACKZAA as ZZFEEDBACKZAA
}
验证:6 个扩展对象全部激活。项目资源管理器里的扩展包应长这样:

对照表(做完了逐条勾):
No. |
扩展仓库对象 |
被扩展的仓库对象 |
说明 |
|---|---|---|---|
1 |
|
|
扩展包含结构 |
2 |
|
|
扩展包含视图 |
3 |
|
|
受限事务性基础视图 |
4 |
|
|
事务性投影视图 |
5 |
|
|
事务性接口视图 |
6 |
|
|
草稿查询视图 |
步骤 26:路径 B(向导)——用扩展字段向导一次生成 6 个扩展对象
做什么:如果系统支持扩展字段向导(Extension Field Wizard),可以跳过步骤 23–25,让向导一次创建追加结构 + 5 个 CDS 扩展视图(并自动补 UI 注解)。向导可以从消费视图(C 视图)、接口投影视图(I 视图)或受限基础视图(R 视图)启动,入口不同,默认勾选的层也不同。

怎么点/怎么填:
右键单击消费投影视图
ZRAP630C_ShopTP_###(包含provider contract TRANSACTIONAL_QUERY语句的那个视图),选择 Generate ABAP Repository Objects...。

在 Select Generator 屏幕展开 ABAP Cloud: Extensibility,选择 Extension Fields,单击 Next。

在 Enter Package 屏幕输入包
ZRAP630_###_EXT,单击 Next。

在 Configure Generator 屏幕单击 Add (1),在 Add Field 对话框里填写:
Name:
ZZFEEDBACKZAALabel:
FeedbackData Element:
TEXT100勾选 Generate UI annotations (3)
单击 Add (4)。

展开 Business Object Layer Extensions 和 Business Service Layer Extensions,确认 Extend object? 为
Yes,单击 Next。

向导列出将要创建/修改的工件(追加结构 + 5 个扩展视图 + 服务层扩展)。选中某一行,下方 Preview 会显示该对象的代码。

各扩展视图的预览如下(可作为步骤 25 的对照):




单击 Next,选择传输请求,单击 Finish。
验证:扩展包 ZRAP630_###_EXT 里出现向导生成的 6 个对象(外加你的行为扩展、行为实现类等),全部处于激活状态。
向导不是「另一套东西」,它和你前面手动做的事完全等价:走的还是
Generate ABAP Repository Objects框架,只是把 6 个对象的创建和代码填写自动化了。所以同一个系统里两种方法可以混用,但要避免对同一个视图重复扩展。

向导生成的代码(供与手动路径对照):
@EndUserText.label : 'ZAPD_ZRAP630SSHOP_###'
@AbapCatalog.enhancement.category : #NOT_EXTENSIBLE
extend type zrap630sshop_### with zapd_zrap630sshop_### {
zzfeedbackzaa : text100;
}
extend view entity ZRAP630E_SHOP_### with
{
SHOP.ZZFEEDBACKZAA as ZZFEEDBACKZAA
}
extend view entity ZRAP630R_SHOPTP_### with
{
@EndUserText.label: 'Feedback'
_EXTENSION.ZZFEEDBACKZAA as ZZFEEDBACKZAA
}
extend view entity ZRAP630R_SHOP_D_### with
{
SHOP.ZZFEEDBACKZAA as ZZFEEDBACKZAA
}
extend view entity ZRAP630I_SHOPTP_### with
{
@EndUserText.label: 'Feedback'
SHOP.ZZFEEDBACKZAA as ZZFEEDBACKZAA
}
extend view entity ZRAP630C_SHOPTP_### with
{
@EndUserText.label: 'Feedback'
@UI.dataFieldDefault: [{hidden: false}]
@UI.identification: [{hidden: false}]
@UI.lineItem: [{hidden: false}]
SHOP.ZZFEEDBACKZAA as ZZFEEDBACKZAA
}
步骤 27:验证新字段在 Fiori UI 中可用
做什么:扩展完整个视图栈后,新字段才真正「穿透」到 UI。这是练习 3 的验收动作。
怎么点/怎么填:
打开基础 BO 的服务绑定,双击实体 Shop 启动预览。
单击 Go。
验证:列表页出现名为 Feedback 的新列。

选中一条记录,单击 Edit。

看不到字段时按顺序排查:① C 视图扩展 ZX_ZRAP630C_SHOPTP_### 是否激活;② UI 注解(@UI.lineItem / @UI.identification / @UI.dataFieldDefault)是否写了;③ 服务绑定是否重新发布;④ 浏览器硬刷新。
步骤 28:练习 4 开场——创建抽象实体作为动作参数
做什么:练习 4 给 Shop 加一个动作 Update feedback,用弹窗接收用户输入的反馈文本,写回 ZZFEEDBACKZAA 字段。动作的参数必须通过**抽象实体(abstract entity)**传递,所以先建一个带 feedback 字段的抽象实体。
为什么必须排在练习 3 之后:通过可扩展性添加的动作,只能加在同样通过可扩展性添加的字段上。没有步骤 23–27 加的 ZZFEEDBACKZAA,就没有动作的操作对象。
怎么点/怎么填:
右键单击包
ZRAP630_###_EXT里的 Data Definition 文件夹 → New Data Definition。填写:Package =
ZRAP630_###_EXT,Name =ZRAP630_A_Feedback_###,Description =Pass feedback as a parameter,单击 Next。选择传输请求。
在模板列表里展开 Abstract Entity (creation),选择 Define abstract entity with parameters,单击 Finish。

把模板代码替换为(本例不需要
with parameters子句):
@EndUserText.label: 'Pass feedback as a parameter'
define abstract entity ZRAP630_A_Feedback_###
{
feedback : abap.char(100);
}
激活。
验证:抽象实体 ZRAP630_A_Feedback_### 激活成功,包含一个 100 字符的 feedback 字段。
步骤 29:在行为扩展里声明只读字段与动作
做什么:在 BDEF 扩展里把 zzfeedbackzaa 设为只读(它只能通过动作修改,用户不能直接编辑),并声明 ZZ_ProvideFeedback 动作:参数为抽象实体,结果返回 1 条 $self。
怎么填:在行为扩展里追加两行(放在 side effects 之后):
field(readonly) zzfeedbackzaa;
action(authorization : global, features : instance ) ZZ_ProvideFeedback parameter ZRAP630_A_Feedback_### result[1] $self;
改完后扩展代码:
extension using interface zrap630i_shoptp_###
implementation in class zbp_rap630r_ext_shoptp_### unique;
extend behavior for Shop
{
validation zz_validateDeliverydate on save { create; field DeliveryDate; }
extend draft determine action Prepare
{
validation zz_validateDeliveryDate;
}
determination ZZ_setOverallStatus on modify { field OrderedItem; }
side effects { field OrderedItem affects field OrderItemPrice , field CurrencyCode ; }
field(readonly) zzfeedbackzaa;
action(authorization : global, features : instance ) ZZ_ProvideFeedback parameter ZRAP630_A_Feedback_### result[1] $self;
}
激活(Ctrl+F3)。
验证:激活成功。若报「字段不存在」,检查练习 3 是否真的把 ZZFEEDBACKZAA 加到了接口视图层(I 视图扩展)。
步骤 30:生成缺失的行为并实现动作方法
做什么:动作需要三类处理器:全局授权(global authorization)、实例特性(instance features)、以及动作本身的实现。用代码辅助让框架生成缺失的方法,再填实现。
怎么点/怎么填:
在
Shop实体上按Ctrl+1打开内容辅助,选择 Add all N missing methods of entity ... in local handler class。

打开行为实现类,切到 Local Types,找到生成的方法
ZZ_ProvideFeedback。

填入实现:
METHOD ZZ_ProvideFeedback.
MODIFY ENTITIES OF ZRAP630I_ShopTP_### IN LOCAL MODE
ENTITY Shop
UPDATE FIELDS ( zzfeedbackzaa )
WITH VALUE #( FOR key IN keys ( %tky = key-%tky
zzfeedbackzaa = key-%param-feedback ) ).
"Read the changed data for action result
READ ENTITIES OF ZRAP630I_ShopTP_### IN LOCAL MODE
ENTITY Shop
ALL FIELDS WITH
CORRESPONDING #( keys )
RESULT DATA(result_read).
"return result entities
result = VALUE #( FOR order_2 IN result_read ( %tky = order_2-%tky
%param = order_2 ) ).
ENDMETHOD.
激活。
验证:激活成功。动作实现里 key-%param-feedback 就是弹窗输入的文本,result 回填动作结果供 UI 刷新。
步骤 31:在投影 BDEF 中暴露动作
做什么:动作在 R 层定义后,还要在消费层的投影行为定义里 use 一次,UI 才知道有这个动作。
怎么点/怎么填:
右键单击包
ZRAP630_###中的投影行为定义ZRAP630C_ShopTP_###,选择 New Behavior Extension。

填写:
Package:
ZRAP630_###_EXTName:
ZRAP630C_Ext_SHOPTP_###Description:
Behavior extension for projection bdef
单击 Next。

选择传输请求,单击 Finish。
输入投影层扩展代码:
extension for projection;
extend behavior for Shop
{
use action ZZ_ProvideFeedback;
}
激活。
验证:投影层扩展激活成功。注意文件开头是 extension for projection;,这是它与 R 层行为扩展的区别。
为什么动作要在两层各声明一次:R 层决定「业务对象能做什么」,投影层决定「这个消费场景暴露什么」。同一个 RAP BO 可以有多个投影(给不同应用用),每个投影自己决定要不要
use某个动作——这也是扩展点设计的常见模式。
步骤 32:加 UI 注解,让动作按钮出现并测试
做什么:BDEF 里声明了动作、投影层也 use 了,但 Fiori 界面还需要 UI 注解才会渲染按钮。注解加在 C 视图扩展 ZX_ZRAP630C_SHOPTP_### 里。
怎么填:编辑 ZX_ZRAP630C_SHOPTP_###,在 UI.identification 和 UI.lineItem 注解数组里各追加一项 FOR_ACTION:
, { type: #FOR_ACTION, dataAction: 'ZZ_ProvideFeedback', label: 'Update feedback' }
改完后整个扩展视图代码:
extend view entity ZRAP630C_ShopTP_### with
{
@EndUserText.label: 'Feedback'
@UI.dataFieldDefault: [{hidden: false}]
@UI.identification: [{hidden: false},
{type: #FOR_ACTION, dataAction: 'ZZ_ProvideFeedback', label: 'Update feedback' } ]
@UI.lineItem: [{hidden: false},
{type: #FOR_ACTION, dataAction: 'ZZ_ProvideFeedback', label: 'Update feedback' } ]
Shop.ZZFEEDBACKZAA as ZZFEEDBACKZAA
}
激活,回到预览并刷新。
验证:列表页/对象页出现 Update feedback 按钮;选中一行后单击,弹窗输入反馈文本(例如 This is great),再点 Update feedback,字段被写回并刷新。
回看第 29 步的声明:
parameter ZRAP630_A_Feedback_###定义了弹窗的入参结构(一个feedback字段),result[1] $self表示动作返回当前实体本身,所以执行完 UI 能直接拿返回数据刷新这一行,而不必整页重载。

到这里,练习 2、3、4 全部完成。回顾一下你做过的三件事:只扩展、不修改基础 BO;行为扩展只碰 BDEF 与实现类;数据模型扩展必须沿视图栈自下而上。
验收与清理
功能验收清单
按顺序过一遍,全部勾上才算真正跑通:
练习包
ZRAP630_###、ZRAP630_###_EXT存在且已加入 Favorite Packages。ZRAP630_###_EXT下有练习 1 生成的服务定义、服务绑定和投影视图,服务绑定状态为 Published。Fiori elements 预览能创建银行并保存成功(补完授权后)。
(可选)测试类
zcl_test_abap_cloud_###在PRIVILEGED+WITH PRIVILEGED ACCESS下能创建并读回银行。行为扩展
ZRAP630R_EXT_SHOPTP_###的三个行为(validation / determination / side effect)都已激活、在预览里表现符合预期。列表页有 Feedback 列,对象页可编辑它。
列表页有 Update feedback 按钮,弹窗提交后字段更新。
基础对象未被修改:
ZRAP630R_ShopTP_###等基础对象仍是原样,你的改动全部落在ZRAP630_###_EXT的扩展对象和追加结构里。
边界验收(用自己的话回答)
哪些场景必须用 developer extensibility(应用内扩展),哪些只能 side-by-side?
你改的是标准对象,还是扩展对象?扩展对象和基础对象在传输请求里怎么区分?
行为扩展与数据模型扩展的工作量差在哪?为什么动作必须排在加字段之后?
PRIVILEGED与WITH PRIVILEGED ACCESS分别跳过了哪一层检查?为什么它们不能替代正式授权?
五分钟演示脚本
如果要把成果演示给别人,按这个顺序走最省时间,也最能体现「扩展而非修改」:
打开服务绑定预览,展示练习 1 的银行列表并新建一家银行(体现已发布 API + 生成器)。
切到 Shop 应用,打开一个订单,换一个价格超过 1000 欧元的物料(体现 determination + side effect 即时刷新)。
新建订单不填交货日期并保存(体现 validation 拦截)。
展示列表里的 Feedback 列,点 Update feedback 输入一段文字并提交(体现字段扩展 + 动作)。
最后打开
ZRAP630R_ShopTP_###说明它没有被改动,所有变化都在扩展包里(体现 Clean Core 边界)。
资源清理
保留:如果你还要继续在这个系统里练习,保留两个包和扩展对象即可,服务绑定保持 Published。
释放传输请求:如果传输请求里只有练习对象且你不再需要,可以让管理员删除该请求;否则把请求释放(release)到后续系统,避免占着未释放堆积。
解绑服务:不想再暴露 OData 服务时,在服务绑定里点 Unpublish,再删除服务绑定。
撤销临时授权:为练习创建或修改的 IAM 应用、业务目录、角色,如果只用于本工作坊,记得从用户上移除角色并清理 IAM 应用,尤其在生产租户上。
Trial 系统:SAP BTP ABAP Trial 有生命周期,长期不用会被回收;重要代码请用 abapGit 导出到自己的仓库(或本地 git)。
本地实验类:步骤 14 的对照代码(
BAPI_BANK_CREATE等)如果留在类里,类将无法激活;清理时把这些语句删掉或注释掉。
常见问题
现象 |
原因 |
处理 |
|---|---|---|
|
系统版本/合同不同;对象未以 C1 合同发布;或在错误的节点( |
确认系统是 BTP ABAP Environment / S/4HANA Cloud Public Edition;在 |
|
ADT 版本过旧,生成器未注册;或过滤条件把列表过滤掉了 |
升级 Eclipse + ADT 到最新;清空 Filter by 再展开 |
生成器 Finish 时报「不允许在 SAP 命名空间创建对象」 |
对话框默认建议了基础 BO/SAP 交付包 |
在 Enter Package 或配置页把包手动改成 |
预览打开是空白页或 403 |
服务绑定没发布;用户缺 IAM 角色;服务 URL 被浏览器缓存 |
先 Publish 服务绑定;检查角色的业务目录;硬刷新或换无痕窗口 |
创建银行报 |
用户角色里 |
按步骤 11 建/改 IAM 应用与角色;临时验证可用后台作业类 + |
创建银行报 |
|
让 BankCountry 与 SWIFT 代码匹配;不填 SWIFT 代码即可避开 |
创建报 |
主键(国家/地区 + 银行代码)重复 |
换一个未使用的 BankInternalID,或先删除旧记录 |
加 |
ABAP SQL 受 DCL 管控,与 EML 授权是两层 |
给 |
激活 BDEF 扩展报 |
BDEF 扩展未激活,或方法名大小写/拼写不一致 |
先激活 BDEF 扩展,再激活行为实现类;核对名称与声明一致 |
行为扩展对话框默认包是 SAP 包 |
ADT 建议基础 BO 所在包 |
手动改成 |
新字段在 UI 上看不到 |
漏扩展某一层视图;C 视图缺 UI 注解;服务绑定未重新发布;缓存 |
按步骤 27 的排查顺序逐项检查,重点看 C 视图扩展与 |
换物料后价格/审批状态不刷新 |
缺 side effect,或 side effect 未激活;或处于未保存的草稿 |
补 |
|
系统版本低于 2408(早期版本只有手动扩展路径) |
走步骤 23–25 的手动扩展路径,或升级系统 |
Update feedback 按钮不出现 |
投影 BDEF 没写 |
依次检查步骤 30、31、32,激活后重新打开预览 |
官方原文(参考)
本教程是对官方工作坊材料的中文重排与补全:对象名、代码和操作路径来自仓库 exercises/ex0–ex4,截图取自原始文档;本教程在原版基础上按「做什么 → 怎么点/怎么填 → 验证」重写了每一步,并把练习 3 的两条路径(手动 / 扩展字段向导)并列讲清。官方材料若有版本差异,以你系统里的实际界面为准。
案例原始文档(含全部练习与原始截图):99-02-rap630.md
工作坊仓库(main 分支):https://github.com/SAP-samples/abap-platform-rap630
扩展项目解决方案代码:https://github.com/SAP-samples/abap-platform-rap630-ext
开源的 RAP Generator:https://github.com/SAP-samples/cloud-abap-rap
官方帮助:开发 RAP 扩展(Develop RAP Extensions):https://help.sap.com/docs/abap-cloud/abap-rap/develop-rap-extensions
官方帮助:RAP 可扩展性启用(RAP Extensibility Enablement):https://help.sap.com/docs/abap-cloud/abap-rap/rap-extensibility-enablement
官方帮助:用扩展字段向导生成扩展字段(Generating Extension Fields):https://help.sap.com/docs/abap-cloud/abap-development-tools-user-guide/generating-extension-fields
官方帮助:S/4HANA Cloud 的扩展方式总览:https://help.sap.com/docs/SAP_S4HANA_CLOUD/6aa39f1ac05441e5a23f484f31e477e7/1b345c53060846b091f55ea901e21ae7.html
已发布对象与后继对象清单(ATC Cloudification Repository,含 CSV/JSON):https://github.com/SAP/abap-atc-cr-cv-s4hc