org.camunda.bpm.engine.externaltask
Interface LockedExternalTask

All Known Implementing Classes:

LockedExternalTaskImpl

public interface LockedExternalTask

Represents an external task that was fetched and locked.

Author:

Thorben Lindhauer

Method Summary

String	getActivityId()
String	getActivityInstanceId()
String	getErrorDetails()
String	getErrorMessage()
String	getExecutionId()
String	getId()
Date	getLockExpirationTime()
long	getPriority() Returns the priority of the locked external task.
String	getProcessDefinitionId()
String	getProcessDefinitionKey()
String	getProcessInstanceId()
Integer	getRetries()
String	getTenantId()
String	getTopicName()
org.camunda.bpm.engine.variable.VariableMap	getVariables()
String	getWorkerId()

Method Detail

getId

String getId()

Returns:

the id of the task

getTopicName

String getTopicName()

Returns:

the name of the topic the task belongs to

getWorkerId

String getWorkerId()

Returns:

the id of the worker that has locked the task

getLockExpirationTime

Date getLockExpirationTime()

Returns:

the absolute time at which the lock expires

getProcessInstanceId

String getProcessInstanceId()

Returns:

the id of the process instance the task exists in

getExecutionId

String getExecutionId()

Returns:

the id of the execution that the task is assigned to

getActivityId

String getActivityId()

Returns:

the id of the activity for which the task is created

getActivityInstanceId

String getActivityInstanceId()

Returns:

the id of the activity instance in which context the task exists

getProcessDefinitionId

String getProcessDefinitionId()

Returns:

the id of the process definition the task's activity belongs to

getProcessDefinitionKey

String getProcessDefinitionKey()

Returns:

the key of the process definition the task's activity belongs to

getRetries

Integer getRetries()

Returns:

the number of retries left. The number of retries is provided by a task client, therefore the initial value is null.

getErrorMessage

String getErrorMessage()

Returns:

the full error message submitted with the latest reported failure executing this task; null if no failure was reported previously or if no error message was submitted

See Also:

ExternalTaskService.handleFailure(String, String, String, int, long)

getErrorDetails

String getErrorDetails()

Returns:

error details submitted with the latest reported failure executing this task; null if no failure was reported previously or if no error details was submitted

See Also:

ExternalTaskService.handleFailure(String, String, String, String, int, long)

getVariables

org.camunda.bpm.engine.variable.VariableMap getVariables()

Returns:

a map of variables that contains an entry for every variable that was specified at fetching time, if such a variable exists in the task's ancestor execution hierarchy.

getTenantId

String getTenantId()

Returns:

the id of the tenant the task belongs to. Can be null if the task belongs to no single tenant.

getPriority

long getPriority()

Returns the priority of the locked external task. The default priority is 0.

Returns:

the priority of the external task