com.groiss.wf
Class SystemAction

java.lang.Object
  com.groiss.wf.SystemAction

public class SystemAction
extends Object

This class provides some methods useful for preprocessing and postconditions.

Constructor Summary

SystemAction()

Method Summary

void	autoTake() This method performs a take when the activity instance is assigned to a role and there is exactly one user having this role.
void	cancelActivity(String name) Cancel the activity: finishs the activity with the given task id
void	cancelProcess() Cancel the whole process.
boolean	evaluateXPath(String xpathExpression) evaluates the given XPath 1.0 expression
void	finishActivity(String label) finish a task, an andpar, orpar, or a parfor.
Page	finishIf(HttpServletRequest req)
Object	getFormFieldValue(String formfield) Returns the value of a formfield.
boolean	isActive(String task) Returns true if there is an active or idle or suspended activity instance in the current process that has the task with the given id.
boolean	isFalse() Use as condition dummy, returns false.
boolean	isStartAgent(String formfield) This method returns true if the formfield contains a user object and the user is the start agent of the current process.
boolean	isTrue() Use as condition dummy, always returns true.
void	join(String n, String mode) Expression in andjoin for implementing generalized andjoin
boolean	lock(String name) Add a lock to the process instance.
boolean	log(String message, String level) writes the argument on the log
boolean	manualIf()
void	parforJoin(String n, String mode) Expression in end parfor for implementing generalized parfor join
void	setFieldToAgent(String formfield) Set a form field to the current agent
void	setFieldToOU(String formfield) Set a form field to the home org unit of agent
void	setFieldToValue(String formfield, String value) Set a form field to the home org unit of agent
boolean	unlock(String name) Removes the lock.

Methods inherited from class java.lang.Object

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

Constructor Detail

SystemAction

public SystemAction()

Method Detail

lock

public boolean lock(String name)
             throws Exception

Add a lock to the process instance.

Parameters:

name - name of the lock

Returns:

always true

Throws:

Exception

unlock

public boolean unlock(String name)
               throws Exception

Removes the lock.

Parameters:

name - name of the lock

Returns:

always true

Throws:

Exception

cancelActivity

public void cancelActivity(String name)

Cancel the activity: finishs the activity with the given task id

Parameters:

name - the id of a task

Throws:

Exception

cancelProcess

public void cancelProcess()

Cancel the whole process.

Throws:

Exception

autoTake

public void autoTake()
              throws Exception

This method performs a take when the activity instance is assigned to a role and there is exactly one user having this role.

Throws:

Exception

log

public boolean log(String message,
                   String level)

writes the argument on the log

Parameters:

message - the message

level - the log level

Returns:

true

setFieldToAgent

public void setFieldToAgent(String formfield)

Set a form field to the current agent

Parameters:

formfield - the form field: formid "." fieldame

setFieldToOU

public void setFieldToOU(String formfield)

Set a form field to the home org unit of agent

Parameters:

formfield - the form field: formid "." fieldame

getFormFieldValue

public Object getFormFieldValue(String formfield)

Returns the value of a formfield.

Parameters:

formfield - in the syntax formid "." fieldname

Returns:

the value object

setFieldToValue

public void setFieldToValue(String formfield,
                            String value)
                     throws Exception

Set a form field to the home org unit of agent

Parameters:

formfield - the form field: formid "." fieldame

Throws:

Exception

isStartAgent

public boolean isStartAgent(String formfield)

This method returns true if the formfield contains a user object and the user is the start agent of the current process.

Parameters:

formfield - the form field in syntax: formid "." fieldame

isActive

public boolean isActive(String task)

Returns true if there is an active or idle or suspended activity instance in the current process that has the task with the given id.

Parameters:

task - the id of a task object

Returns:

true if there is an active task

join

public void join(String n,
                 String mode)

Expression in andjoin for implementing generalized andjoin

Parameters:

n - number of branches that must be completed

mode - either cancel or none. every other value is taken as none

parforJoin

public void parforJoin(String n,
                       String mode)

Expression in end parfor for implementing generalized parfor join

Parameters:

n - number of branches that must be completed

mode - either cancel or none. every other value is taken as none

finishActivity

public void finishActivity(String label)

finish a task, an andpar, orpar, or a parfor.

Parameters:

label - the label of a step

isTrue

public boolean isTrue()

Use as condition dummy, always returns true.

isFalse

public boolean isFalse()

Use as condition dummy, returns false.

manualIf

public boolean manualIf()

finishIf

public Page finishIf(HttpServletRequest req)
              throws Exception

Throws:

Exception

evaluateXPath

public boolean evaluateXPath(String xpathExpression)
                      throws Exception

evaluates the given XPath 1.0 expression

Parameters:

xpathExpression -

Returns:

the result of the XPath-expression

Throws:

Exception