lumis.content.workflow
Interface IWorkflowManager

Package class diagram package IWorkflowManager
All Known Implementing Classes:
WorkflowManager

@StableMinor(version="4.1",
             sinceVersion="4.0")
public interface IWorkflowManager

Interface for Workflow Manager.

Since:
4.0.0

Field Summary
static String ASSIGNED_TO_KEEP_SAME_VALUE
          The value used by some methods to indicate that the current assigned to value must be kept.
 
Method Summary
 boolean autoArchivePublishedContent(String metaDataId, ITransaction transaction)
          Used for the automatic content archiving process.
 boolean contentMayBePublished(SessionConfig sessionConfig, String itemId, String serviceInstanceId, String sourceId, ITransaction transaction)
           
 void createNewContentWorkflowMetaData(SessionConfig sessionConfig, String itemId, String serviceInstanceId, String sourceId, String assignedTo, ITransaction transaction)
          Creates the content workflow metadata for a new content.
 void deleteAllContentWorkflowMetaData(SessionConfig sessionConfig, String serviceInstanceId, ITransaction transaction)
          Deletes all the workflow metadata that is assocated to a specified service instance.
 void deleteContentWorkflowMetaData(SessionConfig sessionConfig, String itemId, String serviceInstanceId, String sourceId, ITransaction transaction)
          Deletes the content workflow metadata of the given content.
 void destroyServiceInstanceWorkflow(SessionConfig sessionConfig, String serviceInstanceId, ITransaction transaction)
          Destroys the service instance workflow, so that the service instance can be correctly removed.
 void executeAction(SessionConfig sessionConfig, String itemId, String serviceInstanceId, String sourceId, String performedTransitionId, String newAssignedTo, ITransaction transaction)
          Executes an action on a content's workflow.
 Collection<WorkflowStateConfig> getAccessibleStates(SessionConfig sessionConfig, String serviceInstanceId, boolean includeScopeAll, boolean includeScopeAssignedTo, ITransaction transaction)
          Returns a collection of workflow's accessible states.
 Collection<WorkflowTransitionConfig> getAccessibleTransitions(SessionConfig sessionConfig, String itemId, String serviceInstanceId, String sourceId, ITransaction transaction)
          Returns the transitions that are accessible by the sessionConfig's user for a specified content.
 Collection<WorkflowConfig> getAllWorkflows(SessionConfig sessionConfig, ITransaction transaction)
          Returns all registered workflows.
 ContentWorkflowMetaData getContentWorkflowMetaData(SessionConfig sessionConfig, String metaDataId, ITransaction transaction)
          Returns the content workflow metadata for a metadata id.
 ContentWorkflowMetaData getContentWorkflowMetaData(SessionConfig sessionConfig, String itemId, String serviceInstanceId, String sourceId, ITransaction transaction)
          Returns the content workflow metadata for a content.
 Collection<String> getPossibleAssignedToForAction(SessionConfig sessionConfig, String itemId, String serviceInstanceId, String sourceId, String transitionId, ITransaction transaction)
          Returns the possible assignedTo values for a workflow transition.
 WorkflowConfig getServiceInstanceWorkflow(SessionConfig sessionConfig, String serviceInstanceId, ITransaction transaction)
          Returns the workflow of a service instance.
 WorkflowStateConfig getState(SessionConfig sessionConfig, String workflowId, String stateId, ITransaction transaction)
          Returns a workflow state.
 WorkflowTransitionConfig getTransition(SessionConfig sessionConfig, String workflowId, String transitionId, ITransaction transaction)
          Returns a workflow transition.
 List<WorkflowTransitionConfig> getTransitionsByStateId(SessionConfig sessionConfig, String workflowId, String stateId, ITransaction transaction)
          Returns the transitions for a workflow state.
 WorkflowConfig getWorkflow(SessionConfig sessionConfig, String workflowId, ITransaction transaction)
          Returns a workflow.
 Collection<WorkflowPermission> getWorkflowPermissions(SessionConfig sessionConfig, String serviceInstanceId, ITransaction transaction)
          Returns the permissions set for a workflow in a service instance.
 boolean hasEditPermission(SessionConfig sessionConfig, String itemId, String serviceInstanceId, String sourceId, ITransaction transaction)
          Returns true if the sessionConfig's user has edit permission to the specified item, according to the workflow's definition, state and assigned to.
 void register(SessionConfig sessionConfig, String workflowConfigPath, ITransaction transaction)
          Register a workflow.
 void setServiceInstanceWorkflow(SessionConfig sessionConfig, String serviceInstanceId, String workflowId, ITransaction transaction)
          Sets the workflow to be used in a service instance.
 void setWorkflowPermissions(SessionConfig sessionConfig, String serviceInstanceId, Collection<WorkflowPermission> permissions, ITransaction transaction)
          Updates the workflow permissions in a service instance.
 void unregister(SessionConfig sessionConfig, String workflowId, ITransaction transaction)
          Removes a workflow from the register.
 void updateRegister(SessionConfig sessionConfig, String workflowId, ITransaction transaction)
          Updates the register of a workflow.
 

Field Detail

ASSIGNED_TO_KEEP_SAME_VALUE

static final String ASSIGNED_TO_KEEP_SAME_VALUE
The value used by some methods to indicate that the current assigned to value must be kept.

See Also:
Constant Field Values
Method Detail

register

void register(SessionConfig sessionConfig,
              String workflowConfigPath,
              ITransaction transaction)
              throws PortalException
Register a workflow.

Parameters:
sessionConfig - the user session information.
workflowConfigPath - the path, relative to the definition directory, to the directory with the workflow's definition.
transaction - the transaction for persistence access.
Throws:
PortalException

updateRegister

void updateRegister(SessionConfig sessionConfig,
                    String workflowId,
                    ITransaction transaction)
                    throws PortalException
Updates the register of a workflow.

Parameters:
sessionConfig - the user session information.
workflowId - the workflow id.
transaction - the transaction for persistence access.
Throws:
PortalException
Since:
4.0.5

unregister

void unregister(SessionConfig sessionConfig,
                String workflowId,
                ITransaction transaction)
                throws PortalException
Removes a workflow from the register.

Parameters:
sessionConfig - the user session information.
workflowId - the workflow's identifier.
transaction - the transaction for persistence access.
Throws:
PortalException

getWorkflow

WorkflowConfig getWorkflow(SessionConfig sessionConfig,
                           String workflowId,
                           ITransaction transaction)
                           throws PortalException
Returns a workflow.

Parameters:
sessionConfig - the user session information.
workflowId - the workflow's identifier.
transaction - the transaction for persistence access.
Returns:
the workflow.
Throws:
PortalException

getState

WorkflowStateConfig getState(SessionConfig sessionConfig,
                             String workflowId,
                             String stateId,
                             ITransaction transaction)
                             throws PortalException
Returns a workflow state.

Parameters:
sessionConfig - the user session information.
workflowId - the identifier of the state's workflow.
stateId - the state's identifier.
transaction - the transaction for persistence access.
Returns:
the state.
Throws:
PortalException

getTransition

WorkflowTransitionConfig getTransition(SessionConfig sessionConfig,
                                       String workflowId,
                                       String transitionId,
                                       ITransaction transaction)
                                       throws PortalException
Returns a workflow transition.

Parameters:
sessionConfig - the user session information.
workflowId - the identifier of the state's workflow.
transitionId - the transition's identifier.
transaction - the transaction for persistence access.
Returns:
the transition.
Throws:
PortalException

getTransitionsByStateId

List<WorkflowTransitionConfig> getTransitionsByStateId(SessionConfig sessionConfig,
                                                       String workflowId,
                                                       String stateId,
                                                       ITransaction transaction)
                                                       throws PortalException
Returns the transitions for a workflow state.

Parameters:
sessionConfig - the user session information.
workflowId - the identifier of the state's workflow.
stateId - the state's identifier.
transaction - the transaction for persistence access.
Returns:
a list with the state's transitions.
Throws:
PortalException

getAccessibleTransitions

Collection<WorkflowTransitionConfig> getAccessibleTransitions(SessionConfig sessionConfig,
                                                              String itemId,
                                                              String serviceInstanceId,
                                                              String sourceId,
                                                              ITransaction transaction)
                                                              throws PortalException
Returns the transitions that are accessible by the sessionConfig's user for a specified content.

Parameters:
sessionConfig - the user session information.
itemId - the content's itemId.
serviceInstanceId - the content's service instance identifier.
sourceId - the content's source identifier.
transaction - the transaction for persistence access.
Returns:
a collection with the transitions.
Throws:
PortalException

getAccessibleStates

Collection<WorkflowStateConfig> getAccessibleStates(SessionConfig sessionConfig,
                                                    String serviceInstanceId,
                                                    boolean includeScopeAll,
                                                    boolean includeScopeAssignedTo,
                                                    ITransaction transaction)
                                                    throws PortalException
Returns a collection of workflow's accessible states.

Parameters:
sessionConfig - user session information.
serviceInstanceId - the content service instance id.
includeScopeAll - if the states with permission scope all are to be included.
includeScopeAssignedTo - if the states with permission scope assigned to are to be included.
transaction - the transaction for persistence acecess.
Returns:
a collection with the workflow's acessible states.
Throws:
PortalException

getServiceInstanceWorkflow

WorkflowConfig getServiceInstanceWorkflow(SessionConfig sessionConfig,
                                          String serviceInstanceId,
                                          ITransaction transaction)
                                          throws PortalException
Returns the workflow of a service instance.

Parameters:
sessionConfig - user session information.
serviceInstanceId - the service instance's id.
transaction - the transaction for persistence access.
Throws:
PortalException

setServiceInstanceWorkflow

void setServiceInstanceWorkflow(SessionConfig sessionConfig,
                                String serviceInstanceId,
                                String workflowId,
                                ITransaction transaction)
                                throws PortalException
Sets the workflow to be used in a service instance.

Parameters:
sessionConfig - user session information.
serviceInstanceId - the service instance's id.
workflowId - the workflow's id.
transaction - the transaction for persistence access.
Throws:
PortalException

destroyServiceInstanceWorkflow

void destroyServiceInstanceWorkflow(SessionConfig sessionConfig,
                                    String serviceInstanceId,
                                    ITransaction transaction)
                                    throws PortalException
Destroys the service instance workflow, so that the service instance can be correctly removed. This method should be called only prior to a service instance removal.

Parameters:
sessionConfig - user session information.
serviceInstanceId - the service instance's id.
transaction - the transaction for persistence access.
Throws:
PortalException

deleteAllContentWorkflowMetaData

void deleteAllContentWorkflowMetaData(SessionConfig sessionConfig,
                                      String serviceInstanceId,
                                      ITransaction transaction)
                                      throws PortalException
Deletes all the workflow metadata that is assocated to a specified service instance.

Parameters:
sessionConfig - the user session information.
serviceInstanceId - the service instance identifier.
transaction - the transaction for persistence access.
Throws:
PortalException
Since:
4.0.11

getAllWorkflows

Collection<WorkflowConfig> getAllWorkflows(SessionConfig sessionConfig,
                                           ITransaction transaction)
                                           throws PortalException
Returns all registered workflows.

Parameters:
sessionConfig - the user session information.
transaction - the transaction for persistence access.
Returns:
a collection with all registered workflows.
Throws:
PortalException

getWorkflowPermissions

Collection<WorkflowPermission> getWorkflowPermissions(SessionConfig sessionConfig,
                                                      String serviceInstanceId,
                                                      ITransaction transaction)
                                                      throws PortalException
Returns the permissions set for a workflow in a service instance.

Parameters:
sessionConfig - user session information.
serviceInstanceId - the service instance's id.
transaction - the transaction for persistence access.
Returns:
a WorkflowPermission collection.
Throws:
PortalException

setWorkflowPermissions

void setWorkflowPermissions(SessionConfig sessionConfig,
                            String serviceInstanceId,
                            Collection<WorkflowPermission> permissions,
                            ITransaction transaction)
                            throws PortalException
Updates the workflow permissions in a service instance.

Parameters:
sessionConfig - user session information.
serviceInstanceId - the service instance's id.
permissions - the set of permissions to be set in the service instance. All previous permissions will be deleted.
transaction - the transaction for persistence access.
Throws:
PortalException

getContentWorkflowMetaData

ContentWorkflowMetaData getContentWorkflowMetaData(SessionConfig sessionConfig,
                                                   String metaDataId,
                                                   ITransaction transaction)
                                                   throws PortalException
Returns the content workflow metadata for a metadata id.

Parameters:
sessionConfig - user session information.
metaDataId - the metadata's id.
transaction - the transaction for persistence access.
Returns:
the content workflow metadata.
Throws:
PortalException

getContentWorkflowMetaData

ContentWorkflowMetaData getContentWorkflowMetaData(SessionConfig sessionConfig,
                                                   String itemId,
                                                   String serviceInstanceId,
                                                   String sourceId,
                                                   ITransaction transaction)
                                                   throws PortalException
Returns the content workflow metadata for a content.

Parameters:
sessionConfig - user session information.
itemId - the content's item id.
serviceInstanceId - the content's service instance id.
sourceId - the content's source id.
transaction - the transaction for persistence access.
Returns:
the content workflow metadata.
Throws:
PortalException

createNewContentWorkflowMetaData

void createNewContentWorkflowMetaData(SessionConfig sessionConfig,
                                      String itemId,
                                      String serviceInstanceId,
                                      String sourceId,
                                      String assignedTo,
                                      ITransaction transaction)
                                      throws PortalException
Creates the content workflow metadata for a new content.

Parameters:
sessionConfig - user session information.
itemId - the content's item id.
serviceInstanceId - the content's service instance id.
sourceId - the content's source id.
assignedTo -
transaction - the transaction for persistence access.
Throws:
PortalException

deleteContentWorkflowMetaData

void deleteContentWorkflowMetaData(SessionConfig sessionConfig,
                                   String itemId,
                                   String serviceInstanceId,
                                   String sourceId,
                                   ITransaction transaction)
                                   throws PortalException
Deletes the content workflow metadata of the given content.

Parameters:
sessionConfig - user session information.
itemId - the content's item id.
serviceInstanceId - the content's service instance id.
sourceId - the content's source id.
transaction - the transaction for persistence access.
Throws:
PortalException

executeAction

void executeAction(SessionConfig sessionConfig,
                   String itemId,
                   String serviceInstanceId,
                   String sourceId,
                   String performedTransitionId,
                   String newAssignedTo,
                   ITransaction transaction)
                   throws PortalException
Executes an action on a content's workflow.

Parameters:
sessionConfig - user session information.
itemId - the content's item id.
serviceInstanceId - the content's service instance id.
sourceId - the content's source id.
performedTransitionId - the transition action performed. If null, no transition is performed.
newAssignedTo - the new assigned to principal id.
transaction - the transaction for persistence access.
Throws:
PortalException

hasEditPermission

boolean hasEditPermission(SessionConfig sessionConfig,
                          String itemId,
                          String serviceInstanceId,
                          String sourceId,
                          ITransaction transaction)
                          throws PortalException
Returns true if the sessionConfig's user has edit permission to the specified item, according to the workflow's definition, state and assigned to.

If there is no workflow, or no content workflow metadata, true is returned.

Parameters:
sessionConfig - user session information.
itemId - the content's item id.
serviceInstanceId - the content's service instance id.
sourceId - the content's source id.
transaction - the transaction for persistence access.
Returns:
true if the user has the permission, false otherwise.
Throws:
PortalException

getPossibleAssignedToForAction

Collection<String> getPossibleAssignedToForAction(SessionConfig sessionConfig,
                                                  String itemId,
                                                  String serviceInstanceId,
                                                  String sourceId,
                                                  String transitionId,
                                                  ITransaction transaction)
                                                  throws PortalException
Returns the possible assignedTo values for a workflow transition.

Parameters:
sessionConfig - user session information.
serviceInstanceId - the content's service instance id.
sourceId - the content's source id.
transitionId - the workflow's transition id.
transaction - the transaction for persistence access.
Returns:
a collection of principals ids that may be assigned to a content in the given workflow state.
Throws:
PortalException

contentMayBePublished

boolean contentMayBePublished(SessionConfig sessionConfig,
                              String itemId,
                              String serviceInstanceId,
                              String sourceId,
                              ITransaction transaction)
                              throws PortalException
Parameters:
sessionConfig - user session information.
itemId - the content's item id.
serviceInstanceId - the content's service instance id.
sourceId - the content's source id.
transaction - the transaction for persistence access.
Returns:
true if the content may be published, according to its workflow state, false otherwise.
Throws:
PortalException

autoArchivePublishedContent

boolean autoArchivePublishedContent(String metaDataId,
                                    ITransaction transaction)
                                    throws PortalException
Used for the automatic content archiving process. Performs a transition to a directly reachable archival state, if any. If the content is not in a published state or is already in an archived state or is not after its publishing period then nothing is done.

Parameters:
metaDataId - the content's metadata id.
transaction - the transaction for persistence access.
Returns:
true if the content was archived, or false if nothing was done.
Throws:
PortalException
Since:
4.0.11


Lumisportal  4.1.0.071221 - Copyright © 2001-2007, Lumis. All Rights Reserved.