Toggle menu

getProcessInstance

Returns details of a specified active process instance.

Parameters 

NameTypeDescription
includeCanUnclaimBooleanIf including tasks, include unclaimability of each task
includeCurrentTasksBooleanInclude details of any active tasks for this process instance
includeMessageListenersBooleanInclude details of any active message listeners in the response. Currently only supports boundary messages
includeProcessDefinitionBooleanInclude full details of the process definition used to start the process instance
includeProcessDescriptionBooleanInclude the expanded process description (documentation field) in the response
includeProcessVariablesBooleanInclude process variables in the response
includeStarterDetailsBooleanInclude start time, start user ID, process definition ID
includeTaskVariablesBooleanInclude task variables
includeTaskDescriptionsBooleanInclude expanded task description (documentation field)
processDefinitionKeyInList<String>Only return the process instance if it has a process definition key included in the supplied list
processInstanceBusinessKeyStringThe business key of the instance to retrieve information about
processInstanceIdStringID of the process instance to retrieve information about
Either processInstanceId or processInstanceBusinessKey are required. All other parameters are true by default but may be set to false to reduce the response size and make the query more efficient

Example Request

this.callWorkerMethod("workflow", "getProcessInstance",{
    "processInstanceId":"2511"
}); 

Response

{
    "jsonrpc": "2.0",
    "id": 132,
    "result": {
        "businessKey": null,
        "isSuspended": false,
        "processVariables": {},
        "currentTasks": [],
        "processDefinition": {
            "id": "anactiveprocess:1:2509",
            "formProperties": {},
            "category": "http://www.gossinteractive.com/processdef",
            "diagramResourceName": "an active process-V-1.anactiveprocess.png",
            "description": "Starts on a timer and last for a long time",
            "isSuspended": false,
            "name": "an active process",
            "identityLinks": [],
            "deploymentId": "2506",
            "resourceName": "an active process-V-1.bpmn20.xml",
            "key": "anactiveprocess",
            "version": 1
        },
        "activityId": null,
        "id": "2511",
        "startTime": "2017-02-01T15:44:14Z",
        "startUserId": null,
        "parentId": null,
        "isEnded": false,
        "processInstanceId": "2511",
        "processDefinitionId": "anactiveprocess:1:2509",
        "messageListeners": {}
    }
}

Last modified on August 03, 2023

Share this page

Facebook icon Twitter icon email icon

Print

print icon