Package org.camunda.bpm.engine

Interface RepositoryService

All Known Implementing Classes:

RepositoryServiceImpl

public interface RepositoryService

Service providing access to the repository of process definitions and deployments.

Author:

Tom Baeyens, Falko Menge, Tijs Rademakers, Joram Barrez

Method Summary

Modifier and Type	Method	Description
void	activateProcessDefinitionById(String processDefinitionId)	Activates the process definition with the given id.
void	activateProcessDefinitionById(String processDefinitionId, boolean activateProcessInstances, Date activationDate)	Activates the process definition with the given id.
void	activateProcessDefinitionByKey(String processDefinitionKey)	Activates the process definition with the given key (=id in the bpmn20.xml file).
void	activateProcessDefinitionByKey(String processDefinitionKey, boolean activateProcessInstances, Date activationDate)	Activates the process definition with the given key (=id in the bpmn20.xml file).
void	addCandidateStarterGroup(String processDefinitionId, String groupId)	Deprecated. Use authorization mechanism instead.
void	addCandidateStarterUser(String processDefinitionId, String userId)	Deprecated. Use authorization mechanism instead.
CaseDefinitionQuery	createCaseDefinitionQuery()	Query case definitions.
DecisionDefinitionQuery	createDecisionDefinitionQuery()	Query decision definitions.
DecisionRequirementsDefinitionQuery	createDecisionRequirementsDefinitionQuery()	Query decision requirements definition.
DeploymentBuilder	createDeployment()	Starts creating a new deployment
ProcessApplicationDeploymentBuilder	createDeployment(ProcessApplicationReference processApplication)	Starts creating a new ProcessApplicationDeployment.
DeploymentQuery	createDeploymentQuery()	Query process definitions.
ProcessDefinitionQuery	createProcessDefinitionQuery()	Query process definitions.
void	deleteCandidateStarterGroup(String processDefinitionId, String groupId)	Deprecated. Use authorization mechanism instead.
void	deleteCandidateStarterUser(String processDefinitionId, String userId)	Deprecated. Use authorization mechanism instead.
void	deleteDeployment(String deploymentId)	Deletes the given deployment.
void	deleteDeployment(String deploymentId, boolean cascade)	Deletes the given deployment and cascade deletion to process instances, history process instances and jobs.
void	deleteDeployment(String deploymentId, boolean cascade, boolean skipCustomListeners)	Deletes the given deployment and cascade deletion to process instances, history process instances and jobs.
void	deleteDeployment(String deploymentId, boolean cascade, boolean skipCustomListeners, boolean skipIoMappings)	Deletes the given deployment and cascade deletion to process instances, history process instances and jobs.
void	deleteDeploymentCascade(String deploymentId)	Deprecated. use deleteDeployment(String, boolean).
void	deleteProcessDefinition(String processDefinitionId)	Deletes the process definition which belongs to the given process definition id.
void	deleteProcessDefinition(String processDefinitionId, boolean cascade)	Deletes the process definition which belongs to the given process definition id.
void	deleteProcessDefinition(String processDefinitionId, boolean cascade, boolean skipCustomListeners)	Deletes the process definition which belongs to the given process definition id.
void	deleteProcessDefinition(String processDefinitionId, boolean cascade, boolean skipCustomListeners, boolean skipIoMappings)	Deletes the process definition which belongs to the given process definition id.
DeleteProcessDefinitionsSelectBuilder	deleteProcessDefinitions()	Fluent builder to delete process definitions.
BpmnModelInstance	getBpmnModelInstance(String processDefinitionId)	Returns the BpmnModelInstance for the given processDefinitionId.
CaseDefinition	getCaseDefinition(String caseDefinitionId)	Returns the CaseDefinition.
InputStream	getCaseDiagram(String caseDefinitionId)	Gives access to a deployed case diagram, e.g., a PNG image, through a stream of bytes.
InputStream	getCaseModel(String caseDefinitionId)	Gives access to a deployed case model, e.g., a CMMN 1.0 XML file, through a stream of bytes.
CmmnModelInstance	getCmmnModelInstance(String caseDefinitionId)	Returns the CmmnModelInstance for the given caseDefinitionId.
DecisionDefinition	getDecisionDefinition(String decisionDefinitionId)	Returns the DecisionDefinition.
InputStream	getDecisionDiagram(String decisionDefinitionId)	Gives access to a deployed decision diagram, e.g., a PNG image, through a stream of bytes.
InputStream	getDecisionModel(String decisionDefinitionId)	Gives access to a deployed decision model, e.g., a DMN 1.1 XML file, through a stream of bytes.
DecisionRequirementsDefinition	getDecisionRequirementsDefinition(String decisionRequirementsDefinitionId)	Returns the DecisionRequirementsDefinition.
InputStream	getDecisionRequirementsDiagram(String decisionRequirementsDefinitionId)	Gives access to a deployed decision requirements diagram, e.g., a PNG image, through a stream of bytes.
InputStream	getDecisionRequirementsModel(String decisionRequirementsDefinitionId)	Gives access to a deployed decision requirements model, e.g., a DMN 1.1 XML file, through a stream of bytes.
List<String>	getDeploymentResourceNames(String deploymentId)	Retrieves a list of deployment resource names for the given deployment, ordered alphabetically.
List<Resource>	getDeploymentResources(String deploymentId)	Retrieves a list of deployment resources for the given deployment, ordered alphabetically by name.
DmnModelInstance	getDmnModelInstance(String decisionDefinitionId)	Returns the DmnModelInstance for the given decisionDefinitionId.
List<IdentityLink>	getIdentityLinksForProcessDefinition(String processDefinitionId)	Deprecated. Use authorization mechanism instead.
ProcessDefinition	getProcessDefinition(String processDefinitionId)	Returns the ProcessDefinition including all BPMN information like additional Properties (e.g.
InputStream	getProcessDiagram(String processDefinitionId)	Gives access to a deployed process diagram, e.g., a PNG image, through a stream of bytes.
DiagramLayout	getProcessDiagramLayout(String processDefinitionId)	Provides positions and dimensions of elements in a process diagram as provided by getProcessDiagram(String).
InputStream	getProcessModel(String processDefinitionId)	Gives access to a deployed process model, e.g., a BPMN 2.0 XML file, through a stream of bytes.
InputStream	getResourceAsStream(String deploymentId, String resourceName)	Gives access to a deployment resource through a stream of bytes.
InputStream	getResourceAsStreamById(String deploymentId, String resourceId)	Gives access to a deployment resource through a stream of bytes.
Collection<CalledProcessDefinition>	getStaticCalledProcessDefinitions(String processDefinitionId)	For the given process, returns a list of CalledProcessDefinition.
void	suspendProcessDefinitionById(String processDefinitionId)	Suspends the process definition with the given id.
void	suspendProcessDefinitionById(String processDefinitionId, boolean suspendProcessInstances, Date suspensionDate)	Suspends the process definition with the given id.
void	suspendProcessDefinitionByKey(String processDefinitionKey)	Suspends the all process definitions with the given key (= id in the bpmn20.xml file).
void	suspendProcessDefinitionByKey(String processDefinitionKey, boolean suspendProcessInstances, Date suspensionDate)	Suspends the all process definitions with the given key (= id in the bpmn20.xml file).
void	updateCaseDefinitionHistoryTimeToLive(String caseDefinitionId, Integer historyTimeToLive)	Updates time to live of case definition.
void	updateDecisionDefinitionHistoryTimeToLive(String decisionDefinitionId, Integer historyTimeToLive)	Updates time to live of decision definition.
void	updateProcessDefinitionHistoryTimeToLive(String processDefinitionId, Integer historyTimeToLive)	Updates time to live of process definition.
UpdateProcessDefinitionSuspensionStateSelectBuilder	updateProcessDefinitionSuspensionState()	Activate or suspend process definitions using a fluent builder.

Method Details

createDeployment

DeploymentBuilder createDeployment()

Starts creating a new deployment

createDeployment

ProcessApplicationDeploymentBuilder createDeployment(ProcessApplicationReference processApplication)

Starts creating a new ProcessApplicationDeployment.

See Also:

• ProcessApplicationDeploymentBuilder

deleteDeployment

void deleteDeployment(String deploymentId)

Deletes the given deployment.

Parameters:

deploymentId - id of the deployment, cannot be null.

Throws:

RuntimeException - If there are still runtime or history process instances or jobs.

AuthorizationException - If the user has no Permissions.DELETE permission on Resources.DEPLOYMENT.

deleteDeploymentCascade

@Deprecated
void deleteDeploymentCascade(String deploymentId)

Deprecated.

use deleteDeployment(String, boolean). This methods may be deleted from 5.3.

Deletes the given deployment and cascade deletion to process instances, history process instances and jobs.

Parameters:

deploymentId - id of the deployment, cannot be null.

Throws:

AuthorizationException - If the user has no Permissions.DELETE permission on Resources.DEPLOYMENT.

deleteDeployment

void deleteDeployment(String deploymentId,
 boolean cascade)

Deletes the given deployment and cascade deletion to process instances, history process instances and jobs.

Parameters:

deploymentId - id of the deployment, cannot be null.

Throws:

AuthorizationException - If the user has no Permissions.DELETE permission on Resources.DEPLOYMENT.

deleteDeployment

void deleteDeployment(String deploymentId,
 boolean cascade,
 boolean skipCustomListeners)

Deletes the given deployment and cascade deletion to process instances, history process instances and jobs.

Parameters:

deploymentId - id of the deployment, cannot be null.

cascade - if set to true, all process instances (including) history are deleted

skipCustomListeners - if true, only the built-in ExecutionListeners are notified with the ExecutionListener.EVENTNAME_END event.

Throws:

AuthorizationException - If the user has no Permissions.DELETE permission on Resources.DEPLOYMENT.

deleteDeployment

void deleteDeployment(String deploymentId,
 boolean cascade,
 boolean skipCustomListeners,
 boolean skipIoMappings)

Deletes the given deployment and cascade deletion to process instances, history process instances and jobs.

Parameters:

deploymentId - id of the deployment, cannot be null.

cascade - if set to true, all process instances (including) history are deleted

skipCustomListeners - if true, only the built-in ExecutionListeners are notified with the ExecutionListener.EVENTNAME_END event.

skipIoMappings - specifies whether input/output mappings for tasks should be invoked

Throws:

AuthorizationException - If the user has no Permissions.DELETE permission on Resources.DEPLOYMENT.

deleteProcessDefinition

void deleteProcessDefinition(String processDefinitionId)

Deletes the process definition which belongs to the given process definition id. Same behavior as deleteProcessDefinition(java.lang.String, boolean, boolean) Both boolean parameters of this method are per default false. The deletion is in this case not cascading.

Parameters:

processDefinitionId - the id, which corresponds to the process definition

Throws:

ProcessEngineException - If the process definition does not exist

AuthorizationException - If the user has no Permissions.DELETE permission on Resources.PROCESS_DEFINITION.

See Also:

• deleteProcessDefinition(java.lang.String, boolean, boolean)

deleteProcessDefinition

void deleteProcessDefinition(String processDefinitionId,
 boolean cascade)

Deletes the process definition which belongs to the given process definition id. Cascades the deletion if the cascade is set to true. Same behavior as deleteProcessDefinition(java.lang.String, boolean, boolean) The skipCustomListeners parameter is per default false. The custom listeners are called if the cascading flag is set to true and the process instances are deleted.

Parameters:

processDefinitionId - the id, which corresponds to the process definition

cascade - if set to true, all process instances (including) history are deleted

Throws:

ProcessEngineException - If the process definition does not exist

AuthorizationException - If the user has no Permissions.DELETE permission on Resources.PROCESS_DEFINITION.

See Also:

• deleteProcessDefinition(java.lang.String, boolean, boolean)

deleteProcessDefinition

void deleteProcessDefinition(String processDefinitionId,
 boolean cascade,
 boolean skipCustomListeners)

Deletes the process definition which belongs to the given process definition id. Cascades the deletion if the cascade is set to true the custom listener can be skipped if the third parameter is set to true.

Parameters:

processDefinitionId - the id, which corresponds to the process definition

cascade - if set to true, all process instances (including) history are deleted

skipCustomListeners - if true, only the built-in ExecutionListeners are notified with the ExecutionListener.EVENTNAME_END event. Is only used if cascade set to true.

Throws:

ProcessEngineException - If the process definition does not exist

AuthorizationException - If the user has no Permissions.DELETE permission on Resources.PROCESS_DEFINITION.

deleteProcessDefinition

void deleteProcessDefinition(String processDefinitionId,
 boolean cascade,
 boolean skipCustomListeners,
 boolean skipIoMappings)

Deletes the process definition which belongs to the given process definition id. Cascades the deletion if the cascade is set to true, the custom listener can be skipped if the third parameter is set to true, io mappings can be skipped if the forth parameter is set to true.

Parameters:

processDefinitionId - the id, which corresponds to the process definition

cascade - if set to true, all process instances (including) history are deleted

skipCustomListeners - if true, only the built-in ExecutionListeners are notified with the ExecutionListener.EVENTNAME_END event. Is only used if cascade set to true.

skipIoMappings - Specifies whether input/output mappings for tasks should be invoked

Throws:

ProcessEngineException - If the process definition does not exist

AuthorizationException - If the user has no Permissions.DELETE permission on Resources.PROCESS_DEFINITION.

deleteProcessDefinitions

DeleteProcessDefinitionsSelectBuilder deleteProcessDefinitions()

Fluent builder to delete process definitions.

Returns:

the builder to delete process definitions

getDeploymentResourceNames

List<String> getDeploymentResourceNames(String deploymentId)

Retrieves a list of deployment resource names for the given deployment, ordered alphabetically.

Parameters:

deploymentId - id of the deployment, cannot be null.

Throws:

AuthorizationException - If the user has no Permissions.READ permission on Resources.DEPLOYMENT.

getDeploymentResources

List<Resource> getDeploymentResources(String deploymentId)

Retrieves a list of deployment resources for the given deployment, ordered alphabetically by name.

Parameters:

deploymentId - id of the deployment, cannot be null.

Throws:

AuthorizationException - If the user has no Permissions.READ permission on Resources.DEPLOYMENT.

getResourceAsStream

InputStream getResourceAsStream(String deploymentId,
 String resourceName)

Gives access to a deployment resource through a stream of bytes.

Parameters:

deploymentId - id of the deployment, cannot be null.

resourceName - name of the resource, cannot be null.

Throws:

ProcessEngineException - When the resource doesn't exist in the given deployment or when no deployment exists for the given deploymentId.

AuthorizationException - If the user has no Permissions.READ permission on Resources.DEPLOYMENT.

getResourceAsStreamById

InputStream getResourceAsStreamById(String deploymentId,
 String resourceId)

Gives access to a deployment resource through a stream of bytes.

Parameters:

deploymentId - id of the deployment, cannot be null.

resourceId - id of the resource, cannot be null.

Throws:

ProcessEngineException - When the resource doesn't exist in the given deployment or when no deployment exists for the given deploymentId.

AuthorizationException - If the user has no Permissions.READ permission on Resources.DEPLOYMENT.

createProcessDefinitionQuery

ProcessDefinitionQuery createProcessDefinitionQuery()

Query process definitions.

createCaseDefinitionQuery

CaseDefinitionQuery createCaseDefinitionQuery()

Query case definitions.

createDecisionDefinitionQuery

DecisionDefinitionQuery createDecisionDefinitionQuery()

Query decision definitions.

createDecisionRequirementsDefinitionQuery

DecisionRequirementsDefinitionQuery createDecisionRequirementsDefinitionQuery()

Query decision requirements definition.

createDeploymentQuery

DeploymentQuery createDeploymentQuery()

Query process definitions.

suspendProcessDefinitionById

void suspendProcessDefinitionById(String processDefinitionId)

Suspends the process definition with the given id. If a process definition is in state suspended, it will not be possible to start new process instances based on the process definition. Note: all the process instances of the process definition will still be active (ie. not suspended)!

Note: for more complex suspend commands use updateProcessDefinitionSuspensionState().

Throws:

ProcessEngineException - If no such processDefinition can be found.

AuthorizationException - If the user has none of the following:

ProcessDefinitionPermissions.SUSPEND permission on Resources.PROCESS_DEFINITION

Permissions.UPDATE permission on Resources.PROCESS_DEFINITION

suspendProcessDefinitionById

void suspendProcessDefinitionById(String processDefinitionId,
 boolean suspendProcessInstances,
 Date suspensionDate)

Suspends the process definition with the given id. If a process definition is in state suspended, it will not be possible to start new process instances based on the process definition.

Note: for more complex suspend commands use updateProcessDefinitionSuspensionState().

Parameters:

suspendProcessInstances - If true, all the process instances of the provided process definition will be suspended too.

suspensionDate - The date on which the process definition will be suspended. If null, the process definition is suspended immediately. Note: The job executor needs to be active to use this!

Throws:

ProcessEngineException - If no such processDefinition can be found.

AuthorizationException -

If the user has no Permissions.UPDATE permission on Resources.PROCESS_DEFINITION.

and if suspendProcessInstances is set to true and the user has none of the following:

• ProcessInstancePermissions.SUSPEND permission on Resources.PROCESS_INSTANCE
• ProcessDefinitionPermissions.SUSPEND_INSTANCE permission on Resources.PROCESS_DEFINITION
• Permissions.UPDATE permission on Resources.PROCESS_INSTANCE
• Permissions.UPDATE_INSTANCE permission on Resources.PROCESS_DEFINITION

See Also:

• RuntimeService.suspendProcessInstanceById(String)

suspendProcessDefinitionByKey

void suspendProcessDefinitionByKey(String processDefinitionKey)

Suspends the all process definitions with the given key (= id in the bpmn20.xml file). If a process definition is in state suspended, it will not be possible to start new process instances based on the process definition. Note: all the process instances of the process definition will still be active (ie. not suspended)!

Note: for more complex suspend commands use updateProcessDefinitionSuspensionState().

Throws:

ProcessEngineException - If no such processDefinition can be found.

AuthorizationException - If the user has none of the following:

ProcessDefinitionPermissions.SUSPEND permission on Resources.PROCESS_DEFINITION

Permissions.UPDATE permission on Resources.PROCESS_DEFINITION

suspendProcessDefinitionByKey

void suspendProcessDefinitionByKey(String processDefinitionKey,
 boolean suspendProcessInstances,
 Date suspensionDate)

Suspends the all process definitions with the given key (= id in the bpmn20.xml file). If a process definition is in state suspended, it will not be possible to start new process instances based on the process definition.

Note: for more complex suspend commands use updateProcessDefinitionSuspensionState().

Parameters:

suspendProcessInstances - If true, all the process instances of the provided process definition will be suspended too.

suspensionDate - The date on which the process definition will be suspended. If null, the process definition is suspended immediately. Note: The job executor needs to be active to use this!

Throws:

ProcessEngineException - If no such processDefinition can be found.

AuthorizationException -

If the user has no Permissions.UPDATE permission on Resources.PROCESS_DEFINITION.

and if suspendProcessInstances is set to true and the user has none of the following:

• ProcessInstancePermissions.SUSPEND permission on Resources.PROCESS_INSTANCE
• ProcessDefinitionPermissions.SUSPEND_INSTANCE permission on Resources.PROCESS_DEFINITION
• Permissions.UPDATE permission on Resources.PROCESS_INSTANCE
• Permissions.UPDATE_INSTANCE permission on Resources.PROCESS_DEFINITION

See Also:

• RuntimeService.suspendProcessInstanceById(String)

activateProcessDefinitionById

void activateProcessDefinitionById(String processDefinitionId)

Activates the process definition with the given id.

Note: for more complex activate commands use updateProcessDefinitionSuspensionState().

Throws:

ProcessEngineException - If no such processDefinition can be found or if the process definition is already in state active.

AuthorizationException - If the user has none of the following:

ProcessDefinitionPermissions.SUSPEND permission on Resources.PROCESS_DEFINITION

Permissions.UPDATE permission on Resources.PROCESS_DEFINITION

activateProcessDefinitionById

void activateProcessDefinitionById(String processDefinitionId,
 boolean activateProcessInstances,
 Date activationDate)

Activates the process definition with the given id.

Note: for more complex activate commands use updateProcessDefinitionSuspensionState().

Parameters:

suspendProcessInstances - If true, all the process instances of the provided process definition will be activated too.

activationDate - The date on which the process definition will be activated. If null, the process definition is suspended immediately. Note: The job executor needs to be active to use this!

Throws:

ProcessEngineException - If no such processDefinition can be found.

AuthorizationException -

If the user has no Permissions.UPDATE permission on Resources.PROCESS_DEFINITION.

and if suspendProcessInstances is set to true and the user has none of the following:

• ProcessInstancePermissions.SUSPEND permission on Resources.PROCESS_INSTANCE
• ProcessDefinitionPermissions.SUSPEND_INSTANCE permission on Resources.PROCESS_DEFINITION
• Permissions.UPDATE permission on Resources.PROCESS_INSTANCE
• Permissions.UPDATE_INSTANCE permission on Resources.PROCESS_DEFINITION

See Also:

• RuntimeService.activateProcessInstanceById(String)

activateProcessDefinitionByKey

void activateProcessDefinitionByKey(String processDefinitionKey)

Activates the process definition with the given key (=id in the bpmn20.xml file).

Note: for more complex activate commands use updateProcessDefinitionSuspensionState().

Throws:

ProcessEngineException - If no such processDefinition can be found.

AuthorizationException - If the user has none of the following:

ProcessDefinitionPermissions.SUSPEND permission on Resources.PROCESS_DEFINITION

Permissions.UPDATE permission on Resources.PROCESS_DEFINITION

activateProcessDefinitionByKey

void activateProcessDefinitionByKey(String processDefinitionKey,
 boolean activateProcessInstances,
 Date activationDate)

Activates the process definition with the given key (=id in the bpmn20.xml file).

Note: for more complex activate commands use updateProcessDefinitionSuspensionState().

Parameters:

suspendProcessInstances - If true, all the process instances of the provided process definition will be activated too.

activationDate - The date on which the process definition will be activated. If null, the process definition is suspended immediately. Note: The job executor needs to be active to use this!

Throws:

ProcessEngineException - If no such processDefinition can be found.

AuthorizationException -

If the user has no Permissions.UPDATE permission on Resources.PROCESS_DEFINITION.

and if suspendProcessInstances is set to true and the user has none of the following:

• ProcessInstancePermissions.SUSPEND permission on Resources.PROCESS_INSTANCE
• ProcessDefinitionPermissions.SUSPEND_INSTANCE permission on Resources.PROCESS_DEFINITION
• Permissions.UPDATE permission on Resources.PROCESS_INSTANCE
• Permissions.UPDATE_INSTANCE permission on Resources.PROCESS_DEFINITION

See Also:

• RuntimeService.activateProcessInstanceById(String)

updateProcessDefinitionSuspensionState

UpdateProcessDefinitionSuspensionStateSelectBuilder updateProcessDefinitionSuspensionState()

Activate or suspend process definitions using a fluent builder. Specify the definitions by calling one of the by methods, like byProcessDefinitionId. To update the suspension state call UpdateProcessDefinitionSuspensionStateBuilder.activate() or UpdateProcessDefinitionSuspensionStateBuilder.suspend().

Returns:

the builder to update the suspension state

updateProcessDefinitionHistoryTimeToLive

void updateProcessDefinitionHistoryTimeToLive(String processDefinitionId,
 Integer historyTimeToLive)

Updates time to live of process definition. The field is used within history cleanup process.

Parameters:

processDefinitionId - The id of the process definition to update

historyTimeToLive - the value of history time to live to update

Throws:

AuthorizationException - If the user has no Permissions.UPDATE permission on Resources.PROCESS_DEFINITION.

NotAllowedException - in case feature flag enforceHistoryTimeToLive is set to true and the given historyTimeToLive value is null.

updateDecisionDefinitionHistoryTimeToLive

void updateDecisionDefinitionHistoryTimeToLive(String decisionDefinitionId,
 Integer historyTimeToLive)

Updates time to live of decision definition. The field is used within history cleanup process.

Parameters:

decisionDefinitionId - The id of the decision definition to update

historyTimeToLive - the value of history time to live to update

Throws:

AuthorizationException - If the user has no Permissions.UPDATE permission on Resources.DECISION_DEFINITION.

NotAllowedException - in case feature flag enforceHistoryTimeToLive is set to true and the given historyTimeToLive value is null.

updateCaseDefinitionHistoryTimeToLive

void updateCaseDefinitionHistoryTimeToLive(String caseDefinitionId,
 Integer historyTimeToLive)

Updates time to live of case definition. The field is used within history cleanup process.

Parameters:

caseDefinitionId - The given case definition id to update

historyTimeToLive - the value of history time to live to update

Throws:

NotAllowedException - in case feature flag enforceHistoryTimeToLive is set to true and the given historyTimeToLive value is null.

getProcessModel

InputStream getProcessModel(String processDefinitionId)

Gives access to a deployed process model, e.g., a BPMN 2.0 XML file, through a stream of bytes.

Parameters:

processDefinitionId - id of a ProcessDefinition, cannot be null.

Throws:

NotFoundException - when the process model doesn't exist.

AuthorizationException - If the user has no Permissions.READ permission on Resources.PROCESS_DEFINITION.

getProcessDiagram

InputStream getProcessDiagram(String processDefinitionId)

Gives access to a deployed process diagram, e.g., a PNG image, through a stream of bytes.

Parameters:

processDefinitionId - id of a ProcessDefinition, cannot be null.

Returns:

null when the diagram resource name of a ProcessDefinition is null.

Throws:

ProcessEngineException - when the process diagram doesn't exist.

AuthorizationException - If the user has no Permissions.READ permission on Resources.PROCESS_DEFINITION.

getProcessDefinition

ProcessDefinition getProcessDefinition(String processDefinitionId)

Returns the ProcessDefinition including all BPMN information like additional Properties (e.g. documentation).

Throws:

AuthorizationException - If the user has no Permissions.READ permission on Resources.PROCESS_DEFINITION.

getProcessDiagramLayout

DiagramLayout getProcessDiagramLayout(String processDefinitionId)

Provides positions and dimensions of elements in a process diagram as provided by getProcessDiagram(String). This method requires a process model and a diagram image to be deployed.

Parameters:

processDefinitionId - id of a ProcessDefinition, cannot be null.

Returns:

Map with process element ids as keys and positions and dimensions as values.

Throws:

ProcessEngineException - When the process model or diagram doesn't exist.

AuthorizationException - If the user has no Permissions.READ permission on Resources.PROCESS_DEFINITION.

getBpmnModelInstance

BpmnModelInstance getBpmnModelInstance(String processDefinitionId)

Returns the BpmnModelInstance for the given processDefinitionId.

Parameters:

processDefinitionId - the id of the Process Definition for which the BpmnModelInstance should be retrieved.

Returns:

the BpmnModelInstance

Throws:

AuthorizationException - If the user has no Permissions.READ permission on Resources.PROCESS_DEFINITION.

getCmmnModelInstance

CmmnModelInstance getCmmnModelInstance(String caseDefinitionId)

Returns the CmmnModelInstance for the given caseDefinitionId.

Parameters:

caseDefinitionId - the id of the Case Definition for which the CmmnModelInstance should be retrieved.

Returns:

the CmmnModelInstance

Throws:

NotValidException - when the given case definition id or deployment id or resource name is null

NotFoundException - when no CMMN model instance or deployment resource is found for the given case definition id

ProcessEngineException - when an internal exception happens during the execution of the command.

getDmnModelInstance

DmnModelInstance getDmnModelInstance(String decisionDefinitionId)

Returns the DmnModelInstance for the given decisionDefinitionId.

Parameters:

decisionDefinitionId - the id of the Decision Definition for which the DmnModelInstance should be retrieved.

Returns:

the DmnModelInstance

Throws:

NotValidException - when the given decision definition id or deployment id or resource name is null

NotFoundException - when no DMN model instance or deployment resource is found for the given decision definition id

ProcessEngineException - when an internal exception happens during the execution of the command.

AuthorizationException - If the user has no Permissions.READ permission on Resources.DECISION_DEFINITION.

addCandidateStarterUser

@Deprecated
void addCandidateStarterUser(String processDefinitionId,
 String userId)

Deprecated.

Use authorization mechanism instead.

Authorizes a candidate user for a process definition.

Parameters:

processDefinitionId - id of the process definition, cannot be null.

userId - id of the user involve, cannot be null.

Throws:

ProcessEngineException - When the process definition or user doesn't exist.

addCandidateStarterGroup

@Deprecated
void addCandidateStarterGroup(String processDefinitionId,
 String groupId)

Deprecated.

Use authorization mechanism instead.

Authorizes a candidate group for a process definition.

Parameters:

processDefinitionId - id of the process definition, cannot be null.

groupId - id of the group involve, cannot be null.

Throws:

ProcessEngineException - When the process definition or group doesn't exist.

deleteCandidateStarterUser

@Deprecated
void deleteCandidateStarterUser(String processDefinitionId,
 String userId)

Deprecated.

Use authorization mechanism instead.

Removes the authorization of a candidate user for a process definition.

Parameters:

processDefinitionId - id of the process definition, cannot be null.

userId - id of the user involve, cannot be null.

Throws:

ProcessEngineException - When the process definition or user doesn't exist.

deleteCandidateStarterGroup

@Deprecated
void deleteCandidateStarterGroup(String processDefinitionId,
 String groupId)

Deprecated.

Use authorization mechanism instead.

Removes the authorization of a candidate group for a process definition.

Parameters:

processDefinitionId - id of the process definition, cannot be null.

groupId - id of the group involve, cannot be null.

Throws:

ProcessEngineException - When the process definition or group doesn't exist.

getIdentityLinksForProcessDefinition

@Deprecated
List<IdentityLink> getIdentityLinksForProcessDefinition(String processDefinitionId)

Deprecated.

Use authorization mechanism instead.

Retrieves the IdentityLinks associated with the given process definition. Such an IdentityLink informs how a certain identity (eg. group or user) is authorized for a certain process definition

getCaseDefinition

CaseDefinition getCaseDefinition(String caseDefinitionId)

Returns the CaseDefinition.

Throws:

NotValidException - when the given case definition id is null

NotFoundException - when no case definition is found for the given case definition id

ProcessEngineException - when an internal exception happens during the execution of the command.

getCaseModel

InputStream getCaseModel(String caseDefinitionId)

Gives access to a deployed case model, e.g., a CMMN 1.0 XML file, through a stream of bytes.

Parameters:

caseDefinitionId - id of a CaseDefinition, cannot be null.

Throws:

NotValidException - when the given case definition id or deployment id or resource name is null

NotFoundException - when no case definition or deployment resource is found for the given case definition id

ProcessEngineException - when an internal exception happens during the execution of the command

getCaseDiagram

InputStream getCaseDiagram(String caseDefinitionId)

Gives access to a deployed case diagram, e.g., a PNG image, through a stream of bytes.

Parameters:

caseDefinitionId - id of a CaseDefinition, cannot be null.

Returns:

null when the diagram resource name of a CaseDefinition is null.

Throws:

ProcessEngineException - when the process diagram doesn't exist.

getDecisionDefinition

DecisionDefinition getDecisionDefinition(String decisionDefinitionId)

Returns the DecisionDefinition.

Throws:

NotValidException - when the given decision definition id is null

NotFoundException - when no decision definition is found for the given decision definition id

ProcessEngineException - when an internal exception happens during the execution of the command.

AuthorizationException - If the user has no Permissions.READ permission on Resources.DECISION_DEFINITION.

getDecisionRequirementsDefinition

DecisionRequirementsDefinition getDecisionRequirementsDefinition(String decisionRequirementsDefinitionId)

Returns the DecisionRequirementsDefinition.

Throws:

NotValidException - when the given decision requirements definition id is null

NotFoundException - when no decision requirements definition is found for the given decision requirements definition id

ProcessEngineException - when an internal exception happens during the execution of the command.

AuthorizationException - If the user has no Permissions.READ permission on Resources.DECISION_REQUIREMENTS_DEFINITION.

getDecisionModel

InputStream getDecisionModel(String decisionDefinitionId)

Gives access to a deployed decision model, e.g., a DMN 1.1 XML file, through a stream of bytes.

Parameters:

decisionDefinitionId - id of a DecisionDefinition, cannot be null.

Throws:

NotValidException - when the given decision definition id or deployment id or resource name is null

NotFoundException - when no decision definition or deployment resource is found for the given decision definition id

ProcessEngineException - when an internal exception happens during the execution of the command

AuthorizationException - If the user has no Permissions.READ permission on Resources.DECISION_DEFINITION.

getDecisionRequirementsModel

InputStream getDecisionRequirementsModel(String decisionRequirementsDefinitionId)

Gives access to a deployed decision requirements model, e.g., a DMN 1.1 XML file, through a stream of bytes.

Parameters:

decisionRequirementsDefinitionId - id of a DecisionRequirementsDefinition, cannot be null.

Throws:

NotValidException - when the given decision requirements definition id or deployment id or resource name is null

NotFoundException - when no decision requirements definition or deployment resource is found for the given decision requirements definition id

ProcessEngineException - when an internal exception happens during the execution of the command

AuthorizationException - If the user has no Permissions.READ permission on Resources.DECISION_REQUIREMENTS_DEFINITION.

getDecisionDiagram

InputStream getDecisionDiagram(String decisionDefinitionId)

Gives access to a deployed decision diagram, e.g., a PNG image, through a stream of bytes.

Parameters:

decisionDefinitionId - id of a DecisionDefinition, cannot be null.

Returns:

null when the diagram resource name of a DecisionDefinition is null.

Throws:

ProcessEngineException - when the decision diagram doesn't exist.

AuthorizationException - If the user has no Permissions.READ permission on Resources.DECISION_DEFINITION.

getDecisionRequirementsDiagram

InputStream getDecisionRequirementsDiagram(String decisionRequirementsDefinitionId)

Gives access to a deployed decision requirements diagram, e.g., a PNG image, through a stream of bytes.

Parameters:

decisionRequirementsDefinitionId - id of a DecisionRequirementsDefinition, cannot be null.

Returns:

null when the diagram resource name of a DecisionRequirementsDefinition is null.

Throws:

ProcessEngineException - when the decision requirements diagram doesn't exist.

AuthorizationException - If the user has no Permissions.READ permission on Resources.DECISION_REQUIREMENTS_DEFINITION.

getStaticCalledProcessDefinitions

Collection<CalledProcessDefinition> getStaticCalledProcessDefinitions(String processDefinitionId)

For the given process, returns a list of CalledProcessDefinition. The list contains all processes that are referenced statically by call activities in the given process. This method does not resolve process definitions that are referenced with expressions. Each CalledProcessDefinition contains a list of call activity ids, which specifies the call activities that are calling that process. This method does not resolve references to case definitions.

Parameters:

processDefinitionId - id of a ProcessDefinition

Returns:

a list of CalledProcessDefinition.

Throws:

NotFoundException - When the process definition doesn't exist.

AuthorizationException - If the user has no Permissions.READ permission on Resources.PROCESS_DEFINITION.