Package org.nuxeo.ecm.platform.task.core.service

Class DocumentTaskProvider

java.lang.Object

org.nuxeo.ecm.platform.task.core.service.DocumentTaskProvider

All Implemented Interfaces:

Serializable, TaskProvider

public class DocumentTaskProvider
extends Object
implements TaskProvider

Since:

5.5

Author:

Laurent Doguin, Antoine Taillefer

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor	Description
DocumentTaskProvider()

Method Summary

Modifier and Type	Method	Description
String	endTask(CoreSession coreSession, NuxeoPrincipal principal, Task task, String comment, String eventName, boolean isValidated)	Ends the task
List<Task>	getAllCurrentTaskInstances(CoreSession session, List<SortInfo> sortInfos)	Returns the list of task instances associated assigned to the current user.
List<Task>	getAllTaskInstances(String processId, String nodeId, CoreSession session)	Returns all the tasks instances for the given processId originating from the given nodeId.
List<Task>	getAllTaskInstances(String processId, List<String> actors, CoreSession session)	Returns all the tasks instances for the given processId which assigned to one of the actor in the list or its pool.
List<Task>	getAllTaskInstances(String processId, CoreSession session)	Returns all the tasks instances for the given processId.
List<Task>	getAllTaskInstances(String processId, NuxeoPrincipal user, CoreSession session)	Returns all the tasks instances for the given processId and where the user is the actor or belongs to the pooled actor list.
List<Task>	getCurrentTaskInstances(List<String> actors, CoreSession coreSession)	Returns a list of task instances assigned to one of the actors in the list or to its pool.
List<Task>	getCurrentTaskInstances(List<String> actors, CoreSession coreSession, List<SortInfo> sortInfos)	Provide @param sortInfo to handle sort page-provider contributions (see getCurrentTaskInstances(org.nuxeo.ecm.core.api.CoreSession))
List<Task>	getCurrentTaskInstances(CoreSession coreSession)
List<Task>	getCurrentTaskInstances(CoreSession coreSession, List<SortInfo> sortInfos)	Provide @param sortInfo to handle sort page-provider contributions (see getCurrentTaskInstances(org.nuxeo.ecm.core.api.CoreSession))
List<Task>	getTaskInstances(DocumentModel dm, List<String> actors, boolean includeDelegatedTasks, CoreSession session)	Returns the list of task instances associated with this document assigned to one of the actor in the list or its pool.
List<Task>	getTaskInstances(DocumentModel dm, List<String> actors, CoreSession coreSession)	Returns the list of task instances associated with this document assigned to one of the actor in the list or its pool.
List<Task>	getTaskInstances(DocumentModel dm, NuxeoPrincipal user, CoreSession coreSession)	Returns the list of task instances associated with this document for which the user is the actor or belongs to the pooled actor list.
static List<Task>	getTasks(String pageProviderName, CoreSession session, boolean unrestricted, List<SortInfo> sortInfos, Object... params)
static List<Task>	wrapDocModelInTask(List<DocumentModel> taskDocuments)	Converts a DocumentModelList to a list of Tasks.
static List<Task>	wrapDocModelInTask(DocumentModelList taskDocuments)	Deprecated. since 6.0, use wrapDocModelInTask(List) instead.
static List<Task>	wrapDocModelInTask(DocumentModelList taskDocuments, boolean detach)	Deprecated. since 6.0, use wrapDocModelInTask(List) instead.

Methods inherited from class java.lang.Object

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

Constructor Detail

DocumentTaskProvider

public DocumentTaskProvider()

Method Detail

getCurrentTaskInstances

public List<Task> getCurrentTaskInstances(CoreSession coreSession)

Specified by:

getCurrentTaskInstances in interface TaskProvider

Returns:

A list of task instances where the current user is an actor. Doesn't take into account tasks that were delegated to this user.

getCurrentTaskInstances

public List<Task> getCurrentTaskInstances(CoreSession coreSession,
                                          List<SortInfo> sortInfos)

Provide @param sortInfo to handle sort page-provider contributions (see getCurrentTaskInstances(org.nuxeo.ecm.core.api.CoreSession))

Specified by:

getCurrentTaskInstances in interface TaskProvider

Since:

5.9.3

getCurrentTaskInstances

public List<Task> getCurrentTaskInstances(List<String> actors,
                                          CoreSession coreSession)

Returns a list of task instances assigned to one of the actors in the list or to its pool.

Specified by:

getCurrentTaskInstances in interface TaskProvider

Parameters:

actors - a list used as actorId to retrieve the tasks.

getCurrentTaskInstances

public List<Task> getCurrentTaskInstances(List<String> actors,
                                          CoreSession coreSession,
                                          List<SortInfo> sortInfos)

Provide @param sortInfo to handle sort page-provider contributions (see getCurrentTaskInstances(org.nuxeo.ecm.core.api.CoreSession))

Specified by:

getCurrentTaskInstances in interface TaskProvider

Since:

5.9.3

getTaskInstances

public List<Task> getTaskInstances(DocumentModel dm,
                                   NuxeoPrincipal user,
                                   CoreSession coreSession)

Description copied from interface: TaskProvider

Returns the list of task instances associated with this document for which the user is the actor or belongs to the pooled actor list. Doesn't take into account tasks that were delegated to this user.

If the user is null, then it returns all task instances for the document. The query is done in unrestricted mode and so the documents linked to the tasks are detached.

Specified by:

getTaskInstances in interface TaskProvider

Parameters:

dm - the document.

getTaskInstances

public List<Task> getTaskInstances(DocumentModel dm,
                                   List<String> actors,
                                   CoreSession coreSession)

Description copied from interface: TaskProvider

Returns the list of task instances associated with this document assigned to one of the actor in the list or its pool. Doesn't take into account tasks that were delegated to these users. The query is done in unrestricted mode and so the documents linked to the tasks are detached.

Specified by:

getTaskInstances in interface TaskProvider

getAllTaskInstances

public List<Task> getAllTaskInstances(String processId,
                                      CoreSession session)

Description copied from interface: TaskProvider

Returns all the tasks instances for the given processId.

The query is done in unrestricted mode and so the documents linked to the tasks are detached.

Specified by:

getAllTaskInstances in interface TaskProvider

getAllTaskInstances

public List<Task> getAllTaskInstances(String processId,
                                      NuxeoPrincipal user,
                                      CoreSession session)

Description copied from interface: TaskProvider

Returns all the tasks instances for the given processId and where the user is the actor or belongs to the pooled actor list. Doesn't take into account tasks that were delegated to this user.

The query is done in unrestricted mode and so the documents linked to the tasks are detached.

Specified by:

getAllTaskInstances in interface TaskProvider

getAllTaskInstances

public List<Task> getAllTaskInstances(String processId,
                                      List<String> actors,
                                      CoreSession session)

Description copied from interface: TaskProvider

Returns all the tasks instances for the given processId which assigned to one of the actor in the list or its pool. Doesn't take into account tasks that were delegated to these users.

The query is done in unrestricted mode and so the documents linked to the tasks are detached.

Specified by:

getAllTaskInstances in interface TaskProvider

wrapDocModelInTask

public static List<Task> wrapDocModelInTask(List<DocumentModel> taskDocuments)

Converts a DocumentModelList to a list of Tasks.

Since:

6.0

wrapDocModelInTask

@Deprecated
public static List<Task> wrapDocModelInTask(DocumentModelList taskDocuments)

Deprecated.

since 6.0, use wrapDocModelInTask(List) instead.

wrapDocModelInTask

@Deprecated
public static List<Task> wrapDocModelInTask(DocumentModelList taskDocuments,
                                            boolean detach)

Deprecated.

since 6.0, use wrapDocModelInTask(List) instead.

Converts a DocumentModelList to a list of Tasks.

Parameters:

detach - if true, detach each document before converting it to a Task.

endTask

public String endTask(CoreSession coreSession,
                      NuxeoPrincipal principal,
                      Task task,
                      String comment,
                      String eventName,
                      boolean isValidated)

Description copied from interface: TaskProvider

Ends the task

Specified by:

endTask in interface TaskProvider

Parameters:

coreSession - the session to use when notifying and resolving of referenced document for notification.

principal - principal used when notifying

task - the instance to end

comment - string added to the task comments and used as a notification comment

eventName - the core event name to use when notifying

isValidated - boolean marker to state if the task was validated or rejected

Returns:

the name of the Seam event to raise

getAllTaskInstances

public List<Task> getAllTaskInstances(String processId,
                                      String nodeId,
                                      CoreSession session)

Description copied from interface: TaskProvider

Returns all the tasks instances for the given processId originating from the given nodeId.

The query is done in unrestricted mode and so the documents linked to the tasks are detached.

Specified by:

getAllTaskInstances in interface TaskProvider

getTaskInstances

public List<Task> getTaskInstances(DocumentModel dm,
                                   List<String> actors,
                                   boolean includeDelegatedTasks,
                                   CoreSession session)

Description copied from interface: TaskProvider

Returns the list of task instances associated with this document assigned to one of the actor in the list or its pool. If the parameter includeDelegatedTasks is true, takes into account tasks that were delegated to these users. The query is done in unrestricted mode and so the documents linked to the tasks are detached.

Specified by:

getTaskInstances in interface TaskProvider

getAllCurrentTaskInstances

public List<Task> getAllCurrentTaskInstances(CoreSession session,
                                             List<SortInfo> sortInfos)

Description copied from interface: TaskProvider

Returns the list of task instances associated assigned to the current user. Takes into account tasks that were delegated to this user. The query is done in unrestricted mode and so the documents linked to the tasks are detached.

Specified by:

getAllCurrentTaskInstances in interface TaskProvider

getTasks

public static List<Task> getTasks(String pageProviderName,
                                  CoreSession session,
                                  boolean unrestricted,
                                  List<SortInfo> sortInfos,
                                  Object... params)

Since:

6.0