创建草稿数据

ABAP RESTful 应用程序编程模型 › 学习 › 业务对象 › RAP 业务对象供应 › RAP 业务对象行为 › 草稿 › 草稿运行时 › 创建草稿数据

通过创建新草稿或编辑活动实例来创建草稿实例。

草稿和活动数据的生命周期

如上图所示,创建草稿数据有两个选项:

修改 CREATE 请求

通过使用 CREATE 的修改操作,创建新草稿实例,即没有相应活动实例的草稿实例。对于此类创建请求,草稿标识必须设置为 true。与活动实例的 CREATE 类似,RAP 运行时为实例设置独占锁,并使用触发器 CREATE 触发修改时的任何确定。创建新实例时,必须确保主键的唯一性。否则,如果重复键到达活动数据库表,则拒绝整个请求。有关早期唯一性检查的详细信息,请参阅主键的唯一性检查。

在 Fiori 元素 UI 上,使用创建按钮执行草稿标识设置为真的 CREATE 请求。无法使用 Fiori UI 上的创建按钮直接创建活动实例。

但是,通过 EML,可以区分创建草稿数据的请求和创建活动数据的请求。要创建草稿实例,必须将草稿标识设置为 true:

MODIFY ENTITIES OF BusinessObjectName
  ENTITY BO_Entity
    CREATE FROM
    VALUE #( ( %is_draft          = if_abap_behv=>mk-on  "positive draft indicator
               %control-FieldName = if_abap_behv=>mk-on
               %data-FieldName    = 'Value') )
  REPORTED DATA(create_reported)
  FAILED DATA(create_failed)
  MAPPED DATA(create_mapped).

编辑操作

通过对活动实例执行草稿操作 EDIT,您可以创建编辑草稿实例,该草稿实例在持久数据库中具有相应的活动实例。编辑操作通过将相应的活动实例数据自动复制到草稿表,创建新的草稿文档。同时,EDIT 会触发活动实例的独占锁。在草稿的持久锁阶段结束之前(激活草稿或持久锁在特定时间后过期),都会维护此锁定。

编辑操作具有参数,您可以使用该参数确定是否可以编辑已存在草稿的活动实例。将参数 preserve_changes 设置为 true 后,如果已存在草稿,则会拒绝您的操作请求。如果 preserve_changes 设置为 false(缺省设置),则执行编辑操作。这意味着,会将活动实例复制到草稿数据库表,并使用活动数据的值覆盖现有草稿。在这种情况下,您将丢失对现有草稿实例所做的更改。因此,建议始终在操作请求中包含参数 。

对于编辑操作请求,不必设置草稿标识,因为 EDIT 始终在活动实例上执行。

同时检查操作的实例权限和功能控制。要实施应用程序特定的控制,请在行为定义中定义 EDIT 操作,并在行为池中为功能或权限实施方法。

在 Fiori 元素 UI 上,选择编辑按钮时会触发编辑操作,该按钮仅在活动实例的对象页面上可用。从 UI 触发编辑操作始终包括设置为 true 的参数 preserve_changes。

在这种情况下,OData 会发送 POST EDIT 的操作执行请求,然后由 RAP 运行时框架执行。

编辑操作可以通过 EML 执行,就像任何其他业务逻辑操作一样:

MODIFY ENTITIES OF BusinessObjectName
  ENTITY BO_Entity
    EXECUTE Edit FROM
    VALUE #( ( %key-element1           = 'KeyValue'
               %param-preserve_changes = 'X' ) )
  REPORTED DATA(edit_reported)
  FAILED DATA(edit_failed)
  MAPPED DATA(edit_mapped).

来源:SAP Help Portal · 2025 FPS02 (Oct 2026) · 中文为 SAP 官方机器翻译

← 草稿运行时 · 运行时创建草稿 →