org.camunda.bpm.engine.runtime
Interface SignalEventReceivedBuilder

All Known Implementing Classes:

SignalEventReceivedBuilderImpl

public interface SignalEventReceivedBuilder

Fluent builder to notify the process engine that a signal event has been received.

Method Summary

SignalEventReceivedBuilder	executionId(String executionId) Specify a single execution to deliver the signal to.
void	send() Delivers the signal to waiting executions and process definitions.
SignalEventReceivedBuilder	setVariables(Map<String,Object> variables) Add the given variables to the triggered executions.
SignalEventReceivedBuilder	tenantId(String tenantId) Specify a tenant to deliver the signal to.
SignalEventReceivedBuilder	withoutTenantId() Specify that the signal can only be received on executions or process definitions which belongs to no tenant.

Method Detail

setVariables

SignalEventReceivedBuilder setVariables(Map<String,Object> variables)

Add the given variables to the triggered executions.

Parameters:

variables - a map of variables added to the executions

Returns:

the builder

executionId

SignalEventReceivedBuilder executionId(String executionId)

Specify a single execution to deliver the signal to.

Parameters:

executionId - the id of the process instance or the execution to deliver the signal to

Returns:

the builder

tenantId

SignalEventReceivedBuilder tenantId(String tenantId)

Specify a tenant to deliver the signal to. The signal can only be received on executions or process definitions which belongs to the given tenant. Cannot be used in combination with executionId(String).

Parameters:

tenantId - the id of the tenant

Returns:

the builder

withoutTenantId

SignalEventReceivedBuilder withoutTenantId()

Specify that the signal can only be received on executions or process definitions which belongs to no tenant. Cannot be used in combination with executionId(String).

Returns:

the builder

send

void send()

Delivers the signal to waiting executions and process definitions. The notification and instantiation happen synchronously.

Note that the signal delivers to all tenants if no tenant is specified using tenantId(String) or withoutTenantId().

Throws:

ProcessEngineException - if a single execution is specified and no such execution exists or has not subscribed to the signal

AuthorizationException -

if notify an execution and the user has no Permissions.UPDATE permission on Resources.PROCESS_INSTANCE or no Permissions.UPDATE_INSTANCE permission on Resources.PROCESS_DEFINITION.

if start a new process instance and the user has no Permissions.CREATE permission on Resources.PROCESS_INSTANCE and no Permissions.CREATE_INSTANCE permission on Resources.PROCESS_DEFINITION.