Package com.comalatech.workflow

Interface TaskService

  • public interface TaskService
    Provide services for manipulating the content's tasks. Note that for retrieving tasks you have to use the StateService
    Since:
    1.0
    See Also:
    StateService

    • Method Detail

      • createTask

        Task createTask​(com.atlassian.confluence.core.ContentEntityObject content,
                String taskName,
                String assignee,
                String comment,
                Date dueDate)
         throws WorkflowException
        Create a task on the content in the current State. The task may be assigned to a user
        Parameters:
        content - the content object
        taskName - the name of the task
        assignee - the name of the assignee (optional)
        comment - a comment of description of the task
        dueDate - the due date for this task. (alpha functionality, not yet supported)
        Returns:
        the Task created
        Throws:
        WorkflowException
        Since:
        1.3

      • createTask

        Task createTask​(com.atlassian.confluence.core.ContentEntityObject content,
                String taskName,
                String assignee,
                String comment)
         throws WorkflowException
        Create a task on the content in the current State. The task may be assigned to a user.
        Parameters:
        content - the content object
        taskName - the name of the task
        assignee - the name of the assignee (optional)
        comment - a comment of description of the task
        Returns:
        the Task created
        Throws:
        WorkflowException
        Since:
        1.0

      • editTask

        Task editTask​(com.atlassian.confluence.core.ContentEntityObject content,
              String taskId,
              String newTaskName,
              String newComment,
              Date dueDate)
       throws WorkflowException
        Edits a currently existing task. This method works as a PUT operation where if no data is provided for a field and it had already a value then it will be removed.
        Parameters:
        content - the content object
        taskId - the id of the task to edit
        newTaskName - the new name of the task
        newComment - the new comment for the task
        dueDate - the new due date for the task (alpha functionality, not yet supported)
        Returns:
        the updated Task object
        Throws:
        WorkflowException
        Since:
        1.3

      • completeTask

        @Deprecated
Task completeTask​(com.atlassian.confluence.core.ContentEntityObject content,
                  String taskId,
                  String outcome,
                  String comment)
           throws WorkflowException
        Deprecated.
        since 6.17.3 use completeTask(ContentEntityObject, String, String) instead
        Completes the given task.
        Parameters:
        content - the content object
        taskId - the id of the task to complete
        outcome - the outcome of the task. User approved or rejected for Approval-type tasks
        comment - a comment associated with the completion
        Returns:
        the task containing the new completion
        Throws:
        WorkflowException
        Since:
        1.0

      • completeTask

        Task completeTask​(com.atlassian.confluence.core.ContentEntityObject content,
                  String taskId,
                  String comment)
           throws WorkflowException
        Completes the given task.
        Parameters:
        content - the content object
        taskId - the id of the task to complete
        comment - a comment associated with the completion
        Returns:
        the task containing the new completion
        Throws:
        WorkflowException
        Since:
        6.17.3

      • removeTask

        void removeTask​(com.atlassian.confluence.core.ContentEntityObject content,
                String taskId)
         throws WorkflowException
        Removes a given task
        Parameters:
        content - the content object
        taskId - the id of the task to remove
        Throws:
        WorkflowException
        Since:
        1.1

      • removeTask

        void removeTask​(com.atlassian.confluence.core.ContentEntityObject content,
                String taskId,
                String comment)
         throws WorkflowException
        Removes a given task
        Parameters:
        content - the content object
        taskId - the id of the task to remove
        comment - the comment associated with the deletion
        Throws:
        WorkflowException
        Since:
        1.11.1

      • assignTask

        Task assignTask​(com.atlassian.confluence.core.ContentEntityObject content,
                String taskId,
                String assignee,
                String comment)
         throws WorkflowException
        Assigns the given task
        Parameters:
        content - the content object
        taskId - the id of the task (in the current state)
        assignee - the name of the assignee
        comment - the comment associated to this assignment
        Returns:
        the task containing the new assignment
        Throws:
        WorkflowException
        Since:
        1.0

      • assignTask

        Task assignTask​(com.atlassian.confluence.core.ContentEntityObject content,
                String taskId,
                String assignee,
                String comment,
                Date dueDate)
         throws WorkflowException
        Assigns the given task
        Parameters:
        content - the content object
        taskId - the id of the task (in the current state)
        assignee - the name of the assignee
        comment - the comment associated to this assignment
        dueDate - the due date for this task
        Returns:
        the task containing the new assignment
        Throws:
        WorkflowException
        Since:
        1.3

      • getTasks

        List<ContentTask> getTasks​(com.atlassian.confluence.core.ContentEntityObject ceo)
        Returns all tasks which are on the given content object.
        Parameters:
        ceo - the Content object to return the tasks for.
        Returns:
        list of tasks, empty list if none.

      • getActiveTasks

        List<ContentTask> getActiveTasks​(com.atlassian.confluence.core.ContentEntityObject ceo)
        Returns a list of tasks which are currently active on the given content object.
        Parameters:
        ceo - the content object to return the active tasks for.
        Returns:
        list of active tasks, empty list if none.

      • getCompletedTasks

        List<ContentTask> getCompletedTasks​(com.atlassian.confluence.core.ContentEntityObject ceo)
        Returns a list of tasks which are completed on the given content object.
        Parameters:
        ceo - the content object to returne the completed tasks for.
        Returns:
        list of compelted tasks, empty if none.