集成 SAP Workflow Management

ABAP RESTful 应用程序编程模型 › 重用 › 集成 SAP Workflow Management

工作流功能提供现代流程自动化功能。

关于 SAP Workflow Management

备注

工作流服务始终需要集成场景。有关详细信息,请参阅实施工作流。

通过 SAP Workflow Management,您可以基于 Business Process Model and Notation (BPMN) 设计工作流。workflow definition 定义由 RAP 实例调用 workflow instance 时处理的各个连续流程步骤。

有关工作流服务的详细信息,请参阅工作流简介和工作流定义与工作流实例。

工作流和编号

何时必须在运行时触发工作流实例取决于为 RAP BO 定义的编号。触发工作流实例所需的操作定义为保存操作,因此只能在 RAP 业务对象的早期或延迟保存阶段调用:

  • 早期编号:建议使用所需方法在 determination on save 中调用触发工作流实例。

  • 延迟编号:建议在 determination on save 中触发工作流。如果需要,甚至稍后在 adjust_numbers 方法中使用 setPayload 方法设置有效负载。

要查看在运行时调用相应实施的时间点,请参阅保存序列运行时,有关在延迟编号场景中实施工作流的详细信息,请参阅工作流功能的 API。

有关编号的更多信息,请参阅编号。

批量启用

为确保批量启用触发工作流,需要在外部指定接口 CpWfHandle 的键值 I_CPWF_INST。需要 32 个字符的 UUID 作为输入参数。如果使用相同的 registerWorkflow 和相同的有效负载重复调用操作 CpWfHandle,则会导致短转储。

建议使用 cl_system_uuid=>create_uuid_c32_static( ) 类创建所需的 UUID。

回调类

服务回调类实施在工作流完成后执行的流程。此类必须实施接口 if_swf_cpwf_callback。注册工作流时需要此排定课程。

工作流示例

在此简化示例中,工作流由四个具体流程步骤组成,并根据预定义条件实施简单的差旅审批工作流:

差旅工作流程

需要 Workflow ID 才能从 RAP 行为池中的实施触发工作流实例。

以下代码片段显示了如何在第三步中设置变量 lastUserTask1.decision 中包含的第二步中的用户输入:

展开以下代码示例以查看源代码

示例代码

var lastUserTask1 = $.usertask1.last;
$.context.Wfdecision = "undefined";

if (lastUserTask1.decision === "myaccept") {
	$context.Wfdecision = "WF-accepted";
}

if (lastUserTask1.decision === "myreject") {
	$context.Wfdecision = "WF-rejected";
}

流程概览

业务对象接口 I_CPWF_INST

在 RAP 行为池中,可以通过已发布的业务对象接口 I_CPWF_INST 集成工作流。初始调用包括以下步骤:

  • registerWorkflow:检查所需配置设置以及是否成功注册新的工作流实例。

  • setPayload:以 json 格式提供工作流实例的输入数据。

根据为相应 RAP BO 定义的编号模式,必须在 RAP BO 运行时的早期保存阶段或延迟保存阶段调用这两个流程步骤。

有关业务对象接口 I_CPWF_INST 的详细信息,请参阅工作流功能的 API 或参阅 ADT 中的相应 KTD 文档。

已实施示例流程

此示例使用简化的工作流,以显示如何触发工作流以及如何接收服务回调。业务对象通过 early numbering 实施,因此两个确定都作为determination on save 保存顺序中 FINALIZE 的一部分实施。工作流由设置工作流所需字段的操作 TriggerDecisionWorkflow 触发。这会触发 determination on save 并启动实际工作流。