Package org.cristalise.kernel.lifecycle.instance

Class Activity

java.lang.Object

org.cristalise.kernel.graph.model.Vertex

org.cristalise.kernel.graph.model.GraphableVertex

org.cristalise.kernel.lifecycle.instance.WfVertex

org.cristalise.kernel.lifecycle.instance.Activity

Direct Known Subclasses:

CompositeActivity, PredefinedStep

public class Activity
extends WfVertex

Nested Class Summary

Nested classes/interfaces inherited from class org.cristalise.kernel.lifecycle.instance.WfVertex

WfVertex.Types

Field Summary

Fields

Modifier and Type	Field	Description
boolean	active	true is available to be executed
protected Vector<String>	mErrors	vector of errors (Strings) that is constructed each time verify() was launched
static final String	PREDEF_STEPS_ELEMENT
protected int	state
protected static final String	XPATH_TOKEN

Fields inherited from class org.cristalise.kernel.graph.model.GraphableVertex

mIsComposite

Constructor Summary

Constructors

Constructor	Description
Activity()

Method Summary

Modifier and Type	Method	Description
void	abort(AgentPath agent, ItemPath itemPath, TransactionKey transactionKey)
Next	addNext(WfVertex vertex)	adds a New link between the current Activity and the WfVertex passed in param
List<Job>	calculateAllJobs(AgentPath agent, ItemPath itemPath, boolean recurse)
List<Job>	calculateJobs(AgentPath agent, ItemPath itemPath, boolean recurse)	Calculates the lists of jobs for the activity and its children (cf org.cristalise.kernel.entity.Job)
boolean	getActive()
String	getCurrentAgentName()
String	getCurrentAgentRole()
String	getDescription()
String	getErrors()	return the String that identifies the errors found in th activity
int	getErrorTransitionId()	Returns the id of the error Transition associated with the current state
Next	getNext()
int	getState()
GTimeStamp	getStateDate()	Returns the startDate.
StateMachine	getStateMachine()
StateMachine	getStateMachine(TransactionKey transKey)
String	getStateName()
String	getType()	Returns the type.
String	getTypeName()
boolean	isFinished()
boolean	loop()	Used in verify()
void	reinit(int idLoop)	reinitialises the Activity and propagate (for Loop)
String	request(AgentPath agent, ItemPath itemPath, int transitionID, String requestData, String attachmentType, byte[] attachment, boolean validateOutcome, TransactionKey transactionKey)
String	request(AgentPath agent, ItemPath itemPath, int transitionID, String requestData, String attachmentType, byte[] attachment, TransactionKey transactionKey)
void	run(TransactionKey transactionKey)	called by precedent Activity runNext() for setting the activity able to be executed
protected String	runActivityLogic(AgentPath agent, ItemPath itemPath, int transitionID, String requestData, TransactionKey transactionKey)	Overridden in predefined steps
void	runFirst(TransactionKey transactionKey)	sets the activity available to be executed on start of Workflow or composite activity (when it is the first one of the (sub)process
void	runNext(TransactionKey transactionKey)	sets the next activity available if possible
void	setActive(boolean acti)	sets the ability to be executed
void	setActiveDate(GTimeStamp date)	Deprecated.
void	setStartDate(GTimeStamp date)	Deprecated.
void	setState(int state)	Sets a new State
void	setStateDate(GTimeStamp startDate)
void	setType(String type)	Sets the type.
String	toString()
boolean	verify()	Method verify.

Methods inherited from class org.cristalise.kernel.lifecycle.instance.WfVertex

evaluateProperty, evaluatePropertyValue, evaluateScript, findLastVertex, findPair, getActContext, getWf

Methods inherited from class org.cristalise.kernel.graph.model.GraphableVertex

addChild, deriveVersionNumber, getBuiltInProperty, getBuiltInProperty, getCentrePoint, getChildren, getChildrenEdges, getChildrenGraphModel, getCreationContext, getInEdgeIds, getInEdges, getInGraphables, getIsComposite, getIsLayoutable, getKeyValuePairs, getLayoutableChildren, getOtherPairingID, getOutEdgeIds, getOutEdges, getOutGraphables, getOutlinePoints, getPairingId, getParent, getPath, getProperties, isMyPair, search, setBuiltInProperty, setChildrenGraphModel, setIsComposite, setIsLayoutable, setKeyValuePairs, setParent, setProperties, updatePropertiesFromCollection, updatePropertiesFromCollection

Methods inherited from class org.cristalise.kernel.graph.model.Vertex

addInEdgeId, addOutEdgeId, clearTag, containsPoint, hasTag, isJoin, isLoop, moveAbsolute, removeInEdgeId, removeOutEdgeId, setInEdgeIds, setOutEdgeIds, setOutlinePoints, setTag

Methods inherited from class java.lang.Object

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

Field Details

PREDEF_STEPS_ELEMENT

public static final String PREDEF_STEPS_ELEMENT

See Also:

• Constant Field Values

XPATH_TOKEN

protected static final String XPATH_TOKEN

See Also:

• Constant Field Values

mErrors

protected Vector<String> mErrors

vector of errors (Strings) that is constructed each time verify() was launched

state

protected int state

active

public boolean active

true is available to be executed

Constructor Details

Activity

public Activity()

Method Details

addNext

public Next addNext(WfVertex vertex)

adds a New link between the current Activity and the WfVertex passed in param

Specified by:

addNext in class WfVertex

getStateMachine

public StateMachine getStateMachine()
                             throws InvalidDataException

Throws:

InvalidDataException

getStateMachine

public StateMachine getStateMachine(TransactionKey transKey)
                             throws InvalidDataException

Throws:

InvalidDataException

getState

public int getState()
             throws InvalidDataException

Returns:

The current State of the StateMachine (Used in Serialisation)

Throws:

InvalidDataException - data was inconsistent

getErrorTransitionId

public int getErrorTransitionId()

Returns the id of the error Transition associated with the current state

Returns:

the id of the error Transition associated with the current state or -1 of there is no error Transition

getStateName

public String getStateName()
                    throws InvalidDataException

Throws:

InvalidDataException

setState

public void setState(int state)

Sets a new State

isFinished

public boolean isFinished()
                   throws InvalidDataException

Throws:

InvalidDataException

request

public String request(AgentPath agent,
 ItemPath itemPath,
 int transitionID,
 String requestData,
 String attachmentType,
 byte[] attachment,
 TransactionKey transactionKey)
               throws AccessRightsException,
InvalidTransitionException,
InvalidDataException,
ObjectNotFoundException,
PersistencyException,
ObjectAlreadyExistsException,
ObjectCannotBeUpdated,
CannotManageException,
InvalidCollectionModification

Throws:

AccessRightsException

InvalidTransitionException

InvalidDataException

ObjectNotFoundException

PersistencyException

ObjectAlreadyExistsException

ObjectCannotBeUpdated

CannotManageException

InvalidCollectionModification

request

public String request(AgentPath agent,
 ItemPath itemPath,
 int transitionID,
 String requestData,
 String attachmentType,
 byte[] attachment,
 boolean validateOutcome,
 TransactionKey transactionKey)
               throws AccessRightsException,
InvalidTransitionException,
InvalidDataException,
ObjectNotFoundException,
PersistencyException,
ObjectAlreadyExistsException,
ObjectCannotBeUpdated,
CannotManageException,
InvalidCollectionModification

Throws:

AccessRightsException

InvalidTransitionException

InvalidDataException

ObjectNotFoundException

PersistencyException

ObjectAlreadyExistsException

ObjectCannotBeUpdated

CannotManageException

InvalidCollectionModification

runActivityLogic

protected String runActivityLogic(AgentPath agent,
 ItemPath itemPath,
 int transitionID,
 String requestData,
 TransactionKey transactionKey)
                           throws InvalidDataException,
InvalidCollectionModification,
ObjectAlreadyExistsException,
ObjectCannotBeUpdated,
ObjectNotFoundException,
PersistencyException,
CannotManageException,
AccessRightsException

Overridden in predefined steps

Parameters:

agent -

itemPath -

transitionID -

requestData -

transactionKey -

Returns:

Throws:

InvalidDataException

InvalidCollectionModification

ObjectAlreadyExistsException

ObjectCannotBeUpdated

ObjectNotFoundException

PersistencyException

CannotManageException

AccessRightsException

verify

public boolean verify()

Description copied from class: WfVertex

Method verify.

Specified by:

verify in class WfVertex

Returns:

boolean

loop

public boolean loop()

Used in verify()

Specified by:

loop in class WfVertex

Returns:

boolean

runNext

public void runNext(TransactionKey transactionKey)
             throws InvalidDataException

sets the next activity available if possible

Specified by:

runNext in class WfVertex

Throws:

InvalidDataException

getNext

public Next getNext()

Returns:

the only Next of the Activity

reinit

public void reinit(int idLoop)
            throws InvalidDataException

reinitialises the Activity and propagate (for Loop)

Specified by:

reinit in class WfVertex

Throws:

InvalidDataException

getErrors

public String getErrors()

return the String that identifies the errors found in th activity

Specified by:

getErrors in class WfVertex

Returns:

String

run

public void run(TransactionKey transactionKey)
         throws InvalidDataException

called by precedent Activity runNext() for setting the activity able to be executed

Specified by:

run in class WfVertex

Throws:

InvalidDataException

runFirst

public void runFirst(TransactionKey transactionKey)
              throws InvalidDataException

sets the activity available to be executed on start of Workflow or composite activity (when it is the first one of the (sub)process

Specified by:

runFirst in class WfVertex

Throws:

InvalidDataException

getActive

public boolean getActive()

Returns:

the current ability to be executed

setActive

public void setActive(boolean acti)

sets the ability to be executed

getDescription

public String getDescription()

Returns:

the Description field of properties

getCurrentAgentName

public String getCurrentAgentName()

getCurrentAgentRole

public String getCurrentAgentRole()

calculateJobs

public List<Job> calculateJobs(AgentPath agent,
 ItemPath itemPath,
 boolean recurse)
                        throws ObjectNotFoundException,
InvalidDataException

Calculates the lists of jobs for the activity and its children (cf org.cristalise.kernel.entity.Job)

Throws:

ObjectNotFoundException

InvalidDataException

calculateAllJobs

public List<Job> calculateAllJobs(AgentPath agent,
 ItemPath itemPath,
 boolean recurse)
                           throws ObjectNotFoundException,
InvalidDataException

Throws:

ObjectNotFoundException

InvalidDataException

getStateDate

public GTimeStamp getStateDate()

Returns the startDate.

Returns:

GTimeStamp startDate

setStateDate

public void setStateDate(GTimeStamp startDate)

setActiveDate

@Deprecated
public void setActiveDate(GTimeStamp date)

Deprecated.

setStartDate

@Deprecated
public void setStartDate(GTimeStamp date)

Deprecated.

getType

public String getType()

Returns the type.

Returns:

String

getTypeName

public String getTypeName()

setType

public void setType(String type)

Sets the type.

Parameters:

type - The type to set

abort

public void abort(AgentPath agent,
 ItemPath itemPath,
 TransactionKey transactionKey)
           throws AccessRightsException,
InvalidTransitionException,
InvalidDataException,
ObjectNotFoundException,
PersistencyException,
ObjectAlreadyExistsException,
ObjectCannotBeUpdated,
CannotManageException,
InvalidCollectionModification

Overrides:

abort in class WfVertex

Throws:

AccessRightsException

InvalidTransitionException

InvalidDataException

ObjectNotFoundException

PersistencyException

ObjectAlreadyExistsException

ObjectCannotBeUpdated

CannotManageException

InvalidCollectionModification

toString

public String toString()

Overrides:

toString in class Object