隐式响应参数

ABAP RESTful 应用程序编程模型 › 学习 › 业务对象 › RAP 业务对象供应 › 业务对象提供者 API › 隐式响应参数

实施业务对象合同时,使用隐式响应参数。这些参数没有固定的数据类型,而是由编译器分配,其类型派生自行为定义。

通过使用通用类型 CHANGING,可将隐式参数显式声明为处理器类的方法签名中的 DATA 参数:

METHODS method_name FOR MODIFY | READ | LOCK
    [IMPORTING]

      <operation>_import_parameter    FOR <OPERATION> entity
      ...

     CHANGING  failed   TYPE DATA
              [mapped   TYPE DATA]  "Relevant for CREATE only
               reported TYPE DATA.

ABAP 编译器将类型 DATA 替换为具体行为定义产生的相应派生类型。

隐式参数

参数

描述

FAILED

此导出参数定义为嵌套表,其中包含行为定义中定义的每个实体的一个表。

失败的表包括用于识别发生错误的数据集的信息:

  • %CID 和

  • 相关业务对象实例的标识。

失败原因由预定义组件指定:

  • %FAIL ,存储故障症状。

访问失败参数类型的元素信息 (F2)

REPORTED

此导出参数用于返回消息。将其定义为嵌套表,其中包含行为定义中定义的每个实体的一个表。

报告的表包括实例特定消息的数据。

消息相关的数据集由以下组件标识:

  • %CID

  • 相关实例的标识

  • 具有消息接口实例的 %MSG IF_ABAP_BEHV_MESSAGE

  • %ELEMENT,指实体的所有元素。

访问报告参数类型的元素信息 (F2)

MAPPED

此映射参数定义为嵌套表,其中包含行为定义中定义的每个实体的一个表。

映射的参数为消费者提供标识映射信息。其中包括有关应用程序为给定内容标识创建哪些键值的信息。BO 运行时在同一请求和响应的任何后续调用中传递创建的键值。

相关数据集由以下组件标识:

  • %CID

  • %KEY

派生数据类型的组件

ABAP RESTful 编程模型上下文中的所有派生数据类型还包含不源自实体行类型的组件,并以字符 % 开头,以避免与原始组件发生命名冲突。例如,失败表的行类型包含用于存储失败实例症状的组件 %fail 以及包含实体所有主键字段的 include 结构 %key。

示例

失败参数中 %... 组件的使用

 APPEND #VALUE( %KEY = ... %FAIL = ... ) TO failed-entity.

以下列表提供了最常见的 %... 组件的描述:

组件

描述

%CID

只要业务对象运行时未创建主键,则内容标识 %CID 是实例的临时主键。

内容标识始终由 SADL 框架提供。仅在内部编号和/或延迟编号时才需要。内容标识提供相关实体实例之间的参考。一个很好的示例是具有内部编号和/或延迟编号的多个父/子实例的 DEEP INSERT。在这种情况下,使用内容标识 %CID 在子实例和父实例之间建立参考。

%CID_REF

内容标识 %CID 的参考。

%tky

包含实体(CDS 视图)的所有关键元素,包括派生的关键组件,例如草稿场景中的 %IS_DRAFT。

%tky 是几乎所有派生类型的一部分,包括 for modify( ) 方法中的触发器参数。

%PID

在 ADJUST_NUMBERS 方法中设置最终键值之前,定义临时标识。

仅当在行为定义中定义 LATE NUMBERING 而不添加 IN PLACE 时,初步标识才可用。

%CONTROL

反映消费者要求的元素。

%CONTROL 结构的字段根据操作提供有关在请求中提供的实体元素(对于 CREATE 和 UPDATE 操作)或在读取请求中请求的元素(对于 READ 操作)的信息。

对于每个实体元素,此控制结构包含一个标志,指示相应字段是否由使用者提供/请求。

实体的元素名称具有统一类型 ABP_BEHV_FLAG。

%DATA

包含实体(CDS 视图)的所有数据元素。

%FAIL

存储失败数据集(业务对象实例)的症状。

%MSG

提供消息接口 IF_ABAP_BEHV_MESSAGE 的实例。

%ELEMENT

指实体的所有元素。

%PARAM

保存操作的导入/结果类型。

有关派生类型的详细信息,请参阅:RAP 的 ABAP、BDEF 派生类型(ABAP 关键字文档)。

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

← 派生数据类型 · RAP 业务对象最佳实践 →