com.whitestein.lsps.human

Class TodoServiceBean

java.lang.Object

com.whitestein.lsps.common.SecureAndLoggingService

com.whitestein.lsps.human.TodoServiceBean

All Implemented Interfaces:

com.whitestein.lsps.human.ejb.TodoServiceLocal, TodoServiceRemote, TodoService

@PermitAll
public class TodoServiceBean
extends com.whitestein.lsps.common.SecureAndLoggingService
implements com.whitestein.lsps.human.ejb.TodoServiceLocal, TodoServiceRemote

Implementation of TodoService.

Field Summary

Fields inherited from class com.whitestein.lsps.common.SecureAndLoggingService

PRINCIPAL_KEY

Constructor Summary

Constructors

Constructor and Description
TodoServiceBean() Creates new instance.
TodoServiceBean(TodoDao todoDao, PersonServiceLocal personService, ProcessServiceLocal processService, SecurityManagerServiceLocal securityManager, CommunicationService communicationService) Creates new instance.

Method Summary

Modifier and Type	Method and Description
void	allocateTodo(long todoId, java.lang.String personId)
void	checkOrphanedTodo(long todoId)
void	checkOrphanedTodosFor(java.lang.String personId, java.util.Set<RoleUnitName> removedRoles)
void	delegate(long todoId, java.util.Collection<java.lang.String> delegateIds) Delegates the to-do identified by its ID to a given set of delegates identified by their ID-s.
void	escalateTodo(long todoId, java.lang.String reason) Escalates to-do.
java.util.Collection<Person>	getAllOnBehalfOf(long todoId, java.lang.String personId) Returns the set of persons on behalf of which the user sees the to-do in his to-do list.
TodoAuthorization	getAuthorization(long todoId, java.lang.String personId) Returns the reason why the person can see the to-do in his to-do list.
CompressedData	getCompressedTodoSavedState(long todoId) Returns the content of a saved to-do.
java.util.Collection<Person>	getCurrentAssignees(long todoId) Find current assignees for a to-do specified by its ID.
TodoEscalation	getEscalation(long escalationId) Returns todo escalation for the given id.
java.util.Collection<TodoEscalation>	getEscalations(long todoId) Returns a collection of todo escalations.
java.lang.String	getImplementationType(long todoId)
Todo	getLockedTodo(long todoId) Returns the to-do for the given ID including the to-do content and its performers.
java.util.List<java.lang.Long>	getNextTodoIds(ExecutionTrace et, long modelInstanceId, java.lang.String thisTodoNamespace)
TodoList	getNextTodos(ExecutionTrace et, long modelInstanceId, java.lang.String thisTodoNamespace)
TodoList	getPersonalTodoList(PagingCriteria criteria) Returns the personal list for the current user, the to-dos do not contain the to-do content nor the to-do performers.
java.util.Collection<Person>	getRejecters(long todoId) Gets persons who reject to-do specified by its ID.
java.util.Collection<TodoRejection>	getRejections(long todoId) Gets rejections for to-do specified by its ID.
Todo	getTodo(long todoId) Returns the to-do for the given ID including the to-do content and its performers.
long	getTodoCount(TodoListCriteria criteria) Returns the count of to-dos relevant for the current user.
java.lang.Long	getTodoId(long modelInstanceId, long taskId) Returns to-do id.
TodoList	getTodoList(TodoListCriteria criteria) Returns the list of to-dos relevant for the current user.
TodoList	getTodoListForPerson(java.lang.String personId, TodoListCriteria criteria) Returns the list of to-dos relevant for the user identified by the given id.
java.util.List<java.lang.Long>	getTodoListIdsForPerson(java.lang.String personId, TodoListCriteria criteria) Returns the list of to-dos ids relevant for the user identified by the given id.
ByteData	getTodoSavedState(long todoId) Returns the content of a saved to-do.
Todo	getTodoWithIncludes(long todoId, boolean includeContent, boolean includePerformers) Returns the to-do for the given ID.
boolean	isUserRejected(long todoId, java.lang.String personId) Returns true if a todo is rejected by a user.
void	lockTodo(long todoId) Locks the to-do.
void	lockTodoForPerson(long todoId, java.lang.String personId) Locks the to-do for the given person.
void	reassign(long todoId, PerformerList performers) Reassigns todo to new performers.
void	reassignTodo(long todoId, java.util.Set<Performer> performers)
void	rejectAnyTodoForPerson(long todoId, java.lang.String personId, java.lang.String reason, boolean rejectInaccessible) Rejects a to-do specified by its ID by a user, with some reason.
void	rejectTodo(long todoId, java.lang.String reason) Rejects a to-do specified by its ID by a user that is currently logged in, with some reason.
void	rejectTodoForPerson(long todoId, java.lang.String personId, java.lang.String reason) Rejects a to-do specified by its ID by a user, with some reason.
void	resetTodo(long todoId) Resets to-do state.
void	saveTodo(long todoId, ByteData data) Saves to-do.
TodoList	searchTodos(TodoCriteria criteria) Returns the list of to-dos for the given criteria.
TodoList	sendSignalToModelInstance(long modelInstanceId, ObjectValue signal) Sends a signal to the process and returns next to-do group.
TodoList	sendSignalToModelInstanceInNewTransaction(long modelInstanceId, ObjectValue signal) Sends a signal to the process and returns next to-do group.
TodoList	sendSignalToModelInstanceWithDeadlockRetry(long modelInstanceId, ObjectValue signal) Sends a signal to the process and returns next to-do group.
void	setCompressedTodoSavedState(long todoId, CompressedData data) Sets the todo saved state.
void	setNotes(long todoId, java.lang.String notes) Sets notes to the todo
void	setPriority(long todoId, java.lang.Integer priority) Sets priority of the todo in personal todo list
void	setTodoSavedState(long todoId, ByteData data) Sets the todo saved state.
TodoList	startInterpretModelInstance(long modelInstanceId) Starts the interpretation of an existing process for given process ID.
TodoList	startInterpretModelInstanceInNewTransaction(long modelInstanceId) Starts the interpretation of an existing process for given process ID.
TodoList	startInterpretModelInstanceWithDeadlockRetry(long modelInstanceId) Starts the interpretation of an existing process for given process ID.
ExecutionTrace	submit(long todoId, ModelInstance detachedModelInstance)
TodoList	submitTodo(long todoId, ByteData result) Submits the to-do and returns the next to-do group.
TodoList	submitTodo(long todoId, ModelInstance detachedModelInstance)
TodoList	submitTodoInNewTransaction(long todoId, ByteData result) Submits the to-do and returns the next to-do group.
TodoList	submitTodoInNewTransaction(long todoId, ModelInstance detachedModelInstance)
TodoList	submitTodoWithDeadlockRetry(long todoId, ByteData result) Submits the to-do and returns the next to-do group.
TodoList	submitTodoWithDeadlockRetry(long todoId, ModelInstance detachedModelInstance)
void	undoDelegation(long todoId) Undo the to-do delegation for a to-do specified by its ID.
void	undoRejectTodo(long todoId, java.lang.String personId) Undo the rejection of a to-do specified by its ID, by a person specified by its id.
void	unlockTodo(long todoId) Unlocks to-do.

Methods inherited from class com.whitestein.lsps.common.SecureAndLoggingService

getCurrentTransactionData, getOriginalPrincipal, getSecurityManagerService

Methods inherited from class java.lang.Object

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

Constructor Detail

TodoServiceBean

public TodoServiceBean()

Creates new instance.

TodoServiceBean

public TodoServiceBean(TodoDao todoDao,
                       PersonServiceLocal personService,
                       ProcessServiceLocal processService,
                       SecurityManagerServiceLocal securityManager,
                       CommunicationService communicationService)

Creates new instance.

Parameters:

todoDao -

personService -

processService -

securityManager -

communicationService -

Throws:

java.lang.NullPointerException - if any of the arguments is null

Method Detail

startInterpretModelInstance

@RightsAllowed(value="ModelInstance:Create")
public TodoList startInterpretModelInstance(long modelInstanceId)
                                                                                  throws ModelInstanceNotFoundException,
                                                                                         InvalidModelInstanceStateException,
                                                                                         ErrorException

Description copied from interface: TodoService

Starts the interpretation of an existing process for given process ID. Returns a list of to-dos visible to the current user which were created during the current request.

Specified by:

startInterpretModelInstance in interface TodoService

Parameters:

modelInstanceId - process ID

Returns:

a list of to-dos

Throws:

ModelInstanceNotFoundException

InvalidModelInstanceStateException

ErrorException

startInterpretModelInstanceWithDeadlockRetry

@RightsAllowed(value="ModelInstance:Create")
public TodoList startInterpretModelInstanceWithDeadlockRetry(long modelInstanceId)
                                                                                                   throws ModelInstanceNotFoundException,
                                                                                                          InvalidModelInstanceStateException,
                                                                                                          LspsException

Description copied from interface: TodoService

Starts the interpretation of an existing process for given process ID. Returns a list of to-dos visible to the current user which were created during the current request. The action is executed in a new transaction with retry in case of deadlock.

Specified by:

startInterpretModelInstanceWithDeadlockRetry in interface TodoService

Parameters:

modelInstanceId - process ID

Returns:

a list of to-dos

Throws:

ModelInstanceNotFoundException

InvalidModelInstanceStateException

ErrorException

LspsException

startInterpretModelInstanceInNewTransaction

@RightsAllowed(value="ModelInstance:Create")
public TodoList startInterpretModelInstanceInNewTransaction(long modelInstanceId)
                                                                                                  throws ModelInstanceNotFoundException,
                                                                                                         InvalidModelInstanceStateException,
                                                                                                         ErrorException

Description copied from interface: TodoService

Starts the interpretation of an existing process for given process ID. Returns a list of to-dos visible to the current user which were created during the current request. Method is invoked in a new transaction.

Specified by:

startInterpretModelInstanceInNewTransaction in interface TodoService

Parameters:

modelInstanceId - process ID

Returns:

a list of to-dos

Throws:

ModelInstanceNotFoundException

InvalidModelInstanceStateException

ErrorException

getTodo

@RightsAllowed(value={"Todo:Read_Own","Todo:Read_All"})
 @DoNotLog(exceptionClasses=java.security.AccessControlException.class)
public Todo getTodo(long todoId)

Description copied from interface: TodoService

Returns the to-do for the given ID including the to-do content and its performers.

Specified by:

getTodo in interface TodoService

Parameters:

todoId - to-do ID

Returns:

the to-do for the given ID

getTodoWithIncludes

@RightsAllowed(value={"Todo:Read_Own","Todo:Read_All"})
 @DoNotLog(exceptionClasses=java.security.AccessControlException.class)
public Todo getTodoWithIncludes(long todoId,
                                                                                                                                                                boolean includeContent,
                                                                                                                                                                boolean includePerformers)

Description copied from interface: TodoService

Returns the to-do for the given ID. Optionally includes to-do content and its performers.

Specified by:

getTodoWithIncludes in interface TodoService

Parameters:

todoId - to-do ID

Returns:

the to-do for the given ID

getTodoSavedState

@RightsAllowed(value={"Todo:Read_Own","Todo:Read_All"})
 @DoNotLog(exceptionClasses=java.security.AccessControlException.class)
public ByteData getTodoSavedState(long todoId)

Description copied from interface: TodoService

Returns the content of a saved to-do.

Specified by:

getTodoSavedState in interface TodoService

Parameters:

todoId - to-do ID

Returns:

the content data

getCompressedTodoSavedState

@RightsAllowed(value={"Todo:Read_Own","Todo:Read_All"})
 @DoNotLog(exceptionClasses=java.security.AccessControlException.class)
public CompressedData getCompressedTodoSavedState(long todoId)

Description copied from interface: TodoService

Returns the content of a saved to-do.

Specified by:

getCompressedTodoSavedState in interface TodoService

Parameters:

todoId - to-do ID

Returns:

the content data

setTodoSavedState

@RightsAllowed(value="Todo:Write_All")
 @DoNotLog(exceptionClasses=java.security.AccessControlException.class)
public void setTodoSavedState(long todoId,
                                                                                                                                             ByteData data)
                                                                                                                                      throws TodoNotFoundException,
                                                                                                                                             InvalidTodoStatusException

Description copied from interface: TodoService

Sets the todo saved state.

Specified by:

setTodoSavedState in interface TodoService

Throws:

TodoNotFoundException

InvalidTodoStatusException - if the todo is not alive

setCompressedTodoSavedState

@RightsAllowed(value="Todo:Write_All")
 @DoNotLog(exceptionClasses=java.security.AccessControlException.class)
public void setCompressedTodoSavedState(long todoId,
                                                                                                                                                       CompressedData data)
                                                                                                                                                throws TodoNotFoundException,
                                                                                                                                                       InvalidTodoStatusException

Description copied from interface: TodoService

Sets the todo saved state.

Specified by:

setCompressedTodoSavedState in interface TodoService

Throws:

TodoNotFoundException

InvalidTodoStatusException - if the todo is not alive

getLockedTodo

@RightsAllowed(value="Todo:Process")
 @DoNotLog(exceptionClasses={TodoAllocatedException.class,java.security.AccessControlException.class})
public Todo getLockedTodo(long todoId)
                                                                                                                                                               throws TodoAllocatedException

Description copied from interface: TodoService

Returns the to-do for the given ID including the to-do content and its performers. The to-do will be locked (allocated) to the current user if it is still alive.

Specified by:

getLockedTodo in interface TodoService

Parameters:

todoId - to-do ID

Returns:

the to-do for the given ID

Throws:

TodoAllocatedException

lockTodo

@RightsAllowed(value="Todo:Process")
public void lockTodo(long todoId)
                                                   throws TodoNotFoundException,
                                                          InvalidTodoStatusException,
                                                          TodoAllocatedException

Description copied from interface: TodoService

Locks the to-do. The to-do will be visible only in the to-do list of the current user.

Specified by:

lockTodo in interface TodoService

Parameters:

todoId - to-do ID

Throws:

TodoNotFoundException - if no to-do exists for the given todoId

InvalidTodoStatusException - if the to-do is not alive

TodoAllocatedException - if the to-do is already allocated to another person

lockTodoForPerson

@RightsAllowed(value="Todo:Process")
public void lockTodoForPerson(long todoId,
                                                                   java.lang.String personId)
                                                            throws TodoNotFoundException,
                                                                   TodoAllocatedException,
                                                                   InvalidTodoStatusException,
                                                                   PersonNotFoundException

Description copied from interface: TodoService

Locks the to-do for the given person. The to-do will be visible only in the to-do list of the given person.

Specified by:

lockTodoForPerson in interface TodoService

Parameters:

todoId - to-do ID

personId - person ID which will have the to-do locked

Throws:

TodoNotFoundException - if no to-do exists for the given todoId

TodoAllocatedException - if the to-do is already allocated to another person

InvalidTodoStatusException - if the to-do is not alive

PersonNotFoundException - if the person with a given id does not exist

resetTodo

@RightsAllowed(value="Todo:Process")
public void resetTodo(long todoId)
                                                    throws TodoNotFoundException

Description copied from interface: TodoService

Resets to-do state.

Specified by:

resetTodo in interface TodoService

Throws:

TodoNotFoundException - if no to-do exists for the given todoId

submit

@RightsAllowed(value="Todo:Process")
public ExecutionTrace submit(long todoId,
                                                                  ModelInstance detachedModelInstance)
                                                           throws TodoNotFoundException,
                                                                  InvalidTodoStatusException,
                                                                  TodoNotAllocatedException,
                                                                  TodoAllocatedException,
                                                                  ErrorException

Specified by:

submit in interface com.whitestein.lsps.human.ejb.TodoServiceLocal

Throws:

TodoNotFoundException

InvalidTodoStatusException

TodoNotAllocatedException

TodoAllocatedException

ErrorException

submitTodo

@RightsAllowed(value="Todo:Process")
public TodoList submitTodo(long todoId,
                                                                ByteData result)
                                                         throws TodoNotFoundException,
                                                                InvalidTodoStatusException,
                                                                TodoNotAllocatedException,
                                                                TodoAllocatedException,
                                                                ErrorException

Description copied from interface: TodoService

Submits the to-do and returns the next to-do group. Returns a list of to-dos visible to the current user which were created during the current request.

Specified by:

submitTodo in interface TodoService

Parameters:

todoId - to-do ID

result - data entered by user in the web page, may be null.

Returns:

to-do group to be shown to the user, not null, may be empty.

Throws:

TodoNotFoundException - if no to-do exists for the given todoId

InvalidTodoStatusException - if the to-do is not alive anymore

TodoNotAllocatedException - if the to-do is not allocated to the current person

TodoAllocatedException - if the to-do is allocated to another person

ErrorException - if there is an error processing the to-do

submitTodo

@RightsAllowed(value="Todo:Process")
public TodoList submitTodo(long todoId,
                                                                ModelInstance detachedModelInstance)
                                                         throws TodoNotFoundException,
                                                                InvalidTodoStatusException,
                                                                TodoNotAllocatedException,
                                                                TodoAllocatedException,
                                                                ErrorException

Specified by:

submitTodo in interface com.whitestein.lsps.human.ejb.TodoServiceLocal

Throws:

TodoNotFoundException

InvalidTodoStatusException

TodoNotAllocatedException

TodoAllocatedException

ErrorException

submitTodoWithDeadlockRetry

@RightsAllowed(value="Todo:Process")
public TodoList submitTodoWithDeadlockRetry(long todoId,
                                                                                 ByteData result)
                                                                          throws TodoNotFoundException,
                                                                                 InvalidTodoStatusException,
                                                                                 TodoNotAllocatedException,
                                                                                 TodoAllocatedException,
                                                                                 ErrorException,
                                                                                 LspsException

Description copied from interface: TodoService

Submits the to-do and returns the next to-do group. Returns a list of to-dos visible to the current user which were created during the current request. The action is executed in a new transaction with retry in case of deadlock.

Specified by:

submitTodoWithDeadlockRetry in interface TodoService

Parameters:

todoId - to-do ID

result - data entered by user in the web page

Returns:

to-do group to be shown to the user or null

Throws:

TodoNotFoundException - if no to-do exists for the given todoId

InvalidTodoStatusException - if the to-do is not alive anymore

TodoNotAllocatedException - if the to-do is not allocated to the current person

TodoAllocatedException - if the to-do is allocated to another person

ErrorException - if there is an error processing the to-do

LspsException

submitTodoWithDeadlockRetry

@RightsAllowed(value="Todo:Process")
public TodoList submitTodoWithDeadlockRetry(long todoId,
                                                                                 ModelInstance detachedModelInstance)
                                                                          throws TodoNotFoundException,
                                                                                 InvalidTodoStatusException,
                                                                                 TodoNotAllocatedException,
                                                                                 TodoAllocatedException,
                                                                                 ErrorException,
                                                                                 LspsException

Specified by:

submitTodoWithDeadlockRetry in interface com.whitestein.lsps.human.ejb.TodoServiceLocal

Throws:

TodoNotFoundException

InvalidTodoStatusException

TodoNotAllocatedException

TodoAllocatedException

ErrorException

LspsException

submitTodoInNewTransaction

@RightsAllowed(value="Todo:Process")
public TodoList submitTodoInNewTransaction(long todoId,
                                                                                ByteData result)
                                                                         throws TodoNotFoundException,
                                                                                InvalidTodoStatusException,
                                                                                TodoNotAllocatedException,
                                                                                TodoAllocatedException,
                                                                                ErrorException

Description copied from interface: TodoService

Submits the to-do and returns the next to-do group. Returns a list of to-dos visible to the current user which were created during the current request. Method is invoked in a new transaction.

Specified by:

submitTodoInNewTransaction in interface TodoService

Parameters:

todoId - to-do ID

result - data entered by user in the web page

Returns:

to-do group to be shown to the user or null

Throws:

TodoNotFoundException - if no to-do exists for the given todoId

InvalidTodoStatusException - if the to-do is not alive anymore

TodoNotAllocatedException - if the to-do is not allocated to the current person

TodoAllocatedException - if the to-do is allocated to another person

ErrorException - if there is an error processing the to-do

submitTodoInNewTransaction

@RightsAllowed(value="Todo:Process")
public TodoList submitTodoInNewTransaction(long todoId,
                                                                                ModelInstance detachedModelInstance)
                                                                         throws TodoNotFoundException,
                                                                                InvalidTodoStatusException,
                                                                                TodoNotAllocatedException,
                                                                                TodoAllocatedException,
                                                                                ErrorException

Specified by:

submitTodoInNewTransaction in interface com.whitestein.lsps.human.ejb.TodoServiceLocal

Throws:

TodoNotFoundException

InvalidTodoStatusException

TodoNotAllocatedException

TodoAllocatedException

ErrorException

getNextTodos

@RightsAllowed(value="Todo:Process")
public TodoList getNextTodos(ExecutionTrace et,
                                                                  long modelInstanceId,
                                                                  java.lang.String thisTodoNamespace)

Specified by:

getNextTodos in interface com.whitestein.lsps.human.ejb.TodoServiceLocal

getNextTodoIds

@RightsAllowed(value="Todo:Process")
public java.util.List<java.lang.Long> getNextTodoIds(ExecutionTrace et,
                                                                                          long modelInstanceId,
                                                                                          java.lang.String thisTodoNamespace)

Specified by:

getNextTodoIds in interface com.whitestein.lsps.human.ejb.TodoServiceLocal

saveTodo

@RightsAllowed(value="Todo:Process")
public void saveTodo(long todoId,
                                                          ByteData data)
                                                   throws TodoNotFoundException,
                                                          InvalidTodoStatusException

Description copied from interface: TodoService

Saves to-do. The to-do will appear again in the to-do lists of all associated performers.

Specified by:

saveTodo in interface TodoService

Parameters:

todoId - to-do ID

data - user-entered values

Throws:

TodoNotFoundException - if no to-do exists for the given todoId

InvalidTodoStatusException - if the to-do is not alive anymore

unlockTodo

@RightsAllowed(value="Todo:Process")
public void unlockTodo(long todoId)
                                                     throws TodoNotFoundException,
                                                            InvalidTodoStatusException

Description copied from interface: TodoService

Unlocks to-do. The to-do will appear again in the to-do lists of all associated performers.

Specified by:

unlockTodo in interface TodoService

Parameters:

todoId - to-do ID

Throws:

TodoNotFoundException - if no to-do exists for the given todoId

InvalidTodoStatusException

sendSignalToModelInstance

@RightsAllowed(value="Signal:Send")
public TodoList sendSignalToModelInstance(long modelInstanceId,
                                                                              ObjectValue signal)
                                                                       throws ModelInstanceNotFoundException,
                                                                              InvalidModelInstanceStateException,
                                                                              ErrorException

Description copied from interface: TodoService

Sends a signal to the process and returns next to-do group. Returns a list of to-dos visible to the current user which were created during the current request.

Specified by:

sendSignalToModelInstance in interface TodoService

Parameters:

modelInstanceId - model instance ID

signal - signal to be sent to the process

Returns:

to-do group to be shown to the user or null

Throws:

ModelInstanceNotFoundException

InvalidModelInstanceStateException

ErrorException

sendSignalToModelInstanceWithDeadlockRetry

@RightsAllowed(value="Signal:Send")
public TodoList sendSignalToModelInstanceWithDeadlockRetry(long modelInstanceId,
                                                                                               ObjectValue signal)
                                                                                        throws ModelInstanceNotFoundException,
                                                                                               InvalidModelInstanceStateException,
                                                                                               ErrorException,
                                                                                               LspsException

Description copied from interface: TodoService

Sends a signal to the process and returns next to-do group. Returns a list of to-dos visible to the current user which were created during the current request. The action is executed in a new transaction with retry in case of deadlock.

Specified by:

sendSignalToModelInstanceWithDeadlockRetry in interface TodoService

Parameters:

modelInstanceId - model instance ID

signal - signal to be sent to the process

Returns:

to-do group to be shown to the user or null

Throws:

ModelInstanceNotFoundException

InvalidModelInstanceStateException

ErrorException

LspsException

sendSignalToModelInstanceInNewTransaction

@RightsAllowed(value="Signal:Send")
public TodoList sendSignalToModelInstanceInNewTransaction(long modelInstanceId,
                                                                                              ObjectValue signal)
                                                                                       throws ModelInstanceNotFoundException,
                                                                                              InvalidModelInstanceStateException,
                                                                                              ErrorException

Description copied from interface: TodoService

Sends a signal to the process and returns next to-do group. Returns a list of to-dos visible to the current user which were created during the current request. Method is invoked in a new transaction.

Specified by:

sendSignalToModelInstanceInNewTransaction in interface TodoService

Parameters:

modelInstanceId - model instance ID

signal - signal to be sent to the process

Returns:

to-do group to be shown to the user or null

Throws:

ModelInstanceNotFoundException

InvalidModelInstanceStateException

ErrorException

getTodoList

@RightsAllowed(value={"Todo:Read_All","Todo:Read_Own"})
public TodoList getTodoList(TodoListCriteria criteria)

Description copied from interface: TodoService

Returns the list of to-dos relevant for the current user.

Specified by:

getTodoList in interface TodoService

Returns:

list of to-dos

getTodoCount

public long getTodoCount(TodoListCriteria criteria)

Description copied from interface: TodoService

Returns the count of to-dos relevant for the current user.

Specified by:

getTodoCount in interface TodoService

Returns:

a count of to-dos

getTodoListForPerson

@RightsAllowed(value={"Todo:Read_All","Todo:Read_Own"})
 @DoNotLog(exceptionClasses=java.security.AccessControlException.class)
public TodoList getTodoListForPerson(java.lang.String personId,
                                                                                                                                                                     TodoListCriteria criteria)
                                                                                                                                                              throws PersonNotFoundException

Description copied from interface: TodoService

Returns the list of to-dos relevant for the user identified by the given id.

Specified by:

getTodoListForPerson in interface TodoService

Parameters:

personId - the id of a person

Returns:

list of to-dos

Throws:

PersonNotFoundException - if no person with the given personId exists

getTodoListIdsForPerson

public java.util.List<java.lang.Long> getTodoListIdsForPerson(java.lang.String personId,
                                                              TodoListCriteria criteria)
                                                       throws PersonNotFoundException

Description copied from interface: TodoService

Returns the list of to-dos ids relevant for the user identified by the given id.

Specified by:

getTodoListIdsForPerson in interface TodoService

Returns:

list of todo ids

Throws:

PersonNotFoundException

searchTodos

@RightsAllowed(value="Todo:Read")
public TodoList searchTodos(TodoCriteria criteria)

Description copied from interface: TodoService

Returns the list of to-dos for the given criteria.

Specified by:

searchTodos in interface TodoService

Parameters:

criteria - to-do criteria

Returns:

list of to-dos

getPersonalTodoList

@RightsAllowed(value={"Todo:Read_All","Todo:Read_Own"})
public TodoList getPersonalTodoList(PagingCriteria criteria)

Description copied from interface: TodoService

Returns the personal list for the current user, the to-dos do not contain the to-do content nor the to-do performers.

Specified by:

getPersonalTodoList in interface TodoService

Parameters:

criteria - paging criteria

Returns:

list of personal to-dos

escalateTodo

@RightsAllowed(value={"Todo:Escalate_Own","Todo:Escalate_All"})
public void escalateTodo(long todoId,
                                                                                         java.lang.String reason)
                                                                                  throws TodoNotFoundException,
                                                                                         InvalidTodoStatusException,
                                                                                         ErrorException

Description copied from interface: TodoService

Escalates to-do.

Specified by:

escalateTodo in interface TodoService

Parameters:

todoId - to-do ID

reason - reason of escalation

Throws:

TodoNotFoundException - if no to-do exists for the given todoId

InvalidTodoStatusException - if the to-do is not alive anymore

ErrorException

rejectTodo

@RightsAllowed(value="Todo:Reject")
public void rejectTodo(long todoId,
                                                           java.lang.String reason)
                                                    throws TodoNotFoundException,
                                                           InvalidTodoStatusException

Description copied from interface: TodoService

Rejects a to-do specified by its ID by a user that is currently logged in, with some reason.

Specified by:

rejectTodo in interface TodoService

Parameters:

todoId - to-do ID

reason - reason of rejection

Throws:

TodoNotFoundException - if no to-do exists for the given todoId

InvalidTodoStatusException - if the to-do is not alive anymore

rejectTodoForPerson

@RightsAllowed(value="Todo:Reject")
public void rejectTodoForPerson(long todoId,
                                                                    java.lang.String personId,
                                                                    java.lang.String reason)
                                                             throws TodoNotFoundException,
                                                                    InvalidTodoStatusException

Description copied from interface: TodoService

Rejects a to-do specified by its ID by a user, with some reason.

Specified by:

rejectTodoForPerson in interface TodoService

Parameters:

todoId - to-do ID

reason - reason of rejection

Throws:

TodoNotFoundException - if no to-do exists for the given todoId

InvalidTodoStatusException - if the to-do is not alive anymore

rejectAnyTodoForPerson

@RightsAllowed(value="Todo:Reject")
public void rejectAnyTodoForPerson(long todoId,
                                                                       java.lang.String personId,
                                                                       java.lang.String reason,
                                                                       boolean rejectInaccessible)
                                                                throws TodoNotFoundException,
                                                                       InvalidTodoStatusException

Description copied from interface: TodoService

Rejects a to-do specified by its ID by a user, with some reason.

Specified by:

rejectAnyTodoForPerson in interface TodoService

Parameters:

todoId - to-do ID

reason - reason of rejection

rejectInaccessible - if true todos for that the current person can't access can be rejected

Throws:

TodoNotFoundException - if no to-do exists for the given todoId

InvalidTodoStatusException - if the to-do is not alive anymore

undoRejectTodo

@RightsAllowed(value="Todo:Undo_Reject")
public void undoRejectTodo(long todoId,
                                                                    java.lang.String personId)
                                                             throws TodoNotFoundException,
                                                                    InvalidTodoStatusException,
                                                                    PersonNotFoundException

Description copied from interface: TodoService

Undo the rejection of a to-do specified by its ID, by a person specified by its id.

Specified by:

undoRejectTodo in interface TodoService

Parameters:

todoId - to-do ID

personId - id of person who rejected the to-do

Throws:

TodoNotFoundException - if no to-do exists for the given todoId

InvalidTodoStatusException - if the to-do is not alive anymore

PersonNotFoundException - if no person with the given id exists

getRejecters

@RightsAllowed(value="Todo:Read_Assignees")
public java.util.Collection<Person> getRejecters(long todoId)
                                                                                      throws TodoNotFoundException

Description copied from interface: TodoService

Gets persons who reject to-do specified by its ID.

Specified by:

getRejecters in interface TodoService

Parameters:

todoId - to-do ID

Returns:

set of persons that reject the to-do

Throws:

TodoNotFoundException - if no to-do exists for the given todoId

getRejections

@RightsAllowed(value="Todo:Read_Assignees")
public java.util.Collection<TodoRejection> getRejections(long todoId)
                                                                                              throws TodoNotFoundException

Description copied from interface: TodoService

Gets rejections for to-do specified by its ID.

Specified by:

getRejections in interface TodoService

Parameters:

todoId - to-do ID

Returns:

set of TodoRejections for the to-do

Throws:

TodoNotFoundException - if no to-do exists for the given todoId

getEscalation

@RightsAllowed(value={"Todo:Read_Own","Todo:Read_All"})
public TodoEscalation getEscalation(long escalationId)
                                                                                     throws TodoEscalationNotFoundException

Description copied from interface: TodoService

Returns todo escalation for the given id.

Specified by:

getEscalation in interface TodoService

Returns:

todo escalation for the given id

Throws:

TodoEscalationNotFoundException

getEscalations

@RightsAllowed(value={"Todo:Read_Own","Todo:Read_All"})
public java.util.Collection<TodoEscalation> getEscalations(long todoId)
                                                                                                            throws TodoNotFoundException

Description copied from interface: TodoService

Returns a collection of todo escalations.

Specified by:

getEscalations in interface TodoService

Returns:

a collection of todo escalations

Throws:

TodoNotFoundException - if no to-do exists for the given todoId

delegate

@RightsAllowed(value={"Todo:Delegate_All","Todo:Delegate_Own"})
public void delegate(long todoId,
                                                                                     java.util.Collection<java.lang.String> delegateIds)
                                                                              throws TodoNotFoundException,
                                                                                     InvalidTodoStatusException,
                                                                                     PersonNotFoundException

Description copied from interface: TodoService

Delegates the to-do identified by its ID to a given set of delegates identified by their ID-s.

Specified by:

delegate in interface TodoService

Parameters:

todoId - to-do ID

delegateIds - Set of delegate's ID-s

Throws:

TodoNotFoundException - if no to-do exists for the given todoId

InvalidTodoStatusException - if the to-do is not alive anymore

PersonNotFoundException - if no person with the given delegates exist

undoDelegation

@RightsAllowed(value="Todo:Delegate_All")
public void undoDelegation(long todoId)
                                                              throws TodoNotFoundException,
                                                                     InvalidTodoStatusException

Description copied from interface: TodoService

Undo the to-do delegation for a to-do specified by its ID. Does nothing if at delegation level 0.

Specified by:

undoDelegation in interface TodoService

Parameters:

todoId - to-do ID

Throws:

TodoNotFoundException - if no to-do exists for the given todoId

InvalidTodoStatusException

getCurrentAssignees

@RightsAllowed(value="Todo:Read_Assignees")
public java.util.Collection<Person> getCurrentAssignees(long todoId)
                                                                                             throws TodoNotFoundException

Description copied from interface: TodoService

Find current assignees for a to-do specified by its ID. Only initial performers and delegation is taken into account. The resulting persons contain also first level substitutions.

Specified by:

getCurrentAssignees in interface TodoService

Parameters:

todoId - to-do ID

Returns:

set of assignees

Throws:

TodoNotFoundException - if no to-do exists for the given todoId

getAuthorization

@RightsAllowed(value={"Todo:Read_Own","Todo:Read_All"})
public TodoAuthorization getAuthorization(long todoId,
                                                                                                  java.lang.String personId)
                                                                                           throws TodoNotFoundException,
                                                                                                  PersonNotFoundException

Description copied from interface: TodoService

Returns the reason why the person can see the to-do in his to-do list.

Specified by:

getAuthorization in interface TodoService

Parameters:

todoId - to-do ID

personId - ID of person

Returns:

authorization information

Throws:

TodoNotFoundException - if no to-do exists for the given todoId

PersonNotFoundException - if no person exists for the given personId

getAllOnBehalfOf

@RightsAllowed(value={"Todo:Read_Own","Todo:Read_All"})
public java.util.Collection<Person> getAllOnBehalfOf(long todoId,
                                                                                                             java.lang.String personId)
                                                                                                      throws TodoNotFoundException,
                                                                                                             PersonNotFoundException

Description copied from interface: TodoService

Returns the set of persons on behalf of which the user sees the to-do in his to-do list. If the to-do is in the user's to-do list because he is a substitute of some other users (see TodoService.getAuthorization(long, String)), this method returns the set of the to-do performers that have this user as their substitute. If the to-do is in the user's to-do list because it was delegated to him, this method returns the person that performed the delegation. In other cases an empty set will be returned.

Specified by:

getAllOnBehalfOf in interface TodoService

Returns:

set of persons on behalf of which the user sees the to-do in his to-do list

Throws:

TodoNotFoundException - if no to-do exists for the given todoId

PersonNotFoundException - if no person exists for the given personId

setNotes

@RightsAllowed(value="Todo:Process")
public void setNotes(long todoId,
                                                          java.lang.String notes)
                                                   throws TodoNotFoundException,
                                                          InvalidTodoStatusException,
                                                          TodoNotAllocatedException,
                                                          TodoAllocatedException

Description copied from interface: TodoService

Sets notes to the todo

Specified by:

setNotes in interface TodoService

Throws:

TodoNotFoundException - if no to-do exists for the given todoId

InvalidTodoStatusException - if the to-do is not alive anymore

TodoNotAllocatedException - if the to-do is not allocated to the current person

TodoAllocatedException - if the to-do is allocated to another person

setPriority

@RightsAllowed(value="Todo:Process")
public void setPriority(long todoId,
                                                             java.lang.Integer priority)
                                                      throws TodoNotFoundException,
                                                             InvalidTodoStatusException,
                                                             TodoNotAllocatedException,
                                                             TodoAllocatedException

Description copied from interface: TodoService

Sets priority of the todo in personal todo list

Specified by:

setPriority in interface TodoService

Throws:

TodoNotFoundException - if no to-do exists for the given todoId

InvalidTodoStatusException - if the to-do is not alive anymore

TodoNotAllocatedException - if the to-do is not allocated to the current person

TodoAllocatedException - if the to-do is allocated to another person

checkOrphanedTodo

@RightsAllowed(value="Todo:Read_All")
public void checkOrphanedTodo(long todoId)

Specified by:

checkOrphanedTodo in interface com.whitestein.lsps.human.ejb.TodoServiceLocal

checkOrphanedTodosFor

@RightsAllowed(value="Todo:Read_All")
public void checkOrphanedTodosFor(java.lang.String personId,
                                                                        java.util.Set<RoleUnitName> removedRoles)

Specified by:

checkOrphanedTodosFor in interface com.whitestein.lsps.human.ejb.TodoServiceLocal

reassign

public void reassign(long todoId,
                     PerformerList performers)
              throws TodoNotFoundException,
                     InvalidTodoStatusException

Description copied from interface: TodoService

Reassigns todo to new performers.

Specified by:

reassign in interface TodoService

Throws:

TodoNotFoundException

InvalidTodoStatusException

reassignTodo

@RightsAllowed(value="Todo:Reassign")
public void reassignTodo(long todoId,
                                                               java.util.Set<Performer> performers)
                                                        throws TodoNotFoundException,
                                                               InvalidTodoStatusException

Specified by:

reassignTodo in interface com.whitestein.lsps.human.ejb.TodoServiceLocal

Throws:

TodoNotFoundException

InvalidTodoStatusException

allocateTodo

public void allocateTodo(long todoId,
                         java.lang.String personId)
                  throws TodoNotFoundException,
                         InvalidTodoStatusException,
                         ErrorException

Specified by:

allocateTodo in interface com.whitestein.lsps.human.ejb.TodoServiceLocal

Throws:

TodoNotFoundException

InvalidTodoStatusException

ErrorException

getImplementationType

public java.lang.String getImplementationType(long todoId)
                                       throws TodoNotFoundException

Specified by:

getImplementationType in interface com.whitestein.lsps.human.ejb.TodoServiceLocal

Throws:

TodoNotFoundException

isUserRejected

public boolean isUserRejected(long todoId,
                              java.lang.String personId)

Description copied from interface: TodoService

Returns true if a todo is rejected by a user.

Specified by:

isUserRejected in interface TodoService

Returns:

true if a todo is rejected by a user

getTodoId

public java.lang.Long getTodoId(long modelInstanceId,
                                long taskId)

Returns to-do id.

Specified by:

getTodoId in interface com.whitestein.lsps.human.ejb.TodoServiceLocal

Parameters:

modelInstanceId -

taskId -

Returns:

to-do id