topic Re: Process instance state image generator access via API in Alfresco Archive

Process instance state image generator access via API

lossril — Fri, 08 Jan 2016 15:06:31 GMT

Hello!In Activiti-explorer webapp in Manage/Administration/Running process instances we can see a diagram of a process instance with current state markup. Can anyone please tell me how to get it or point me to some tutorials/javadocs on this case? I cannot find anything about it in userguide, only t

Re: Process instance state image generator access via API

iam — Fri, 08 Jan 2016 21:47:55 GMT

Do you have installed activiti-rest web application?
WIth activiti-rest you can get process instance diagram:
http://localhost:8080/activiti-rest/service/runtime/process-instances/{processInstanceId}/diagram
Change {processInstanceId} to your process instance id.

Re: Process instance state image generator access via API

lossril — Mon, 11 Jan 2016 07:02:53 GMT

Yes, I know about this option. I've searched through Activiti sources and found the code for it. Here it is:

<java>
public @ResponseBody byte[] getProcessInstanceDiagram(@PathVariable String processInstanceId, HttpServletResponse response) {
    ProcessInstance processInstance = getProcessInstanceFromRequest(processInstanceId);

    ProcessDefinitionEntity pde = (ProcessDefinitionEntity) ((RepositoryServiceImpl) repositoryService)
        .getDeployedProcessDefinition(processInstance.getProcessDefinitionId());

    if (pde != null && pde.isGraphicalNotationDefined()) {
      BpmnModel bpmnModel = repositoryService.getBpmnModel(pde.getId());
      ProcessDiagramGenerator diagramGenerator = processEngineConfiguration.getProcessDiagramGenerator();
      InputStream resource = diagramGenerator.generateDiagram(bpmnModel, "png", runtimeService.getActiveActivityIds(processInstance.getId()),
          Collections.<String>emptyList(), processEngineConfiguration.getActivityFontName(), processEngineConfiguration.getLabelFontName(),
          processEngineConfiguration.getClassLoader(), 1.0);

      try {
        byte[] responseBytes = IOUtils.toByteArray(resource);
        response.setContentType("image/png");
        return responseBytes;

      } catch(Exception e) {
        response.setContentType("application/json");
        throw new ActivitiIllegalArgumentException("Error exporting diagram", e);
      }

    } else {
      response.setContentType("application/json");
      throw new ActivitiIllegalArgumentException("Process instance with id '" + processInstance.getId() + "' has no graphical notation defined.");
    }
}
</java>

Re: Process instance state image generator access via API

lossril — Mon, 11 Jan 2016 07:04:31 GMT

But I find lack of the javadocs or any documentation at all for ProcessDiagramGenerator (or other non-engine class) quite disturbing.

Re: Process instance state image generator access via API

jbarrez — Wed, 20 Jan 2016 21:21:36 GMT

The cheesy answer would be that if you find it disturbing, we always accept pull requests that fix the disturbing situation 😉

The ProcessDiagramGenerator is mostly an internal class … hence why it's not directly documented in the userguide.

Re: Process instance state image generator access via API

lossril — Fri, 22 Jan 2016 12:31:42 GMT

The problem about pull requests is I cannot work with github from work - our firewalls are set up for full tinfoil hat mode. I will try to fix it but no promises.