Get Variable Instance
Retrieves a historic variable by id.
Method
GET /history/variable-instance/{id}
Parameters
Path Parameters
Name | Description |
---|---|
id | The id of the variable instance. |
Query Parameters
Name | Description |
---|---|
deserializeValue |
Determines whether serializable variable values (typically variables that store custom Java objects) should be deserialized on server side (default true ).
If set to If set to Note: While |
Result
A user object with the following properties:
Name | Value | Description | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
id | String | The id of the variable instance. | ||||||||||||
name | String | The name of the variable instance. | ||||||||||||
type | String | The value type of the variable. | ||||||||||||
value | String/Number/Boolean/Object |
|
||||||||||||
valueInfo | Object | A JSON object containing additional, value-type-dependent properties.
For variables of type
|
||||||||||||
processDefinitionKey | String | The key of the process definition the variable instance belongs to. | ||||||||||||
processDefinitionId | String | The id of the process definition the variable instance belongs to. | ||||||||||||
processInstanceId | String | The id the process instance belongs to. | ||||||||||||
executionId | String | The execution id the variable instance belongs to. | ||||||||||||
activityInstanceId | String | The id of the activity instance in which the variable is valid. | ||||||||||||
caseDefinitionKey | String | The key of the case definition the variable instance belongs to. | ||||||||||||
caseDefinitionId | String | The id of the case definition the variable instance belongs to. | ||||||||||||
caseInstanceId | String | The case instance id the variable instance belongs to. | ||||||||||||
caseExecutionId | String | The case execution id the variable instance belongs to. | ||||||||||||
taskId | String | The id of the task the variable instance belongs to. | ||||||||||||
tenantId | String | The id of the tenant that this variable instance belongs to. | ||||||||||||
errorMessage | String | An error message in case a Java Serialized Object could not be de-serialized. | ||||||||||||
state | String | The current state of the variable. Can be 'CREATED' or 'DELETED'. |
Response Codes
Code | Media type | Description |
---|---|---|
200 | application/json | Request successful. |
404 | application/json | Variable with given id does not exist. See the Introduction for the error response format. |
Example
Request
GET /history/variable-instance/someId
Response
Status 200.
{
"id": "someId",
"name": "amount",
"type": "Integer",
"variableType": "integer",
"value": 5,
"valueInfo": {},
"processDefinitionKey": "aProcessDefinitionKey",
"processDefinitionId": "aProcessDefinitionId",
"processInstanceId": "aProcessInstanceId",
"executionId": "aExecutionId",
"activityInstanceId": "Task_1:b68b71ca-e310-11e2-beb0-f0def1557726",
"caseDefinitionKey": null,
"caseInstanceId": null,
"caseExecutionId": null,
"taskId": null,
"tenantId": null,
"errorMessage": null
}