org.camunda.bpm.engine.runtime

Interface UpdateProcessInstancesSuspensionStateBuilder

All Superinterfaces:

UpdateProcessInstancesRequest, UpdateProcessInstanceSuspensionStateBuilder

All Known Implementing Classes:

UpdateProcessInstancesSuspensionStateBuilderImpl

public interface UpdateProcessInstancesSuspensionStateBuilder
extends UpdateProcessInstanceSuspensionStateBuilder, UpdateProcessInstancesRequest

Method Summary

Modifier and Type	Method and Description
Batch	activateAsync() Activates the provided process instances asynchronously.
Batch	suspendAsync() Suspends the provided process instances asynchronously.

Methods inherited from interface org.camunda.bpm.engine.runtime.UpdateProcessInstanceSuspensionStateBuilder

activate, suspend

Methods inherited from interface org.camunda.bpm.engine.runtime.UpdateProcessInstancesRequest

byHistoricProcessInstanceQuery, byProcessInstanceIds, byProcessInstanceIds, byProcessInstanceQuery

Method Detail

activateAsync

Batch activateAsync()

Activates the provided process instances asynchronously.

If you have a process instance hierarchy, activating one process instance from the hierarchy will not activate other process instances from that hierarchy.

Throws:

BadUserRequestException - If no process Instances are found If a process Instance is set to null

AuthorizationException - if the user has no Permissions.CREATE or BatchPermissions.CREATE_BATCH_UPDATE_PROCESS_INSTANCES_SUSPEND permission on Resources.BATCH.

suspendAsync

Batch suspendAsync()

Suspends the provided process instances asynchronously. This means that the execution is stopped, so the token state will not change. However, actions that do not change token state, like setting/removing variables, etc. will succeed.

Tasks belonging to the suspended process instance will also be suspended. This means that any actions influencing the tasks' lifecycles will fail, such as

• claiming
• completing
• delegation
• changes in task assignees, owners, etc.

Actions that only change task properties will succeed, such as changing variables or adding comments.

If a process instance is in state suspended, the engine will also not execute jobs (timers, messages) associated with this instance.

If you have a process instance hierarchy, suspending one process instance from the hierarchy will not suspend other process instances from that hierarchy.

Throws:

BadUserRequestException - If no process Instances are found If a process Instance is set to null

AuthorizationException - if the user has no Permissions.CREATE or BatchPermissions.CREATE_BATCH_UPDATE_PROCESS_INSTANCES_SUSPEND permission on Resources.BATCH.