操作实施

ABAP RESTful 应用程序编程模型 › 学习 › 业务对象 › RAP 业务对象供应 › RAP 业务对象行为 › 操作 › 非标准工序 › 操作 › 操作实施

使用相应方法 FOR MODIFY 在行为池中实施操作。

通常,属于业务对象实体的自定义操作在行为池中实施,该行为池由关键字 implementation in class ABAP_ClASS_NAME [unique] 在行为定义中定义。

具体实施基于作为行为池一部分的本地处理器类中的 ABAP 语言。

如下面的列表中所示,每个这样的局部类都继承自基本处理器类 CL_ABAP_BEHAVIOR_HANDLER。处理器方法 FOR MODIFY 的签名是基于由关键字 FOR ACTION(后跟 AliasedEntityName~ActionName)定义的实体的类型。别名使用引用合适 CDS 实体的附加别名 AliasedEntityName 在行为定义中定义。

在本地处理器类中实施操作

CLASS lhc_handler DEFINITION INHERITING FROM cl_abap_behavior_handler.

PRIVATE SECTION.

  METHODS method_name FOR MODIFY
    IMPORTING keys FOR ACTION AliasedEntityName~ActionName
   [REQUEST requested_fields]
   [RESULT result].

ENDCLASS.

CLASS lhc_handler IMPLEMENTATION.
  METHOD method_name.

  // Implement method here!
  ENDMETHOD.
ENDCLASS.

导入参数

  • 根据操作类型,导入参数 keys 具有以下组件:

    操作细节

    导入参数组件

    实例操作

    实例操作导入对其执行操作的实例的密钥。

    实例操作导入 %cid_ref。如果对尚未具有最终键值的新创建实例执行操作,则操作使用者可以填充此组件。然后使用操作所分配到的实例的 %cid 填充 %cid_ref。

    静态操作

    静态操作导入 %cid。对于静态操作,%cid 用作唯一标识操作的操作标识。

    含参数的操作

    具有参数 的操作导入参数输入 的参数结构 %param。

    含结果类型实体的操作

    如果操作返回一个或多个实体实例,则操作导入 %cid 以在设置最终键值之前标识新实例。

    工厂操作

    工厂操作导入 %cid 和 %cid_ref。

    由于工厂操作始终创建新实例,因此在设置最终键值之前填充 %cid 以标识新实例。

    如果工厂操作是实例绑定的,则还会导入 %cid_ref 以标识它们分配到的可能的新创建实例。

  • 如果在行为定义中将结果参数定义为 selective,则行为池中的操作声明会收到另一个导入参数 REQUEST requested_field。在请求参数中,标记操作执行者选择的操作结果的所有字段。因此,操作提供者知道预期哪些字段作为结果。

结果参数

结果参数的组件取决于导入结构的组件。如果导入 %cid 和 %cid_ref 的导入值,则会返回这些值。

如果定义了结果,则具有将由操作实施填充的结构 %param。此组件是反映已定义结果类型的类型的表。

对于具有选择性结果的操作,只需在 %param 中填写在 REQUEST 中请求的字段。

操作的 UI 使用

要使操作可由 Fiori 元素 UI 使用,您需要在相关 CDS 视图中定义操作按钮。

操作始终分配到行为定义中的一个业务对象实体。在相应的 CDS 视图中,必须在 @UI 注释中定义操作按钮。

使用 @UI.lineItem: [ {type: #FOR_ACTION, dataAction: 'ActionName', label: 'ButtonLabel' } ] 定义列表报表页面上的操作按钮。

使用 @UI.identification: [ {type: #FOR_ACTION, dataAction: 'ActionName', label: 'ButtonLabel' } ] 定义对象页面上的操作按钮。

ActionName 必须与行为定义中的操作名称相对应。如果为操作定义了外部操作名称,则必须使用此外部名称。

示例

有关完全实施的操作,请参阅实施操作和为 UI 使用启用操作。