pro.taskana

Interface TaskService

All Known Implementing Classes:

TaskServiceImpl

public interface TaskService

The Task Service manages all operations on tasks.

Method Summary

Modifier and Type	Method and Description
Task	claim(String taskId) Claim an existing task for the current user.
Task	claim(String taskId, boolean forceClaim) Claim an existing task for the current user.
Task	completeTask(String taskId) Complete a claimed Task as owner/admin and update State and Timestamps.
Task	completeTask(String taskId, boolean isForced) Complete a claimed Task and update State and Timestamps.
Task	createTask(Task taskToCreate) Persists a not persisted Task which does not exist already.
TaskQuery	createTaskQuery() This method provides a query builder for quering the database.
Task	getTask(String taskId) Get the details of a task by Id without checking permissions.
List<TaskSummary>	getTasksByWorkbasketKeyAndState(String workbasketKey, TaskState taskState) Getting a list of all Task summaries which got matching workbasketIds and states.
List<TaskSummary>	getTaskSummariesByWorkbasketKey(String workbasketKey) Getting a short summary of all tasks in a specific work basket.
Attachment	newAttachment() Returns a not persisted instance of Attachment.
Task	newTask(String workbasketKey) Returns a not persisted instance of Task.
Task	setTaskRead(String taskId, boolean isRead) Marks a task as read.
Task	transfer(String taskId, String workbasketKey) Transfer a task to another work basket.
Task	updateTask(Task task) Update a task.

Method Detail

claim

Task claim(String taskId)
    throws TaskNotFoundException,
           InvalidStateException,
           InvalidOwnerException

Claim an existing task for the current user.

Parameters:

taskId - the id of the task to be claimed

Returns:

claimed Task

Throws:

TaskNotFoundException - if the task with taskId was not found

InvalidStateException - if the state of the task with taskId is not TaskState.READY

InvalidOwnerException - if the task with taskId is claimed by some else

claim

Task claim(String taskId,
           boolean forceClaim)
    throws TaskNotFoundException,
           InvalidStateException,
           InvalidOwnerException

Claim an existing task for the current user. Enable forced claim.

Parameters:

taskId - the id of the task to be claimed

forceClaim - if true, claim is performed even if the task is already claimed by someone else

Returns:

claimed Task

Throws:

TaskNotFoundException - if the task with taskId was not found

InvalidStateException - if the state of the task with taskId is not TaskState.READY

InvalidOwnerException - if the task with taskId is claimed by someone else

completeTask

Task completeTask(String taskId)
           throws TaskNotFoundException,
                  InvalidOwnerException,
                  InvalidStateException

Complete a claimed Task as owner/admin and update State and Timestamps.

Parameters:

taskId - - Id of the Task which should be completed.

Returns:

Task - updated task after completion.

Throws:

InvalidStateException - when Task wasn´t claimed before.

TaskNotFoundException - if the given Task can´t be found in DB.

InvalidOwnerException - if current user is not the task-owner or administrator.

completeTask

Task completeTask(String taskId,
                  boolean isForced)
           throws TaskNotFoundException,
                  InvalidOwnerException,
                  InvalidStateException

Complete a claimed Task and update State and Timestamps.

Parameters:

taskId - - Id of the Task which should be completed.

isForced - - Flag which can complete a Task in every case if Task does exist.

Returns:

Task - updated task after completion.

Throws:

InvalidStateException - when Task wasn´t claimed before.

TaskNotFoundException - if the given Task can´t be found in DB.

InvalidOwnerException - if current user is not the task-owner or administrator.

createTask

Task createTask(Task taskToCreate)
         throws NotAuthorizedException,
                WorkbasketNotFoundException,
                ClassificationNotFoundException,
                TaskAlreadyExistException,
                InvalidWorkbasketException,
                InvalidArgumentException

Persists a not persisted Task which does not exist already.

Parameters:

taskToCreate - the transient task object to be persisted

Returns:

the created and persisted task

Throws:

TaskAlreadyExistException - when the Task does already exist.

NotAuthorizedException - thrown if the current user is not authorized to create that task

WorkbasketNotFoundException - thrown if the work basket referenced by the task is not found

ClassificationNotFoundException - thrown if the Classification referenced by the task is not found

InvalidWorkbasketException - thrown if the referenced Workbasket has missing required properties

InvalidArgumentException - thrown if the primary ObjectReference is invalid

getTask

Task getTask(String taskId)
      throws TaskNotFoundException

Get the details of a task by Id without checking permissions.

Parameters:

taskId - the id of the task

Returns:

the Task

Throws:

TaskNotFoundException - thrown of the Task with taskId is not found

transfer

Task transfer(String taskId,
              String workbasketKey)
       throws TaskNotFoundException,
              WorkbasketNotFoundException,
              NotAuthorizedException,
              InvalidWorkbasketException

Transfer a task to another work basket. The transfer sets the transferred flag and resets the read flag.

Parameters:

taskId - The id of the Task to be transferred

workbasketKey - The key of the target work basket

Returns:

the transferred task

Throws:

TaskNotFoundException - Thrown if the Task with taskId was not found.

WorkbasketNotFoundException - Thrown if the target work basket was not found.

NotAuthorizedException - Thrown if the current user is not authorized to transfer this Task to the target work basket

InvalidWorkbasketException - Thrown if either the source or the target workbasket has a missing required property

setTaskRead

Task setTaskRead(String taskId,
                 boolean isRead)
          throws TaskNotFoundException

Marks a task as read.

Parameters:

taskId - the id of the task to be updated

isRead - the new status of the read flag.

Returns:

the updated Task

Throws:

TaskNotFoundException - Thrown if the Task with taskId was not found

createTaskQuery

TaskQuery createTaskQuery()

This method provides a query builder for quering the database.

Returns:

a TaskQuery

getTasksByWorkbasketKeyAndState

List<TaskSummary> getTasksByWorkbasketKeyAndState(String workbasketKey,
                                                  TaskState taskState)
                                           throws WorkbasketNotFoundException,
                                                  NotAuthorizedException,
                                                  ClassificationNotFoundException

Getting a list of all Task summaries which got matching workbasketIds and states.

Parameters:

workbasketKey - the key of the workbasket where the tasks need to be in.

taskState - which is required for the request,

Returns:

a filled/empty list of tasks with attributes which are matching given params.

Throws:

WorkbasketNotFoundException - if the workbasketId can´t be resolved to a existing work basket.

NotAuthorizedException - if the current user got no rights for reading on this work basket.

ClassificationNotFoundException - if a single Classification can not be found for a task which is returned

getTaskSummariesByWorkbasketKey

List<TaskSummary> getTaskSummariesByWorkbasketKey(String workbasketKey)
                                           throws WorkbasketNotFoundException,
                                                  NotAuthorizedException

Getting a short summary of all tasks in a specific work basket.

Parameters:

workbasketKey - Key of work basket where tasks are located.

Returns:

TaskSummaryList with all TaskSummaries of a work basket

Throws:

WorkbasketNotFoundException - if a Work basket can´t be located.

NotAuthorizedException - if the current user got no rights for reading on this work basket.

newTask

Task newTask(String workbasketKey)

Returns a not persisted instance of Task.

Parameters:

workbasketKey - the key of the workbasket to which the task belongs

Returns:

an empty new Task

newAttachment

Attachment newAttachment()

Returns a not persisted instance of Attachment.

Returns:

an empty new Attachment

updateTask

Task updateTask(Task task)
         throws InvalidArgumentException,
                TaskNotFoundException,
                ConcurrencyException,
                WorkbasketNotFoundException,
                ClassificationNotFoundException,
                InvalidWorkbasketException,
                NotAuthorizedException,
                AttachmentPersistenceException

Update a task.

Parameters:

task - the task to be updated in the database

Returns:

the updated task

Throws:

InvalidArgumentException - if the task to be updated contains invalid properties like e.g. invalid object references

TaskNotFoundException - if the id of the task is not found in the database

ConcurrencyException - if the task has already been updated by another user

InvalidWorkbasketException - if the updated task refers to a workbasket that has missing required properties

ClassificationNotFoundException - if the updated task refers to a classification that cannot be found

WorkbasketNotFoundException - if the updated task refers to a work basket that cannot be found

NotAuthorizedException - if the current user is not authorized to update the task

AttachmentPersistenceException - if an Attachment with ID will be added multiple times without using the task-methods.