当前位置：首页 > news >正文

SAP-BTP :(9)RAP-草稿处理

news 2026/5/24 22:12:41

一、草稿处理的核心价值

草稿（Draft）是 RAP 为企业级应用提供的一种关键机制，它允许用户在不立即提交数据的情况下长期编辑一个业务对象实例，并且可以临时保存编辑状态、离开后返回继续编辑，最后一次性激活。

传统无草稿 BO：每次修改立即进入事务缓冲区，一旦离开页面，未提交的更改即丢失。
启用草稿后：编辑内容被持久化到专门的草稿表，支持草稿创建、编辑、激活、删除等操作。

草稿机制使得 RAP 应用能够支持复杂的、多步骤的表单填写场景，例如旅行申请、订单录入等。

二、启用草稿所需的核心构件

构件	作用
草稿表（Draft Table）	存储草稿数据，与激活数据表分离；由 RAP 框架完全管理
行为定义中的`with draft`	开启 BO 的草稿能力
关联上的`with draft`	允许通过关联导航到草稿实例
`draft determine action Prepare`	激活前的校验触发点
`lock master total etag`	并发控制，使用 ETag 字段防止版本冲突
投影中的`use draft`	将草稿能力暴露给服务消费者

三、案例步骤整理

Step 1 – 在基础业务对象中启用草稿

1.1 添加`with draft`声明

在基础行为定义ZI_RAP_Travel_####的头部，managed;之后添加：with draft;

1.2 指定草稿表

Travel 实体：draft table zrap_dtrav_####

Booking 实体：draft table zrap_dbook_####

1.3 生成草稿表

光标放在表名上，按Ctrl+1（Quick Fix），选择生成草稿表。

框架自动根据实体模型生成对应的草稿表结构。

注意：以后修改 BO 数据模型后，可再次用 Quick Fix 重新生成草稿表（会更新表定义）。

1.4 调整关联声明（解决警告）

Travel 实体中的_Booking关联改为：association _Booking { create; with draft; }

Booking 实体中的_Travel关联改为：association _Travel { with draft; }

原因：草稿启用后，关联必须显式标记with draft，才能在草稿实例间导航。

1.5 添加总 ETag 锁定：lock master total etag LastChangedAt

作用：使用LastChangedAt字段作为乐观锁版本标识，防止草稿基于过期的激活实例激活。

1.6 指定`draft determine action Prepare`触发的校验

意义：当用户点击“激活”时，框架会先调用Prepare动作，在此处执行所有需要检查的校验，并将消息保存为状态消息（即使激活失败，用户返回后仍能看到错误提示）。

Step 2 – 在投影业务对象中暴露草稿

2.1 添加`use draft`

在投影行为定义ZC_RAP_Travel_####的头部添加：use draft;

2.2 调整投影关联

Travel 投影：use association _Booking { create; with draft; }
Booking 投影：use association _Travel { with draft; }

2.3 针对 OData V2 的特殊处理

如果使用 OData V2，需要注释掉use etag：
因为 OData V2 的 Fiori Elements 尚不支持 ETag 与草稿同时使用。

Step 3 – 调整行为实现（授权控制）

在行为池类ZBP_I_RAP_TRAVEL_####中：

找到get_authorizations方法。
在requested_authorizations条件判断中，取消注释与%action-Prepare和%action-Edit相关的代码行。
这样，草稿相关的两个内置动作（Prepare和Edit）也会受到授权检查。

Step 4 – 预览与测试

启动 Fiori 应用后，你会看到：

过滤器区域新增“编辑状态”（Editing Status）筛选。

创建新对象时，在对象页面编辑字段时，你会立即在底部看到草稿保存指示器。

在后端查看相关的草稿表，可以看到目前已输入的所有值。

四、关键设计思想

1. 草稿表完全由框架管理

开发者只需声明draft table xxx，无需手动编写任何 DDL 或 DML。
框架自动处理草稿的创建、读取、更新、激活、删除。

2. 状态消息持久化

启用草稿后，校验失败的消息会作为状态消息写入草稿表，而不是仅存在于当前会话。
用户关闭应用再打开，依然能看到之前的错误提示 —— 极大提升用户体验。

3. 关联的草稿导航

关联必须显式标记with draft，才能在主实体与子实体的草稿实例之间导航。
这避免了非草稿关联错误地指向激活实例。

4. ETag 乐观锁

使用lock master total etag确保激活操作基于最新的激活实例版本。
如果草稿基于旧版本，激活时会触发冲突处理（通常提示用户刷新）。

5. Prepare 动作作为校验集中点

在激活 OData 请求的单独 changeset 中调用Prepare，将校验与激活分离。
这样即使校验失败，也已保存的状态消息仍然可以返回给前端。

五、与无草稿 BO 的主要区别

特性	无草稿	有草稿
编辑方式	直接修改事务缓冲区	持久化到草稿表
离开页面后修改是否保留	❌ 丢失	✅ 保留
状态消息持久化	❌ 仅当前会话	✅ 存入草稿表
on-modify determination	立即在缓冲区执行	立即在草稿实例执行
on-save determination	在 COMMIT 时执行	在激活时执行
并发控制	数据库锁（短暂）	ETag + 草稿锁（可长时间）