Modifier and Type | Method and Description |
---|---|
TaskQuery |
active()
Only select tasks which are active (ie.
|
TaskQuery |
activityInstanceIdIn(String... activityInstanceIds)
Only select task which have one of the activity instance ids.
|
TaskQuery |
caseDefinitionId(String caseDefinitionId)
Only select tasks which are part of a case instance which has the given
case definition id.
|
TaskQuery |
caseDefinitionKey(String caseDefinitionKey)
Only select tasks which are part of a case instance which has the given
case definition key.
|
TaskQuery |
caseDefinitionName(String caseDefinitionName)
Only select tasks which are part of a case instance which has the given
case definition name.
|
TaskQuery |
caseDefinitionNameLike(String caseDefinitionNameLike)
Only select tasks which are part of a case instance which case definition
name is like the given parameter.
|
TaskQuery |
caseExecutionId(String caseExecutionId)
Only select tasks for the given case execution.
|
TaskQuery |
caseInstanceBusinessKey(String caseInstanceBusinessKey)
Only select tasks for the given case instance business key
|
TaskQuery |
caseInstanceBusinessKeyLike(String caseInstanceBusinessKeyLike)
Only select tasks matching the given case instance business key.
|
TaskQuery |
caseInstanceId(String caseInstanceId)
Only select tasks for the given case instance id.
|
TaskQuery |
caseInstanceVariableValueEquals(String variableName,
Object variableValue)
Only select tasks which are part of a case instance that have a variable
with the given name set to the given value.
|
TaskQuery |
caseInstanceVariableValueGreaterThan(String variableName,
Object variableValue)
Only select tasks which are part of a case instance that have a variable
with the given name and a variable value greater than the passed value.
|
TaskQuery |
caseInstanceVariableValueGreaterThanOrEquals(String variableName,
Object variableValue)
Only select tasks which are part of a case instance that have a
variable value greater than or equal to the passed value.
|
TaskQuery |
caseInstanceVariableValueLessThan(String variableName,
Object variableValue)
Only select tasks which are part of a case instance that have a variable
value less than the passed value.
|
TaskQuery |
caseInstanceVariableValueLessThanOrEquals(String variableName,
Object variableValue)
Only select tasks which are part of a case instance that have a variable
value less than or equal to the passed value.
|
TaskQuery |
caseInstanceVariableValueLike(String variableName,
String variableValue)
Only select tasks which are part of a case instance that have a variable value
like the given value.
|
TaskQuery |
caseInstanceVariableValueNotEquals(String variableName,
Object variableValue)
Only select tasks which are part of a case instance that have a variable
with the given name, but with a different value than the passed value.
|
TaskQuery |
caseInstanceVariableValueNotLike(String variableName,
String variableValue)
Only select tasks which are part of a case instance that have a variable value
not like the given value.
|
TaskQuery |
dueAfter(Date dueDate)
Only select tasks which have a due date after the given date.
|
TaskQuery |
dueAfterExpression(String dueDateExpression)
Only select tasks which have a due date after the described date by the given expression.
|
TaskQuery |
dueBefore(Date dueDate)
Only select tasks which have a due date before the given date.
|
TaskQuery |
dueBeforeExpression(String dueDateExpression)
Only select tasks which have a due date before the described date by the given expression.
|
TaskQuery |
dueDate(Date dueDate)
Only select tasks with the given due date.
|
TaskQuery |
dueDateExpression(String dueDateExpression)
Only select tasks with the described due date by the given expression.
|
TaskQuery |
endOr()
endOr() terminates an OR query on which an arbitrary amount of filter criteria were applied.
|
TaskQuery |
excludeSubtasks()
Only select tasks that have no parent (i.e.
|
TaskQuery |
executionId(String executionId)
Only select tasks for the given execution.
|
TaskQuery |
followUpAfter(Date followUpDate)
Only select tasks which have a follow-up date after the given date.
|
TaskQuery |
followUpAfterExpression(String followUpDateExpression)
Only select tasks which have a follow-up date after the described date by the given expression.
|
TaskQuery |
followUpBefore(Date followUpDate)
Only select tasks which have a follow-up date before the given date.
|
TaskQuery |
followUpBeforeExpression(String followUpDateExpression)
Only select tasks which have a follow-up date before the described date by the given expression.
|
TaskQuery |
followUpBeforeOrNotExistent(Date followUpDate)
Only select tasks which have no follow-up date or a follow-up date before the given date.
|
TaskQuery |
followUpBeforeOrNotExistentExpression(String followUpDateExpression)
Only select tasks which have no follow-up date or a follow-up date before the described date by the given expression.
|
TaskQuery |
followUpDate(Date followUpDate)
Only select tasks with the given follow-up date.
|
TaskQuery |
followUpDateExpression(String followUpDateExpression)
Only select tasks with the described follow-up date by the given expression.
|
TaskQuery |
includeAssignedTasks()
Select both assigned and not assigned tasks for candidate user or group queries.
|
TaskQuery |
initializeFormKeys()
If called, the form keys of the fetched tasks are initialized and
Task.getFormKey() will return a value (in case the task has a form key). |
TaskQuery |
matchVariableNamesIgnoreCase()
All queries for task-, process- and case-variables will match the variable names in a case-insensitive way.
|
TaskQuery |
matchVariableValuesIgnoreCase()
All queries for task-, process- and case-variables will match the variable values in a case-insensitive way.
|
TaskQuery |
or()
After calling or(), a chain of several filter criteria could follow.
|
TaskQuery |
orderByCaseExecutionId()
Order by case execution id (needs to be followed by
Query.asc() or Query.desc() ). |
TaskQuery |
orderByCaseExecutionVariable(String variableName,
ValueType valueType)
Order by a task variable value of a certain type.
|
TaskQuery |
orderByCaseInstanceId()
Order by case instance id (needs to be followed by
Query.asc() or Query.desc() ). |
TaskQuery |
orderByCaseInstanceVariable(String variableName,
ValueType valueType)
Order by a task variable value of a certain type.
|
TaskQuery |
orderByDueDate()
Order by due date (needs to be followed by
Query.asc() or Query.desc() ). |
TaskQuery |
orderByExecutionId()
Order by execution id (needs to be followed by
Query.asc() or Query.desc() ). |
TaskQuery |
orderByExecutionVariable(String variableName,
ValueType valueType)
Order by an execution variable value of a certain type.
|
TaskQuery |
orderByFollowUpDate()
Order by follow-up date (needs to be followed by
Query.asc() or Query.desc() ). |
TaskQuery |
orderByProcessInstanceId()
Order by process instance id (needs to be followed by
Query.asc() or Query.desc() ). |
TaskQuery |
orderByProcessVariable(String variableName,
ValueType valueType)
Order by a process instance variable value of a certain type.
|
TaskQuery |
orderByTaskAssignee()
Order by assignee (needs to be followed by
Query.asc() or Query.desc() ). |
TaskQuery |
orderByTaskCreateTime()
Order by the time on which the tasks were created (needs to be followed by
Query.asc() or Query.desc() ). |
TaskQuery |
orderByTaskDescription()
Order by description (needs to be followed by
Query.asc() or Query.desc() ). |
TaskQuery |
orderByTaskId()
Order by task id (needs to be followed by
Query.asc() or Query.desc() ). |
TaskQuery |
orderByTaskName()
Order by task name (needs to be followed by
Query.asc() or Query.desc() ). |
TaskQuery |
orderByTaskNameCaseInsensitive()
Order by task name case insensitive (needs to be followed by
Query.asc() or Query.desc() ). |
TaskQuery |
orderByTaskPriority()
Order by priority (needs to be followed by
Query.asc() or Query.desc() ). |
TaskQuery |
orderByTaskVariable(String variableName,
ValueType valueType)
Order by a task variable value of a certain type.
|
TaskQuery |
orderByTenantId()
Order by tenant id (needs to be followed by
Query.asc() or Query.desc() ). |
TaskQuery |
processDefinitionId(String processDefinitionId)
Only select tasks which are part of a process instance which has the given
process definition id.
|
TaskQuery |
processDefinitionKey(String processDefinitionKey)
Only select tasks which are part of a process instance which has the given
process definition key.
|
TaskQuery |
processDefinitionKeyIn(String... processDefinitionKeys)
Only select tasks which are part of a process instance which has one of the
given process definition keys.
|
TaskQuery |
processDefinitionName(String processDefinitionName)
Only select tasks which are part of a process instance which has the given
process definition name.
|
TaskQuery |
processDefinitionNameLike(String processDefinitionName)
Only select tasks which are part of a process instance which process definition
name is like the given parameter.
|
TaskQuery |
processInstanceBusinessKey(String processInstanceBusinessKey)
Only select tasks for the given process instance business key
|
TaskQuery |
processInstanceBusinessKeyExpression(String processInstanceBusinessKeyExpression)
Only select tasks for the given process instance business key described by the given expression
|
TaskQuery |
processInstanceBusinessKeyIn(String... processInstanceBusinessKeys)
Only select tasks for any of the given the given process instance business keys.
|
TaskQuery |
processInstanceBusinessKeyLike(String processInstanceBusinessKey)
Only select tasks matching the given process instance business key.
|
TaskQuery |
processInstanceBusinessKeyLikeExpression(String processInstanceBusinessKeyExpression)
Only select tasks matching the given process instance business key described by the given expression.
|
TaskQuery |
processInstanceId(String processInstanceId)
Only select tasks for the given process instance id.
|
TaskQuery |
processInstanceIdIn(String... processInstanceIds)
Only select tasks for the given process instance ids.
|
TaskQuery |
processVariableValueEquals(String variableName,
Object variableValue)
Only select tasks which have are part of a process that have a variable
with the given name set to the given value.
|
TaskQuery |
processVariableValueGreaterThan(String variableName,
Object variableValue)
Only select tasks which are part of a process that have a variable
with the given name and a value greater than the given one.
|
TaskQuery |
processVariableValueGreaterThanOrEquals(String variableName,
Object variableValue)
Only select tasks which are part of a process that have a variable
with the given name and a value greater than or equal to the given one.
|
TaskQuery |
processVariableValueLessThan(String variableName,
Object variableValue)
Only select tasks which are part of a process that have a variable
with the given name and a value less than the given one.
|
TaskQuery |
processVariableValueLessThanOrEquals(String variableName,
Object variableValue)
Only select tasks which are part of a process that have a variable
with the given name and a value greater than or equal to the given one.
|
TaskQuery |
processVariableValueLike(String variableName,
String variableValue)
Only select tasks which are part of a process that have a variable
with the given name and matching the given value.
|
TaskQuery |
processVariableValueNotEquals(String variableName,
Object variableValue)
Only select tasks which have a variable with the given name, but
with a different value than the passed value.
|
TaskQuery |
processVariableValueNotLike(String variableName,
String variableValue)
Only select tasks which are part of a process that have a variable
with the given name and not matching the given value.
|
TaskQuery |
suspended()
Only select tasks which are suspended, because its process instance was suspended.
|
TaskQuery |
taskAssigned()
Only select tasks which have an assignee.
|
TaskQuery |
taskAssignee(String assignee)
Only select tasks which are assigned to the given user.
|
TaskQuery |
taskAssigneeExpression(String assigneeExpression)
Only select tasks which are assigned to the user described by the given expression.
|
TaskQuery |
taskAssigneeIn(String... assignees)
Only select tasks which are assigned to one of the given users.
|
TaskQuery |
taskAssigneeLike(String assignee)
Only select tasks which are matching the given user.
|
TaskQuery |
taskAssigneeLikeExpression(String assigneeLikeExpression)
Only select tasks which are assigned to the user described by the given expression.
|
TaskQuery |
taskAssigneeNotIn(String... assignees)
Only select tasks which are not assigned to any of the given users.
|
TaskQuery |
taskCandidateGroup(String candidateGroup)
Only select tasks for which users in the given group are candidates.
|
TaskQuery |
taskCandidateGroupExpression(String candidateGroupExpression)
Only select tasks for which users in the described group by the given expression are candidates.
|
TaskQuery |
taskCandidateGroupIn(List<String> candidateGroups)
Only select tasks for which the 'candidateGroup' is one of the given groups.
|
TaskQuery |
taskCandidateGroupInExpression(String candidateGroupsExpression)
Only select tasks for which the 'candidateGroup' is one of the described groups of the given expression.
|
TaskQuery |
taskCandidateUser(String candidateUser)
Only select tasks for which the given user or one of his groups is a candidate.
|
TaskQuery |
taskCandidateUserExpression(String candidateUserExpression)
Only select tasks for which the described user by the given expression is a candidate.
|
TaskQuery |
taskCreatedAfter(Date after)
Only select tasks that are created after the given date.
|
TaskQuery |
taskCreatedAfterExpression(String afterExpression)
Only select tasks that are created after the described date by the given expression.
|
TaskQuery |
taskCreatedBefore(Date before)
Only select tasks that are created before the given date.
|
TaskQuery |
taskCreatedBeforeExpression(String beforeExpression)
Only select tasks that are created before the described date by the given expression.
|
TaskQuery |
taskCreatedOn(Date createTime)
Only select tasks that are created on the given date.
|
TaskQuery |
taskCreatedOnExpression(String createTimeExpression)
Only select tasks that are created on the described date by the given expression.
|
TaskQuery |
taskDefinitionKey(String key)
Only select tasks with the given taskDefinitionKey.
|
TaskQuery |
taskDefinitionKeyIn(String... taskDefinitionKeys)
Only select tasks which have one of the taskDefinitionKeys.
|
TaskQuery |
taskDefinitionKeyLike(String keyLike)
Only select tasks with a taskDefinitionKey that match the given parameter.
|
TaskQuery |
taskDelegationState(DelegationState delegationState)
Only select tasks with the given
DelegationState . |
TaskQuery |
taskDescription(String description)
Only select tasks with the given description.
|
TaskQuery |
taskDescriptionLike(String descriptionLike)
Only select tasks with a description matching the parameter .
|
TaskQuery |
taskId(String taskId)
Only select tasks with the given task id (in practice, there will be
maximum one of this kind)
|
TaskQuery |
taskIdIn(String... taskIds)
Only select tasks with the given task ids.
|
TaskQuery |
taskInvolvedUser(String involvedUser)
Only select tasks for which there exist an
IdentityLink with the given user |
TaskQuery |
taskInvolvedUserExpression(String involvedUserExpression)
Only select tasks for which there exist an
IdentityLink with the
described user by the given expression |
TaskQuery |
taskMaxPriority(Integer maxPriority)
Only select tasks with the given priority or lower.
|
TaskQuery |
taskMinPriority(Integer minPriority)
Only select tasks with the given priority or higher.
|
TaskQuery |
taskName(String name)
Only select tasks with the given name.
|
TaskQuery |
taskNameLike(String nameLike)
Only select tasks with a name matching the parameter.
|
TaskQuery |
taskNameNotEqual(String name)
Only select tasks with a name not matching the given name/
The query will match the names of tasks in a case-insensitive way.
|
TaskQuery |
taskNameNotLike(String nameNotLike)
Only select tasks with a name not matching the parameter.
|
TaskQuery |
taskOwner(String owner)
Only select tasks for which the given user is the owner.
|
TaskQuery |
taskOwnerExpression(String ownerExpression)
Only select tasks for which the described user by the given expression is the owner.
|
TaskQuery |
taskParentTaskId(String parentTaskId)
Select the tasks which are sub tasks of the given parent task.
|
TaskQuery |
taskPriority(Integer priority)
Only select tasks with the given priority.
|
TaskQuery |
taskUnassigned()
Only select tasks which don't have an assignee.
|
TaskQuery |
taskUnnassigned()
Deprecated.
|
TaskQuery |
taskVariableValueEquals(String variableName,
Object variableValue)
Only select tasks which have a local task variable with the given name
set to the given value.
|
TaskQuery |
taskVariableValueGreaterThan(String variableName,
Object variableValue)
Only select tasks which have a local task variable with the given name
and a value greater than the given one.
|
TaskQuery |
taskVariableValueGreaterThanOrEquals(String variableName,
Object variableValue)
Only select tasks which have a local task variable with the given name
and a value greater than or equal to the given one.
|
TaskQuery |
taskVariableValueLessThan(String variableName,
Object variableValue)
Only select tasks which have a local task variable with the given name
and a value less than the given one.
|
TaskQuery |
taskVariableValueLessThanOrEquals(String variableName,
Object variableValue)
Only select tasks which have a local task variable with the given name
and a value less than or equal to the given one.
|
TaskQuery |
taskVariableValueLike(String variableName,
String variableValue)
Only select tasks which have a local task variable with the given name
matching the given value.
|
TaskQuery |
taskVariableValueNotEquals(String variableName,
Object variableValue)
Only select tasks which have a local task variable with the given name, but
with a different value than the passed value.
|
TaskQuery |
tenantIdIn(String... tenantIds)
Only select tasks with one of the given tenant ids.
|
TaskQuery |
withCandidateGroups()
Only select tasks which have a candidate group
|
TaskQuery |
withCandidateUsers()
Only select tasks which have a candidate user
|
TaskQuery |
withoutCandidateGroups()
Only select tasks which have no candidate group
|
TaskQuery |
withoutCandidateUsers()
Only select tasks which have no candidate user
|
TaskQuery |
withoutDueDate()
Only select tasks which have no due date.
|
TaskQuery |
withoutTenantId()
Only select tasks which have no tenant id.
|
asc, count, desc, list, listPage, singleResult, unlimitedList
TaskQuery taskId(String taskId)
TaskQuery taskName(String name)
TaskQuery taskNameNotEqual(String name)
TaskQuery taskNameLike(String nameLike)
TaskQuery taskNameNotLike(String nameNotLike)
TaskQuery taskDescription(String description)
TaskQuery taskDescriptionLike(String descriptionLike)
TaskQuery taskMinPriority(Integer minPriority)
TaskQuery taskMaxPriority(Integer maxPriority)
TaskQuery taskAssignee(String assignee)
TaskQuery taskAssigneeExpression(String assigneeExpression)
Only select tasks which are assigned to the user described by the given expression.
BadUserRequestException
- Query.list()
, Query.listPage(int, int)
, Query.singleResult()
, or Query.count()
)
or stored queries (in case the query is stored along with a filter).
Expression evaluation can be activated by setting the process engine configuration properties
enableExpressionsInAdhocQueries
(default false
) and
enableExpressionsInStoredQueries
(default true
) to true
.TaskQuery taskAssigneeLike(String assignee)
TaskQuery taskAssigneeLikeExpression(String assigneeLikeExpression)
Only select tasks which are assigned to the user described by the given expression. The syntax is that of SQL: for example usage: taskAssigneeLikeExpression("${'%test%'}")
BadUserRequestException
- Query.list()
, Query.listPage(int, int)
, Query.singleResult()
, or Query.count()
)
or stored queries (in case the query is stored along with a filter).
Expression evaluation can be activated by setting the process engine configuration properties
enableExpressionsInAdhocQueries
(default false
) and
enableExpressionsInStoredQueries
(default true
) to true
.TaskQuery taskAssigneeIn(String... assignees)
TaskQuery taskAssigneeNotIn(String... assignees)
TaskQuery taskOwner(String owner)
TaskQuery taskOwnerExpression(String ownerExpression)
Only select tasks for which the described user by the given expression is the owner.
BadUserRequestException
- Query.list()
, Query.listPage(int, int)
, Query.singleResult()
, or Query.count()
)
or stored queries (in case the query is stored along with a filter).
Expression evaluation can be activated by setting the process engine configuration properties
enableExpressionsInAdhocQueries
(default false
) and
enableExpressionsInStoredQueries
(default true
) to true
.TaskQuery taskUnassigned()
@Deprecated TaskQuery taskUnnassigned()
#taskUnassigned}
TaskQuery taskAssigned()
TaskQuery taskDelegationState(DelegationState delegationState)
DelegationState
.TaskQuery taskCandidateUser(String candidateUser)
Per default it only selects tasks which are not already assigned
to a user. To also include assigned task in the result specify
includeAssignedTasks()
in your query.
ProcessEngineException
- taskCandidateGroup(String)
or
taskCandidateGroupIn(List)
has been executed on the "and query" instance.
No exception is thrown when query is executed and taskCandidateGroup(String)
or
taskCandidateGroupIn(List)
has been executed on the "or query" instance.
null
.
BadUserRequestException
- Query.list()
, Query.listPage(int, int)
, Query.singleResult()
, or Query.count()
)
or stored queries (in case the query is stored along with a filter).
Expression evaluation can be activated by setting the process engine configuration properties
enableExpressionsInAdhocQueries
(default false
) and
enableExpressionsInStoredQueries
(default true
) to true
.TaskQuery taskCandidateUserExpression(String candidateUserExpression)
Per default it only selects tasks which are not already assigned
to a user. To also include assigned task in the result specify
includeAssignedTasks()
in your query.
ProcessEngineException
- taskCandidateGroup(String)
or
taskCandidateGroupIn(List)
has been executed on the query instance.
null
.
BadUserRequestException
- Query.list()
, Query.listPage(int, int)
, Query.singleResult()
, or Query.count()
)
or stored queries (in case the query is stored along with a filter).
Expression evaluation can be activated by setting the process engine configuration properties
enableExpressionsInAdhocQueries
(default false
) and
enableExpressionsInStoredQueries
(default true
) to true
.TaskQuery taskInvolvedUser(String involvedUser)
IdentityLink
with the given userTaskQuery taskInvolvedUserExpression(String involvedUserExpression)
Only select tasks for which there exist an IdentityLink
with the
described user by the given expression
BadUserRequestException
- Query.list()
, Query.listPage(int, int)
, Query.singleResult()
, or Query.count()
)
or stored queries (in case the query is stored along with a filter).
Expression evaluation can be activated by setting the process engine configuration properties
enableExpressionsInAdhocQueries
(default false
) and
enableExpressionsInStoredQueries
(default true
) to true
.TaskQuery withCandidateGroups()
ProcessEngineException
- When method has been executed within "or query".TaskQuery withoutCandidateGroups()
ProcessEngineException
- When method has been executed within "or query".TaskQuery withCandidateUsers()
ProcessEngineException
- When method has been executed within "or query".TaskQuery withoutCandidateUsers()
ProcessEngineException
- When method has been executed within "or query".TaskQuery taskCandidateGroup(String candidateGroup)
Per default it only selects tasks which are not already assigned
to a user. To also include assigned task in the result specify
includeAssignedTasks()
in your query.
ProcessEngineException
- taskCandidateUser(String)
or
taskCandidateGroupIn(List)
has been executed on the "and query" instance.taskCandidateUser(String)
or
taskCandidateGroupIn(List)
has been executed on the "or query" instance.null
.TaskQuery taskCandidateGroupExpression(String candidateGroupExpression)
Per default it only selects tasks which are not already assigned
to a user. To also include assigned task in the result specify
includeAssignedTasks()
in your query.
ProcessEngineException
- taskCandidateUser(String)
or
taskCandidateGroupIn(List)
has been executed on the query instance.
null
.
BadUserRequestException
- Query.list()
, Query.listPage(int, int)
, Query.singleResult()
, or Query.count()
)
or stored queries (in case the query is stored along with a filter).
Expression evaluation can be activated by setting the process engine configuration properties
enableExpressionsInAdhocQueries
(default false
) and
enableExpressionsInStoredQueries
(default true
) to true
.TaskQuery taskCandidateGroupIn(List<String> candidateGroups)
Per default it only selects tasks which are not already assigned
to a user. To also include assigned task in the result specify
includeAssignedTasks()
in your query.
ProcessEngineException
- taskCandidateGroup(String)
or
taskCandidateUser(String)
has been executed on the "and query" instance.taskCandidateGroup(String)
or
taskCandidateUser(String)
has been executed on the "or query" instance.null
.TaskQuery taskCandidateGroupInExpression(String candidateGroupsExpression)
Per default it only selects tasks which are not already assigned
to a user. To also include assigned task in the result specify
includeAssignedTasks()
in your query.
ProcessEngineException
- taskCandidateGroup(String)
or
taskCandidateUser(String)
has been executed on the query instance.
null
.BadUserRequestException
- Query.list()
, Query.listPage(int, int)
, Query.singleResult()
, or Query.count()
)
or stored queries (in case the query is stored along with a filter).
Expression evaluation can be activated by setting the process engine configuration properties
enableExpressionsInAdhocQueries
(default false
) and
enableExpressionsInStoredQueries
(default true
) to true
.TaskQuery includeAssignedTasks()
By default taskCandidateUser(String)
, taskCandidateGroup(String)
and taskCandidateGroupIn(List)
queries only select not assigned tasks.
ProcessEngineException
- When no candidate user or group(s) are specified beforehandTaskQuery processInstanceId(String processInstanceId)
TaskQuery processInstanceIdIn(String... processInstanceIds)
TaskQuery processInstanceBusinessKey(String processInstanceBusinessKey)
TaskQuery processInstanceBusinessKeyExpression(String processInstanceBusinessKeyExpression)
TaskQuery processInstanceBusinessKeyIn(String... processInstanceBusinessKeys)
TaskQuery processInstanceBusinessKeyLike(String processInstanceBusinessKey)
TaskQuery processInstanceBusinessKeyLikeExpression(String processInstanceBusinessKeyExpression)
TaskQuery activityInstanceIdIn(String... activityInstanceIds)
TaskQuery taskCreatedOn(Date createTime)
TaskQuery taskCreatedOnExpression(String createTimeExpression)
TaskQuery taskCreatedBefore(Date before)
TaskQuery taskCreatedBeforeExpression(String beforeExpression)
TaskQuery taskCreatedAfter(Date after)
TaskQuery taskCreatedAfterExpression(String afterExpression)
TaskQuery excludeSubtasks()
TaskQuery taskDefinitionKey(String key)
TaskQuery taskDefinitionKeyLike(String keyLike)
TaskQuery taskDefinitionKeyIn(String... taskDefinitionKeys)
TaskQuery taskParentTaskId(String parentTaskId)
TaskQuery caseInstanceId(String caseInstanceId)
TaskQuery caseInstanceBusinessKey(String caseInstanceBusinessKey)
TaskQuery caseInstanceBusinessKeyLike(String caseInstanceBusinessKeyLike)
TaskQuery caseExecutionId(String caseExecutionId)
TaskQuery caseDefinitionKey(String caseDefinitionKey)
TaskQuery caseDefinitionId(String caseDefinitionId)
TaskQuery caseDefinitionName(String caseDefinitionName)
TaskQuery caseDefinitionNameLike(String caseDefinitionNameLike)
TaskQuery matchVariableNamesIgnoreCase()
TaskQuery matchVariableValuesIgnoreCase()
TaskQuery taskVariableValueEquals(String variableName, Object variableValue)
TaskQuery taskVariableValueNotEquals(String variableName, Object variableValue)
Serializable
objects (which are not primitive type wrappers)
are not supported.TaskQuery taskVariableValueLike(String variableName, String variableValue)
TaskQuery taskVariableValueGreaterThan(String variableName, Object variableValue)
TaskQuery taskVariableValueGreaterThanOrEquals(String variableName, Object variableValue)
TaskQuery taskVariableValueLessThan(String variableName, Object variableValue)
TaskQuery taskVariableValueLessThanOrEquals(String variableName, Object variableValue)
TaskQuery processVariableValueEquals(String variableName, Object variableValue)
TaskQuery processVariableValueNotEquals(String variableName, Object variableValue)
Serializable
objects (which are not primitive type wrappers)
are not supported.TaskQuery processVariableValueLike(String variableName, String variableValue)
TaskQuery processVariableValueNotLike(String variableName, String variableValue)
TaskQuery processVariableValueGreaterThan(String variableName, Object variableValue)
TaskQuery processVariableValueGreaterThanOrEquals(String variableName, Object variableValue)
TaskQuery processVariableValueLessThan(String variableName, Object variableValue)
TaskQuery processVariableValueLessThanOrEquals(String variableName, Object variableValue)
TaskQuery caseInstanceVariableValueEquals(String variableName, Object variableValue)
ProcessEngineConfiguration#getVariableSerializers()
.
Byte-arrays and Serializable
objects (which are not primitive type wrappers)
are not supported.name
- name of the variable, cannot be null.TaskQuery caseInstanceVariableValueNotEquals(String variableName, Object variableValue)
ProcessEngineConfiguration#getVariableSerializers()
.
Byte-arrays and Serializable
objects (which are not primitive type wrappers)
are not supported.name
- name of the variable, cannot be null.TaskQuery caseInstanceVariableValueLike(String variableName, String variableValue)
name
- variable name, cannot be null.value
- variable value. The string can include the
wildcard character '%' to express like-strategy:
starts with (string%), ends with (%string) or contains (%string%).TaskQuery caseInstanceVariableValueNotLike(String variableName, String variableValue)
name
- variable name, cannot be null.value
- variable value. The string can include the
wildcard character '%' to express like-strategy:
starts with (string%), ends with (%string) or contains (%string%).TaskQuery caseInstanceVariableValueGreaterThan(String variableName, Object variableValue)
Serializable
objects (which are not primitive type wrappers)
are not supported.name
- variable name, cannot be null.TaskQuery caseInstanceVariableValueGreaterThanOrEquals(String variableName, Object variableValue)
Serializable
objects (which
are not primitive type wrappers) are not supported.name
- variable name, cannot be null.TaskQuery caseInstanceVariableValueLessThan(String variableName, Object variableValue)
Serializable
objects (which are not primitive type wrappers)
are not supported.name
- variable name, cannot be null.TaskQuery caseInstanceVariableValueLessThanOrEquals(String variableName, Object variableValue)
Serializable
objects (which are not primitive type wrappers)
are not supported.name
- variable name, cannot be null.TaskQuery processDefinitionKey(String processDefinitionKey)
TaskQuery processDefinitionKeyIn(String... processDefinitionKeys)
TaskQuery processDefinitionId(String processDefinitionId)
TaskQuery processDefinitionName(String processDefinitionName)
TaskQuery processDefinitionNameLike(String processDefinitionName)
TaskQuery dueDateExpression(String dueDateExpression)
Only select tasks with the described due date by the given expression.
BadUserRequestException
- Query.list()
, Query.listPage(int, int)
, Query.singleResult()
, or Query.count()
)
or stored queries (in case the query is stored along with a filter).
Expression evaluation can be activated by setting the process engine configuration properties
enableExpressionsInAdhocQueries
(default false
) and
enableExpressionsInStoredQueries
(default true
) to true
.TaskQuery dueBefore(Date dueDate)
TaskQuery dueBeforeExpression(String dueDateExpression)
Only select tasks which have a due date before the described date by the given expression.
BadUserRequestException
- Query.list()
, Query.listPage(int, int)
, Query.singleResult()
, or Query.count()
)
or stored queries (in case the query is stored along with a filter).
Expression evaluation can be activated by setting the process engine configuration properties
enableExpressionsInAdhocQueries
(default false
) and
enableExpressionsInStoredQueries
(default true
) to true
.TaskQuery dueAfter(Date dueDate)
TaskQuery dueAfterExpression(String dueDateExpression)
Only select tasks which have a due date after the described date by the given expression.
BadUserRequestException
- Query.list()
, Query.listPage(int, int)
, Query.singleResult()
, or Query.count()
)
or stored queries (in case the query is stored along with a filter).
Expression evaluation can be activated by setting the process engine configuration properties
enableExpressionsInAdhocQueries
(default false
) and
enableExpressionsInStoredQueries
(default true
) to true
.TaskQuery followUpDate(Date followUpDate)
TaskQuery followUpDateExpression(String followUpDateExpression)
Only select tasks with the described follow-up date by the given expression.
BadUserRequestException
- Query.list()
, Query.listPage(int, int)
, Query.singleResult()
, or Query.count()
)
or stored queries (in case the query is stored along with a filter).
Expression evaluation can be activated by setting the process engine configuration properties
enableExpressionsInAdhocQueries
(default false
) and
enableExpressionsInStoredQueries
(default true
) to true
.TaskQuery followUpBefore(Date followUpDate)
TaskQuery followUpBeforeExpression(String followUpDateExpression)
Only select tasks which have a follow-up date before the described date by the given expression.
BadUserRequestException
- Query.list()
, Query.listPage(int, int)
, Query.singleResult()
, or Query.count()
)
or stored queries (in case the query is stored along with a filter).
Expression evaluation can be activated by setting the process engine configuration properties
enableExpressionsInAdhocQueries
(default false
) and
enableExpressionsInStoredQueries
(default true
) to true
.TaskQuery followUpBeforeOrNotExistent(Date followUpDate)
TaskQuery followUpBeforeOrNotExistentExpression(String followUpDateExpression)
Only select tasks which have no follow-up date or a follow-up date before the described date by the given expression. Serves the typical use case "give me all tasks without follow-up or follow-up date which is already due"
BadUserRequestException
- Query.list()
, Query.listPage(int, int)
, Query.singleResult()
, or Query.count()
)
or stored queries (in case the query is stored along with a filter).
Expression evaluation can be activated by setting the process engine configuration properties
enableExpressionsInAdhocQueries
(default false
) and
enableExpressionsInStoredQueries
(default true
) to true
.TaskQuery followUpAfter(Date followUpDate)
TaskQuery followUpAfterExpression(String followUpDateExpression)
Only select tasks which have a follow-up date after the described date by the given expression.
BadUserRequestException
- Query.list()
, Query.listPage(int, int)
, Query.singleResult()
, or Query.count()
)
or stored queries (in case the query is stored along with a filter).
Expression evaluation can be activated by setting the process engine configuration properties
enableExpressionsInAdhocQueries
(default false
) and
enableExpressionsInStoredQueries
(default true
) to true
.TaskQuery suspended()
TaskQuery active()
TaskQuery initializeFormKeys()
Task.getFormKey()
will return a value (in case the task has a form key).ProcessEngineException
- When method has been executed within "or query". Method must be executed on the base query.TaskQuery tenantIdIn(String... tenantIds)
ProcessEngineException
- withoutTenantId()
has been executed on
the "and query" instance. No exception is thrown when a query is executed
and withoutTenantId()
has been executed on the "or query" instance.
null
tenant id is passed.TaskQuery withoutTenantId()
ProcessEngineException
- When query is executed and tenantIdIn(String...)
has been executed on the "and query" instance. No exception is thrown when query is
executed and tenantIdIn(String...)
has been executed on the "or query" instance.TaskQuery withoutDueDate()
TaskQuery orderByTaskId()
Query.asc()
or Query.desc()
).ProcessEngineException
- When method has been executed within "or query".TaskQuery orderByTaskName()
Query.asc()
or Query.desc()
).ProcessEngineException
- When method has been executed within "or query".TaskQuery orderByTaskNameCaseInsensitive()
Query.asc()
or Query.desc()
).ProcessEngineException
- When method has been executed within "or query".TaskQuery orderByTaskDescription()
Query.asc()
or Query.desc()
).ProcessEngineException
- When method has been executed within "or query".TaskQuery orderByTaskPriority()
Query.asc()
or Query.desc()
).ProcessEngineException
- When method has been executed within "or query".TaskQuery orderByTaskAssignee()
Query.asc()
or Query.desc()
).ProcessEngineException
- When method has been executed within "or query".TaskQuery orderByTaskCreateTime()
Query.asc()
or Query.desc()
).ProcessEngineException
- When method has been executed within "or query".TaskQuery orderByProcessInstanceId()
Query.asc()
or Query.desc()
).ProcessEngineException
- When method has been executed within "or query".TaskQuery orderByCaseInstanceId()
Query.asc()
or Query.desc()
).ProcessEngineException
- When method has been executed within "or query".TaskQuery orderByExecutionId()
Query.asc()
or Query.desc()
).ProcessEngineException
- When method has been executed within "or query".TaskQuery orderByCaseExecutionId()
Query.asc()
or Query.desc()
).ProcessEngineException
- When method has been executed within "or query".TaskQuery orderByDueDate()
Query.asc()
or Query.desc()
).ProcessEngineException
- When method has been executed within "or query".TaskQuery orderByFollowUpDate()
Query.asc()
or Query.desc()
).ProcessEngineException
- When method has been executed within "or query".TaskQuery orderByProcessVariable(String variableName, ValueType valueType)
null
values is database-specific.ProcessEngineException
- When method has been executed within "or query".TaskQuery orderByExecutionVariable(String variableName, ValueType valueType)
null
values is database-specific.ProcessEngineException
- When method has been executed within "or query".TaskQuery orderByTaskVariable(String variableName, ValueType valueType)
null
values is database-specific.ProcessEngineException
- When method has been executed within "or query".TaskQuery orderByCaseExecutionVariable(String variableName, ValueType valueType)
null
values is database-specific.ProcessEngineException
- When method has been executed within "or query".TaskQuery orderByCaseInstanceVariable(String variableName, ValueType valueType)
null
values is database-specific.ProcessEngineException
- When method has been executed within "or query".TaskQuery orderByTenantId()
Query.asc()
or Query.desc()
).
Note that the ordering of tasks without tenant id is database-specific.ProcessEngineException
- When method has been executed within "or query".TaskQuery or()
After calling or(), a chain of several filter criteria could follow. Each filter criterion that follows or()
will be linked together with an OR expression until the OR query is terminated. To terminate the OR query right
after the last filter criterion was applied, endOr()
must be invoked.
TaskQuery
on which an arbitrary amount of filter criteria could be applied.
The several filter criteria will be linked together by an OR expression.ProcessEngineException
- when or() has been invoked directly after or() or after or() and trailing filter
criteria. To prevent throwing this exception, endOr()
must be invoked after a chain of filter criteria to
mark the end of the OR query.TaskQuery endOr()
endOr() terminates an OR query on which an arbitrary amount of filter criteria were applied. To terminate the
OR query which has been started by invoking or()
, endOr() must be invoked. Filter criteria which are
applied after calling endOr() are linked together by an AND expression.
TaskQuery
on which an arbitrary amount of filter criteria could be applied.
The filter criteria will be linked together by an AND expression.ProcessEngineException
- when endOr() has been invoked before or()
was invoked. To prevent throwing
this exception, or()
must be invoked first.Copyright © 2022. All rights reserved.