|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
@PublicService public interface WorkflowService
Workflow Service. Client facing API for interacting with Alfresco Workflows and Tasks.
Method Summary | |
---|---|
WorkflowInstance |
cancelWorkflow(java.lang.String workflowId)
Cancel an "in-flight" Workflow instance |
NodeRef |
createPackage(NodeRef container)
Create a Workflow Package (a container of content to route through the Workflow). |
WorkflowInstance |
deleteWorkflow(java.lang.String workflowId)
Delete an "in-flight" Workflow instance NOTE: This will force a delete, meaning that the workflow instance may not go through all the appropriate cancel events. |
WorkflowDeployment |
deployDefinition(NodeRef workflowDefinition)
Deploy a Workflow Definition to the Alfresco Repository Note: The specified content object must be of type bpm:workflowdefinition. |
WorkflowDeployment |
deployDefinition(java.lang.String engineId,
java.io.InputStream workflowDefinition,
java.lang.String mimetype)
Deploy a Workflow Definition to the Alfresco Repository |
WorkflowTask |
endTask(java.lang.String taskId,
java.lang.String transitionId)
End the Task (i.e. |
WorkflowPath |
fireEvent(java.lang.String pathId,
java.lang.String event)
Fire custom event against specified path |
java.util.List |
getActiveWorkflows(java.lang.String workflowDefinitionId)
Gets all "in-flight" workflow instances of the specified Workflow Definition |
java.util.List |
getAllDefinitions()
Gets all deployed Workflow Definitions (with all previous versions) |
java.util.List |
getAllDefinitionsByName(java.lang.String workflowName)
Gets all (including previous) Workflow Definitions for the given unique name |
java.util.List |
getAssignedTasks(java.lang.String authority,
WorkflowTaskState state)
Gets all tasks assigned to the specified authority |
WorkflowDefinition |
getDefinitionById(java.lang.String workflowDefinitionId)
Gets a Workflow Definition by unique Id |
WorkflowDefinition |
getDefinitionByName(java.lang.String workflowName)
Gets the latest Workflow Definition by unique name |
byte[] |
getDefinitionImage(java.lang.String workflowDefinitionId)
Gets a graphical view of the Workflow Definition |
java.util.List |
getDefinitions()
Gets latest deployed Workflow Definitions |
java.util.List |
getPackageContents(java.lang.String taskId)
Get a list of node refs to all the package contents for the given task id. |
java.util.Map |
getPathProperties(java.lang.String pathId)
Gets the properties associated with the specified path (and parent paths) |
java.util.List |
getPooledTasks(java.lang.String authority)
Gets the pooled tasks available to the specified authority |
WorkflowTask |
getTaskById(java.lang.String taskId)
Gets a Task by unique Id |
java.util.List |
getTaskDefinitions(java.lang.String workflowDefinitionId)
Gets the Task Definitions for the given Workflow Definition |
java.util.List |
getTasksForWorkflowPath(java.lang.String pathId)
Gets all Tasks associated with the specified path |
java.util.List |
getTimers(java.lang.String workflowId)
Gets all active timers for the specified workflow |
WorkflowInstance |
getWorkflowById(java.lang.String workflowId)
Gets a specific workflow instances |
java.util.List |
getWorkflowPaths(java.lang.String workflowId)
Gets all Paths for the specified Workflow instance |
java.util.List |
getWorkflowsForContent(NodeRef packageItem,
boolean active)
Gets the Workflows that act upon the specified Repository content. |
boolean |
isDefinitionDeployed(NodeRef workflowDefinition)
Is the specified Workflow Definition already deployed? Note: the notion of "already deployed" may differ between bpm engines. |
boolean |
isDefinitionDeployed(java.lang.String engineId,
java.io.InputStream workflowDefinition,
java.lang.String mimetype)
Is the specified Workflow Definition already deployed? Note: the notion of "already deployed" may differ between bpm engines. |
java.util.List |
queryTasks(WorkflowTaskQuery query)
Query for tasks |
WorkflowPath |
signal(java.lang.String pathId,
java.lang.String transitionId)
Signal the transition from one Workflow Node to another |
WorkflowPath |
startWorkflow(java.lang.String workflowDefinitionId,
java.util.Map parameters)
Start a Workflow Instance |
WorkflowPath |
startWorkflowFromTemplate(NodeRef templateDefinition)
Start a Workflow Instance from an existing "Start Task" template node held in the Repository. |
void |
undeployDefinition(java.lang.String workflowDefinitionId)
Undeploy an exisiting Workflow Definition TODO: Determine behaviour when "in-flight" workflow instances exist |
WorkflowTask |
updateTask(java.lang.String taskId,
java.util.Map properties,
java.util.Map add,
java.util.Map remove)
Update the Properties and Associations of a Task |
Method Detail |
---|
@Auditable(parameters={"engineId", "workflowDefinition", "mimetype"}, recordable={true, false, true}) WorkflowDeployment deployDefinition(java.lang.String engineId, java.io.InputStream workflowDefinition, java.lang.String mimetype)
engineId
- the bpm engine idworkflowDefinition
- the workflow definitionmimetype
- the mimetype of the workflow definition
@Auditable(key=ARG_0, parameters="workflowDefinition") WorkflowDeployment deployDefinition(NodeRef workflowDefinition)
workflowDefinition
- the content object containing the definition
@Auditable(parameters="definitionContent") boolean isDefinitionDeployed(NodeRef workflowDefinition)
workflowDefinition
- the content object containing the definition
@Auditable(parameters={"engineId", "workflowDefinition", "mimetype"}, recordable={true, false, true}) boolean isDefinitionDeployed(java.lang.String engineId, java.io.InputStream workflowDefinition, java.lang.String mimetype)
engineId
- the bpm engine idworkflowDefinition
- the definition to checkmimetype
- the mimetype of the definition
@Auditable(parameters="workflowDefinitionId") void undeployDefinition(java.lang.String workflowDefinitionId)
workflowDefinitionId
- the id of the definition to undeploy@Auditable java.util.List getDefinitions()
@Auditable java.util.List getAllDefinitions()
@Auditable(parameters="workflowDefinitionId") WorkflowDefinition getDefinitionById(java.lang.String workflowDefinitionId)
workflowDefinitionId
- the workflow definition id
@Auditable(parameters="workflowName") WorkflowDefinition getDefinitionByName(java.lang.String workflowName)
workflowName
- workflow name e.g. jbpm$wf:review
@Auditable(parameters="workflowName") java.util.List getAllDefinitionsByName(java.lang.String workflowName)
workflowName
- workflow name e.g. jbpm$wf:review
@Auditable(parameters="workflowDefinitionId") byte[] getDefinitionImage(java.lang.String workflowDefinitionId)
workflowDefinitionId
- the workflow definition id
@Auditable(parameters="workflowDefinitionId") java.util.List getTaskDefinitions(java.lang.String workflowDefinitionId)
workflowDefinitionId
- the workflow definition id
@Auditable(parameters={"workflowDefinitionId", "parameters"}) WorkflowPath startWorkflow(java.lang.String workflowDefinitionId, java.util.Map parameters)
workflowDefinitionId
- the workflow definition idparameters
- the initial set of parameters used to populate the "Start Task" properties
@Auditable(parameters="templateDefinition") WorkflowPath startWorkflowFromTemplate(NodeRef templateDefinition)
templateDefinition
- the node representing the Start Task properties
@Auditable(parameters="workflowDefinitionId") java.util.List getActiveWorkflows(java.lang.String workflowDefinitionId)
workflowDefinitionId
- the workflow definition id
@Auditable(parameters="workflowId") WorkflowInstance getWorkflowById(java.lang.String workflowId)
workflowId
- the id of the workflow to retrieve
@Auditable(parameters="workflowId") java.util.List getWorkflowPaths(java.lang.String workflowId)
workflowId
- workflow instance id
@Auditable(parameters="pathId") java.util.Map getPathProperties(java.lang.String pathId)
pathId
- workflow path id
@Auditable(parameters="workflowId") WorkflowInstance cancelWorkflow(java.lang.String workflowId)
workflowId
- the workflow instance to cancel
@Auditable(parameters="workflowId") WorkflowInstance deleteWorkflow(java.lang.String workflowId)
workflowId
- the workflow instance to cancel
@Auditable(parameters={"pathId", "transitionId"}) WorkflowPath signal(java.lang.String pathId, java.lang.String transitionId)
pathId
- the workflow path to signal ontransition
- the transition to follow (or null, for the default transition)
@Auditable(parameters={"pathId", "event"}) WorkflowPath fireEvent(java.lang.String pathId, java.lang.String event)
pathId
- the workflow path to fire event onevent
- name of event
@Auditable(parameters="pathId") java.util.List getTasksForWorkflowPath(java.lang.String pathId)
pathId
- the path id
@Auditable(parameters="workflowId") java.util.List getTimers(java.lang.String workflowId)
@Auditable(parameters="taskId") WorkflowTask getTaskById(java.lang.String taskId)
taskId
- the task id
@Auditable(parameters={"authority", "state"}) java.util.List getAssignedTasks(java.lang.String authority, WorkflowTaskState state)
authority
- the authoritystate
- filter by specified workflow task state
@Auditable(parameters="authority") java.util.List getPooledTasks(java.lang.String authority)
authority
- the authority
@Auditable(parameters="query") java.util.List queryTasks(WorkflowTaskQuery query)
query
- the filter by which tasks are queried
@Auditable(parameters={"taskId", "properties", "add", "remove"}) WorkflowTask updateTask(java.lang.String taskId, java.util.Map properties, java.util.Map add, java.util.Map remove)
taskId
- the task id to updateproperties
- the map of properties to set on the task (or null, if none to set)add
- the map of items to associate with the task (or null, if none to add)remove
- the map of items to dis-associate with the task (or null, if none to remove)
@Auditable(parameters={"taskId", "transitionId"}) WorkflowTask endTask(java.lang.String taskId, java.lang.String transitionId)
taskId
- the task id to endtransition
- the task transition to take on completion (or null, for the default transition)
@Auditable(key=ARG_0, parameters="container") NodeRef createPackage(NodeRef container)
container
- (optional) a pre-created container (e.g. folder, versioned folder or layered folder)
@Auditable(key=ARG_0, parameters={"packageItem", "active"}) java.util.List getWorkflowsForContent(NodeRef packageItem, boolean active)
packageItem
- the repository content item to get workflows foractive
- true => active workflows only, false => completed workflows only
@Auditable(key=ARG_0, parameters={"packageItem", "active"}) java.util.List getPackageContents(java.lang.String taskId)
taskId
- - the task id
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |