org.camunda.bpm.engine.repository
Interface ProcessDefinitionQuery

All Superinterfaces:

Query<ProcessDefinitionQuery,ProcessDefinition>

All Known Implementing Classes:

ProcessDefinitionQueryImpl

public interface ProcessDefinitionQuery
extends Query<ProcessDefinitionQuery,ProcessDefinition>

Allows programmatic querying of ProcessDefinitions.

Author:

Tom Baeyens, Joram Barrez, Daniel Meyer, Saeid Mirzaei

Method Summary

ProcessDefinitionQuery	active() Only selects process definitions which are active
ProcessDefinitionQuery	deploymentId(String deploymentId) Only select process definitions that are deployed in a deployment with the given deployment id
ProcessDefinitionQuery	incidentId(String incidentId) Only selects process definitions with the given incident id.
ProcessDefinitionQuery	incidentMessage(String incidentMessage) Only selects process definitions with the given incident message.
ProcessDefinitionQuery	incidentMessageLike(String incidentMessageLike) Only selects process definitions with an incident message like the given.
ProcessDefinitionQuery	incidentType(String incidentType) Only selects process definitions with the given incident type.
ProcessDefinitionQuery	includeProcessDefinitionsWithoutTenantId() Select process definitions which have no tenant id.
ProcessDefinitionQuery	latestVersion() Only select the process definitions which are the latest deployed (ie.
ProcessDefinitionQuery	messageEventSubscription(String messageName) Deprecated.
ProcessDefinitionQuery	messageEventSubscriptionName(String messageName) Selects the single process definition which has a start message event with the messageName.
ProcessDefinitionQuery	orderByDeploymentId() Order by deployment id (needs to be followed by Query.asc() or Query.desc()).
ProcessDefinitionQuery	orderByProcessDefinitionCategory() Order by the category of the process definitions (needs to be followed by Query.asc() or Query.desc()).
ProcessDefinitionQuery	orderByProcessDefinitionId() Order by the id of the process definitions (needs to be followed by Query.asc() or Query.desc()).
ProcessDefinitionQuery	orderByProcessDefinitionKey() Order by process definition key (needs to be followed by Query.asc() or Query.desc()).
ProcessDefinitionQuery	orderByProcessDefinitionName() Order by the name of the process definitions (needs to be followed by Query.asc() or Query.desc()).
ProcessDefinitionQuery	orderByProcessDefinitionVersion() Order by the version of the process definitions (needs to be followed by Query.asc() or Query.desc()).
ProcessDefinitionQuery	orderByTenantId() Order by tenant id (needs to be followed by Query.asc() or Query.desc()).
ProcessDefinitionQuery	orderByVersionTag() Order by version tag (needs to be followed by Query.asc() or Query.desc()).
ProcessDefinitionQuery	processDefinitionCategory(String processDefinitionCategory) Only select process definitions with the given category.
ProcessDefinitionQuery	processDefinitionCategoryLike(String processDefinitionCategoryLike) Only select process definitions where the category matches the given parameter.
ProcessDefinitionQuery	processDefinitionId(String processDefinitionId) Only select process definiton with the given id.
ProcessDefinitionQuery	processDefinitionIdIn(String... ids) Only select process definiton with the given id.
ProcessDefinitionQuery	processDefinitionKey(String processDefinitionKey) Only select process definition with the given key.
ProcessDefinitionQuery	processDefinitionKeyLike(String processDefinitionKeyLike) Only select process definitions where the key matches the given parameter.
ProcessDefinitionQuery	processDefinitionName(String processDefinitionName) Only select process definitions with the given name.
ProcessDefinitionQuery	processDefinitionNameLike(String processDefinitionNameLike) Only select process definitions where the name matches the given parameter.
ProcessDefinitionQuery	processDefinitionResourceName(String resourceName) Only select process definition with the given resource name.
ProcessDefinitionQuery	processDefinitionResourceNameLike(String resourceNameLike) Only select process definition with a resource name like the given .
ProcessDefinitionQuery	processDefinitionVersion(Integer processDefinitionVersion) Only select process definition with a certain version.
ProcessDefinitionQuery	startableByUser(String userId) Only selects process definitions which given userId is authorized to start
ProcessDefinitionQuery	suspended() Only selects process definitions which are suspended
ProcessDefinitionQuery	tenantIdIn(String... tenantIds) Only select process definitions with one of the given tenant ids.
ProcessDefinitionQuery	versionTag(String versionTag) Only selects process definitions with a specific version tag
ProcessDefinitionQuery	versionTagLike(String versionTagLike) Only selects process definitions with a version tag like the given
ProcessDefinitionQuery	withoutTenantId() Only select process definitions which have no tenant id.

Methods inherited from interface org.camunda.bpm.engine.query.Query

asc, count, desc, list, listPage, singleResult

Method Detail

processDefinitionId

ProcessDefinitionQuery processDefinitionId(String processDefinitionId)

Only select process definiton with the given id.

processDefinitionIdIn

ProcessDefinitionQuery processDefinitionIdIn(String... ids)

Only select process definiton with the given id.

processDefinitionCategory

ProcessDefinitionQuery processDefinitionCategory(String processDefinitionCategory)

Only select process definitions with the given category.

processDefinitionCategoryLike

ProcessDefinitionQuery processDefinitionCategoryLike(String processDefinitionCategoryLike)

Only select process definitions where the category matches the given parameter. The syntax that should be used is the same as in SQL, eg. %activiti%

processDefinitionName

ProcessDefinitionQuery processDefinitionName(String processDefinitionName)

Only select process definitions with the given name.

processDefinitionNameLike

ProcessDefinitionQuery processDefinitionNameLike(String processDefinitionNameLike)

Only select process definitions where the name matches the given parameter. The syntax that should be used is the same as in SQL, eg. %activiti%

deploymentId

ProcessDefinitionQuery deploymentId(String deploymentId)

Only select process definitions that are deployed in a deployment with the given deployment id

processDefinitionKey

ProcessDefinitionQuery processDefinitionKey(String processDefinitionKey)

Only select process definition with the given key.

processDefinitionKeyLike

ProcessDefinitionQuery processDefinitionKeyLike(String processDefinitionKeyLike)

Only select process definitions where the key matches the given parameter. The syntax that should be used is the same as in SQL, eg. %activiti%

processDefinitionVersion

ProcessDefinitionQuery processDefinitionVersion(Integer processDefinitionVersion)

Only select process definition with a certain version. Particulary useful when used in combination with processDefinitionKey(String)

latestVersion

ProcessDefinitionQuery latestVersion()

Only select the process definitions which are the latest deployed (ie. which have the highest version number for the given key).

Can only be used in combination with processDefinitionKey(String) of processDefinitionKeyLike(String). Can also be used without any other criteria (ie. query.latest().list()), which will then give all the latest versions of all the deployed process definitions.

For multi-tenancy: select the latest deployed process definitions for each tenant. If a process definition is deployed for multiple tenants then all process definitions are selected.

Throws:

ProcessEngineException - if used in combination with #groupId(string), #processDefinitionVersion(int) or deploymentId(String)

processDefinitionResourceName

ProcessDefinitionQuery processDefinitionResourceName(String resourceName)

Only select process definition with the given resource name.

processDefinitionResourceNameLike

ProcessDefinitionQuery processDefinitionResourceNameLike(String resourceNameLike)

Only select process definition with a resource name like the given .

startableByUser

ProcessDefinitionQuery startableByUser(String userId)

Only selects process definitions which given userId is authorized to start

suspended

ProcessDefinitionQuery suspended()

Only selects process definitions which are suspended

active

ProcessDefinitionQuery active()

Only selects process definitions which are active

incidentType

ProcessDefinitionQuery incidentType(String incidentType)

Only selects process definitions with the given incident type.

incidentId

ProcessDefinitionQuery incidentId(String incidentId)

Only selects process definitions with the given incident id.

incidentMessage

ProcessDefinitionQuery incidentMessage(String incidentMessage)

Only selects process definitions with the given incident message.

incidentMessageLike

ProcessDefinitionQuery incidentMessageLike(String incidentMessageLike)

Only selects process definitions with an incident message like the given.

versionTag

ProcessDefinitionQuery versionTag(String versionTag)

Only selects process definitions with a specific version tag

versionTagLike

ProcessDefinitionQuery versionTagLike(String versionTagLike)

Only selects process definitions with a version tag like the given

messageEventSubscription

@Deprecated
ProcessDefinitionQuery messageEventSubscription(String messageName)

Deprecated.

See Also:

messageEventSubscriptionName(String)

messageEventSubscriptionName

ProcessDefinitionQuery messageEventSubscriptionName(String messageName)

Selects the single process definition which has a start message event with the messageName.

tenantIdIn

ProcessDefinitionQuery tenantIdIn(String... tenantIds)

Only select process definitions with one of the given tenant ids.

withoutTenantId

ProcessDefinitionQuery withoutTenantId()

Only select process definitions which have no tenant id.

includeProcessDefinitionsWithoutTenantId

ProcessDefinitionQuery includeProcessDefinitionsWithoutTenantId()

Select process definitions which have no tenant id. Can be used in combination with tenantIdIn(String...).

orderByProcessDefinitionCategory

ProcessDefinitionQuery orderByProcessDefinitionCategory()

Order by the category of the process definitions (needs to be followed by Query.asc() or Query.desc()).

orderByProcessDefinitionKey

ProcessDefinitionQuery orderByProcessDefinitionKey()

Order by process definition key (needs to be followed by Query.asc() or Query.desc()).

orderByProcessDefinitionId

ProcessDefinitionQuery orderByProcessDefinitionId()

Order by the id of the process definitions (needs to be followed by Query.asc() or Query.desc()).

orderByProcessDefinitionVersion

ProcessDefinitionQuery orderByProcessDefinitionVersion()

Order by the version of the process definitions (needs to be followed by Query.asc() or Query.desc()).

orderByProcessDefinitionName

ProcessDefinitionQuery orderByProcessDefinitionName()

Order by the name of the process definitions (needs to be followed by Query.asc() or Query.desc()).

orderByDeploymentId

ProcessDefinitionQuery orderByDeploymentId()

Order by deployment id (needs to be followed by Query.asc() or Query.desc()).

orderByTenantId

ProcessDefinitionQuery orderByTenantId()

Order by tenant id (needs to be followed by Query.asc() or Query.desc()). Note that the ordering of process instances without tenant id is database-specific.

orderByVersionTag

ProcessDefinitionQuery orderByVersionTag()

Order by version tag (needs to be followed by Query.asc() or Query.desc()). Note: sorting by versionTag is a string based sort. There is no interpretation of the version which can lead to a sorting like: v0.1.0 v0.10.0 v0.2.0.