Package org.jbpm.services.api

## Interface UserTaskService

- All Known Subinterfaces:
    `UserTaskServiceEJBLocal`, `UserTaskServiceEJBRemote`
  All Known Implementing Classes:
    `UserTaskServiceCDIImpl`, `UserTaskServiceEJBImpl`, `UserTaskServiceImpl`

      public interface UserTaskService

- - ### Method Summary

    All Methods Instance Methods Abstract Methods
    Modifier and Type | Method | Description
    --- | --- | ---
    `void` | `activate​(Long taskId, String userId)` | Activate the task, i.e. set the task to status Ready.
    `void` | `activate​(String deploymentId, Long taskId, String userId)` | Activate the task, i.e. set the task to status Ready.
    `Long` | `addAttachment​(Long taskId, String userId, String name, Object attachment)` | Add attachment to a task
    `Long` | `addAttachment​(String deploymentId, Long taskId, String userId, String name, Object attachment)` | Add attachment to a task
    `Long` | `addComment​(Long taskId, String text, String addedBy, Date addedOn)` | Add comment to a task
    `Long` | `addComment​(String deploymentId, Long taskId, String text, String addedBy, Date addedOn)` | Add comment to a task
    `void` | `claim​(Long taskId, String userId)` | Claim responsibility for a task, i.e. set the task to status Reserved
    `void` | `claim​(String deploymentId, Long taskId, String userId)` | Claim responsibility for a task, i.e. set the task to status Reserved
    `void` | `claim​(String deploymentId, Collection<Long> taskIds, String userId)` | Claim responsibility for a list of tasks, i.e. set the tasks to status Reserved
    `void` | `complete​(Long taskId, String userId, Map<String,​Object> params)` | Complete a task with the given data
    `void` | `complete​(String deploymentId, Long taskId, String userId, Map<String,​Object> params)` | Complete a task with the given data
    `void` | `completeAutoProgress​(Long taskId, String userId, Map<String,​Object> params)` | Complete a task with the given data.
    `void` | `completeAutoProgress​(String deploymentId, Long taskId, String userId, Map<String,​Object> params)` | Complete a task with the given data.
    `void` | `delegate​(Long taskId, String userId, String targetUserId)` | Delegate a task from userId to targetUserId
    `void` | `delegate​(String deploymentId, Long taskId, String userId, String targetUserId)` | Delegate a task from userId to targetUserId
    `void` | `deleteAttachment​(Long taskId, Long attachmentId)` | Delete attachment from a task
    `void` | `deleteAttachment​(String deploymentId, Long taskId, Long attachmentId)` | Delete attachment from a task
    `void` | `deleteComment​(Long taskId, Long commentId)` | Deletes comment from a task
    `void` | `deleteComment​(String deploymentId, Long taskId, Long commentId)` | Deletes comment from a task
    `void` | `deleteContent​(Long taskId, Long contentId)` | Deletes content given by `contentId` from given task
    `void` | `deleteContent​(String deploymentId, Long taskId, Long contentId)` | Deletes content given by `contentId` from given task
    `<T> T` | `execute​(String deploymentId, org.kie.api.command.Command<T> command)` | Executes provided command on the underlying command executor
    `<T> T` | `execute​(String deploymentId, org.kie.api.runtime.manager.Context<?> context, org.kie.api.command.Command<T> command)` | Executes provided command on the underlying command executor
    `void` | `exit​(Long taskId, String userId)` | Requesting application is no longer interested in the task output
    `void` | `exit​(String deploymentId, Long taskId, String userId)` | Requesting application is no longer interested in the task output
    `void` | `fail​(Long taskId, String userId, Map<String,​Object> faultData)` | Actual owner completes the execution of the task raising a fault.
    `void` | `fail​(String deploymentId, Long taskId, String userId, Map<String,​Object> faultData)` | Actual owner completes the execution of the task raising a fault.
    `void` | `forward​(Long taskId, String userId, String targetEntityId)` | Forward the task to another organization entity.
    `void` | `forward​(String deploymentId, Long taskId, String userId, String targetEntityId)` | Forward the task to another organization entity.
    `org.kie.api.task.model.Attachment` | `getAttachmentById​(Long taskId, Long attachmentId)` | Get attachment by identifier
    `org.kie.api.task.model.Attachment` | `getAttachmentById​(String deploymentId, Long taskId, Long attachmentId)` | Get attachment by identifier
    `Object` | `getAttachmentContentById​(Long taskId, Long attachmentId)` | Get attachment's content by identifier
    `Object` | `getAttachmentContentById​(String deploymentId, Long taskId, Long attachmentId)` | Get attachment's content by identifier
    `List<org.kie.api.task.model.Attachment>` | `getAttachmentsByTaskId​(Long taskId)` | Get attachments for a task
    `List<org.kie.api.task.model.Attachment>` | `getAttachmentsByTaskId​(String deploymentId, Long taskId)` | Get attachments for a task
    `org.kie.api.task.model.Comment` | `getCommentById​(Long taskId, Long commentId)` | Get comment by identifier
    `org.kie.api.task.model.Comment` | `getCommentById​(String deploymentId, Long taskId, Long commentId)` | Get comment by identifier
    `List<org.kie.api.task.model.Comment>` | `getCommentsByTaskId​(Long taskId)` | Get comments for a task
    `List<org.kie.api.task.model.Comment>` | `getCommentsByTaskId​(String deploymentId, Long taskId)` | Get comments for a task
    `org.kie.api.task.model.Task` | `getTask​(Long taskId)` | Returns task instance
    `org.kie.api.task.model.Task` | `getTask​(String deploymentId, Long taskId)` | Returns task instance
    `Map<String,​Object>` | `getTaskInputContentByTaskId​(Long taskId)` | Returns task input data of a task
    `Map<String,​Object>` | `getTaskInputContentByTaskId​(String deploymentId, Long taskId)` | Returns task input data of a task
    `Map<String,​Object>` | `getTaskOutputContentByTaskId​(Long taskId)` | Returns task output data currently stored, might be null of no data is stored
    `Map<String,​Object>` | `getTaskOutputContentByTaskId​(String deploymentId, Long taskId)` | Returns task output data currently stored, might be null of no data is stored
    `void` | `nominate​(Long taskId, String userId, List<org.kie.api.task.model.OrganizationalEntity> potentialOwners)` | Nominate a task to be handled by potentialOwners
    `void` | `nominate​(String deploymentId, Long taskId, String userId, List<org.kie.api.task.model.OrganizationalEntity> potentialOwners)` | Nominate a task to be handled by potentialOwners
    `void` | `release​(Long taskId, String userId)` | Release a previously claimed task
    `void` | `release​(String deploymentId, Long taskId, String userId)` | Release a previously claimed task
    `void` | `resume​(Long taskId, String userId)` | Resume a previously suspended task
    `void` | `resume​(String deploymentId, Long taskId, String userId)` | Resume a previously suspended task
    `Long` | `saveContent​(Long taskId, Map<String,​Object> values)` | Saves gives values as content of a task, applies to task output as input cannot be altered
    `Long` | `saveContent​(String deploymentId, Long taskId, Map<String,​Object> values)` | Saves gives values as content of a task, applies to task output as input cannot be altered
    `Long` | `saveContentFromUser​(Long taskId, String userId, Map<String,​Object> values)` | Saves gives values as content of a task, applies to task output as input cannot be altered
    `void` | `setDescription​(Long taskId, String description)` | Sets description of the task
    `void` | `setDescription​(String deploymentId, Long taskId, String description)` | Sets description of the task
    `void` | `setExpirationDate​(Long taskId, Date date)` | Sets expiration date of a task to given value
    `void` | `setExpirationDate​(String deploymentId, Long taskId, Date date)` | Sets expiration date of a task to given value
    `void` | `setName​(Long taskId, String name)` | Sets name of the task
    `void` | `setName​(String deploymentId, Long taskId, String name)` | Sets name of the task
    `void` | `setPriority​(Long taskId, int priority)` | Sets priority of a task to given value
    `void` | `setPriority​(String deploymentId, Long taskId, int priority)` | Sets priority of a task to given value
    `void` | `setSkipable​(Long taskId, boolean skipable)` | Sets skipable property of a task to given value
    `void` | `setSkipable​(String deploymentId, Long taskId, boolean skipable)` | Sets skipable property of a task to given value
    `void` | `skip​(Long taskId, String userId)` | Skip a claimed task
    `void` | `skip​(String deploymentId, Long taskId, String userId)` | Skip a claimed task
    `void` | `start​(Long taskId, String userId)` | Start the execution of the task, i.e. set the task to status InProgress.
    `void` | `start​(String deploymentId, Long taskId, String userId)` | Start the execution of the task, i.e. set the task to status InProgress.
    `void` | `stop​(Long taskId, String userId)` | Cancel/stop the processing of the task.
    `void` | `stop​(String deploymentId, Long taskId, String userId)` | Cancel/stop the processing of the task.
    `void` | `suspend​(Long taskId, String userId)` | Suspend a claimed task.
    `void` | `suspend​(String deploymentId, Long taskId, String userId)` | Suspend a claimed task.
    `void` | `updateTask​(Long taskId, String userId, UserTaskInstanceDesc userTask, Map<String,​Object> inputData, Map<String,​Object> outputData)` | Updates user task properties and data inputs and outputs.
    `void` | `updateTask​(String deploymentId, Long taskId, String userId, UserTaskInstanceDesc userTask, Map<String,​Object> inputData, Map<String,​Object> outputData)` | Updates user task properties and data inputs and outputs.

- - ### Method Detail

    - #### activate

          void activate​(Long taskId,
                        String userId)

      Activate the task, i.e. set the task to status Ready.
      Parameters:
        `taskId` -
        `userId` -
      Throws:
        `TaskNotFoundException` - in case task with given id was not found

    - #### activate

          void activate​(String deploymentId,
                        Long taskId,
                        String userId)

      Activate the task, i.e. set the task to status Ready.
      Parameters:
        `deploymentId` -
        `taskId` -
        `userId` -
      Throws:
        `TaskNotFoundException` - in case task with given id was not found or is not associated with given deployment id

    - #### claim

          void claim​(Long taskId,
                     String userId)

      Claim responsibility for a task, i.e. set the task to status Reserved
      Parameters:
        `taskId` -
        `userId` -
      Throws:
        `TaskNotFoundException` - in case task with given id was not found

    - #### claim

          void claim​(String deploymentId,
                     Collection<Long> taskIds,
                     String userId)

      Claim responsibility for a list of tasks, i.e. set the tasks to status Reserved
      Parameters:
        `deploymentId` -
        `taskIds` - list of task to be claimed
        `userId` -

    - #### claim

          void claim​(String deploymentId,
                     Long taskId,
                     String userId)

      Claim responsibility for a task, i.e. set the task to status Reserved
      Parameters:
        `deploymentId` -
        `taskId` -
        `userId` -
      Throws:
        `TaskNotFoundException` - in case task with given id was not found or is not associated with given deployment id

    - #### complete

          void complete​(Long taskId,
                        String userId,
                        Map<String,​Object> params)

      Complete a task with the given data
      Parameters:
        `taskId` -
        `userId` -
        `params` -
      Throws:
        `TaskNotFoundException` - in case task with given id was not found

    - #### complete

          void complete​(String deploymentId,
                        Long taskId,
                        String userId,
                        Map<String,​Object> params)

      Complete a task with the given data
      Parameters:
        `deploymentId` -
        `taskId` -
        `userId` -
        `params` -
      Throws:
        `TaskNotFoundException` - in case task with given id was not found or is not associated with given deployment id

    - #### completeAutoProgress

          void completeAutoProgress​(Long taskId,
                                    String userId,
                                    Map<String,​Object> params)

      Complete a task with the given data. If needed, the task is automatically claimed and/or started.
      Parameters:
        `taskId` -
        `userId` -
        `params` -
      Throws:
        `TaskNotFoundException` - in case task with given id was not found

    - #### completeAutoProgress

          void completeAutoProgress​(String deploymentId,
                                    Long taskId,
                                    String userId,
                                    Map<String,​Object> params)

      Complete a task with the given data. If needed, the task is automatically claimed and/or started.
      Parameters:
        `deploymentId` -
        `taskId` -
        `userId` -
        `params` -
      Throws:
        `TaskNotFoundException` - in case task with given id was not found or is not associated with given deployment id

    - #### delegate

          void delegate​(Long taskId,
                        String userId,
                        String targetUserId)

      Delegate a task from userId to targetUserId
      Parameters:
        `taskId` -
        `userId` -
        `targetUserId` -
      Throws:
        `TaskNotFoundException` - in case task with given id was not found

    - #### delegate

          void delegate​(String deploymentId,
                        Long taskId,
                        String userId,
                        String targetUserId)

      Delegate a task from userId to targetUserId
      Parameters:
        `deploymentId` -
        `taskId` -
        `userId` -
        `targetUserId` -
      Throws:
        `TaskNotFoundException` - in case task with given id was not found or is not associated with given deployment id

    - #### exit

          void exit​(Long taskId,
                    String userId)

      Requesting application is no longer interested in the task output
      Parameters:
        `taskId` -
        `userId` -
      Throws:
        `TaskNotFoundException` - in case task with given id was not found

    - #### exit

          void exit​(String deploymentId,
                    Long taskId,
                    String userId)

      Requesting application is no longer interested in the task output
      Parameters:
        `deploymentId` -
        `taskId` -
        `userId` -
      Throws:
        `TaskNotFoundException` - in case task with given id was not found or is not associated with given deployment id

    - #### fail

          void fail​(Long taskId,
                    String userId,
                    Map<String,​Object> faultData)

      Actual owner completes the execution of the task raising a fault. The fault illegalOperationFault is returned if the task interface defines no faults. If fault name or fault data is not set the operation returns illegalArgumentFault.
      Parameters:
        `taskId` -
        `userId` -
        `faultData` -
      Throws:
        `TaskNotFoundException` - in case task with given id was not found

    - #### fail

          void fail​(String deploymentId,
                    Long taskId,
                    String userId,
                    Map<String,​Object> faultData)

      Actual owner completes the execution of the task raising a fault. The fault illegalOperationFault is returned if the task interface defines no faults. If fault name or fault data is not set the operation returns illegalArgumentFault.
      Parameters:
        `deploymentId` -
        `taskId` -
        `userId` -
        `faultData` -
      Throws:
        `TaskNotFoundException` - in case task with given id was not found or is not associated with given deployment id

    - #### forward

          void forward​(Long taskId,
                       String userId,
                       String targetEntityId)

      Forward the task to another organization entity. The caller has to specify the receiving organizational entity. Potential owners can only forward a task while the task is in the Ready state. For details on forwarding human tasks refer to section 4.7.3 in WS-HumanTask_v1.pdf
      Parameters:
        `taskId` -
        `userId` -
        `targetEntityId` -
      Throws:
        `TaskNotFoundException` - in case task with given id was not found

    - #### forward

          void forward​(String deploymentId,
                       Long taskId,
                       String userId,
                       String targetEntityId)

      Forward the task to another organization entity. The caller has to specify the receiving organizational entity. Potential owners can only forward a task while the task is in the Ready state. For details on forwarding human tasks refer to section 4.7.3 in WS-HumanTask_v1.pdf
      Parameters:
        `deploymentId` -
        `taskId` -
        `userId` -
        `targetEntityId` -
      Throws:
        `TaskNotFoundException` - in case task with given id was not found or is not associated with given deployment id

    - #### release

          void release​(Long taskId,
                       String userId)

      Release a previously claimed task
      Parameters:
        `taskId` -
        `userId` -
      Throws:
        `TaskNotFoundException` - in case task with given id was not found

    - #### release

          void release​(String deploymentId,
                       Long taskId,
                       String userId)

      Release a previously claimed task
      Parameters:
        `deploymentId` -
        `taskId` -
        `userId` -
      Throws:
        `TaskNotFoundException` - in case task with given id was not found or is not associated with given deployment id

    - #### resume

          void resume​(Long taskId,
                      String userId)

      Resume a previously suspended task
      Parameters:
        `taskId` -
        `userId` -
      Throws:
        `TaskNotFoundException` - in case task with given id was not found

    - #### resume

          void resume​(String deploymentId,
                      Long taskId,
                      String userId)

      Resume a previously suspended task
      Parameters:
        `deploymentId` -
        `taskId` -
        `userId` -
      Throws:
        `TaskNotFoundException` - in case task with given id was not found or is not associated with given deployment id

    - #### skip

          void skip​(Long taskId,
                    String userId)

      Skip a claimed task
      Parameters:
        `taskId` -
        `userId` -
      Throws:
        `TaskNotFoundException` - in case task with given id was not found

    - #### skip

          void skip​(String deploymentId,
                    Long taskId,
                    String userId)

      Skip a claimed task
      Parameters:
        `deploymentId` -
        `taskId` -
        `userId` -
      Throws:
        `TaskNotFoundException` - in case task with given id was not found or is not associated with given deployment id

    - #### start

          void start​(Long taskId,
                     String userId)

      Start the execution of the task, i.e. set the task to status InProgress.
      Parameters:
        `taskId` -
        `userId` -
      Throws:
        `TaskNotFoundException` - in case task with given id was not found

    - #### start

          void start​(String deploymentId,
                     Long taskId,
                     String userId)

      Start the execution of the task, i.e. set the task to status InProgress.
      Parameters:
        `deploymentId` -
        `taskId` -
        `userId` -
      Throws:
        `TaskNotFoundException` - in case task with given id was not found or is not associated with given deployment id

    - #### stop

          void stop​(Long taskId,
                    String userId)

      Cancel/stop the processing of the task. The task returns to the Reserved state.
      Parameters:
        `taskId` -
        `userId` -
      Throws:
        `TaskNotFoundException` - in case task with given id was not found

    - #### stop

          void stop​(String deploymentId,
                    Long taskId,
                    String userId)

      Cancel/stop the processing of the task. The task returns to the Reserved state.
      Parameters:
        `deploymentId` -
        `taskId` -
        `userId` -
      Throws:
        `TaskNotFoundException` - in case task with given id was not found or is not associated with given deployment id

    - #### suspend

          void suspend​(Long taskId,
                       String userId)

      Suspend a claimed task.
      Parameters:
        `taskId` -
        `userId` -
      Throws:
        `TaskNotFoundException` - in case task with given id was not found

    - #### suspend

          void suspend​(String deploymentId,
                       Long taskId,
                       String userId)

      Suspend a claimed task.
      Parameters:
        `deploymentId` -
        `taskId` -
        `userId` -
      Throws:
        `TaskNotFoundException` - in case task with given id was not found or is not associated with given deployment id

    - #### nominate

          void nominate​(Long taskId,
                        String userId,
                        List<org.kie.api.task.model.OrganizationalEntity> potentialOwners)

      Nominate a task to be handled by potentialOwners
      Parameters:
        `taskId` -
        `userId` -
        `potentialOwners` -
      Throws:
        `TaskNotFoundException` - in case task with given id was not found

    - #### nominate

          void nominate​(String deploymentId,
                        Long taskId,
                        String userId,
                        List<org.kie.api.task.model.OrganizationalEntity> potentialOwners)

      Nominate a task to be handled by potentialOwners
      Parameters:
        `deploymentId` -
        `taskId` -
        `userId` -
        `potentialOwners` -
      Throws:
        `TaskNotFoundException` - in case task with given id was not found or is not associated with given deployment id

    - #### setPriority

          void setPriority​(Long taskId,
                           int priority)

      Sets priority of a task to given value
      Parameters:
        `taskId` -
        `priority` -
      Throws:
        `TaskNotFoundException` - in case task with given id was not found

    - #### setPriority

          void setPriority​(String deploymentId,
                           Long taskId,
                           int priority)

      Sets priority of a task to given value
      Parameters:
        `deploymentId` -
        `taskId` -
        `priority` -
      Throws:
        `TaskNotFoundException` - in case task with given id was not found or is not associated with given deployment id

    - #### setExpirationDate

          void setExpirationDate​(Long taskId,
                                 Date date)

      Sets expiration date of a task to given value
      Parameters:
        `taskId` -
        `date` -
      Throws:
        `TaskNotFoundException` - in case task with given id was not found

    - #### setExpirationDate

          void setExpirationDate​(String deploymentId,
                                 Long taskId,
                                 Date date)

      Sets expiration date of a task to given value
      Parameters:
        `deploymentId` -
        `taskId` -
        `date` -
      Throws:
        `TaskNotFoundException` - in case task with given id was not found or is not associated with given deployment id

    - #### setSkipable

          void setSkipable​(Long taskId,
                           boolean skipable)

      Sets skipable property of a task to given value
      Parameters:
        `taskId` -
        `skipable` -
      Throws:
        `TaskNotFoundException` - in case task with given id was not found

    - #### setSkipable

          void setSkipable​(String deploymentId,
                           Long taskId,
                           boolean skipable)

      Sets skipable property of a task to given value
      Parameters:
        `deploymentId` -
        `taskId` -
        `skipable` -
      Throws:
        `TaskNotFoundException` - in case task with given id was not found or is not associated with given deployment id

    - #### setName

          void setName​(Long taskId,
                       String name)

      Sets name of the task
      Parameters:
        `taskId` -
        `name` -
      Throws:
        `TaskNotFoundException` - in case task with given id was not found

    - #### setName

          void setName​(String deploymentId,
                       Long taskId,
                       String name)

      Sets name of the task
      Parameters:
        `deploymentId` -
        `taskId` -
        `name` -
      Throws:
        `TaskNotFoundException` - in case task with given id was not found or is not associated with given deployment id

    - #### setDescription

          void setDescription​(Long taskId,
                              String description)

      Sets description of the task
      Parameters:
        `taskId` -
        `description` -
      Throws:
        `TaskNotFoundException` - in case task with given id was not found

    - #### setDescription

          void setDescription​(String deploymentId,
                              Long taskId,
                              String description)

      Sets description of the task
      Parameters:
        `deploymentId` -
        `taskId` -
        `description` -
      Throws:
        `TaskNotFoundException` - in case task with given id was not found or is not associated with given deployment id

    - #### updateTask

          void updateTask​(Long taskId,
                          String userId,
                          UserTaskInstanceDesc userTask,
                          Map<String,​Object> inputData,
                          Map<String,​Object> outputData)

      Updates user task properties and data inputs and outputs. Allowed properties to be updated are:
      - name
      - description
      - priority
      - expiration date
      - formName
      Parameters:
        `userId` - user id who is going to perform the update
        `userTask` - user task with properties to be updated
        `inputData` - map of input variables to be added/replaced on a task
        `outputData` - map of output variables to be added/replaced on a task
      Throws:
        `TaskNotFoundException` - in case task id was not given or task was not found with given id

    - #### updateTask

          void updateTask​(String deploymentId,
                          Long taskId,
                          String userId,
                          UserTaskInstanceDesc userTask,
                          Map<String,​Object> inputData,
                          Map<String,​Object> outputData)

      Updates user task properties and data inputs and outputs. Allowed properties to be updated are:
      - name
      - description
      - priority
      - expiration date
      - formName
      Parameters:
        `deploymentId` -
        `userId` - user id who is going to perform the update
        `userTask` - user task with properties to be updated
        `inputData` - map of input variables to be added/replaced on a task
        `outputData` - map of output variables to be added/replaced on a task
      Throws:
        `TaskNotFoundException` - in case task id was not given or task was not found with given id or is not associated with given deployment id

    - #### saveContent

          Long saveContent​(Long taskId,
                           Map<String,​Object> values)

      Saves gives values as content of a task, applies to task output as input cannot be altered
      Parameters:
        `taskId` -
        `values` -
      Returns:
      Throws:
        `TaskNotFoundException` - in case task with given id was not found

    - #### saveContentFromUser

          Long saveContentFromUser​(Long taskId,
                                   String userId,
                                   Map<String,​Object> values)

      Saves gives values as content of a task, applies to task output as input cannot be altered
      Parameters:
        `taskId` -
        `values` -
      Returns:
      Throws:
        `TaskNotFoundException` - in case task with given id was not found

    - #### saveContent

          Long saveContent​(String deploymentId,
                           Long taskId,
                           Map<String,​Object> values)

      Saves gives values as content of a task, applies to task output as input cannot be altered
      Parameters:
        `deploymentId` -
        `taskId` -
        `values` -
      Returns:
      Throws:
        `TaskNotFoundException` - in case task with given id was not found or is not associated with given deployment id

    - #### getTaskOutputContentByTaskId

          Map<String,​Object> getTaskOutputContentByTaskId​(Long taskId)

      Returns task output data currently stored, might be null of no data is stored
      Parameters:
        `taskId` -
      Returns:
      Throws:
        `TaskNotFoundException` - in case task with given id was not found

    - #### getTaskOutputContentByTaskId

          Map<String,​Object> getTaskOutputContentByTaskId​(String deploymentId,
                                                                Long taskId)

      Returns task output data currently stored, might be null of no data is stored
      Parameters:
        `deploymentId` -
        `taskId` -
      Returns:
      Throws:
        `TaskNotFoundException` - in case task with given id was not found or is not associated with given deployment id

    - #### getTaskInputContentByTaskId

          Map<String,​Object> getTaskInputContentByTaskId​(Long taskId)

      Returns task input data of a task
      Parameters:
        `taskId` -
      Returns:
      Throws:
        `TaskNotFoundException` - in case task with given id was not found

    - #### getTaskInputContentByTaskId

          Map<String,​Object> getTaskInputContentByTaskId​(String deploymentId,
                                                               Long taskId)

      Returns task input data of a task
      Parameters:
        `deploymentId` -
        `taskId` -
      Returns:
      Throws:
        `TaskNotFoundException` - in case task with given id was not found or is not associated with given deployment id

    - #### deleteContent

          void deleteContent​(Long taskId,
                             Long contentId)

      Deletes content given by `contentId` from given task
      Parameters:
        `taskId` -
        `contentId` -
      Throws:
        `TaskNotFoundException` - in case task with given id was not found

    - #### deleteContent

          void deleteContent​(String deploymentId,
                             Long taskId,
                             Long contentId)

      Deletes content given by `contentId` from given task
      Parameters:
        `deploymentId` -
        `taskId` -
        `contentId` -
      Throws:
        `TaskNotFoundException` - in case task with given id was not found or is not associated with given deployment id

    - #### addComment

          Long addComment​(Long taskId,
                          String text,
                          String addedBy,
                          Date addedOn)

      Add comment to a task
      Parameters:
        `taskId` -
        `text` -
        `addedBy` -
        `addedOn` -
      Returns:
      Throws:
        `TaskNotFoundException` - in case task with given id was not found

    - #### addComment

          Long addComment​(String deploymentId,
                          Long taskId,
                          String text,
                          String addedBy,
                          Date addedOn)

      Add comment to a task
      Parameters:
        `deploymentId` -
        `taskId` -
        `text` -
        `addedBy` -
        `addedOn` -
      Returns:
      Throws:
        `TaskNotFoundException` - in case task with given id was not found or is not associated with given deployment id

    - #### deleteComment

          void deleteComment​(Long taskId,
                             Long commentId)

      Deletes comment from a task
      Parameters:
        `taskId` -
        `commentId` -
      Throws:
        `TaskNotFoundException` - in case task with given id was not found

    - #### deleteComment

          void deleteComment​(String deploymentId,
                             Long taskId,
                             Long commentId)

      Deletes comment from a task
      Parameters:
        `deploymentId` -
        `taskId` -
        `commentId` -
      Throws:
        `TaskNotFoundException` - in case task with given id was not found or is not associated with given deployment id

    - #### getCommentsByTaskId

          List<org.kie.api.task.model.Comment> getCommentsByTaskId​(Long taskId)

      Get comments for a task
      Parameters:
        `taskId` -
      Returns:
      Throws:
        `TaskNotFoundException` - in case task with given id was not found

    - #### getCommentsByTaskId

          List<org.kie.api.task.model.Comment> getCommentsByTaskId​(String deploymentId,
                                                                   Long taskId)

      Get comments for a task
      Parameters:
        `deploymentId` -
        `taskId` -
      Returns:
      Throws:
        `TaskNotFoundException` - in case task with given id was not found or is not associated with given deployment id

    - #### getCommentById

          org.kie.api.task.model.Comment getCommentById​(Long taskId,
                                                        Long commentId)

      Get comment by identifier
      Parameters:
        `commentId` -
      Returns:
      Throws:
        `TaskNotFoundException` - in case task with given id was not found

    - #### getCommentById

          org.kie.api.task.model.Comment getCommentById​(String deploymentId,
                                                        Long taskId,
                                                        Long commentId)

      Get comment by identifier
      Parameters:
        `deploymentId` -
        `commentId` -
      Returns:
      Throws:
        `TaskNotFoundException` - in case task with given id was not found or is not associated with given deployment id

    - #### addAttachment

          Long addAttachment​(Long taskId,
                             String userId,
                             String name,
                             Object attachment)

      Add attachment to a task
      Parameters:
        `taskId` -
        `userId` -
        `attachment` -
      Returns:
      Throws:
        `TaskNotFoundException` - in case task with given id was not found

    - #### addAttachment

          Long addAttachment​(String deploymentId,
                             Long taskId,
                             String userId,
                             String name,
                             Object attachment)

      Add attachment to a task
      Parameters:
        `deploymentId` -
        `taskId` -
        `userId` -
        `attachment` -
      Returns:
      Throws:
        `TaskNotFoundException` - in case task with given id was not found or is not associated with given deployment id

    - #### deleteAttachment

          void deleteAttachment​(Long taskId,
                                Long attachmentId)

      Delete attachment from a task
      Parameters:
        `taskId` -
        `attachmentId` -
      Throws:
        `TaskNotFoundException` - in case task with given id was not found

    - #### deleteAttachment

          void deleteAttachment​(String deploymentId,
                                Long taskId,
                                Long attachmentId)

      Delete attachment from a task
      Parameters:
        `deploymentId` -
        `taskId` -
        `attachmentId` -
      Throws:
        `TaskNotFoundException` - in case task with given id was not found or is not associated with given deployment id

    - #### getAttachmentById

          org.kie.api.task.model.Attachment getAttachmentById​(Long taskId,
                                                              Long attachmentId)

      Get attachment by identifier
      Parameters:
        `attachmentId` -
      Returns:
      Throws:
        `TaskNotFoundException` - in case task with given id was not found

    - #### getAttachmentById

          org.kie.api.task.model.Attachment getAttachmentById​(String deploymentId,
                                                              Long taskId,
                                                              Long attachmentId)

      Get attachment by identifier
      Parameters:
        `deploymentId` -
        `attachmentId` -
      Returns:
      Throws:
        `TaskNotFoundException` - in case task with given id was not found or is not associated with given deployment id

    - #### getAttachmentContentById

          Object getAttachmentContentById​(Long taskId,
                                          Long attachmentId)

      Get attachment's content by identifier
      Parameters:
        `attachmentId` -
      Returns:
      Throws:
        `TaskNotFoundException` - in case task with given id was not found

    - #### getAttachmentContentById

          Object getAttachmentContentById​(String deploymentId,
                                          Long taskId,
                                          Long attachmentId)

      Get attachment's content by identifier
      Parameters:
        `deploymentId` -
        `attachmentId` -
      Returns:
      Throws:
        `TaskNotFoundException` - in case task with given id was not found or is not associated with given deployment id

    - #### getAttachmentsByTaskId

          List<org.kie.api.task.model.Attachment> getAttachmentsByTaskId​(Long taskId)

      Get attachments for a task
      Parameters:
        `taskId` -
      Returns:
      Throws:
        `TaskNotFoundException` - in case task with given id was not found

    - #### getAttachmentsByTaskId

          List<org.kie.api.task.model.Attachment> getAttachmentsByTaskId​(String deploymentId,
                                                                         Long taskId)

      Get attachments for a task
      Parameters:
        `deploymentId` -
        `taskId` -
      Returns:
      Throws:
        `TaskNotFoundException` - in case task with given id was not found or is not associated with given deployment id

    - #### getTask

          org.kie.api.task.model.Task getTask​(Long taskId)

      Returns task instance
      Parameters:
        `taskId` -
      Returns:
      Throws:
        `TaskNotFoundException` - in case task with given id was not found

    - #### getTask

          org.kie.api.task.model.Task getTask​(String deploymentId,
                                              Long taskId)

      Returns task instance
      Parameters:
        `deploymentId` -
        `taskId` -
      Returns:
      Throws:
        `TaskNotFoundException` - in case task with given id was not found or is not associated with given deployment id

    - #### execute

          <T> T execute​(String deploymentId,
                        org.kie.api.command.Command<T> command)

      Executes provided command on the underlying command executor
      Parameters:
        `deploymentId` - identifier of the deployment that engine should be used for execution
        `command` - actual command for execution
      Returns:
        results of command execution

    - #### execute

          <T> T execute​(String deploymentId,
                        org.kie.api.runtime.manager.Context<?> context,
                        org.kie.api.command.Command<T> command)

      Executes provided command on the underlying command executor
      Parameters:
        `deploymentId` - identifier of the deployment that engine should be used for execution
        `context` - context implementation to be used for getting runtime engine
        `command` - actual command for execution
      Returns:
        results of command execution