Appearance
completeTaskWithForm
Flowable 7.1.0 摘要:在成功执行任务并提交任务表格时调用。
方法签名与说明
void completeTaskWithForm ( String taskId, String formDefinitionId, String outcome, Map < String , Object > variables)
在成功执行任务并提交任务表格时调用。 Parameters:
- TaskID-要完成的任务的ID不能为null。
- FormDefinitionID-完成任务的填充表单定义的ID不能为null。
- 结果 - 完整形式的结果可能为无效。
- 变量 - 完整表单的值。可能是空的或空的。
Throws:
- FlowableObjectNotFoundException-当给定ID不存在任务时。
void completeTaskWithForm ( String taskId, String formDefinitionId, String outcome, String userId, Map < String , Object > variables)
在成功执行任务并提交任务表格时调用。 Parameters:
- TaskID-要完成的任务的ID不能为null。
- FormDefinitionID-完成任务的填充表单定义的ID不能为null。
- 结果 - 完整形式的结果可能为无效。
- USERID-完成任务的用户。
- 变量 - 完整表单的值。可能是空的或空的。
Throws:
- FlowableObjectNotFoundException-当给定ID不存在任务时。
void completeTaskWithForm ( String taskId, String formDefinitionId, String outcome, Map < String , Object > variables, Map < String , Object > transientVariables)
在成功执行任务并提交任务表格时调用。 Parameters:
- TaskID-要完成的任务的ID不能为null。
- FormDefinitionID-完成任务的填充表单定义的ID不能为null。
- 结果 - 完整形式的结果可能为无效。
- 变量 - 完整表单的值。可能是空的或空的。
- 瞬态变量 - 需要添加到过程实例瞬态变量中的其他瞬态值。可能是空的或空的。
Throws:
- FlowableObjectNotFoundException-当给定ID不存在任务时。
void completeTaskWithForm ( String taskId, String formDefinitionId, String outcome, String userId, Map < String , Object > variables, Map < String , Object > transientVariables)
在成功执行任务并提交任务表格时调用。 Parameters:
- TaskID-要完成的任务的ID不能为null。
- FormDefinitionID-完成任务的填充表单定义的ID不能为null。
- 结果 - 完整形式的结果可能为无效。
- USERID-完成任务的用户。
- 变量 - 完整表单的值。可能是空的或空的。
- 瞬态变量 - 需要添加到过程实例瞬态变量中的其他瞬态值。可能是空的或空的。
Throws:
- FlowableObjectNotFoundException-当给定ID不存在任务时。
void completeTaskWithForm ( String taskId, String formDefinitionId, String outcome, Map < String , Object > variables,
boolean localScope)
在成功执行任务并提交任务表格时调用。 Parameters:
- TaskID-要完成的任务的ID不能为null。
- FormDefinitionID-完成任务的填充表单定义的ID不能为null。
- 结果 - 完整形式的结果可能为无效。
- 变量 - 完整表单的值。可能是空的或空的。
- localscope-如果为true,则提供的变量将被存储为任务 - 本地,而不是过程实例宽(这是完整的默认值(String,Map))。
Throws:
- FlowableObjectNotFoundException-当给定ID不存在任务时。
void completeTaskWithForm ( String taskId, String formDefinitionId, String outcome, String userId, Map < String , Object > variables,
boolean localScope)
在成功执行任务并提交任务表格时调用。 Parameters:
- TaskID-要完成的任务的ID不能为null。
- FormDefinitionID-完成任务的填充表单定义的ID不能为null。
- 结果 - 完整形式的结果可能为无效。
- USERID-完成任务的用户。
- 变量 - 完整表单的值。可能是空的或空的。
- localscope-如果为true,则提供的变量将被存储为任务 - 本地,而不是过程实例宽(这是完整的默认值(String,Map))。
Throws:
- FlowableObjectNotFoundException-当给定ID不存在任务时。
常见使用场景
- 推动任务完成并写入流程变量。
- 与表单提交流程结合,统一处理用户输入。
- 官方摘要:在成功执行任务并提交任务表格时调用。
Kotlin 调用示例
kotlin
val taskId = "TASKID"
val formDefinitionId = "FORMDEFINITIONID"
val outcome = "OUTCOME"
val variables = mutableMapOf("flag" to true)
taskService.completeTaskWithForm(taskId, formDefinitionId, outcome, variables)注意事项
- 完成任务前请校验必填变量,避免流程分支异常。
- 带表单的完成操作要处理外部表单数据校验。
- 调用前请确认当前用户具备相应的任务/流程操作权限。
- 本文基于 Flowable 7.1.0 Javadoc。
相关 API
- complete
- completeTaskWithForm
- resolveTask