Package org.ametys.plugins.bpm

Class BPMWorkflowManager

java.lang.Object

org.ametys.runtime.plugin.component.AbstractLogEnabled

org.ametys.plugins.bpm.BPMWorkflowManager

All Implemented Interfaces:

LogEnabled, PluginAware, Initializable, Component, Contextualizable, Serviceable

public class BPMWorkflowManager
extends AbstractLogEnabled
implements Component, Serviceable, Initializable, Contextualizable, PluginAware

Manager for retrieving, creation, edition and suppression of workflows, and retrieving information on workflows definitions

Field Summary

Fields

Modifier and Type	Field	Description
private AddOrUpdateResourceHelper	_addOrUpdateResourceHelper
private AmetysObjectResolver	_ametysObjectResolver
private static String	_BPM_PROCESS_TEMPLATE
private Context	_context
private CurrentUserProvider	_currentUserProvider
private GroupManager	_groupManager
private I18nUtils	_i18nUtils
private JSONUtils	_jsonUtils
private String	_pluginName
private AmetysObjectResolver	_resolver
private RightManager	_rightManager
private SiteManager	_siteManager
private SkinsManager	_skinsManager
private URIPrefixHandler	_uriPrefixHandler
private UserHelper	_userHelper
private Map<String,Map<String,Object>>	_workflowDefinitionsCache
private WorkflowHelper	_workflowHelper
private WorkflowProvider	_workflowProvider
static String	BPM_ROOT_NODE	The plugin root node name
static String	BPMPROCESSES_ROOT_NODE	The processes node name under each workflow
static String	BPMWORKFLOW_ROOT_NODE	The BPM Workflows node name
static String	PAGE_TAG_CREATEPROCESS	Tag for the create process page
static String	PAGE_TAG_PROCESS_DASHBOARD	Tag for the process dashboard page
static String	RIGHT_WORKFLOW_CREATE	Right to create a new workflow
static String	RIGHT_WORKFLOW_DELETE	Right to delete any workflow
static String	RIGHT_WORKFLOW_EDIT	Right to edit any workflow
static String	RIGHTS_PROCESS_MANAGE_PROCESSES	Right to manage processes
static String	ROLE	Avalon Role
static int	WORKFLOW_ACTION_EDIT	The fixed id for the edit workflow action on processus

Constructor Summary

Constructors

Constructor	Description
BPMWorkflowManager()

Method Summary

Modifier and Type	Method	Description
private UserIdentity	_convertJsonToUser(Map<String,Object> user)
protected ModifiableTraversableAmetysObject	_getProcessesRootNode(JCRWorkflow workflow, boolean create)	Gets the root of processes of a workflow
protected Map<String,Object>	_getWorkflowDefinitionData(String workflowDefId)	Get the list of variables and their properties for a workflow definition
private Map<? extends String,? extends Map<String,Object>>	_getWorkflowDefinitionRegisters(Configuration[] registers)
protected ModifiableTraversableAmetysObject	_getWorkflowsRootNode(boolean create)	Gets the root of contents
private List<Map<String,Object>>	_groups2Json(GroupIdentity[] groups)
private Map<String,Object>	_processToJson(JCRWorkflowProcess process)
private void	_setProcessValues(JCRWorkflowProcess process, String title, String site, String description, List<PartOnDisk> uploadedAttachments)
private void	_setWorkflowValues(JCRWorkflow workflow, Map<String,Object> values)
private Map<String,Object>	_workflowToJson(JCRWorkflow workflow, Map<String,Object> workflowDefinitionData)
Map<String,Object>	addWorkflow(Map<String,Object> values)	Add a new workflow
boolean	canDelete(JCRWorkflowProcess process)	Determines if the process can be deleted by the current user
void	contextualize(Context context)
JCRWorkflowProcess	createProcess(String workflowId, String title, String site, String description, List<PartOnDisk> uploadedAttachments)	Create a new process
void	deleteProcess(JCRWorkflowProcess process)	Delete a process
Map<String,Object>	deleteProcesses(List<String> processes)	Delete a list of processes
Map<String,Object>	deleteWorkflow(List<String> workflowIds)	Delete a list of workflow
void	editProcess(String processId, String title, String description, List<PartOnDisk> uploadedAttachments, List<String> attachmentsUntouched)	Edit a process
Map<String,Object>	editWorkflow(String workflowId, Map<String,Object> values)	Edit a workflow values
Page	getCreateProcessPage(String siteName, String lang)	Get the page with CREATE_PROCESS tag
Page	getDashboardPage(String siteName, String lang)	Get the page with PROCESS_DASHBOARD tag
JCRWorkflowProcess	getProcess(String workflowName, String processName)	Retrieve a process
String	getProcessPageUrl(JCRWorkflowProcess process, String siteName, String lang, boolean absolute)	Get the url of a process page
String	getTemplateForProcessPage(String siteName, String lang)	Get the template to use for process rendering
Set<JCRWorkflowProcess>	getUserProcesses()	Get the list of processes accessibles to the current user
Map<String,Object>	getWorkflowData(String workflowId)	Retrieve the data of a workflow, in JSON format.
Map<String,Object>	getWorkflowDefinitions()	Get the list of workflow definitions
Map<String,Object>	getWorkflowDefinitionVariables(String workflowDefId)	Retrieve the list of variables from a workflow definition
Map<String,Object>	getWorkflowProcesses(String workflowId)	Retrieve the list of process created from a workflow
List<Object>	getWorkflowProcessus(JCRWorkflow workflow)	Retrieve the list of process created from a workflow
Map<String,Object>	getWorkflows()	Retrieve the list of workflows
List<Map<String,Object>>	getWorkflowsAvailables()	Retrieve the list of workflows availables to the current user, in JSON format
Object	getWorkflowVariable(String workflowId, String variableName)	Retrieve the value of a variable from a workflow
void	initialize()
boolean	isComplete(JCRWorkflowProcess process)	Determines if the process is complete
boolean	isUserAllowedOnWorkflow(JCRWorkflow workflow)	Check if the current user is allowed to create a process from the workflow
boolean	isUserInWorkflowVariables(JCRWorkflow workflow)	Test if the current user is present in any variable of the workflow
void	service(ServiceManager manager)
void	setPluginInfo(String pluginName, String featureName, String id)	Sets the plugin info relative to the current component. Note : The feature name may be null if the targeted component in declared at plugin level.

Methods inherited from class org.ametys.runtime.plugin.component.AbstractLogEnabled

getLogger, setLogger

Methods inherited from class java.lang.Object

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

Field Detail

ROLE

public static final String ROLE

Avalon Role

RIGHT_WORKFLOW_CREATE

public static final String RIGHT_WORKFLOW_CREATE

Right to create a new workflow

See Also:

Constant Field Values

RIGHT_WORKFLOW_EDIT

public static final String RIGHT_WORKFLOW_EDIT

Right to edit any workflow

See Also:

Constant Field Values

RIGHT_WORKFLOW_DELETE

public static final String RIGHT_WORKFLOW_DELETE

Right to delete any workflow

See Also:

Constant Field Values

RIGHTS_PROCESS_MANAGE_PROCESSES

public static final String RIGHTS_PROCESS_MANAGE_PROCESSES

Right to manage processes

See Also:

Constant Field Values

PAGE_TAG_CREATEPROCESS

public static final String PAGE_TAG_CREATEPROCESS

Tag for the create process page

See Also:

Constant Field Values

PAGE_TAG_PROCESS_DASHBOARD

public static final String PAGE_TAG_PROCESS_DASHBOARD

Tag for the process dashboard page

See Also:

Constant Field Values

WORKFLOW_ACTION_EDIT

public static final int WORKFLOW_ACTION_EDIT

The fixed id for the edit workflow action on processus

See Also:

Constant Field Values

BPM_ROOT_NODE

public static final String BPM_ROOT_NODE

The plugin root node name

See Also:

Constant Field Values

BPMWORKFLOW_ROOT_NODE

public static final String BPMWORKFLOW_ROOT_NODE

The BPM Workflows node name

See Also:

Constant Field Values

BPMPROCESSES_ROOT_NODE

public static final String BPMPROCESSES_ROOT_NODE

The processes node name under each workflow

See Also:

Constant Field Values

_BPM_PROCESS_TEMPLATE

private static final String _BPM_PROCESS_TEMPLATE

See Also:

Constant Field Values

_resolver

private AmetysObjectResolver _resolver

_workflowProvider

private WorkflowProvider _workflowProvider

_currentUserProvider

private CurrentUserProvider _currentUserProvider

_rightManager

private RightManager _rightManager

_jsonUtils

private JSONUtils _jsonUtils

_userHelper

private UserHelper _userHelper

_addOrUpdateResourceHelper

private AddOrUpdateResourceHelper _addOrUpdateResourceHelper

_workflowHelper

private WorkflowHelper _workflowHelper

_workflowDefinitionsCache

private Map<String,Map<String,Object>> _workflowDefinitionsCache

_context

private Context _context

_skinsManager

private SkinsManager _skinsManager

_ametysObjectResolver

private AmetysObjectResolver _ametysObjectResolver

_siteManager

private SiteManager _siteManager

_groupManager

private GroupManager _groupManager

_uriPrefixHandler

private URIPrefixHandler _uriPrefixHandler

_pluginName

private String _pluginName

_i18nUtils

private I18nUtils _i18nUtils

Constructor Detail

BPMWorkflowManager

public BPMWorkflowManager()

Method Detail

contextualize

public void contextualize(Context context)
                   throws ContextException

Specified by:

contextualize in interface Contextualizable

Throws:

ContextException

service

public void service(ServiceManager manager)
             throws ServiceException

Specified by:

service in interface Serviceable

Throws:

ServiceException

initialize

public void initialize()
                throws Exception

Specified by:

initialize in interface Initializable

Throws:

Exception

setPluginInfo

public void setPluginInfo(String pluginName,
                          String featureName,
                          String id)

Description copied from interface: PluginAware

Sets the plugin info relative to the current component.
Note : The feature name may be null if the targeted component in declared at plugin level.

Specified by:

setPluginInfo in interface PluginAware

Parameters:

pluginName - Unique identifier for the plugin hosting the extension

featureName - Unique feature identifier (unique for a given pluginName)

id - Unique identifier of this component

getWorkflowDefinitions

public Map<String,Object> getWorkflowDefinitions()

Get the list of workflow definitions

Returns:

The list of workflow definitions, mapped by name and label

getWorkflowVariable

public Object getWorkflowVariable(String workflowId,
                                  String variableName)

Retrieve the value of a variable from a workflow

Parameters:

workflowId - The workflow id

variableName - The variable name

Returns:

The value

getWorkflowDefinitionVariables

public Map<String,Object> getWorkflowDefinitionVariables(String workflowDefId)

Retrieve the list of variables from a workflow definition

Parameters:

workflowDefId - The workflow definition id

Returns:

The list of variables, with their attributes such as the label, type, multiple, if defined

getWorkflows

public Map<String,Object> getWorkflows()

Retrieve the list of workflows

Returns:

The list of workflows

getWorkflowsAvailables

public List<Map<String,Object>> getWorkflowsAvailables()

Retrieve the list of workflows availables to the current user, in JSON format

Returns:

The list of workflows

getWorkflowData

public Map<String,Object> getWorkflowData(String workflowId)

Retrieve the data of a workflow, in JSON format. Contains both the values of the workflow, and the workflow variables definitions

Parameters:

workflowId - The workflow id

Returns:

The data of a workflow

addWorkflow

public Map<String,Object> addWorkflow(Map<String,Object> values)
                                     throws IllegalAccessException

Add a new workflow

Parameters:

values - The values for the new workflow. Must contains a "name", "workflowDef" and any variables mandatory for the workflowDef

Returns:

The result, with the new workflow id if successful

Throws:

IllegalAccessException - If a user with insufficient rights try to execute this method

editWorkflow

public Map<String,Object> editWorkflow(String workflowId,
                                             Map<String,Object> values)
                                      throws IllegalAccessException

Edit a workflow values

Parameters:

workflowId - The workflow

values - The values

Returns:

The result, with the workflow id if successful

Throws:

IllegalAccessException - If a user with insufficient rights try to execute this method

deleteWorkflow

public Map<String,Object> deleteWorkflow(List<String> workflowIds)

Delete a list of workflow

Parameters:

workflowIds - The workflows

Returns:

The result

getWorkflowProcesses

public Map<String,Object> getWorkflowProcesses(String workflowId)

Retrieve the list of process created from a workflow

Parameters:

workflowId - The workflow

Returns:

The list of process

getWorkflowProcessus

public List<Object> getWorkflowProcessus(JCRWorkflow workflow)

Retrieve the list of process created from a workflow

Parameters:

workflow - The workflow

Returns:

The list of process

createProcess

public JCRWorkflowProcess createProcess(String workflowId,
                                        String title,
                                        String site,
                                        String description,
                                        List<PartOnDisk> uploadedAttachments)
                                 throws com.opensymphony.workflow.WorkflowException,
                                        IllegalAccessException

Create a new process

Parameters:

workflowId - The workflow used by the process

title - The process title

site - The site on which the process was created

description - The process description

uploadedAttachments - The process attachments

Returns:

The new process

Throws:

com.opensymphony.workflow.WorkflowException - If an error occurred creating the workflow

IllegalAccessException - If the user is not allowed

editProcess

public void editProcess(String processId,
                        String title,
                        String description,
                        List<PartOnDisk> uploadedAttachments,
                        List<String> attachmentsUntouched)
                 throws com.opensymphony.workflow.WorkflowException

Edit a process

Parameters:

processId - The process id

title - The title

description - The description

uploadedAttachments - The list of new attachments uploaded

attachmentsUntouched - The list of untouched attachments names

Throws:

com.opensymphony.workflow.WorkflowException - If an error occurred while executing the workflow action

getProcess

public JCRWorkflowProcess getProcess(String workflowName,
                                     String processName)

Retrieve a process

Parameters:

workflowName - The workflow name

processName - The process name

Returns:

The process

isComplete

public boolean isComplete(JCRWorkflowProcess process)

Determines if the process is complete

Parameters:

process - The process

Returns:

True if the process is complete

canDelete

public boolean canDelete(JCRWorkflowProcess process)

Determines if the process can be deleted by the current user

Parameters:

process - The process

Returns:

True if the process can be deleted

deleteProcess

public void deleteProcess(JCRWorkflowProcess process)
                   throws IllegalAccessException

Delete a process

Parameters:

process - The process to delete

Throws:

IllegalAccessException - If a user tries to delete a process without being allowed

deleteProcesses

public Map<String,Object> deleteProcesses(List<String> processes)
                                         throws IllegalAccessException

Delete a list of processes

Parameters:

processes - The processes to delete

Returns:

The result

Throws:

IllegalAccessException - If a user tries to delete a process without being allowed

getProcessPageUrl

public String getProcessPageUrl(JCRWorkflowProcess process,
                                String siteName,
                                String lang,
                                boolean absolute)

Get the url of a process page

Parameters:

process - The process

siteName - The current site name. Can not be null.

lang - The current language. Can not be null.

absolute - true to get absolute url.

Returns:

the url of process page

getDashboardPage

public Page getDashboardPage(String siteName,
                             String lang)

Get the page with PROCESS_DASHBOARD tag

Parameters:

siteName - The current site name

lang - The language

Returns:

The page or null if not found.

getCreateProcessPage

public Page getCreateProcessPage(String siteName,
                                 String lang)

Get the page with CREATE_PROCESS tag

Parameters:

siteName - The current site name

lang - The language

Returns:

The page or null if not found.

getTemplateForProcessPage

public String getTemplateForProcessPage(String siteName,
                                        String lang)

Get the template to use for process rendering

Parameters:

siteName - The site containing the page

lang - The sitemap of the page

Returns:

The template to use for process rendering

isUserInWorkflowVariables

public boolean isUserInWorkflowVariables(JCRWorkflow workflow)

Test if the current user is present in any variable of the workflow

Parameters:

workflow - The workflow

Returns:

True if the user is in the workflow variables

getUserProcesses

public Set<JCRWorkflowProcess> getUserProcesses()

Get the list of processes accessibles to the current user

Returns:

The list of processes

isUserAllowedOnWorkflow

public boolean isUserAllowedOnWorkflow(JCRWorkflow workflow)

Check if the current user is allowed to create a process from the workflow

Parameters:

workflow - The workflow

Returns:

True if the user is allowed

_setWorkflowValues

private void _setWorkflowValues(JCRWorkflow workflow,
                                Map<String,Object> values)

_setProcessValues

private void _setProcessValues(JCRWorkflowProcess process,
                               String title,
                               String site,
                               String description,
                               List<PartOnDisk> uploadedAttachments)

_convertJsonToUser

private UserIdentity _convertJsonToUser(Map<String,Object> user)

_workflowToJson

private Map<String,Object> _workflowToJson(JCRWorkflow workflow,
                                                 Map<String,Object> workflowDefinitionData)

_groups2Json

private List<Map<String,Object>> _groups2Json(GroupIdentity[] groups)

_getWorkflowsRootNode

protected ModifiableTraversableAmetysObject _getWorkflowsRootNode(boolean create)

Gets the root of contents

Parameters:

create - true to create automatically the root when missing.

Returns:

the root of workflows

Throws:

UnknownAmetysObjectException - If root node does not exist

_getProcessesRootNode

protected ModifiableTraversableAmetysObject _getProcessesRootNode(JCRWorkflow workflow,
                                                                  boolean create)

Gets the root of processes of a workflow

Parameters:

workflow - The workflow

create - true to create automatically the root when missing.

Returns:

the root of processes

Throws:

UnknownAmetysObjectException - If root node does not exist

_getWorkflowDefinitionData

protected Map<String,Object> _getWorkflowDefinitionData(String workflowDefId)

Get the list of variables and their properties for a workflow definition

Parameters:

workflowDefId - The workflow definition id

Returns:

The list of variables properties, mapped by variable id

_getWorkflowDefinitionRegisters

private Map<? extends String,? extends Map<String,Object>> _getWorkflowDefinitionRegisters(Configuration[] registers)
                                                                                                throws ConfigurationException

Throws:

ConfigurationException

_processToJson

private Map<String,Object> _processToJson(JCRWorkflowProcess process)