Package com.logicaldoc.workflow
Class WorkflowUtil
java.lang.Object
com.logicaldoc.workflow.WorkflowUtil
-
Method Summary
Modifier and TypeMethodDescriptionstatic WorkflowHistory
addNote
(String sid, String taskId, String transitionName, String note, com.logicaldoc.core.security.user.User user) static WorkflowHistory
addNote
(String sid, String taskName, String taskId, String processId, String transitionName, String note, com.logicaldoc.core.security.user.User user) static WorkflowHistory
addNote
(String sid, org.activiti.engine.task.Task task, String transitionName, String note, com.logicaldoc.core.security.user.User user) static void
appendDocument
(String taskId, long docId, String username) Appends a document to a given workflowstatic void
appendDocuments
(String taskId, List<Long> docIds, WorkflowHistory transaction) static void
claim
(String sid, String taskId, com.logicaldoc.core.security.user.User user, WorkflowHistory transaction) static void
complete
(String taskId, String transitionName, WorkflowHistory transaction) static void
complete
(org.activiti.engine.task.Task task, String transitionName, WorkflowHistory transaction) static void
deleteInstance
(String processInstanceId) Deletes a given workflow process instancedeserializeDocIds
(String str) deserializeSupervisors
(String supervisor) static com.logicaldoc.core.document.Document
getAttachedDocument
(String processInstanceId) Returns one of the attached documents in the given WF instancestatic Collection<com.logicaldoc.core.document.Document>
getAttachedDocuments
(String processInstanceId) Returns the documents attache to the given WF instancestatic com.logicaldoc.core.security.user.User
getInitiator
(String processInstanceId, org.activiti.engine.delegate.DelegateTask delegate) Retrieves the user that initiated the workflow(if any)static org.activiti.engine.task.Task
static Object
getVariable
(String processInstanceId, String name) Gets the value of a variable of the specified workflow instancegetVariables
(String processInstanceId) Gets the variables of the specified workflow instancestatic WorkflowDefinition
getWorkflowDefinition
(WorkflowTemplate template) Builds the object model of the workflowprepareDictionary
(org.activiti.engine.delegate.DelegateTask delegate, org.activiti.engine.task.Task task, String taskName, List<String> candidates, String processInstanceId, String processDefinitionId, Map<String, Object> keys) Prepares a dictionary to be passed to the scripting enginestatic void
static void
removeDocument
(String taskId, long docId, WorkflowHistory transaction) static void
removeDocument
(String taskId, long docId, String username) Removes a document from a given workflowstatic void
saveHistory
(WorkflowHistory transaction) Saves a workflow history into the databasestatic void
sendNotifications
(List<String> actors, String emailTemplate, String taskName, String processInstanceId, String processDefinitionId, Map<String, Object> keys, org.activiti.engine.task.Task task) Notifies the actors of a specified workflow nodestatic String
static String
serializeDocIds
(Collection<Long> ids) static String
static String
serializeFileNames
(Collection<Long> ids) static void
setVariable
(String processInstanceId, String name, Object value) Sets the value of a variable of the specified workflow instancestatic String
startWorkflow
(String workflowName, String workflowDescription, String tag, String color, Set<Long> docIds, com.logicaldoc.core.security.Session session, com.logicaldoc.core.security.user.User user) static void
stopInstance
(String processInstanceId) Stops a given workflow process instancestatic void
-
Method Details
-
getAttachedDocument
Returns one of the attached documents in the given WF instance- Parameters:
processInstanceId
- identifier of the process instance- Returns:
- the document
-
getAttachedDocuments
public static Collection<com.logicaldoc.core.document.Document> getAttachedDocuments(String processInstanceId) Returns the documents attache to the given WF instance- Parameters:
processInstanceId
- identifier of the process instance- Returns:
- the collection of documents
-
deserializeDocIds
-
serializeFileNames
-
serializeDocIds
-
serializeDocIdsForDisplay
-
serializeActorIds
-
deserializeSupervisors
-
addNote
public static WorkflowHistory addNote(String sid, String taskId, String transitionName, String note, com.logicaldoc.core.security.user.User user) throws com.logicaldoc.core.PersistenceException - Throws:
com.logicaldoc.core.PersistenceException
-
addNote
public static WorkflowHistory addNote(String sid, org.activiti.engine.task.Task task, String transitionName, String note, com.logicaldoc.core.security.user.User user) throws com.logicaldoc.core.PersistenceException - Throws:
com.logicaldoc.core.PersistenceException
-
addNote
public static WorkflowHistory addNote(String sid, String taskName, String taskId, String processId, String transitionName, String note, com.logicaldoc.core.security.user.User user) throws com.logicaldoc.core.PersistenceException - Throws:
com.logicaldoc.core.PersistenceException
-
complete
public static void complete(org.activiti.engine.task.Task task, String transitionName, WorkflowHistory transaction) throws WorkflowValidationException - Throws:
WorkflowValidationException
-
complete
public static void complete(String taskId, String transitionName, WorkflowHistory transaction) throws WorkflowValidationException - Throws:
WorkflowValidationException
-
deleteInstance
Deletes a given workflow process instance- Parameters:
processInstanceId
- identifier of the instance to delete
-
stopInstance
Stops a given workflow process instance- Parameters:
processInstanceId
- identifier of the instance to stop
-
claim
public static void claim(String sid, String taskId, com.logicaldoc.core.security.user.User user, WorkflowHistory transaction) throws com.logicaldoc.core.PersistenceException - Throws:
com.logicaldoc.core.PersistenceException
-
getTask
-
reassign
public static void reassign(String sid, String taskId, com.logicaldoc.core.security.user.User user) throws com.logicaldoc.core.PersistenceException - Throws:
com.logicaldoc.core.PersistenceException
-
getInitiator
public static com.logicaldoc.core.security.user.User getInitiator(String processInstanceId, org.activiti.engine.delegate.DelegateTask delegate) throws com.logicaldoc.core.PersistenceException Retrieves the user that initiated the workflow(if any)- Parameters:
processInstanceId
- identifier of the process instancedelegate
- the task- Returns:
- the user
- Throws:
com.logicaldoc.core.PersistenceException
- error at data layer
-
prepareDictionary
public static Map<String,Object> prepareDictionary(org.activiti.engine.delegate.DelegateTask delegate, org.activiti.engine.task.Task task, String taskName, List<String> candidates, String processInstanceId, String processDefinitionId, Map<String, Object> keys) throws com.logicaldoc.core.PersistenceExceptionPrepares a dictionary to be passed to the scripting engine- Parameters:
delegate
- delegate of the tasktask
- the tasktaskName
- name of the taskcandidates
- List of unique user namesprocessInstanceId
- identifier of the process instanceprocessDefinitionId
- identifier of the workflow definitionkeys
- map of parameter to be added to the dictionary- Returns:
- map key - value
- Throws:
com.logicaldoc.core.PersistenceException
- error at data layer
-
sendNotifications
public static void sendNotifications(List<String> actors, String emailTemplate, String taskName, String processInstanceId, String processDefinitionId, Map<String, Object> keys, org.activiti.engine.task.Task task) throws com.logicaldoc.core.PersistenceExceptionNotifies the actors of a specified workflow node- Parameters:
actors
- Names of the actorsemailTemplate
- The email template to usetaskName
- Name of the current nodetask
- Current taskprocessInstanceId
- The identifier of the current process instanceprocessDefinitionId
- The identifier of the current process definitionkeys
- Dictionary to use, it could be null- Throws:
com.logicaldoc.core.PersistenceException
- error at data layer
-
unclaim
-
appendDocument
public static void appendDocument(String taskId, long docId, String username) throws com.logicaldoc.core.PersistenceException Appends a document to a given workflow- Parameters:
taskId
- identifier of the current task in the workflowdocId
- identifier of the document to appendusername
- optional the user in name of which the action must be taken- Throws:
com.logicaldoc.core.PersistenceException
- error at data layer
-
getVariables
Gets the variables of the specified workflow instance- Parameters:
processInstanceId
- identifier of the workflow instance- Returns:
- map of variables name-value
-
getVariable
Gets the value of a variable of the specified workflow instance- Parameters:
processInstanceId
- identifier of the workflow instancename
- name of the variable- Returns:
- value value of the variable
-
setVariable
Sets the value of a variable of the specified workflow instance- Parameters:
processInstanceId
- identifier of the workflow instancename
- name of the variablevalue
- value of the variable
-
appendDocuments
public static void appendDocuments(String taskId, List<Long> docIds, WorkflowHistory transaction) throws com.logicaldoc.core.PersistenceException - Throws:
com.logicaldoc.core.PersistenceException
-
removeDocument
public static void removeDocument(String taskId, long docId, String username) throws com.logicaldoc.core.PersistenceException Removes a document from a given workflow- Parameters:
taskId
- identifier of the current task in the workflowdocId
- identifier of the document to appendusername
- optional user in name of which the action must be taken- Throws:
com.logicaldoc.core.PersistenceException
- error at data layer
-
removeDocument
public static void removeDocument(String taskId, long docId, WorkflowHistory transaction) throws com.logicaldoc.core.PersistenceException - Throws:
com.logicaldoc.core.PersistenceException
-
startWorkflow
public static String startWorkflow(String workflowName, String workflowDescription, String tag, String color, Set<Long> docIds, com.logicaldoc.core.security.Session session, com.logicaldoc.core.security.user.User user) throws com.logicaldoc.core.PersistenceException - Throws:
com.logicaldoc.core.PersistenceException
-
getWorkflowDefinition
Builds the object model of the workflow- Parameters:
template
- the templates that stores the XML definition of the workflow- Returns:
- the workflow object model
-
saveHistory
public static void saveHistory(WorkflowHistory transaction) throws com.logicaldoc.core.PersistenceException Saves a workflow history into the database- Parameters:
transaction
- the history to save- Throws:
com.logicaldoc.core.PersistenceException
- error at data layer
-