Package pro.taskana.task.internal

Class TaskServiceImpl

java.lang.Object

pro.taskana.task.internal.TaskServiceImpl

All Implemented Interfaces:

TaskService

public class TaskServiceImpl
extends Object
implements TaskService

This is the implementation of TaskService.

Constructor Summary

Constructors

Constructor	Description
TaskServiceImpl(InternalTaskanaEngine taskanaEngine, TaskMapper taskMapper, TaskCommentMapper taskCommentMapper, AttachmentMapper attachmentMapper)

Method Summary

Modifier and Type	Method	Description
Task	cancelClaim(String taskId)	Cancel the claim of an existing task if it was claimed by the current user before.
Task	cancelTask(String taskId)	Cancels a task.
Task	claim(String taskId)	Claim an existing task for the current user.
Task	completeTask(String taskId)	Complete a claimed Task as owner/admin and update State and Timestamps.
BulkOperationResults<String,TaskanaException>	completeTasks(List<String> taskIds)	Completes a list of tasks.
Task	createTask(Task taskToCreate)	Inserts a not existing Task.
TaskComment	createTaskComment(TaskComment taskComment)	Create a task comment.
TaskQuery	createTaskQuery()	This method provides a query builder for quering the database.
void	deleteTask(String taskId)	Deletes the task with the given Id.
void	deleteTaskComment(String taskCommentId)	Deletes the task comment with the given Id.
BulkOperationResults<String,TaskanaException>	deleteTasks(List<String> taskIds)	Deletes a list of tasks.
List<String>	findTasksIdsAffectedByClassificationChange(String classificationId)
Task	forceCancelClaim(String taskId)	Cancel the claim of an existing task even if it was claimed by another user.
Task	forceClaim(String taskId)	Claim an existing task for the current user even if it is already claimed by someone else.
Task	forceCompleteTask(String taskId)	Completes a Task and updates State and Timestamps in every case if the Task exists.
BulkOperationResults<String,TaskanaException>	forceCompleteTasks(List<String> taskIds)	Completes a list of tasks.
void	forceDeleteTask(String taskId)	Deletes the task with the given Id even if it is not completed.
Task	getTask(String id)	Gets the details of a task by Id without checking permissions.
TaskComment	getTaskComment(String taskCommentid)	Retrieves a task comment for a given taskCommentId.
List<TaskComment>	getTaskComments(String taskId)	Retrieves a list of task comments for a given taskId.
Attachment	newAttachment()	Returns a not inserted instance of Attachment.
Task	newTask()	Returns a not inserted instance of Task.
Task	newTask(String workbasketId)	Returns a not inserted instance of Task.
Task	newTask(String workbasketKey, String domain)	Returns a not inserted instance of Task.
TaskComment	newTaskComment(String taskId)	Returns a not inserted instance of TaskComment.
void	refreshPriorityAndDueDatesOfTasksOnClassificationUpdate(List<String> taskIds, boolean serviceLevelChanged, boolean priorityChanged)
Task	selectAndClaim(TaskQuery taskQuery)	Selects and claims the first task which is returned by the task query.
BulkOperationResults<String,TaskanaException>	setCallbackStateForTasks(List<String> externalIds, CallbackState state)	Sets the callback state on a list of tasks.
BulkOperationResults<String,TaskanaException>	setOwnerOfTasks(String owner, List<String> argTaskIds)	Sets the owner on a list of tasks.
BulkOperationResults<String,TaskanaException>	setPlannedPropertyOfTasks(Instant planned, List<String> argTaskIds)	Sets the planned property on a list of tasks.
Task	setTaskRead(String taskId, boolean isRead)	Marks a task as read.
Task	terminateTask(String taskId)	Terminates a task.
Task	transfer(String taskId, String destinationWorkbasketId, boolean setTransferFlag)	Transfers a Task to another Workbasket.
Task	transfer(String taskId, String workbasketKey, String domain, boolean setTransferFlag)	Transfers a Task to another Workbasket.
BulkOperationResults<String,TaskanaException>	transferTasks(String destinationWorkbasketKey, String destinationWorkbasketDomain, List<String> taskIds, boolean setTransferFlag)	Transfers a list of Tasks to another Workbasket.
BulkOperationResults<String,TaskanaException>	transferTasks(String destinationWorkbasketId, List<String> taskIds, boolean setTransferFlag)	Transfers a list of Tasks to another Workbasket.
Task	updateTask(Task task)	Update a task.
TaskComment	updateTaskComment(TaskComment taskComment)	Update a task comment.
List<String>	updateTasks(List<String> taskIds, Map<TaskCustomField,String> customFieldsToUpdate)	Updates tasks with matching taskIds.
List<String>	updateTasks(ObjectReference selectionCriteria, Map<TaskCustomField,String> customFieldsToUpdate)	Updates tasks with a matching ObjectReference.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface pro.taskana.task.api.TaskService

transfer, transfer, transferTasks, transferTasks

Constructor Detail

TaskServiceImpl

public TaskServiceImpl(InternalTaskanaEngine taskanaEngine,
                       TaskMapper taskMapper,
                       TaskCommentMapper taskCommentMapper,
                       AttachmentMapper attachmentMapper)

Method Detail

claim

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

Description copied from interface: TaskService

Claim an existing task for the current user.

Specified by:

claim in interface TaskService

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 READY

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

NotAuthorizedException - if the current user has no read permission for the workbasket the task is in

forceClaim

public Task forceClaim(String taskId)
                throws TaskNotFoundException,
                       InvalidStateException,
                       InvalidOwnerException,
                       NotAuthorizedException

Description copied from interface: TaskService

Claim an existing task for the current user even if it is already claimed by someone else.

Specified by:

forceClaim in interface TaskService

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 READY

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

NotAuthorizedException - if the current user has no read permission for the workbasket the task is in

cancelClaim

public Task cancelClaim(String taskId)
                 throws TaskNotFoundException,
                        InvalidStateException,
                        InvalidOwnerException,
                        NotAuthorizedException

Description copied from interface: TaskService

Cancel the claim of an existing task if it was claimed by the current user before.

Specified by:

cancelClaim in interface TaskService

Parameters:

taskId - id of the task which should be unclaimed.

Returns:

updated unclaimed task

Throws:

TaskNotFoundException - if the task can´t be found or does not exist

InvalidStateException - if the task is already in an end state.

InvalidOwnerException - if the task is claimed by another user.

NotAuthorizedException - if the current user has no read permission for the workbasket the task is in

forceCancelClaim

public Task forceCancelClaim(String taskId)
                      throws TaskNotFoundException,
                             InvalidStateException,
                             InvalidOwnerException,
                             NotAuthorizedException

Description copied from interface: TaskService

Cancel the claim of an existing task even if it was claimed by another user.

Specified by:

forceCancelClaim in interface TaskService

Parameters:

taskId - id of the task which should be unclaimed.

Returns:

updated unclaimed task

Throws:

TaskNotFoundException - if the task can´t be found or does not exist

InvalidStateException - if the task is already in an end state.

InvalidOwnerException - if forceCancel is false and the task is claimed by another user.

NotAuthorizedException - if the current user has no read permission for the workbasket the task is in

completeTask

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

Description copied from interface: TaskService

Complete a claimed Task as owner/admin and update State and Timestamps. If task is already completed, the task is returned as itself.

Specified by:

completeTask in interface TaskService

Parameters:

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

Returns:

Task - updated task after completion.

Throws:

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

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

InvalidStateException - if Task wasn´t claimed before.

NotAuthorizedException - if the current user has no read permission for the workbasket the task is in

forceCompleteTask

public Task forceCompleteTask(String taskId)
                       throws TaskNotFoundException,
                              InvalidOwnerException,
                              InvalidStateException,
                              NotAuthorizedException

Description copied from interface: TaskService

Completes a Task and updates State and Timestamps in every case if the Task exists. If task is already completed, the task is returned as itself.

Specified by:

forceCompleteTask in interface TaskService

Parameters:

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

Returns:

Task - updated task after completion.

Throws:

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

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

InvalidStateException - if Task wasn´t claimed before.

NotAuthorizedException - if the current user has no read permission for the workbasket the task is in

createTask

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

Description copied from interface: TaskService

Inserts a not existing Task.
The default values of the created Task are:

• id - generated by IdGenerator
• externalId - generated by IdGenerator
• businessProcessId - generated by IdGenerator
• name - name of its Classification
• description - description of its Classification
• creator - id of current user
• state - 'READY'
• isRead - false
• isTransferred - false

Specified by:

createTask in interface TaskService

Parameters:

taskToCreate - the transient task object to be inserted

Returns:

the created and inserted task

Throws:

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

WorkbasketNotFoundException - thrown if the workbasket referenced by the task is not found

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

TaskAlreadyExistException - if the Task does already exist.

InvalidArgumentException - thrown if the primary ObjectReference is invalid

getTask

public Task getTask(String id)
             throws NotAuthorizedException,
                    TaskNotFoundException

Description copied from interface: TaskService

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

Specified by:

getTask in interface TaskService

Parameters:

id - the id of the task

Returns:

the Task

Throws:

NotAuthorizedException - if the current user has no READ permission for the workbasket the task is in.

TaskNotFoundException - thrown of the Task with taskId is not found

transfer

public Task transfer(String taskId,
                     String destinationWorkbasketId,
                     boolean setTransferFlag)
              throws TaskNotFoundException,
                     WorkbasketNotFoundException,
                     NotAuthorizedException,
                     InvalidStateException

Description copied from interface: TaskService

Transfers a Task to another Workbasket.

The transfer resets the read flag and sets the transfer flag if setTransferFlag is true.

Specified by:

transfer in interface TaskService

Parameters:

taskId - the id of the Task which should be transferred

destinationWorkbasketId - the id of the target Workbasket

setTransferFlag - the control about whether to set the TaskSummary.isTransferred() flag or not

Returns:

the transferred Task

Throws:

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

WorkbasketNotFoundException - Thrown if the target Workbasket was not found.

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

InvalidStateException - Thrown if the Task is in a state which does not allow transferring

transfer

public Task transfer(String taskId,
                     String workbasketKey,
                     String domain,
                     boolean setTransferFlag)
              throws TaskNotFoundException,
                     WorkbasketNotFoundException,
                     NotAuthorizedException,
                     InvalidStateException

Description copied from interface: TaskService

Transfers a Task to another Workbasket.

The transfer resets the read flag and sets the transfer flag if setTransferFlag is true.

Specified by:

transfer in interface TaskService

Parameters:

taskId - the id of the Task which should be transferred

workbasketKey - the key of the target Workbasket

domain - the domain of the target Workbasket

setTransferFlag - the control about whether to set the TaskSummary.isTransferred() flag or not

Returns:

the transferred Task

Throws:

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

WorkbasketNotFoundException - Thrown if the target Workbasket was not found.

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

InvalidStateException - Thrown if the Task is in a state which does not allow transferring

setTaskRead

public Task setTaskRead(String taskId,
                        boolean isRead)
                 throws TaskNotFoundException,
                        NotAuthorizedException

Description copied from interface: TaskService

Marks a task as read.

Specified by:

setTaskRead in interface TaskService

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

NotAuthorizedException - if the current user has no read permission for the workbasket the task is in

createTaskQuery

public TaskQuery createTaskQuery()

Description copied from interface: TaskService

This method provides a query builder for quering the database.

Specified by:

createTaskQuery in interface TaskService

Returns:

a TaskQuery

newTask

public Task newTask()

Description copied from interface: TaskService

Returns a not inserted instance of Task. The returned task has no workbasket Id set. When createTask() is invoked for this task, TaskService will call the TaskRouting SPI to determine a workbasket for the task. If the TaskRouting API is not active, e.g. because no TaskRouter is registered, or the TaskRouter(s) don't find a workbasket, the task will not be inserted.

Specified by:

newTask in interface TaskService

Returns:

an empty new Task

newTask

public Task newTask(String workbasketId)

Description copied from interface: TaskService

Returns a not inserted instance of Task.

Specified by:

newTask in interface TaskService

Parameters:

workbasketId - the id of the workbasket to which the task belongs

Returns:

an empty new Task

newTask

public Task newTask(String workbasketKey,
                    String domain)

Description copied from interface: TaskService

Returns a not inserted instance of Task.

Specified by:

newTask in interface TaskService

Parameters:

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

domain - the domain of the workbasket to which the task belongs

Returns:

an empty new Task

newTaskComment

public TaskComment newTaskComment(String taskId)

Description copied from interface: TaskService

Returns a not inserted instance of TaskComment.

Specified by:

newTaskComment in interface TaskService

Parameters:

taskId - The id of the task to which the task comment belongs

Returns:

an empty new TaskComment

newAttachment

public Attachment newAttachment()

Description copied from interface: TaskService

Returns a not inserted instance of Attachment.

Specified by:

newAttachment in interface TaskService

Returns:

an empty new Attachment

updateTask

public Task updateTask(Task task)
                throws InvalidArgumentException,
                       TaskNotFoundException,
                       ConcurrencyException,
                       NotAuthorizedException,
                       AttachmentPersistenceException,
                       InvalidStateException,
                       ClassificationNotFoundException

Description copied from interface: TaskService

Update a task.

Specified by:

updateTask in interface TaskService

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

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

InvalidStateException - if an attempt is made to change the owner of the task and the task is not in state READY .

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

transferTasks

public BulkOperationResults<String,TaskanaException> transferTasks(String destinationWorkbasketId,
                                                                         List<String> taskIds,
                                                                         boolean setTransferFlag)
                                                                  throws NotAuthorizedException,
                                                                         InvalidArgumentException,
                                                                         WorkbasketNotFoundException

Description copied from interface: TaskService

Transfers a list of Tasks to another Workbasket.

The transfer resets the read flag and sets the transfer flag if setTransferFlag is true. Exceptions will be thrown if the caller got no permissions on the target or it does not exist. Other Exceptions will be stored and returned in the end.

Specified by:

transferTasks in interface TaskService

Parameters:

destinationWorkbasketId - target Workbasket id

taskIds - list of source Tasks which will be moved

setTransferFlag - the control about whether to set the TaskSummary.isTransferred() flag or not

Returns:

Bulkresult with ID and Error in it for failed transactions.

Throws:

NotAuthorizedException - if the caller has no permissions on target Workbasket.

InvalidArgumentException - if the method parameters are EMPTY or NULL.

WorkbasketNotFoundException - if the target Workbasket can not be found.

transferTasks

public BulkOperationResults<String,TaskanaException> transferTasks(String destinationWorkbasketKey,
                                                                         String destinationWorkbasketDomain,
                                                                         List<String> taskIds,
                                                                         boolean setTransferFlag)
                                                                  throws NotAuthorizedException,
                                                                         InvalidArgumentException,
                                                                         WorkbasketNotFoundException

Description copied from interface: TaskService

Transfers a list of Tasks to another Workbasket.

The transfer resets the read flag and sets the transfer flag if setTransferFlag is true. Exceptions will be thrown if the caller got no permissions on the target or it does not exist. Other Exceptions will be stored and returned in the end.

Specified by:

transferTasks in interface TaskService

Parameters:

destinationWorkbasketKey - target Workbasket key

destinationWorkbasketDomain - target Workbasket domain

taskIds - list of source Tasks which will be moved

setTransferFlag - the control about whether to set the TaskSummary.isTransferred() flag or not

Returns:

Bulkresult with ID and Error in it for failed transactions.

Throws:

NotAuthorizedException - if the caller has no permissions on target Workbasket.

InvalidArgumentException - if the method parameters are EMPTY or NULL.

WorkbasketNotFoundException - if the target Workbasket can not be found.

deleteTask

public void deleteTask(String taskId)
                throws TaskNotFoundException,
                       InvalidStateException,
                       NotAuthorizedException

Description copied from interface: TaskService

Deletes the task with the given Id.

Specified by:

deleteTask in interface TaskService

Parameters:

taskId - The Id of the task to delete.

Throws:

TaskNotFoundException - If the given Id does not refer to an existing task.

InvalidStateException - If the state of the referenced task is not an end state.

NotAuthorizedException - if the current user is not member of role ADMIN

forceDeleteTask

public void forceDeleteTask(String taskId)
                     throws TaskNotFoundException,
                            InvalidStateException,
                            NotAuthorizedException

Description copied from interface: TaskService

Deletes the task with the given Id even if it is not completed.

Specified by:

forceDeleteTask in interface TaskService

Parameters:

taskId - The Id of the task to delete.

Throws:

TaskNotFoundException - If the given Id does not refer to an existing task.

InvalidStateException - If the state of the referenced task is not an end state and forceDelete is false.

NotAuthorizedException - if the current user is not member of role ADMIN

selectAndClaim

public Task selectAndClaim(TaskQuery taskQuery)
                    throws NotAuthorizedException,
                           InvalidOwnerException

Description copied from interface: TaskService

Selects and claims the first task which is returned by the task query.

Specified by:

selectAndClaim in interface TaskService

Parameters:

taskQuery - the task query.

Returns:

the task that got selected and claimed

Throws:

NotAuthorizedException - if the current user has no read permission for the workbasket the task is in

InvalidOwnerException - if the task is claimed by someone else

deleteTasks

public BulkOperationResults<String,TaskanaException> deleteTasks(List<String> taskIds)
                                                                throws InvalidArgumentException,
                                                                       NotAuthorizedException

Description copied from interface: TaskService

Deletes a list of tasks.

Specified by:

deleteTasks in interface TaskService

Parameters:

taskIds - the ids of the tasks to delete.

Returns:

the result of the operations with Id and Exception for each failed task deletion.

Throws:

InvalidArgumentException - if the TaskIds parameter is NULL

NotAuthorizedException - if the current user is not member of role ADMIN

completeTasks

public BulkOperationResults<String,TaskanaException> completeTasks(List<String> taskIds)
                                                                  throws InvalidArgumentException

Description copied from interface: TaskService

Completes a list of tasks.

Specified by:

completeTasks in interface TaskService

Parameters:

taskIds - of the tasks which should be completed.

Returns:

the result of the operations with Id and Exception for each failed task completion.

Throws:

InvalidArgumentException - If the taskId parameter is NULL.

forceCompleteTasks

public BulkOperationResults<String,TaskanaException> forceCompleteTasks(List<String> taskIds)
                                                                       throws InvalidArgumentException

Description copied from interface: TaskService

Completes a list of tasks.

Specified by:

forceCompleteTasks in interface TaskService

Parameters:

taskIds - of the tasks which should be completed.

Returns:

the result of the operations with Id and Exception for each failed task completion.

Throws:

InvalidArgumentException - If the taskId parameter is NULL.

See Also:

TaskService.forceCompleteTask(java.lang.String)

updateTasks

public List<String> updateTasks(ObjectReference selectionCriteria,
                                Map<TaskCustomField,String> customFieldsToUpdate)
                         throws InvalidArgumentException

Description copied from interface: TaskService

Updates tasks with a matching ObjectReference.

Specified by:

updateTasks in interface TaskService

Parameters:

selectionCriteria - the ObjectReference that is used to select the tasks.

customFieldsToUpdate - a Map that contains as key the identification of the custom field and as value the corresponding new value of that custom field.

Returns:

a list of the Ids of all modified tasks

Throws:

InvalidArgumentException - if the given selectionCriteria is invalid or the given customFieldsToUpdate are null or empty.

updateTasks

public List<String> updateTasks(List<String> taskIds,
                                Map<TaskCustomField,String> customFieldsToUpdate)
                         throws InvalidArgumentException

Description copied from interface: TaskService

Updates tasks with matching taskIds.

Specified by:

updateTasks in interface TaskService

Parameters:

taskIds - the taskIds that are used to select the tasks.

customFieldsToUpdate - a Map that contains as key the identification of the custom field and as value the corresponding new value of that custom field.

Returns:

a list of the Ids of all modified tasks

Throws:

InvalidArgumentException - if the given customFieldsToUpdate are null or empty.

createTaskComment

public TaskComment createTaskComment(TaskComment taskComment)
                              throws NotAuthorizedException,
                                     TaskNotFoundException,
                                     InvalidArgumentException

Description copied from interface: TaskService

Create a task comment.

Specified by:

createTaskComment in interface TaskService

Parameters:

taskComment - the task comment to be created.

Returns:

the created task comment.

Throws:

NotAuthorizedException - If the current user has no authorization to create a task comment for the given taskId in the TaskComment or is not authorized to access the task.

TaskNotFoundException - If the given taskId in the TaskComment does not refer to an existing task.

InvalidArgumentException - If the given taskCommentId from the provided task comment is not null or empty

updateTaskComment

public TaskComment updateTaskComment(TaskComment taskComment)
                              throws NotAuthorizedException,
                                     ConcurrencyException,
                                     TaskCommentNotFoundException,
                                     TaskNotFoundException,
                                     InvalidArgumentException

Description copied from interface: TaskService

Update a task comment.

Specified by:

updateTaskComment in interface TaskService

Parameters:

taskComment - the task comment to be updated in the database.

Returns:

the updated task comment.

Throws:

NotAuthorizedException - If the current user has no authorization to update a task comment or is not authorized to access the task.

ConcurrencyException - if an attempt is made to update the task comment and another user. updated it already.

TaskCommentNotFoundException - If the given taskCommentId in the TaskComment does not refer to an existing taskComment.

TaskNotFoundException - If the given taskId in the TaskComment does not refer to an existing task.

InvalidArgumentException - If the given taskCommentId from the provided task comment is null or empty

deleteTaskComment

public void deleteTaskComment(String taskCommentId)
                       throws NotAuthorizedException,
                              TaskCommentNotFoundException,
                              TaskNotFoundException,
                              InvalidArgumentException

Description copied from interface: TaskService

Deletes the task comment with the given Id.

Specified by:

deleteTaskComment in interface TaskService

Parameters:

taskCommentId - The id of the task comment to delete.

Throws:

NotAuthorizedException - If the current user has no authorization to delete a task comment or is not authorized to access the task.

TaskCommentNotFoundException - If the given taskCommentId in the TaskComment does not refer to an existing taskComment.

TaskNotFoundException - If the given taskId in the TaskComment does not refer to an existing task.

InvalidArgumentException - If the taskCommentId is null/empty

getTaskComment

public TaskComment getTaskComment(String taskCommentid)
                           throws TaskCommentNotFoundException,
                                  NotAuthorizedException,
                                  TaskNotFoundException,
                                  InvalidArgumentException

Description copied from interface: TaskService

Retrieves a task comment for a given taskCommentId.

Specified by:

getTaskComment in interface TaskService

Parameters:

taskCommentid - The id of the task comment which should be retrieved

Returns:

the task comment identified by taskCommentId

Throws:

TaskCommentNotFoundException - If the given taskCommentId in the TaskComment does not refer to an existing taskComment.

NotAuthorizedException - If the current user has no authorization to retrieve a taskComment from a certain task or is not authorized to access the task.

TaskNotFoundException - If the given taskId in the TaskComment does not refer to an existing task.

InvalidArgumentException - If the given taskCommentId is null or empty

getTaskComments

public List<TaskComment> getTaskComments(String taskId)
                                  throws NotAuthorizedException,
                                         TaskNotFoundException

Description copied from interface: TaskService

Retrieves a list of task comments for a given taskId.

Specified by:

getTaskComments in interface TaskService

Parameters:

taskId - The id of the task for which all task comments should be retrieved

Returns:

the list of task comments attached to task with id taskId

Throws:

NotAuthorizedException - If the current user has no authorization to retrieve a taskComment from a certain task or is not authorized to access the task.

TaskNotFoundException - If the given taskId in the TaskComment does not refer to an existing task.

setCallbackStateForTasks

public BulkOperationResults<String,TaskanaException> setCallbackStateForTasks(List<String> externalIds,
                                                                                    CallbackState state)

Description copied from interface: TaskService

Sets the callback state on a list of tasks. Note: this method is primarily intended to be used by the TaskanaAdapter

Specified by:

setCallbackStateForTasks in interface TaskService

Parameters:

externalIds - the EXTERNAL_IDs of the tasks on which the callback state is set.

state - the callback state that is to be set on the tasks

Returns:

the result of the operations with Id and Exception for each failed task deletion.

setOwnerOfTasks

public BulkOperationResults<String,TaskanaException> setOwnerOfTasks(String owner,
                                                                           List<String> argTaskIds)

Description copied from interface: TaskService

Sets the owner on a list of tasks. The owner will only be set on tasks that are in state READY.

Specified by:

setOwnerOfTasks in interface TaskService

Parameters:

owner - the new owner of the tasks

argTaskIds - the IDs of the tasks on which the owner is to be set.

Returns:

the result of the operations with Id and Exception for each failed task update.

setPlannedPropertyOfTasks

public BulkOperationResults<String,TaskanaException> setPlannedPropertyOfTasks(Instant planned,
                                                                                     List<String> argTaskIds)

Description copied from interface: TaskService

Sets the planned property on a list of tasks. Only tasks in state READY and CLAIMED will be affected by this method. On each task, the corresponding due date is set according to the shortest service level in the classifications of the task and the task's attachments.

Specified by:

setPlannedPropertyOfTasks in interface TaskService

Parameters:

planned - the new 'PLANNED" property of the tasks

argTaskIds - the IDs of the tasks on which the new planned property is to be set.

Returns:

the result of the operations with Id and Exception for each failed task update.

cancelTask

public Task cancelTask(String taskId)
                throws TaskNotFoundException,
                       InvalidStateException,
                       NotAuthorizedException

Description copied from interface: TaskService

Cancels a task. Cancellation means a task is obsolete from a business perspective an does not need to be completed anymore.

Specified by:

cancelTask in interface TaskService

Parameters:

taskId - the id of the task to cancel.

Returns:

the updated task.

Throws:

TaskNotFoundException - if the Task with Id TaskId is not found

InvalidStateException - if the task is not in state READY or CLAIMED

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

terminateTask

public Task terminateTask(String taskId)
                   throws TaskNotFoundException,
                          InvalidStateException,
                          NotAuthorizedException

Description copied from interface: TaskService

Terminates a task. Termination is a administrative action to complete a task. This is typically done by an administration to correct any technical issue.

Specified by:

terminateTask in interface TaskService

Parameters:

taskId - the id of the task to cancel.

Returns:

the updated task.

Throws:

TaskNotFoundException - if the Task with Id TaskId is not found

InvalidStateException - if the task is not in state READY or CLAIMED

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

findTasksIdsAffectedByClassificationChange

public List<String> findTasksIdsAffectedByClassificationChange(String classificationId)

refreshPriorityAndDueDatesOfTasksOnClassificationUpdate

public void refreshPriorityAndDueDatesOfTasksOnClassificationUpdate(List<String> taskIds,
                                                                    boolean serviceLevelChanged,
                                                                    boolean priorityChanged)