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

一、草稿处理的核心价值

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

• 传统无草稿 BO：每次修改立即进入事务缓冲区，一旦离开页面，未提交的更改即丢失。

• 启用草稿后：编辑内容被持久化到专门的草稿表，支持草稿创建、编辑、激活、删除等操作。

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

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

三、案例步骤整理

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 的主要区别

六、总结

启用草稿处理只需在行为定义中添加 with draft、指定草稿表、调整关联及 ETag，并在投影中暴露 use draft，即可让 Fiori 应用获得完整的草稿编辑、状态持久化和激活前校验体验。