org.exoplatform.task.service

Interface TaskService

All Known Implementing Classes:

TaskServiceImpl

public interface TaskService

Field Summary

Fields

Modifier and Type	Field and Description
static String	TASK_CREATION
static String	TASK_UPDATE

Method Summary

Modifier and Type	Method and Description
ChangeLogEntry	addTaskLog(long taskId, String username, String actionName, String target) Create a log associated with a task with given taskId.
void	addWatcherToTask(String username, TaskDto task)
TaskDto	cloneTask(long taskId) Clone the task from a task with given taskId.
Long	countAssignedTasks(String user)
Long	countCollaboratedTasks(String user)
int	countIncomingTasks(String user)
Long	countOverdueTasks(String user)
long	countTasks(String user, String query) Count tasks assigned to a user using a search term to find in title or description of the task
int	countTasks(TaskQuery query)
int	countTasksByLabel(LabelDto label, List<Long> projectIds, String username, OrderBy orderBy)
List<Object[]>	countTaskStatusByProject(long projectId)
Long	countUncompletedTasks(String user)
Long	countWatchedTasks(String user)
TaskDto	createTask(TaskDto task) Create a new task.
void	deleteWatcherOfTask(String username, TaskDto task)
TasksList	filterTasks(String query, long projectId, String keyword, List<Long> labels, TaskUtil.DUE dueDate, Priority priority, List<String> assignees, List<String> coworkers, List<String> watchers, Long labelId, Long statusId, org.exoplatform.services.security.Identity currIdentity, String dueCategory, String space_group_id, TimeZone userTimezone, boolean isShowCompleted, boolean advanceSearch, boolean noProjPermission, boolean noLblPermission, String orderBy, String groupBy, int offset, int limit)
TaskDto	findTaskByActivityId(String activityId)
List<TaskDto>	findTasks(String user, String query, int limit)
List<TaskDto>	findTasks(TaskQuery query, int offset, int limit) Find tasks assigned to a user using a term to find in title or description of the task
List<TaskDto>	findTasksByLabel(LabelDto label, List<Long> projectIds, String username, OrderBy orderBy, int offset, int limit)
List<TaskDto>	getAssignedTasks(String user, int limit)
List<TaskDto>	getCollaboratedTasks(String user, int limit)
Set<String>	getCoworker(long taskId)
List<TaskDto>	getIncomingTasks(String user, int offset, int limit)
Set<String>	getMentionedUsers(long taskId)
List<TaskDto>	getOverdueTasks(String user, int limit)
TaskDto	getTask(long taskId) Return the task with given taskId.
List<ChangeLogEntry>	getTaskLogs(long taskId, int offset, int limit)
List<TaskDto>	getUncompletedTasks(String user, int limit)
List<TaskDto>	getWatchedTasks(String user, int limit)
Set<String>	getWatchersOfTask(TaskDto task)
boolean	isExternal(String userId)
void	removeTask(long taskId) Remove the task with given taskId
<T> List<T>	selectTaskField(TaskQuery query, String fieldName)
TaskDto	updateTask(TaskDto task) Update the task.
void	updateTaskOrder(long currentTaskId, Status newStatus, long[] orders)

Field Detail

TASK_CREATION

static final String TASK_CREATION

See Also:

Constant Field Values

TASK_UPDATE

static final String TASK_UPDATE

See Also:

Constant Field Values

Method Detail

createTask

TaskDto createTask(TaskDto task)

Create a new task.

Parameters:

task - the given task.

Returns:

the created task.

updateTask

TaskDto updateTask(TaskDto task)

Update the task.

Parameters:

task - the given task.

Returns:

the updated task.

updateTaskOrder

void updateTaskOrder(long currentTaskId,
                     Status newStatus,
                     long[] orders)

removeTask

void removeTask(long taskId)
         throws EntityNotFoundException

Remove the task with given taskId

Parameters:

taskId - the given task id.

Throws:

EntityNotFoundException - when user is not authorized to remove task

cloneTask

TaskDto cloneTask(long taskId)
           throws EntityNotFoundException

Clone the task from a task with given taskId.

Throws:

EntityNotFoundException

getTask

TaskDto getTask(long taskId)
         throws EntityNotFoundException

Return the task with given taskId.

Parameters:

taskId -

Returns:

the given task.

Throws:

EntityNotFoundException - when user is not authorized to get task.

getWatchedTasks

List<TaskDto> getWatchedTasks(String user,
                              int limit)

countWatchedTasks

Long countWatchedTasks(String user)

getAssignedTasks

List<TaskDto> getAssignedTasks(String user,
                               int limit)

countAssignedTasks

Long countAssignedTasks(String user)

getCollaboratedTasks

List<TaskDto> getCollaboratedTasks(String user,
                                   int limit)

countCollaboratedTasks

Long countCollaboratedTasks(String user)

findTasks

List<TaskDto> findTasks(String user,
                        String query,
                        int limit)

countTasks

int countTasks(TaskQuery query)
        throws Exception

Throws:

Exception

selectTaskField

<T> List<T> selectTaskField(TaskQuery query,
                            String fieldName)

findTasksByLabel

List<TaskDto> findTasksByLabel(LabelDto label,
                               List<Long> projectIds,
                               String username,
                               OrderBy orderBy,
                               int offset,
                               int limit)
                        throws Exception

Throws:

Exception

countTasksByLabel

int countTasksByLabel(LabelDto label,
                      List<Long> projectIds,
                      String username,
                      OrderBy orderBy)
               throws Exception

Throws:

Exception

addTaskLog

ChangeLogEntry addTaskLog(long taskId,
                          String username,
                          String actionName,
                          String target)
                   throws EntityNotFoundException

Create a log associated with a task with given taskId.

Parameters:

taskId - the given task id.

username - the given username.

actionName - the given action name.

target - the given target.

Returns:

add task log.

Throws:

EntityNotFoundException - when user is not authorized to add taskLog.

getTaskLogs

List<ChangeLogEntry> getTaskLogs(long taskId,
                                 int offset,
                                 int limit)
                          throws Exception

Throws:

Exception

findTaskByActivityId

TaskDto findTaskByActivityId(String activityId)

getCoworker

Set<String> getCoworker(long taskId)

getMentionedUsers

Set<String> getMentionedUsers(long taskId)

getUncompletedTasks

List<TaskDto> getUncompletedTasks(String user,
                                  int limit)

countUncompletedTasks

Long countUncompletedTasks(String user)

getIncomingTasks

List<TaskDto> getIncomingTasks(String user,
                               int offset,
                               int limit)
                        throws Exception

Throws:

Exception

countIncomingTasks

int countIncomingTasks(String user)
                throws Exception

Throws:

Exception

getOverdueTasks

List<TaskDto> getOverdueTasks(String user,
                              int limit)

countOverdueTasks

Long countOverdueTasks(String user)

getWatchersOfTask

Set<String> getWatchersOfTask(TaskDto task)

addWatcherToTask

void addWatcherToTask(String username,
                      TaskDto task)
               throws Exception

Throws:

Exception

deleteWatcherOfTask

void deleteWatcherOfTask(String username,
                         TaskDto task)
                  throws Exception

Throws:

Exception

findTasks

List<TaskDto> findTasks(TaskQuery query,
                        int offset,
                        int limit)
                 throws Exception

Find tasks assigned to a user using a term to find in title or description of the task

Parameters:

query - term to search in title or description

limit - term to limit results.

Returns:

List of TaskDto

Throws:

Exception

countTasks

long countTasks(String user,
                String query)

Count tasks assigned to a user using a search term to find in title or description of the task

Parameters:

user - username

query - term to search in title or description

Returns:

tasks count

countTaskStatusByProject

List<Object[]> countTaskStatusByProject(long projectId)

filterTasks

TasksList filterTasks(String query,
                      long projectId,
                      String keyword,
                      List<Long> labels,
                      TaskUtil.DUE dueDate,
                      Priority priority,
                      List<String> assignees,
                      List<String> coworkers,
                      List<String> watchers,
                      Long labelId,
                      Long statusId,
                      org.exoplatform.services.security.Identity currIdentity,
                      String dueCategory,
                      String space_group_id,
                      TimeZone userTimezone,
                      boolean isShowCompleted,
                      boolean advanceSearch,
                      boolean noProjPermission,
                      boolean noLblPermission,
                      String orderBy,
                      String groupBy,
                      int offset,
                      int limit)
               throws Exception

Throws:

Exception

isExternal

boolean isExternal(String userId)