Activiti - Get Process Instance Details" Java API

Question

I am using Activiti 5.12. As provided, in its user guide, REST API to get he details of a process instance is : GET /process-instance/{processInstanceId}

Its response is something like this :

{
"id": "2",
"processDefinitionId": "financialReport:1",
"businessKey": "55",
"startTime": "2010-10-13T14:54:26.750+02:00",
"startActivityId": "startFinancialAnalysis",
"startUserId": "kermit",
"completed": false,
"tasks": [
    {
        "taskId": "3",
        "taskName": "Analyze report",
        "owner": null,
        "assignee": "Kermit",
        "startTime": "2010-10-13T14:53:26.750+02:00",
        "completed": false
    }
],
"activities": [
    {
        "activityId": "4",
        "activityName": "Get report",
        "activityType": "ServiceTask",
        "startTime": "2010-10-13T14:53:25.950+02:00",
        "completed": true,
        "duration": 200
    }
],
"variables": [
    {
        "variableName": "reportName",
        "variableValue": "classified.pdf"
    }
],
"historyVariables": [
    {
        "variableName": "reportName",
        "variableValue": "classified.pdf",
        "variableType": "String",
        "revision": 1,
        "time": "2010-10-13T14:53:26.750+02:00"
    }
]
}

A JAVA API for the same is also provided, which is : ProcessEngines.getProcessEngine(configuredProcessEngineName).getHistoryService().createHistoricProcessInstanceQuery().processInstanceId("somevalue").singleResult()

This Java API does not work, as teh return type HistoricProcessInstance does not have the method to get the task list.

My objective is to get the current state of a process instance, i.e which task it's presently at.

The REST API lists all tasks that process instance has carried out and the last task of the list is the one it's currently executing, as its property completed is false.

I want to achieve the same from java code.

Can you please help me out. Any alternative way to get to my objective is also fine with me.

Answer 1

You can use another query of HistoricService API:

List<HistoricTaskIntance> taskList = getHistoryService()
  .createHistoricTaskInstanceQuery()
  .processInstanceId(processInstanceId)
  .list()

The current task status can be defined by HistoricTaskInstance.getEndTime() that will return null for open tasks.