Package org.nuxeo.ecm.platform.task
Interface TaskProvider
-
- All Superinterfaces:
Serializable
- All Known Subinterfaces:
TaskService
- All Known Implementing Classes:
DocumentTaskProvider
,TaskServiceImpl
public interface TaskProvider extends Serializable
- Since:
- 5.5
- Author:
- Laurent Doguin
-
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description String
endTask(CoreSession coreSession, NuxeoPrincipal principal, Task task, String comment, String eventName, boolean isValidated)
Ends the taskList<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 givenprocessId
originating from the givennodeId
.List<Task>
getAllTaskInstances(String processId, List<String> actors, CoreSession session)
Returns all the tasks instances for the givenprocessId
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 givenprocessId
.List<Task>
getAllTaskInstances(String processId, NuxeoPrincipal user, CoreSession session)
Returns all the tasks instances for the givenprocessId
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 (seegetCurrentTaskInstances(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 (seegetCurrentTaskInstances(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.
-
-
-
Method Detail
-
getCurrentTaskInstances
List<Task> getCurrentTaskInstances(CoreSession coreSession)
- 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.
- Throws:
IllegalStateException
- If the currentUser is null.
-
getCurrentTaskInstances
List<Task> getCurrentTaskInstances(CoreSession coreSession, List<SortInfo> sortInfos)
Provide @param sortInfo to handle sort page-provider contributions (seegetCurrentTaskInstances(org.nuxeo.ecm.core.api.CoreSession)
)- Since:
- 5.9.3
-
getCurrentTaskInstances
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. 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.- Parameters:
actors
- a list used as actorId to retrieve the tasks.- Since:
- 5.5
-
getCurrentTaskInstances
List<Task> getCurrentTaskInstances(List<String> actors, CoreSession coreSession, List<SortInfo> sortInfos)
Provide @param sortInfo to handle sort page-provider contributions (seegetCurrentTaskInstances(org.nuxeo.ecm.core.api.CoreSession)
)- Since:
- 5.9.3
-
getTaskInstances
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. 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.
- Parameters:
dm
- the document.
-
getTaskInstances
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. 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.
-
getTaskInstances
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. If the parameterincludeDelegatedTasks
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.- Since:
- 5.8
-
getAllCurrentTaskInstances
List<Task> getAllCurrentTaskInstances(CoreSession session, List<SortInfo> sortInfos)
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.- Since:
- 7.4
-
getAllTaskInstances
List<Task> getAllTaskInstances(String processId, CoreSession session)
Returns all the tasks instances for the givenprocessId
.The query is done in unrestricted mode and so the documents linked to the tasks are detached.
- Since:
- 5.6
-
getAllTaskInstances
List<Task> getAllTaskInstances(String processId, NuxeoPrincipal user, CoreSession session)
Returns all the tasks instances for the givenprocessId
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.
- Since:
- 5.6
-
getAllTaskInstances
List<Task> getAllTaskInstances(String processId, List<String> actors, CoreSession session)
Returns all the tasks instances for the givenprocessId
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.
- Since:
- 5.6
-
endTask
String endTask(CoreSession coreSession, NuxeoPrincipal principal, Task task, String comment, String eventName, boolean isValidated)
Ends the task- Parameters:
coreSession
- the session to use when notifying and resolving of referenced document for notification.principal
- principal used when notifyingtask
- the instance to endcomment
- string added to the task comments and used as a notification commenteventName
- the core event name to use when notifyingisValidated
- boolean marker to state if the task was validated or rejected- Returns:
- the name of the Seam event to raise
- Throws:
NuxeoException
- when trying to end a task without being granted the right to do so, or when any other error occurs- Since:
- 5.6
-
getAllTaskInstances
List<Task> getAllTaskInstances(String processId, String nodeId, CoreSession session)
Returns all the tasks instances for the givenprocessId
originating from the givennodeId
.The query is done in unrestricted mode and so the documents linked to the tasks are detached.
- Since:
- 5.7
-
-