获取流程表单数据

io.jmix.bpm.processform.ProcessFormDataExtractor bean 提供了以编程方式访问流程表单信息的能力。以下示例展示了一个 REST 控制器,使用该 bean 来获取与正在运行的流程实例相关联的表单数据。

@RestController
@RequestMapping("rest/bpm/process-form-data")
public class FormDataController {

    @Autowired
    private ProcessFormDataExtractor processFormDataExtractor;

    @GetMapping(produces = "application/json")
    public FormData getTaskFormData(
            @RequestParam(required = false) String taskId,
            @RequestParam(required = false) String processDefinitionId) {

        if (Strings.isEmpty(taskId) && Strings.isEmpty(processDefinitionId)) {
            throw new ResponseStatusException(HttpStatus.BAD_REQUEST, "The taskId or processDefinitionId parameter has to be provided");
        }

        if (!Strings.isEmpty(taskId) && !Strings.isEmpty(processDefinitionId)) {
            throw new ResponseStatusException(HttpStatus.BAD_REQUEST, "The request cannot contain both taskId and processDefinitionId.");
        }

        if (Strings.isEmpty(taskId)) {
            return processFormDataExtractor.getStartFormData(processDefinitionId); (1)
        } else {
            return processFormDataExtractor.getTaskFormData(taskId); (2)
        }
    }
}
1 提供一个 processDefinitionID 参数,返回流程启动表单的数据。
2 提供一个 taskID 参数,返回任务表单的数据。

成功调用后的响应体:

{
  "type": "jmix-screen",
  "screenId": "FormExample",
  "openMode": "DIALOG",
  "businessKey": null,
  "businessKeySource": null,
  "allowedProcessKeys": [],
  "fields": [],
  "outcomes": [],
  "formParams": [],
  "outputVariables": []
}
需要注意应用程序端点的安全保护。请参考示例:自定义端点