工序增强

ABAP RESTful 应用程序编程模型 › 学习 › 业务对象 › RAP 业务对象供应 › RAP 业务对象行为 › 操作 › 工序增强

通过增强实施,您可以在数据到达事务缓冲区之前在投影层添加数据或修改传入请求。

您可以在请求传递到基本业务对象之前,通过增强操作将数据添加到修改请求或发出附加请求。

增强的用例包括:

  • 传入请求的缺省设置。

    CREATE 的传入原始请求已增强(已修改),以便将具有预填充值的请求传递到基本业务对象进行处理。在这种情况下,增强请求与原始请求相同,只是值不同。

  • 启用非规范化字段的行为,例如启用语言相关字段的编辑,请参阅编辑语言相关字段。

    增强了 CREATE 的传入原始请求,并发出了 CREATE_BY_ASSOCIATION 的第二个请求。在这种情况下,原始请求将通过第二个请求进行增强。

定义

增强在相关操作的投影行为定义中定义,语法如下:

define behavior for Entity [alias AliasedName]
  ..
{
  use create (augment);
  use update (augment);

  use association AssocName { create (augment); }
  ...
}

实施

增强的实施在增强操作的映射行为池的 ABAP 处理器类中完成。

方法声明

    METHODS augment_operation FOR MODIFY
      IMPORTING entities_create FOR CREATE ProjectionEntityAlias
      IMPORTING entities_update FOR UPDATE ProjectionEntityAlias
      IMPORTING entities_cba    FOR CREATE ProjectionEntityAlias\_Association

如果增加多个操作,则在行为实施中的一个方法中实施逻辑,以便在需要引用另一个实例时能够使用 %cid_ref。

示例

一个逻辑工作单元包含新创建的实例的创建和更新请求。您需要能够在增强实施中引用新创建的实例。这就是在更新操作的增强实施中必须在 %cid_ref 中引用新创建实例的 %cid 的位置。如果在不同的方法中处理 CREATE 和 UPDATE,则无法使用 %cid 和 %cid_ref。

EML 语句 MODIFY 的特殊形式用于在处理器实施中操作对基础 BO 的请求。

  METHOD augment_operation.

    MODIFY AUGMENTING ENTITIES OF BaseBusinessObject
      ENTITY EntityAlias
       CREATE|UPDATE|EXECUTE MyAction FIELDS ( Field1 )
       WITH VALUE #( ( Field1 = 'DefaultValue' ) )
       RELATING TO OriginalInstance BY RelatedInstance.

  ENDMETHOD.

备注

这种形式的 EML 只能由业务对象提供者使用。

使用此 EML 语句,您可以修改基本业务对象的实体。允许所有修改操作(包括操作)。

报表变式没有 FAILED 或 REPORTED 附加项。这是由于其特殊语义。modify augmenting 中的操作不会立即执行,而是仅与原始请求的操作合并。因此,增强请求由基础 BO 处理器处理仅在增强方法终止后开始。处理基础业务对象处理器期间的故障无法在增强实施中报告回 EML 语句。为了跟踪处理增强请求期间可能出现的错误,relating 表用于将消息映射到传入请求。请参阅新实例的 RELATING 机制。

但是,增强方法本身具有更改参数 FAILED 和 REPORTED,如果在其输入中检测到错误,则可以填充这些参数。这些响应包含在投影请求的整体响应中。此外,通过增强方法返回的失败实例会在将其剩余部分传递到基本 BO 之前从请求中移除。

modify augmenting 语句可以请求原始基本实例、原始请求中请求的实例,也可以修改原始请求未请求的其他基本实例。原始实例的识别通过导入的实例代码或使用 %CID_REF 完成。

增强原始申请的实例时,以下法规适用:

  • 要增强原始 UPDATE,针对同一实例发布增强操作 UPDATE。

    仅为增强添加的字段设置值和 %CONTROL 标记。

  • 要增强原始 CREATE(例如,用于设置缺省值),请在同一实例上发出增强操作 CREATE。

    不要发布增强 UPDATE(使用 %CID_REF),因为基础业务对象将会看到未增强的 CREATE 操作,该操作可能会拒绝(例如,由于缺少必填字段)或以不需要的方式进行处理。

  • 要增强原始 CREATE_BY_ASSOCIATION,针对同一实例发布增强操作 CREATE_BY_ASSOCIATION。目标实例集可能包含原始目标实例(已设置附加字段)以及新实例。与 CREATE 相同的法规适用。

  • 无法设置已为原始实例 设置的增强字段。RAP 运行时放弃此类增强字段。例如,无法更改原始请求中设置的值。只能添加在原始请求中未设置的字段。

RELATING 新实例的机制

基本业务对象可能会为增强请求返回 FAILED 和 REPORTED 表中的条目。为了将这些响应与原始请求相关联,如果增强请求包含新实例,MODIFY AUGMENTING 语句会提供一个附加项,允许将增强实例与原始实例相关联。运行时使用此信息将新实例的 FAILED 键值转换回相关原始实例的键值。

如果增强实例失败,则相关原始实例将包含在整个请求的 FAILED 响应中。如果锁定失败,则不会将相关原始实例传递到基本业务对象处理器类。

新实例的内容标识符

在投影层上创建请求,通过创建或按关联创建操作进行增强,该请求仅在其 MAPPED 响应的 %cid 组件中包含原始创建请求的内容标识。原始创建请求的 MAPPED 响应中不包括通过增强按关联创建和创建操作生成的内容标识符。

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

← 工序预检查 · 工序缺省设置 →