Get Variable Instance Count
Queries for the number of historic variable instances that fulfill the given parameters. Takes the same parameters as the Get Variable Instances method.
Method
GET /history/variable-instance/count
Parameters
Query Parameters
Name | Description |
---|---|
variableName | Filter by variable name. |
variableNameLike | Restrict to variables with a name like the parameter. |
variableValue | Filter by variable value. Is treated as a String object on server side. |
includeDeleted | Include variables that has already been deleted during the execution. |
processInstanceId | Filter by the process instance the variable belongs to. |
processInstanceIdIn | Only include historic variable instances which belong to one of the passed process instance ids. |
processDefinitionId | Filter by the process definition the variable belongs to. |
executionIdIn | Only include historic variable instances which belong to one of the passed and comma-separated execution ids. |
caseInstanceId | Filter by the case instance the variable belongs to. |
caseExecutionIdIn | Only include historic variable instances which belong to one of the passed and comma-separated case execution ids. |
caseActivityIdIn | Only include historic variable instances which belong to one of the passed and comma-separated case activity ids. |
taskIdIn | Only include historic variable instances which belong to one of the passed and comma-separated task ids. |
activityInstanceIdIn | Only include historic variable instances which belong to one of the passed and comma-separated activity instance ids. |
tenantIdIn | Only include historic variable instances which belong to one of the passed and comma-separated tenant ids. |
Result
A JSON object that contains the count as the only property.
Name | Value | Description |
---|---|---|
count | Number | The number of matching historic variable instances. |
Response Codes
Code | Media type | Description |
---|---|---|
200 | application/json | Request successful. |
400 | application/json | Returned if some of the query parameters are invalid. |
Example
Request
GET /history/variable-instance/count?variableName=my_variable
Response
{
"count": 1
}