操作实施
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.
导入参数
-
操作细节
导入参数组件
实例操作
实例操作导入对其执行操作的实例的密钥。
实例操作导入 %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 使用启用操作。