org.imixs.workflow.jee.faces
Class AbstractWorkflowController

java.lang.Object
  org.imixs.workflow.jee.faces.AbstractWorkflowController

Direct Known Subclasses:

SimpleWorkflowController

public abstract class AbstractWorkflowController
extends Object

This Class is an abstract controller used in JSF Application A JSF Web Modul should subclass the AbstractWorkflowController for implementing a project specific Imixs Workflow BackingBean

Version:

0.0.1

Author:

rsoika

Field Summary

protected org.imixs.workflow.ItemCollection

workitemItemCollection

Constructor Summary

AbstractWorkflowController()

Method Summary

void	addMessage(String ressourceBundleName, String messageKey, Object param) This method can be used to add a Error Messege to the Application Context during an actionListener Call.
void	doCreateWorkitem(javax.faces.event.ActionEvent event) This method is called by a jsf page to create a new instance of a process.
void	doCreateWorkitem(int ProcessID) This method is called by a jsf page to create a new instance of a process.
void	doDelete(javax.faces.event.ActionEvent event) this method removes the current selected workitem from a view.
void	doEdit(javax.faces.event.ActionEvent event) this method is called by datatables to select an workitem
void	doLoadNext(javax.faces.event.ActionEvent event)
void	doLoadPrev(javax.faces.event.ActionEvent event)
void	doProcessWorkitem(javax.faces.event.ActionEvent event) processes the current issue.
void	doRefresh(javax.faces.event.ActionEvent event) refreshes the current workitem list. so the list will be loaded again.
void	doReset(javax.faces.event.ActionEvent event) resets the current project list and projectMB
void	doSwitchToSearchlist(javax.faces.event.ActionEvent event)
void	doSwitchToWorklistAll(javax.faces.event.ActionEvent event)
void	doSwitchToWorklistByAuthor(javax.faces.event.ActionEvent event)
void	doSwitchToWorklistByCreator(javax.faces.event.ActionEvent event)
void	doSwitchToWorklistByOwner(javax.faces.event.ActionEvent event)
void	doSwitchToWorklistByWriteAccess(javax.faces.event.ActionEvent event)
ArrayList<org.imixs.workflow.ItemCollection>	getActivities() returns a arrayList of Activities to the corresponidng processiD of the current Worktiem.
org.imixs.workflow.jee.ejb.EntityService	getEntityService() returns an instance of the EntityService EJB
String	getID() returns the $uniqueID of the current workitem
int	getMaxSearchResult() returns the maximum size of a search result
org.imixs.workflow.jee.ejb.ModelService	getModelService() returns an instance of the ModelService EJB
String	getModelVersion() returns the current ModelVersion.
int	getRow() Navigation
String	getSearchQuery() defines the searchQuery to be use for a EQL search by the method doSwitchToSearchlist Sublcasses may overwrite this method to define individual search queries.
int	getSortOrder() defines the default sortOrder for finder methods
ArrayList<org.imixs.workflow.ItemCollection>	getStartProcessList() returns a arrayList of start processes.
String	getType() set the value for the attribute 'type' of a workitem to be generated or search by this controller
String	getWorkflowResult() returns the last workflow result to control the navigation flow if no result is found show_worklist will be returned
org.imixs.workflow.jee.ejb.WorkflowService	getWorkflowService() returns an instance of the WorkflowService EJB
org.imixs.workflow.ItemCollection	getWorkitem()
List<org.imixs.workflow.ItemCollection>	getWorkitems()
boolean	isEndOfList()
boolean	isNewWorkitem() indicates if a workitem was processed before by the workflowService
void	setMaxSearchResult(int searchCount) set the maximum size of a search result
void	setModelVersion(String modelVersion)
void	setSearchQuery(String query) set the current searchquery
void	setSortOrder(int sortOrder)
void	setType(String type) defines the type attribute of a workitem to be generated or search by this controller Subclasses may overwrite the type
void	setWorkitem(org.imixs.workflow.ItemCollection aworkitem) updates all attributes by the supported map into the ItemCollection Diese Mehtode wird beim Klick auf einen Datensatz aufgerufen
void	setWorkitems(ArrayList<org.imixs.workflow.ItemCollection> workitems)

Methods inherited from class java.lang.Object

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

Field Detail

workitemItemCollection

protected org.imixs.workflow.ItemCollection workitemItemCollection

Constructor Detail

AbstractWorkflowController

public AbstractWorkflowController()

Method Detail

getEntityService

public org.imixs.workflow.jee.ejb.EntityService getEntityService()

returns an instance of the EntityService EJB

Returns:

getModelService

public org.imixs.workflow.jee.ejb.ModelService getModelService()

returns an instance of the ModelService EJB

Returns:

getWorkflowService

public org.imixs.workflow.jee.ejb.WorkflowService getWorkflowService()

returns an instance of the WorkflowService EJB

Returns:

getID

public String getID()

returns the $uniqueID of the current workitem

Returns:

getType

public String getType()

set the value for the attribute 'type' of a workitem to be generated or search by this controller

setType

public void setType(String type)

defines the type attribute of a workitem to be generated or search by this controller Subclasses may overwrite the type

Parameters:

type -

getSortOrder

public int getSortOrder()

defines the default sortOrder for finder methods

Returns:

setSortOrder

public void setSortOrder(int sortOrder)

getModelVersion

public String getModelVersion()

returns the current ModelVersion. If no ModelVersion is defined the method returns the latest modelversion defined

Returns:

setModelVersion

public void setModelVersion(String modelVersion)

getMaxSearchResult

public int getMaxSearchResult()

returns the maximum size of a search result

Returns:

setMaxSearchResult

public void setMaxSearchResult(int searchCount)

set the maximum size of a search result

Parameters:

searchCount -

getSearchQuery

public String getSearchQuery()

defines the searchQuery to be use for a EQL search by the method doSwitchToSearchlist Sublcasses may overwrite this method to define individual search queries.

Returns:

setSearchQuery

public void setSearchQuery(String query)

set the current searchquery

Parameters:

query -

setWorkitem

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

updates all attributes by the supported map into the ItemCollection Diese Mehtode wird beim Klick auf einen Datensatz aufgerufen

Parameters:

ateam -

getWorkitem

public org.imixs.workflow.ItemCollection getWorkitem()

doCreateWorkitem

public void doCreateWorkitem(javax.faces.event.ActionEvent event)
                      throws Exception

This method is called by a jsf page to create a new instance of a process. This method creates an empty worktitem The Workflow attributes ProcessID, Modelversion and WorfklowGroup will be set to the attributes of the corresponding ProcessEntity provided by param ID in the ActionEvent The Method expects an ID which identifies the ProcessID and optional a ModelVersion The ID is a String value with the following format: modelversion|processID The first Part is the modelversion for the corresponding workflowmodel the second part will be vast to an integer which corresponds to the start process id in the model. The modelversion part with the '|' is optional.

Parameters:

event -

Throws:

Exception

See Also:

WorkitemServiceBean

doCreateWorkitem

public void doCreateWorkitem(int ProcessID)
                      throws Exception

This method is called by a jsf page to create a new instance of a process. This method creates an empty worktitem for a defined ProcessID in the current ModelVersion. The Workflow attributes ProcessID, Modelversion and WorfklowGroup will be set to the attributes of the corresponding ProcessEntity provided by param ID in the ActionEvent

Parameters:

event -

Throws:

Exception

doProcessWorkitem

public void doProcessWorkitem(javax.faces.event.ActionEvent event)
                       throws Exception

processes the current issue. The method expects an parameter "id" with the activity ID which should be processed Method should be overwritten to add additional Business logic here.

Parameters:

event -

Throws:

Exception

doEdit

public void doEdit(javax.faces.event.ActionEvent event)

this method is called by datatables to select an workitem

doDelete

public void doDelete(javax.faces.event.ActionEvent event)
              throws Exception

this method removes the current selected workitem from a view. The Method also deletes also all child workitems recursive

Parameters:

event -

Throws:

Exception

doReset

public void doReset(javax.faces.event.ActionEvent event)

resets the current project list and projectMB

doRefresh

public void doRefresh(javax.faces.event.ActionEvent event)

refreshes the current workitem list. so the list will be loaded again. but start pos will not be changed!

doSwitchToWorklistByAuthor

public void doSwitchToWorklistByAuthor(javax.faces.event.ActionEvent event)

doSwitchToWorklistByWriteAccess

public void doSwitchToWorklistByWriteAccess(javax.faces.event.ActionEvent event)

doSwitchToWorklistByOwner

public void doSwitchToWorklistByOwner(javax.faces.event.ActionEvent event)

doSwitchToWorklistByCreator

public void doSwitchToWorklistByCreator(javax.faces.event.ActionEvent event)

doSwitchToWorklistAll

public void doSwitchToWorklistAll(javax.faces.event.ActionEvent event)

doSwitchToSearchlist

public void doSwitchToSearchlist(javax.faces.event.ActionEvent event)

doLoadNext

public void doLoadNext(javax.faces.event.ActionEvent event)

doLoadPrev

public void doLoadPrev(javax.faces.event.ActionEvent event)

getWorkitems

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

setWorkitems

public void setWorkitems(ArrayList<org.imixs.workflow.ItemCollection> workitems)

getRow

public int getRow()

Navigation

isEndOfList

public boolean isEndOfList()

getWorkflowResult

public String getWorkflowResult()

returns the last workflow result to control the navigation flow if no result is found show_worklist will be returned

Returns:

getActivities

public ArrayList<org.imixs.workflow.ItemCollection> getActivities()

returns a arrayList of Activities to the corresponidng processiD of the current Worktiem. The Method returns the activities corresponding to the worktiems modelVersionID

Returns:

getStartProcessList

public ArrayList<org.imixs.workflow.ItemCollection> getStartProcessList()

returns a arrayList of start processes. A Start process is the first ProcessEntity in a Process group of a model The method only lookups the processEntities once!

Returns:

isNewWorkitem

public boolean isNewWorkitem()

indicates if a workitem was processed before by the workflowService

Returns:

addMessage

public void addMessage(String ressourceBundleName,
                       String messageKey,
                       Object param)

This method can be used to add a Error Messege to the Application Context during an actionListener Call. Typical this method is used in the doProcessWrktiem method to display a processing exception to the user. The method expects the Ressoruce bundle name and the message key inside the bundle.

Parameters:

ressourceBundleName -

messageKey -

param -