org.imixs.workflow.faces.data

Class WorkflowController

java.lang.Object

org.imixs.workflow.faces.data.AbstractDataController

org.imixs.workflow.faces.data.WorkflowController

All Implemented Interfaces:

Serializable

@Named
 @ConversationScoped
public class WorkflowController
extends AbstractDataController
implements Serializable

The WorkflowController is a @ConversationScoped CDI bean to control the processing life cycle of a workitem in JSF an application. The bean can be used in single page applications, as well for complex page flows. The controller supports bookmarkable URLs.

The WorkflowController fires CDI events from the type WorkflowEvent. A CDI bean can observe these events to participate in the processing life cycle.

To load a workitem the methods load(id) and onLoad() can be used. The method load expects a valid uniqueId of a workItem to be loaded. The onLoad() method extracts the uniqueid from the query parameter 'id'. This is the recommended way to support bookmarkable URLs when opening a JSF page with the data of a workitem. The onLoad method can be triggered by an jsf viewAction placed in the header of a JSF page:

 
    <f:metadata>
      <f:viewAction action="... workflowController.onLoad()" />
    </f:metadata> 
 

A bookmarkable URL looks like this:

/myForm.xthml?id=[UNIQUEID]

In combination with the viewAction the WorkflowController is automatically initialized.

After a workitem is loaded, a new conversation is started and the CDI event WorkflowEvent.WORKITEM_CHANGED is fired.

After a workitem was processed, the conversation is automatically closed. Stale conversations will automatically timeout with the default session timeout.

After each call of the method process the Post-Redirect-Get is initialized with the default URL from the start of the conversation. If an alternative action result is provided by the workflow engine, the WorkflowController automatically redirects the user to the new form outcome. This guarantees bookmarkable URLs.

Call the close() method when the workitem data is no longer needed.

Within a JSF form, the items of a workitem can be accessed by the getter method getWorkitem().

   #{workflowController.workitem.item['$workflowstatus']}
 

Version:

2.0.0

Author:

rsoika

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static String	DEFAULT_TYPE

Fields inherited from class org.imixs.workflow.faces.data.AbstractDataController

data

Constructor Summary

Constructors

Constructor and Description
WorkflowController()

Method Summary

Modifier and Type	Method and Description
void	create() This action method is used to initialize a new workitem with the initial values of the assigned workflow task.
void	create(String modelVersion, int taskID, String uniqueIdRef) This method creates a new empty workitem.
List<org.imixs.workflow.ItemCollection>	getEvents() This method returns a List of workflow events assigned to the corresponding '$taskid' and '$modelversion' of the current WorkItem.
org.imixs.workflow.ItemCollection	getWorkitem() Returns the current workItem.
void	load(String uniqueid) Loads a workitem by a given $uniqueid and starts a new conversaton.
String	process() This method processes the current workItem and returns a new action result.
String	process(int id) This method processes the current workItem with the provided eventID.
void	setWorkitem(org.imixs.workflow.ItemCollection workitem) Set the current worktItem

Methods inherited from class org.imixs.workflow.faces.data.AbstractDataController

addMessage, close, getDefaultType, isNewWorkitem, onLoad, reset, setDefaultType, startConversation

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_TYPE

public static final String DEFAULT_TYPE

See Also:

Constant Field Values

Constructor Detail

WorkflowController

public WorkflowController()

Method Detail

getWorkitem

public org.imixs.workflow.ItemCollection getWorkitem()

Returns the current workItem. If no workitem is defined the method Instantiates a empty ItemCollection.

Returns:

- current workItem or an emtpy workitem if not set

setWorkitem

public void setWorkitem(org.imixs.workflow.ItemCollection workitem)

Set the current worktItem

Parameters:

workitem - - new reference or null to clear the current workItem.

create

public void create()
            throws org.imixs.workflow.exceptions.ModelException

This action method is used to initialize a new workitem with the initial values of the assigned workflow task. The method updates the Workflow attributes '$WriteAccess','$workflowgroup', '$workflowStatus', 'txtWorkflowImageURL' and 'txtWorkflowEditorid'.

Parameters:

action - - the action returned by this method

Throws:

org.imixs.workflow.exceptions.ModelException - is thrown in case not valid worklfow task if defined by the current model.

create

public void create(String modelVersion,
                   int taskID,
                   String uniqueIdRef)
            throws org.imixs.workflow.exceptions.ModelException

This method creates a new empty workitem. An existing workitem and optional conversation context will be reset. The method assigns the initial values '$ModelVersion', '$ProcessID' and '$UniqueIDRef' to the new workitem. The method creates the empty field '$workitemID' and the item '$owner' which is assigned to the current user. This data can be used in case that a workitem is not processed but saved (e.g. by the dmsController). The method starts a new conversation context. Finally the method fires the WorkfowEvent WORKITEM_CREATED.

Parameters:

modelVersion - - model version

processID - - processID

processRef - - uniqueid ref

Throws:

org.imixs.workflow.exceptions.ModelException

process

public String process()
               throws org.imixs.workflow.exceptions.PluginException,
                      org.imixs.workflow.exceptions.ModelException

This method processes the current workItem and returns a new action result. The action result redirects the user to the default action result or to a new result provided by the workflow model. The 'action' property is typically evaluated from the ResultPlugin. Alternatively the property can be provided by an application. If no 'action' property is provided the method returns null.

The method fires the WorkflowEvents WORKITEM_BEFORE_PROCESS and WORKITEM_AFTER_PROCESS.

The Method also catches PluginExceptions and adds the corresponding Faces Error Message into the FacesContext. In case of an exception the WorkflowEvent WORKITEM_AFTER_PROCESS will not be fired.

In case the processing was successful, the current conversation will be closed. In Case of an Exception (e.g PluginException) the conversation will not be closed, so that the current workitem data is still available.

Returns:

the action result provided in the 'action' property or evaluated from the default property 'txtworkflowResultmessage' from the ActivityEntity

Throws:

org.imixs.workflow.exceptions.PluginException

org.imixs.workflow.exceptions.ModelException

process

public String process(int id)
               throws org.imixs.workflow.exceptions.ModelException,
                      org.imixs.workflow.exceptions.PluginException

This method processes the current workItem with the provided eventID. The method can be used as an action or actionListener.

Parameters:

id - - activityID to be processed

Throws:

org.imixs.workflow.exceptions.PluginException

org.imixs.workflow.exceptions.ModelException

See Also:

process()

getEvents

public List<org.imixs.workflow.ItemCollection> getEvents()

This method returns a List of workflow events assigned to the corresponding '$taskid' and '$modelversion' of the current WorkItem.

Returns:

load

public void load(String uniqueid)

Loads a workitem by a given $uniqueid and starts a new conversaton. The conversaion will be ended after the workitem was processed or after the MaxInactiveInterval from the session.

Overrides:

load in class AbstractDataController

Parameters:

uniqueid -