实施合同:CREATE-BY-ASSOCIATION

ABAP RESTful 应用程序编程模型 › 学习 › 业务对象 › RAP 业务对象最佳实践 › RAP 业务对象合同 › 常规 RAP 业务对象实施合同 › 实施合同:CREATE-BY-ASSOCIATION

本主题介绍了在 RAP 业务对象中实施按关联创建操作的规则。

通过遵循 RAP BO 中源实体的关联,按关联 (CBA) 操作在事务缓冲区中创建新实体实例。

该实施在方法 <方法> FOR MODIFY 的 ABAP 行为池中完成。

业务对象使用者使用 ABAP EML 创建请求触发按关联创建操作。业务对象使用者希望成功创建的关联实例的键值由 CBA 操作返回。有关详细信息,请参阅 MODIFY。

输入

以下清单定义将哪些组件导入到 CBA 处理器方法。

强制

  • 源实例标识符:source-%tky 和 source-%cid_ref

  • 目标内容标识符:target-%cid

  • 创建时必须填写的任何目标字段。

可选

  • 目标实例标识符:target-%tky

  • 任何非只读的目标字段。

输出

下表汇总了 CBA 实施的提供者规则。

描述

预期提供者实施

示例

更多信息

CBA 操作成功。

对于目标实体的 mapped 结构中的每个已创建目标实例,实施仅返回一行。它列出了将其映射到目标实例标识符的每个已创建目标实例的内容标识符。

现有源实例标识符。 不存在的目标实例标识符。

mapped

CBA 操作不成功。 源实例失败。

实施会为源实体的 failed 结构中的每个失败源输入标识符返回一行。它填写正确的失败原因,并在正确的关联上标记 %assoc 组件。 实施 为要在 failed 中创建的每个目标实例返回一行,失败原因为 dependency。 对于 failed 中列出的每个输入标识符,失败原因不是 not_found,在 reported 中返回一条相关错误消息。

不存在的源实例标识符。(失败导致源实例上出现 not_found,在目标实例上失败原因 dependency。) 未授权 CBA 操作。仅当在非托管业务对象的修改处理器中实施权限时才适用。(失败原因 unauthorized。) 功能控制已禁用字段/操作。这仅适用于在非托管 BO 的修改处理器中实施功能控件的情况。(失败原因为 disabled 或 readonly。)

failed

CBA 操作不成功。 目标实例失败。

实施为要在目标实体的 failed 结构中创建的每个目标实例返回一行。其中列出了具有适当失败原因的目标内容标识符。 对于 failed 中列出的每个输入标识符,失败原因不是 not_found,在 reported 中返回一条相关错误消息。

目标实例的现有实例标识符。(失败原因为 unspecific)。(重复的目标内容标识符无法到达实施方法。之前将出现运行时错误。) 重复的目标实例标识符:对于具有不同内容标识符的重复目标实例标识符,实现可以决定所有目标实例是失败,还是除一个实例外的所有目标实例都失败。 功能控制已禁用字段。这仅适用于在非托管 BO 的修改处理器中实施功能控件的情况。(失败原因 readonly。)

failed

同一处理器中的相关 CBA 操作不成功。(在与 %cid_ref 对应的操作相同的处理器中使用 %cid 的 CBA。)

RAP 运行时引擎为目标实例添加 failed 和 reported 的条目。实施不得填充它们。

重复的目标实例标识符:对于重复的目标实例,创建和 CBA 操作在同一处理器中实施,创建操作失败。相关操作 CBA 相应失败。

failed

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

← 实施合同:创建 · 实施合同:更新 →