wt.lifecycle
Class StandardLifeCycleService

java.lang.Object
  wt.services.StandardManager
      wt.lifecycle.StandardLifeCycleService

All Implemented Interfaces:

Serializable, NetFactor, LifeCycleService, wt.lifecycle.LifeCycleServiceSvr, wt.services.Manager

public class StandardLifeCycleService
extends StandardManager
implements LifeCycleService, wt.lifecycle.LifeCycleServiceSvr, Serializable

Standard implementation of the life cycle service interfaces

Use the newStandardLifeCycleService static factory method(s), not the StandardLifeCycleService constructor, to construct instances of this class. Instances must be constructed using the static factory(s), in order to ensure proper initialization of the instance.

Supported API: true

Extendable: false

See Also:

Serialized Form

Nested Class Summary

class

wt.lifecycle.StandardLifeCycleService.MultiObjectKey

Method Summary

wt.lifecycle.Phase	augmentRoles(wt.lifecycle.LifeCycleManaged object) Given a LifeCycleManaged object, the current State of the Object and the RoleHolder (the phase object), change the role participants to reflect those in the RoleHolder2 Supported API: true
void	augmentRoles(wt.team.Team team) Given a team, rebuild all the ad hoc acls for objects associated with the team.
wt.lifecycle.LifeCycleTemplate	copyTemplate(wt.lifecycle.LifeCycleTemplate lifeCycleTemplate, String copyName, String folderLocation) Produces a copy of the LifeCycleTemplate object and persists it with the name passed as argument.
wt.lifecycle.LifeCycleTemplate	copyTemplate(wt.lifecycle.LifeCycleTemplate lifeCycleTemplate, String copyName, String folderLocation, WTContainerRef context) Produces a copy of the LifeCycleTemplate object and persists it with the name passed as argument.
LifeCycleSignature	createLifeCycleSignature(Persistable object, WTPrincipal signer, String comments, Role role, boolean vote) Answer an initialized but unpersisted LifeCycleSignature instance Supported API: true
wt.lifecycle.LifeCycleManaged	demote(wt.lifecycle.LifeCycleManaged object, LifeCycleSignature signature) Move the object to the previous phase.
wt.lifecycle.LifeCycleManaged	deny(wt.lifecycle.LifeCycleManaged object, LifeCycleSignature signature) Remove the object from the gate and return the object to the submitter Supported API: true
wt.lifecycle.LifeCycleManaged	drop(wt.lifecycle.LifeCycleManaged object, LifeCycleSignature signature) Transition the object to an end state Supported API: true
void	exportTemplates(Vector lifeCycleVector, String fileName, boolean appendFlag) Populate a file with the xml equivalent of the LifeCycleTemplate objects.
QueryResult	findAllTemplateMasters(WTContainerRef context) Answer a vector of all life cycle template masters for the WTContainerRef passed.
Vector	findAllTemplates() Answer a vector of all life cycle templates.
Vector	findAllTemplates(WTContainerRef context) Answer a vector of all life cycle templates for the WTContainerRef passed.
Vector	findAllTemplates(WTContainerRef context, boolean routingOnly) Answer a vector of all life cycle templates for the WTContainerRef passed.
Vector	findAllTemplates(WTContainerRef context, boolean routingOnly, boolean keepFiltered) Answer a vector of all life cycle templates for the WTContainerRef passed.
Vector	findAssociatedProcesses(wt.lifecycle.LifeCycleManaged object, wt.workflow.engine.WfState state) Given a Life Cycle Managed object, return the Workflow processes associated with the current phase.
Vector	findCandidateMasterReferences(Class targetClass) Answer a vector of life cycle template references valid for the class Supported API: true
Vector	findCandidateMasterReferences(Class targetClass, WTContainerRef context) Answer a vector of life cycle template references valid for the target class in the container.
Vector	findCandidateMasterReferences(wt.lifecycle.LifeCycleManaged object) Answer a vector of life cycle template references valid for the life cycle managed object Supported API: true
Vector	findCandidateTemplates(Class targetClass) Answer a vector of enabled life cycle template references valid for the class findCandidateMasterReference is the preferable to use instead of this method.
Vector	findCandidateTemplates(Class targetClass, WTContainerRef containerRef) Answer a vector of enabled life cycle template references valid for the life cycle managed object and container context.
Vector	findCandidateTemplates(wt.lifecycle.LifeCycleManaged object) Answer a vector of enabled life cycle template references valid for the life cycle managed object findCandidateMasterReference is the preferable to use instead of this method.
Vector	findExportImportFileNames() Retrieve a vector of file names from the Import/Export directory Supported API: true
Enumeration	findPredecessorStates(wt.lifecycle.LifeCycleManaged object) Given a particular LifeCycleManged object, answer an enumeration of all the predecessor States Supported API: true
Vector	findRoutingTemplates(WTContainerRef context) Return an Enumeration of all lifecycle templates for the WTContainerRef passed.
WTKeyedMap	findSetStateCandidates(WTCollection lcms) Determines the allowable states the session principal can set the objects in the collection to.
Vector	findStates(wt.lifecycle.LifeCycleTemplate aLifeCycleTemplate) Given a particular LifeCycleTemplate, answer a Vector of all the Life Cycle States used in that LifeCycle Supported API: true
Enumeration	findSuccessorStates(wt.lifecycle.LifeCycleManaged object) Given a particular LifeCycleTemplate, answer an enumeration of all the Successor States Supported API: true
Vector	getAllReviewerList(wt.lifecycle.LifeCycleManaged object) Answer a vector of LifeCycleSignatures Supported API: true
Vector	getAllSignatures(wt.lifecycle.LifeCycleManaged object) Answer a vector of signatures for all roles for the object for the current phase and all preceeding phases.
Vector	getCriteria(wt.lifecycle.LifeCycleManaged object) Answer a vector of Criterion objects for the current phase Supported API: true
ObjectReference	getCurrentWorkflow(wt.lifecycle.LifeCycleManaged object) Given a LifeCycleManaged object, return a reference to the current WfProcess.
QueryResult	getHistory(wt.lifecycle.LifeCycleManaged object) Answer an enumeration of LifeCycleHistory objects based on supplied object.
wt.lifecycle.LifeCycleTemplate	getLatestIteration(wt.lifecycle.LifeCycleTemplateMaster master) Given a LifeCycleTemplateMaster, return the latest iteration (LifeCycleTemplate) Supported API: true
wt.lifecycle.LifeCycleTemplateReference	getLatestIteration(wt.lifecycle.LifeCycleTemplateMasterReference master) Given a LifeCycleTemplateMasterReference, return the latest iteration (LifeCycleTemplateReference) Supported API: true
wt.lifecycle.LifeCycleTemplate	getLifeCycleTemplate(wt.lifecycle.LifeCycleManaged object) Deprecated. in R4.0 - Use myObject.getLifeCycleTemplate() instead.
wt.lifecycle.LifeCycleTemplate	getLifeCycleTemplate(String aTemplateName) Given a String representation of the LifeCycleTemplate name, answer the enabled LifeCycleTemplate.
wt.lifecycle.LifeCycleTemplate	getLifeCycleTemplate(String aTemplateName, WTContainerRef context) Given a String representation of the LifeCycleTemplate name and a WTContainerRef, answer the LifeCycleTemplate.
wt.lifecycle.LifeCycleTemplateMaster	getLifeCycleTemplateMaster(String aMasterName) Given a String representation of the LifeCycleTemplateMaster name, answer the LifeCycleTemplateMasterReference Supported API: true
wt.lifecycle.LifeCycleTemplateMaster	getLifeCycleTemplateMaster(String aMasterName, WTContainerRef context) Given a String representation of the LifeCycleTemplateMaster name and a WTContainerRef, answer the LifeCycleTemplateMasterReference Supported API: true
wt.lifecycle.LifeCycleTemplateReference	getLifeCycleTemplateReference(String aName) Given a String representation of the LifeCycleTemplater name, find the latest iteration or working copy of the LifeCycleTemplate.
wt.lifecycle.LifeCycleTemplateReference	getLifeCycleTemplateReference(String aName, WTContainerRef context) Given a String representation of the LifeCycleTemplater name and a WTContainerRef, find the latest iteration or working copy of the LifeCycleTemplate.
Vector	getPhaseTemplates(wt.lifecycle.LifeCycleTemplate template) Given a LifeCycleTemplate, return a vector of all the PhaseTemplate objects Supported API: true
State	getPredecessorState(wt.lifecycle.LifeCycleManaged lcmObject) This operation determines the current state of the object and returns the predecessor state for the object.
Vector	getReviewerList(wt.lifecycle.LifeCycleManaged object) Answer a vector of LifeCycleSignatures Supported API: true
Vector	getRoles(wt.lifecycle.LifeCycleManaged object) Answer a vector of strings - role names for the current phase Supported API: true
WTKeyedMap	getSeriesSelectors(WTSet lcms) Given a WTSet of objects, returns a WTKeyedMap whose keys are those elements of the argument set that are LifeCycleManaged and whose values are the keys' corresponding SeriesRangeSelector values for their current states, if applicable.
Vector	getSignatures(wt.lifecycle.LifeCycleManaged object) Answer a vector of signatures for all roles for the object for the current phase.
Vector	getSignatures(wt.lifecycle.LifeCycleManaged object, Role role) Answer a vector of LifeCycleSignature for the current phase based on object and role.
Vector	getSignatures(wt.lifecycle.LifeCycleManaged object, WTUser user) Answer a vector of LifeCycleSignatures based on supplied object & user.
Vector	getSignatures(wt.lifecycle.LifeCycleManaged object, WTUser user, Role role) Answer a vector of LifeCycleSignature for the current phase based on object, user and role.
State	getSuccessorState(wt.lifecycle.LifeCycleManaged lcmObject) This operation determines the current state of the object and returns the successor state for the object.
boolean	hasAugmentRoleAccess(Role role, wt.lifecycle.LifeCycleManaged object) Given a role and a LifeCycleManaged object, determines whether the current user has the permissions required to update the role participants Supported API: true
void	importTemplates(String fileName) Given a WTContainerRef and a jar or zip file that contains a version of any number of LifeCycleTemplate objects, import these objects.
void	importTemplates(String fileName, WTContainerRef context) Given a WTContainerRef and a jar or zip file that contains a version of any number of LifeCycleTemplate objects, import these objects.
boolean	isA(wt.lifecycle.LifeCycleManaged object, WTUser user, Role role) Deprecated. at 8.0. A user no longer has to belong to a specific role in order to complete a lifecycle task
boolean	isInFinalPhase(wt.lifecycle.LifeCycleManaged object) Answers whether the LifeCycleManaged object is in the Final phase of its LifeCycle Supported API: true
boolean	isInInitialPhase(wt.lifecycle.LifeCycleManaged object) Answer whether the LifeCycleManaged object is in the Initial phase Supported API: true
boolean	isState(wt.lifecycle.LifeCycleTemplate aLifeCycleTemplate, State aState) Given a particular LifeCycleTemplate and a State, answer whether or not the State is used in the LifeCycle Supported API: true
Set	navigate(wt.lifecycle.LifeCycleManaged lcmObject, Transition name, boolean successor) Navigate the transition of the current state of the LifeCycleManagedObject using the passed transition.
Set	navigate(wt.lifecycle.LifeCycleTemplateReference lctRef, State state, Transition transition, boolean successor) Navigate the transition from the passed state using the passed transition.
Map	navigate(WTCollection c, Transition transition, boolean successor) Navigate the PhaseSuccessors for the Transition for all objects in the WTCollection.
Map	navigate(WTKeyedMap c, Transition transition, boolean successor) Navigates the PhaseTemplate->PhaseSuccession using param transition.
wt.lifecycle.LifeCycleManaged	promote(wt.lifecycle.LifeCycleManaged object, LifeCycleSignature signature) Move the object to the next phase.
wt.lifecycle.LifeCycleManaged	reassign(wt.lifecycle.LifeCycleManaged object, wt.lifecycle.LifeCycleTemplateReference lctRef) Reassign a life cycle managed object to a new life cycle.
wt.lifecycle.LifeCycleManaged	reassign(wt.lifecycle.LifeCycleManaged object, wt.lifecycle.LifeCycleTemplateReference lctRef, WTContainerRef context) Reassign a life cycle managed object to a new life cycle in a certain WTContainerRef.
wt.lifecycle.LifeCycleManaged	reassign(wt.lifecycle.LifeCycleManaged object, wt.lifecycle.LifeCycleTemplateReference lctRef, WTContainerRef context, String comments) Reassign a life cycle managed object to a new life cycle in a certain WTContainerRef.
WTList	reassign(WTList list, wt.lifecycle.LifeCycleTemplateReference lctRef, WTContainerRef context, boolean preserveState) Reassign all objects in a WTList to a lifecycle.
WTList	reassign(WTList list, wt.lifecycle.LifeCycleTemplateReference lctRef, WTContainerRef context, boolean preserveState, String comments) Reassign all objects in a WTList to a lifecycle.
WTList	reassign(WTList list, wt.lifecycle.LifeCycleTemplateReference lctRef, WTContainerRef context, State state) Reassign the life cycle managed objects in a WTList to a new life cycle in a certain WTContainerRef.
WTList	reassign(WTList list, wt.lifecycle.LifeCycleTemplateReference lctRef, WTContainerRef context, State state, String comments) Reassign the life cycle managed objects in a WTList to a new life cycle in a certain WTContainerRef.
TransactionResult	saveLifeCycleTemplate(TransactionContainer aTran) Store or update a LifeCycleTemplate.
TransactionResult	saveLifeCycleTemplate(TransactionContainer aTran, WTContainerRef context) Store or update a LifeCycleTemplate.
TransactionResult	saveLifeCycleTemplate(TransactionContainer aTran, WTContainerRef context, boolean bypassDefaultTransitions) Store or update a LifeCycleTemplate.
void	setEnabled(wt.lifecycle.LifeCycleTemplate aTemplate, boolean enable) Enable/Disable the Life Cycle Template Master Supported API: true
void	setEnabled(wt.lifecycle.LifeCycleTemplateMaster aMaster, boolean enable) Enable/Disable the Life Cycle Template Master Supported API: true
wt.lifecycle.LifeCycleManaged	setLifeCycleState(wt.lifecycle.LifeCycleManaged object, State state) Set the state of the Life Cycle Managed object.
wt.lifecycle.LifeCycleManaged	setLifeCycleState(wt.lifecycle.LifeCycleManaged object, State state, boolean terminAssocRunningProcesses) Set the state of the Life Cycle Managed object and provide the option to terminate the associated workflows.
wt.lifecycle.LifeCycleManaged	setLifeCycleState(wt.lifecycle.LifeCycleManaged object, State state, boolean terminAssocRunningProcesses, Timestamp timestamp) Set the state of the Life Cycle Managed object.
WTList	setLifeCycleState(WTList list, Map stateMap, WTList terminateList) Set the state of the Life Cycle Managed objects in the WTList list.
WTList	setLifeCycleState(WTList list, State state, boolean terminAssocRunningProcesses) Set the state of the Life Cycle Managed objects and provide the option to terminate the associated workflows.
void	setRouting(wt.lifecycle.LifeCycleTemplate aTemplate, boolean routing) Set/reset the rouing attribute on the Life Cycle Template Master.
void	setRouting(wt.lifecycle.LifeCycleTemplateMaster aMaster, boolean routing) Set/reset the routing attribute of the Life Cycle Template Master.
wt.lifecycle.LifeCycleManaged	submitForApproval(wt.lifecycle.LifeCycleManaged object) Submit the object for review.
wt.lifecycle.LifeCycleManaged	validateSubmitForApproval(wt.lifecycle.LifeCycleManaged object) Perform pre-submit validations Supported API: true
LifeCycleSignature	vote(wt.lifecycle.LifeCycleManaged object, LifeCycleSignature signature) Record a signer disposition (Yes/No) and any comments.

Methods inherited from class wt.services.StandardManager

getManagerService, getManagerStatus, getName, getStartupType

Methods inherited from class java.lang.Object

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

Method Detail

submitForApproval

public wt.lifecycle.LifeCycleManaged submitForApproval(wt.lifecycle.LifeCycleManaged object)
                                                throws WTException,
                                                       wt.lifecycle.LifeCycleException

Submit the object for review.

Supported API: true

Specified by:

submitForApproval in interface LifeCycleService

Parameters:

object - the LifeCycleManaged object that should be submitted for approval

Returns:

LifeCycleManaged

Throws:

WTException

wt.lifecycle.LifeCycleException

vote

public LifeCycleSignature vote(wt.lifecycle.LifeCycleManaged object,
                               LifeCycleSignature signature)
                        throws WTException,
                               wt.lifecycle.LifeCycleException

Record a signer disposition (Yes/No) and any comments.

Supported API: true

Specified by:

vote in interface LifeCycleService

Parameters:

object - the LifeCycleManaged object that should be voted on

signature - the signature object where the vote results should be recorded

Returns:

LifeCycleSignature

Throws:

WTException

wt.lifecycle.LifeCycleException

promote

public wt.lifecycle.LifeCycleManaged promote(wt.lifecycle.LifeCycleManaged object,
                                             LifeCycleSignature signature)
                                      throws WTException,
                                             wt.lifecycle.LifeCycleException

Move the object to the next phase.

The doPromote method is executed

Supported API: true

Specified by:

promote in interface LifeCycleService

Parameters:

object - the LifeCycleManaged object that should be promoted

signature - the Signature object where the results and information about the promote should be recorded

Returns:

LifeCycleManaged

Throws:

WTException

wt.lifecycle.LifeCycleException

demote

public wt.lifecycle.LifeCycleManaged demote(wt.lifecycle.LifeCycleManaged object,
                                            LifeCycleSignature signature)
                                     throws WTException,
                                            wt.lifecycle.LifeCycleException

Move the object to the previous phase.

The doDemote method is executed

Supported API: true

Specified by:

demote in interface LifeCycleService

Parameters:

object - the LifeCycleManaged object that should be demoted.

signature - the Signature object where the results and information about the demote should be recorded

Returns:

LifeCycleManaged

Throws:

WTException

wt.lifecycle.LifeCycleException

deny

public wt.lifecycle.LifeCycleManaged deny(wt.lifecycle.LifeCycleManaged object,
                                          LifeCycleSignature signature)
                                   throws WTException,
                                          wt.lifecycle.LifeCycleException

Remove the object from the gate and return the object to the submitter

Supported API: true

Specified by:

deny in interface LifeCycleService

Parameters:

object - the LifeCycleManaged object that should be denied

signature - the Signature object that the result and information about the deny is recorded

Returns:

LifeCycleManaged

Throws:

WTException

wt.lifecycle.LifeCycleException

drop

public wt.lifecycle.LifeCycleManaged drop(wt.lifecycle.LifeCycleManaged object,
                                          LifeCycleSignature signature)
                                   throws WTException,
                                          wt.lifecycle.LifeCycleException

Transition the object to an end state

Supported API: true

Specified by:

drop in interface LifeCycleService

Parameters:

object - the LifeCycleManaged object that should be moved to a final/dropped state

signature - the LifeCycleSignature object records information about the drop process

Returns:

LifeCycleManaged

Throws:

WTException

wt.lifecycle.LifeCycleException

reassign

public wt.lifecycle.LifeCycleManaged reassign(wt.lifecycle.LifeCycleManaged object,
                                              wt.lifecycle.LifeCycleTemplateReference lctRef)
                                       throws WTException,
                                              wt.lifecycle.LifeCycleException

Reassign a life cycle managed object to a new life cycle.

Supported API: true

Specified by:

reassign in interface LifeCycleService

Parameters:

object - the LifeCycleManaged object that should be assigned to a new life cycle

lctRef - a reference to a LifeCycleTemplate, the LifeCycleTemplate that the object should be reassigned to

Returns:

LifeCycleManaged

Throws:

WTException

wt.lifecycle.LifeCycleException

getLifeCycleTemplate

public wt.lifecycle.LifeCycleTemplate getLifeCycleTemplate(wt.lifecycle.LifeCycleManaged object)
                                                    throws WTException,
                                                           wt.lifecycle.LifeCycleException

Deprecated. in R4.0 - Use myObject.getLifeCycleTemplate() instead.

Answer the LifeCycleTemplate the object is assigned to

Supported API: true

Specified by:

getLifeCycleTemplate in interface LifeCycleService

Parameters:

object - the LifeCycleManaged object used as search criteria in the retrieval of the LifeCycleTemplate

Returns:

LifeCycleTemplate

Throws:

WTException

wt.lifecycle.LifeCycleException

getSignatures

public Vector getSignatures(wt.lifecycle.LifeCycleManaged object,
                            WTUser user,
                            Role role)
                     throws WTException,
                            wt.lifecycle.LifeCycleException

Answer a vector of LifeCycleSignature for the current phase based on object, user and role.

Supported API: true

Specified by:

getSignatures in interface LifeCycleService

Parameters:

object - the LifeCycleManaged object used as search criteria in the retrieval of signature objects

user - the WTUser object used as search criteria in the retrieval of Signature objects

role - the Role object used as search criteria in the retrieval of the Signature objects

Returns:

Vector

Throws:

WTException

wt.lifecycle.LifeCycleException

getSignatures

public Vector getSignatures(wt.lifecycle.LifeCycleManaged object,
                            Role role)
                     throws WTException,
                            wt.lifecycle.LifeCycleException

Answer a vector of LifeCycleSignature for the current phase based on object and role.

Supported API: true

Specified by:

getSignatures in interface LifeCycleService

Parameters:

object - the LifeCycleManaged object used as search criteria in the retrieval of the Signature objects

role - the Role object used as search criteria in the retrieval of Signature objects

Returns:

Vector

Throws:

WTException

wt.lifecycle.LifeCycleException

getSignatures

public Vector getSignatures(wt.lifecycle.LifeCycleManaged object)
                     throws WTException,
                            wt.lifecycle.LifeCycleException

Answer a vector of signatures for all roles for the object for the current phase.

Supported API: true

Specified by:

getSignatures in interface LifeCycleService

Parameters:

object - the LifeCycleManaged object used as search criteria in the retrieval of Signature objects

Returns:

Vector

Throws:

WTException

wt.lifecycle.LifeCycleException

getSignatures

public Vector getSignatures(wt.lifecycle.LifeCycleManaged object,
                            WTUser user)
                     throws WTException,
                            wt.lifecycle.LifeCycleException

Answer a vector of LifeCycleSignatures based on supplied object & user.

Supported API: true

Specified by:

getSignatures in interface LifeCycleService

Parameters:

object - The LifeCycleManaged object used as search criteria in the retrieval of Signature objects

user - the WTUser object used as search criteria in the retrieval of Signature objects

Returns:

Vector

Throws:

WTException

wt.lifecycle.LifeCycleException

getAllSignatures

public Vector getAllSignatures(wt.lifecycle.LifeCycleManaged object)
                        throws WTException,
                               wt.lifecycle.LifeCycleException

Answer a vector of signatures for all roles for the object for the current phase and all preceeding phases.

Supported API: true

Specified by:

getAllSignatures in interface LifeCycleService

Parameters:

object - the LifeCycleManaged object used as search criteria in the retrieval of Signature objects

Returns:

Vector

Throws:

WTException

wt.lifecycle.LifeCycleException

createLifeCycleSignature

public LifeCycleSignature createLifeCycleSignature(Persistable object,
                                                   WTPrincipal signer,
                                                   String comments,
                                                   Role role,
                                                   boolean vote)
                                            throws WTException

Answer an initialized but unpersisted LifeCycleSignature instance

Supported API: true

Specified by:

createLifeCycleSignature in interface LifeCycleService

Parameters:

object - the Persistable object that the LifeCycleSignature is associated to

signer - the WTPrincipal who did the work

comments - any comments the signer recorded about the work accomplished

role - the Role object, used to represent the role the signer was participating as

vote - a boolean signer designation, used to record the disposition

Returns:

LifeCycleSignature

Throws:

WTException

getReviewerList

public Vector getReviewerList(wt.lifecycle.LifeCycleManaged object)
                       throws WTException,
                              wt.lifecycle.LifeCycleException

Answer a vector of LifeCycleSignatures

Supported API: true

Specified by:

getReviewerList in interface LifeCycleService

Parameters:

object - The LifeCycleManaged object used as search criteria in the retrieval of Signature objects

Returns:

Vector

Throws:

WTException

wt.lifecycle.LifeCycleException

getAllReviewerList

public Vector getAllReviewerList(wt.lifecycle.LifeCycleManaged object)
                          throws WTException,
                                 wt.lifecycle.LifeCycleException

Answer a vector of LifeCycleSignatures

Supported API: true

Specified by:

getAllReviewerList in interface LifeCycleService

Parameters:

object - The LifeCycleManaged object used as search criteria in the retrieval of Signature objects

Returns:

Vector

Throws:

WTException

wt.lifecycle.LifeCycleException

getRoles

public Vector getRoles(wt.lifecycle.LifeCycleManaged object)
                throws WTException,
                       wt.lifecycle.LifeCycleException

Answer a vector of strings - role names for the current phase

Supported API: true

Specified by:

getRoles in interface LifeCycleService

Parameters:

object - the LifeCycleManaged object used as search criteria in the retrieval of Role objects

Returns:

Vector

Throws:

WTException

wt.lifecycle.LifeCycleException

getCriteria

public Vector getCriteria(wt.lifecycle.LifeCycleManaged object)
                   throws WTException,
                          wt.lifecycle.LifeCycleException

Answer a vector of Criterion objects for the current phase

Supported API: true

Specified by:

getCriteria in interface LifeCycleService

Parameters:

object - the LifeCycleManaged object used as search criteria in the retrieval of Criterion objects

Returns:

Vector

Throws:

WTException

wt.lifecycle.LifeCycleException

saveLifeCycleTemplate

public TransactionResult saveLifeCycleTemplate(TransactionContainer aTran)
                                        throws WTException,
                                               wt.lifecycle.LifeCycleException

Store or update a LifeCycleTemplate. This method accepts and processes a batch container of persistence assertions.

Supported API: true

Specified by:

saveLifeCycleTemplate in interface LifeCycleService

Parameters:

aTran - a TransactionContainer that contains a set of LifeCycleTemplate, PhaseTemplate, AdHocAclSpec, Criterion and Transition assertions that need to be applied against one or more LifeCycleTemplate objects

Returns:

TransactionResult

Throws:

WTException

wt.lifecycle.LifeCycleException

getHistory

public QueryResult getHistory(wt.lifecycle.LifeCycleManaged object)
                       throws WTException,
                              wt.lifecycle.LifeCycleException

Answer an enumeration of LifeCycleHistory objects based on supplied object.

Usage:

LifeCycleHistory aHistory = null; Enumeration e = LifeCycleHelper.service.getHistory(aLifeCycleManaged); while (e.hasMoreElements()) { aHistory = (LifeCycleHistory)e.nextElement(); // -- do stuff }

Supported API: true

Specified by:

getHistory in interface LifeCycleService

Parameters:

object - the LifeCycleManaged object used as search criteria for the retrieval of History information

Returns:

QueryResult

Throws:

WTException

wt.lifecycle.LifeCycleException

isA

public boolean isA(wt.lifecycle.LifeCycleManaged object,
                   WTUser user,
                   Role role)
            throws WTException,
                   wt.lifecycle.LifeCycleException

Deprecated. at 8.0. A user no longer has to belong to a specific role in order to complete a lifecycle task

Answer whether the designated user is validated for the designated role

Supported API: true

Specified by:

isA in interface LifeCycleService

Parameters:

object - the LifeCycleManaged object

user - the designated user

role - the designated role

Returns:

boolean

Throws:

WTException

wt.lifecycle.LifeCycleException

isInInitialPhase

public boolean isInInitialPhase(wt.lifecycle.LifeCycleManaged object)
                         throws WTException

Answer whether the LifeCycleManaged object is in the Initial phase

Supported API: true

Specified by:

isInInitialPhase in interface LifeCycleService

Parameters:

object - The LifeCycleManaged object

Returns:

boolean

Throws:

WTException

isInFinalPhase

public boolean isInFinalPhase(wt.lifecycle.LifeCycleManaged object)
                       throws WTException

Answers whether the LifeCycleManaged object is in the Final phase of its LifeCycle

Supported API: true

Specified by:

isInFinalPhase in interface LifeCycleService

Parameters:

object - The LifeCycleManaged object

Returns:

boolean

Throws:

WTException

getLifeCycleTemplate

public wt.lifecycle.LifeCycleTemplate getLifeCycleTemplate(String aTemplateName)
                                                    throws wt.lifecycle.LifeCycleException,
                                                           WTException

Given a String representation of the LifeCycleTemplate name, answer the enabled LifeCycleTemplate. If no template is found, return null/code>.

Supported API: true

Specified by:

getLifeCycleTemplate in interface LifeCycleService

Parameters:

aTemplateName - the name of the LifeCycleTemplate to retrieve

Returns:

LifeCycleTemplate

Throws:

wt.lifecycle.LifeCycleException

WTException

validateSubmitForApproval

public wt.lifecycle.LifeCycleManaged validateSubmitForApproval(wt.lifecycle.LifeCycleManaged object)
                                                        throws WTException,
                                                               wt.lifecycle.LifeCycleException

Perform pre-submit validations

Supported API: true

Specified by:

validateSubmitForApproval in interface LifeCycleService

Parameters:

object - the LifeCycleManaged object to be submitted

Returns:

LifeCycleManaged

Throws:

WTException

wt.lifecycle.LifeCycleException

hasAugmentRoleAccess

public boolean hasAugmentRoleAccess(Role role,
                                    wt.lifecycle.LifeCycleManaged object)
                             throws WTException,
                                    wt.lifecycle.LifeCycleException

Given a role and a LifeCycleManaged object, determines whether the current user has the permissions required to update the role participants

Supported API: true

Specified by:

hasAugmentRoleAccess in interface LifeCycleService

Parameters:

role - The LifeCycleManaged object that the role/participant mapping is being added to

object - the object whose team is being modified

Returns:

boolean

Throws:

WTException

wt.lifecycle.LifeCycleException

findCandidateTemplates

public Vector findCandidateTemplates(wt.lifecycle.LifeCycleManaged object)
                              throws WTException,
                                     wt.lifecycle.LifeCycleException

Answer a vector of enabled life cycle template references valid for the life cycle managed object findCandidateMasterReference is the preferable to use instead of this method. Using findCandidateMasterReference plus the 'getLifeCycleTemplate' method on that object will get the latest iteration at the last possible moment, eliminating some multi-user timing issues.

Supported API: true

Specified by:

findCandidateTemplates in interface LifeCycleService

Parameters:

object - the LifeCycleManaged object used as search criteria in the retrieval of canidate LifeCycleTemplates

Returns:

Vector

Throws:

WTException

wt.lifecycle.LifeCycleException

findCandidateTemplates

public Vector findCandidateTemplates(Class targetClass)
                              throws WTException,
                                     wt.lifecycle.LifeCycleException

Answer a vector of enabled life cycle template references valid for the class findCandidateMasterReference is the preferable to use instead of this method. Using findCandidateMasterReference plus the 'getLifeCycleTemplate' method on that object will get the latest iteration at the last possible moment, eliminating some multi-user timing issues.

Supported API: true

Specified by:

findCandidateTemplates in interface LifeCycleService

Parameters:

targetClass - the class used as search criteria in the retrieval of canidate LifeCycleTemplates

Returns:

Vector

Throws:

WTException

wt.lifecycle.LifeCycleException

findStates

public Vector findStates(wt.lifecycle.LifeCycleTemplate aLifeCycleTemplate)
                  throws WTException,
                         wt.lifecycle.LifeCycleException

Given a particular LifeCycleTemplate, answer a Vector of all the Life Cycle States used in that LifeCycle

Supported API: true

Specified by:

findStates in interface LifeCycleService

Parameters:

aLifeCycleTemplate - the LifeCycleTemplate used to retrieve the appropriate states

Returns:

Vector

Throws:

WTException

wt.lifecycle.LifeCycleException

isState

public boolean isState(wt.lifecycle.LifeCycleTemplate aLifeCycleTemplate,
                       State aState)
                throws WTException,
                       wt.lifecycle.LifeCycleException

Given a particular LifeCycleTemplate and a State, answer whether or not the State is used in the LifeCycle

Supported API: true

Specified by:

isState in interface LifeCycleService

Parameters:

aLifeCycleTemplate - the LifeCycleTemplate used in the lookup

aState - the State used in the lookup

Returns:

boolean

Throws:

WTException

wt.lifecycle.LifeCycleException

findPredecessorStates

public Enumeration findPredecessorStates(wt.lifecycle.LifeCycleManaged object)
                                  throws WTException,
                                         wt.lifecycle.LifeCycleException

Given a particular LifeCycleManged object, answer an enumeration of all the predecessor States

Supported API: true

Specified by:

findPredecessorStates in interface LifeCycleService

Parameters:

object - the LifeCycleManaged object of interest

Returns:

Enumeration

Throws:

WTException

wt.lifecycle.LifeCycleException

findSuccessorStates

public Enumeration findSuccessorStates(wt.lifecycle.LifeCycleManaged object)
                                throws WTException,
                                       wt.lifecycle.LifeCycleException

Given a particular LifeCycleTemplate, answer an enumeration of all the Successor States

Supported API: true

Specified by:

findSuccessorStates in interface LifeCycleService

Parameters:

object - the LifeCycleManaged object of interest

Returns:

Enumeration

Throws:

WTException

wt.lifecycle.LifeCycleException

setEnabled

public void setEnabled(wt.lifecycle.LifeCycleTemplate aTemplate,
                       boolean enable)
                throws WTException,
                       wt.lifecycle.LifeCycleException

Enable/Disable the Life Cycle Template Master

Supported API: true

Specified by:

setEnabled in interface LifeCycleService

Parameters:

aTemplate - the template to set the enabled flat on

enable - specifies whether or not the template is enabled

Throws:

WTException

wt.lifecycle.LifeCycleException

setEnabled

public void setEnabled(wt.lifecycle.LifeCycleTemplateMaster aMaster,
                       boolean enable)
                throws WTException,
                       wt.lifecycle.LifeCycleException

Enable/Disable the Life Cycle Template Master

Supported API: true

Specified by:

setEnabled in interface LifeCycleService

Parameters:

aMaster - the lifecycle template master to set the enabled flag on

enable - sets the value of the enabled flag to true or false

Throws:

WTException

wt.lifecycle.LifeCycleException

findCandidateMasterReferences

public Vector findCandidateMasterReferences(wt.lifecycle.LifeCycleManaged object)
                                     throws WTException,
                                            wt.lifecycle.LifeCycleException

Answer a vector of life cycle template references valid for the life cycle managed object

Supported API: true

Specified by:

findCandidateMasterReferences in interface LifeCycleService

Parameters:

object - the LifeCycleManaged object used as search criteria in the retrieval of canidate LifeCycleTemplates

Returns:

Vector

Throws:

WTException

wt.lifecycle.LifeCycleException

findCandidateMasterReferences

public Vector findCandidateMasterReferences(Class targetClass)
                                     throws WTException,
                                            wt.lifecycle.LifeCycleException

Answer a vector of life cycle template references valid for the class

Supported API: true

Specified by:

findCandidateMasterReferences in interface LifeCycleService

Parameters:

targetClass - the class used as search criteria in the retrieval of canidate LifeCycleTemplates

Returns:

Vector

Throws:

WTException

wt.lifecycle.LifeCycleException

getLifeCycleTemplateMaster

public wt.lifecycle.LifeCycleTemplateMaster getLifeCycleTemplateMaster(String aMasterName)
                                                                throws wt.lifecycle.LifeCycleException,
                                                                       WTException

Given a String representation of the LifeCycleTemplateMaster name, answer the LifeCycleTemplateMasterReference

Supported API: true

Specified by:

getLifeCycleTemplateMaster in interface LifeCycleService

Parameters:

aMasterName - the name of the LifeCycleTemplate to retrieve

Returns:

LifeCycleTemplateMaster

Throws:

wt.lifecycle.LifeCycleException

WTException

getLifeCycleTemplateReference

public wt.lifecycle.LifeCycleTemplateReference getLifeCycleTemplateReference(String aName)
                                                                      throws wt.lifecycle.LifeCycleException,
                                                                             WTException

Given a String representation of the LifeCycleTemplater name, find the latest iteration or working copy of the LifeCycleTemplate. Return a LifeCycleTemplateReference.

Supported API: true

Specified by:

getLifeCycleTemplateReference in interface LifeCycleService

Parameters:

aName - the name of the LifeCycleTemplate to retrieve

Returns:

LifeCycleTemplateReference

Throws:

wt.lifecycle.LifeCycleException

WTException

setLifeCycleState

public wt.lifecycle.LifeCycleManaged setLifeCycleState(wt.lifecycle.LifeCycleManaged object,
                                                       State state,
                                                       boolean terminAssocRunningProcesses)
                                                throws WTException,
                                                       wt.lifecycle.LifeCycleException

Set the state of the Life Cycle Managed object and provide the option to terminate the associated workflows. If null is passed as the WfState, all processes are terminated.

Supported API: true

Specified by:

setLifeCycleState in interface LifeCycleService

Parameters:

object - The LifeCycleManaged object whose state should be updated

state - The state to set the LifeCycleManaged object to.

terminAssocRunningProcesses - a flag that determines whether or not to terminate the wf processes associated with this phase that are OPEN_RUNNING

Returns:

LifeCycleManaged

Throws:

WTException

wt.lifecycle.LifeCycleException

setLifeCycleState

public wt.lifecycle.LifeCycleManaged setLifeCycleState(wt.lifecycle.LifeCycleManaged object,
                                                       State state)
                                                throws WTException,
                                                       wt.lifecycle.LifeCycleException

Set the state of the Life Cycle Managed object.

Supported API: true

Specified by:

setLifeCycleState in interface LifeCycleService

Parameters:

object - The LifeCycleManaged object whose state should be updated

state - The state to set the LifeCycleManaged object to.

Returns:

LifeCycleManaged

Throws:

WTException

wt.lifecycle.LifeCycleException

findAssociatedProcesses

public Vector findAssociatedProcesses(wt.lifecycle.LifeCycleManaged object,
                                      wt.workflow.engine.WfState state)
                               throws WTException,
                                      wt.lifecycle.LifeCycleException

Given a Life Cycle Managed object, return the Workflow processes associated with the current phase. If null is specified as the Wf State, all processes are retrieved.

Supported API: true

Specified by:

findAssociatedProcesses in interface LifeCycleService

Parameters:

object - the Life Cycle Managed object

state - the Workflow state

Returns:

Vector

Throws:

WTException

wt.lifecycle.LifeCycleException

findExportImportFileNames

public Vector findExportImportFileNames()
                                 throws WTException,
                                        wt.lifecycle.LifeCycleException

Retrieve a vector of file names from the Import/Export directory

Supported API: true

Specified by:

findExportImportFileNames in interface LifeCycleService

Returns:

Vector

Throws:

WTException

wt.lifecycle.LifeCycleException

exportTemplates

public void exportTemplates(Vector lifeCycleVector,
                            String fileName,
                            boolean appendFlag)
                     throws WTException,
                            wt.lifecycle.LifeCycleException

Populate a file with the xml equivalent of the LifeCycleTemplate objects. The xml file is zipped in a jar or zip file.

Supported API: true

Specified by:

exportTemplates in interface LifeCycleService

Parameters:

lifeCycleVector - an enumeration of LifeCycleTemplate objects that need to be exported

fileName - the name of the file that the csv version of the templates should be written to (not including the .csv suffix or the directory name)

appendFlag - a flag that determines whether the exported data should overwrite any existing data or append it to the end

Throws:

WTException

wt.lifecycle.LifeCycleException

importTemplates

public void importTemplates(String fileName)
                     throws WTException,
                            wt.lifecycle.LifeCycleException

Given a WTContainerRef and a jar or zip file that contains a version of any number of LifeCycleTemplate objects, import these objects.

Supported API: true

Specified by:

importTemplates in interface LifeCycleService

Parameters:

fileName - the name of the file that the xml version of the templates should be imported from (not including the .csv extension or the directory name)

Throws:

WTException

wt.lifecycle.LifeCycleException

copyTemplate

public wt.lifecycle.LifeCycleTemplate copyTemplate(wt.lifecycle.LifeCycleTemplate lifeCycleTemplate,
                                                   String copyName,
                                                   String folderLocation)
                                            throws WTException,
                                                   wt.lifecycle.LifeCycleException

Produces a copy of the LifeCycleTemplate object and persists it with the name passed as argument. If the name argument is "null", the name of the copied LifeCycleTemplate object is prefixed with 'copy of'. If the folder location is not specified, the object will be persisted in the orginal LifeCycleTemplates's folder location. Note: The 'Copy Of' prefix is pulled from a Resource Bundle for localization purposes.

Supported API: true

Specified by:

copyTemplate in interface LifeCycleService

Parameters:

lifeCycleTemplate - the LifeCycleTemplate object that should be copied

copyName - the name of the new LifeCycleTemplate

folderLocation - the folder location of the new LifeCycleTemplate

Returns:

LifeCycleTemplate

Throws:

WTException

wt.lifecycle.LifeCycleException

findAllTemplates

public Vector findAllTemplates()
                        throws WTException,
                               wt.lifecycle.LifeCycleException

Answer a vector of all life cycle templates. The latest iteration of each life cycle template will be returned. In this particular context, the definition of 'latest iteration' is either the current user's working copy, if one exists, or the latest iteration in the vault.

Supported API: true

Specified by:

findAllTemplates in interface LifeCycleService

Returns:

Vector

Throws:

WTException

wt.lifecycle.LifeCycleException

getLatestIteration

public wt.lifecycle.LifeCycleTemplate getLatestIteration(wt.lifecycle.LifeCycleTemplateMaster master)
                                                  throws WTException,
                                                         wt.lifecycle.LifeCycleException

Given a LifeCycleTemplateMaster, return the latest iteration (LifeCycleTemplate)

Supported API: true

Specified by:

getLatestIteration in interface LifeCycleService

Parameters:

master - the lifecycle master of interest

Returns:

LifeCycleTemplate

Throws:

WTException

wt.lifecycle.LifeCycleException

getLatestIteration

public wt.lifecycle.LifeCycleTemplateReference getLatestIteration(wt.lifecycle.LifeCycleTemplateMasterReference master)
                                                           throws WTException,
                                                                  wt.lifecycle.LifeCycleException

Given a LifeCycleTemplateMasterReference, return the latest iteration (LifeCycleTemplateReference)

Supported API: true

Specified by:

getLatestIteration in interface LifeCycleService

Parameters:

master - the lifecycle template master of interest

Returns:

LifeCycleTemplateReference

Throws:

WTException

wt.lifecycle.LifeCycleException

getPhaseTemplates

public Vector getPhaseTemplates(wt.lifecycle.LifeCycleTemplate template)
                         throws WTException,
                                wt.lifecycle.LifeCycleException

Given a LifeCycleTemplate, return a vector of all the PhaseTemplate objects

Supported API: true

Specified by:

getPhaseTemplates in interface LifeCycleService

Parameters:

template - the lifecycle template to retrieve the phase templates for

Returns:

Vector

Throws:

WTException

wt.lifecycle.LifeCycleException

getCurrentWorkflow

public ObjectReference getCurrentWorkflow(wt.lifecycle.LifeCycleManaged object)
                                   throws WTException,
                                          wt.lifecycle.LifeCycleException

Given a LifeCycleManaged object, return a reference to the current WfProcess. If the LifeCycleManaged object is in the phase, the Phase WF is returned. If the LifeCycleManaged object is at the gate, the Gate WF is returned. If there is no workflow, a null is returned.

Supported API: true

Specified by:

getCurrentWorkflow in interface LifeCycleService

Parameters:

object - the object whoose current workflow should be returned

Returns:

ObjectReference

Throws:

WTException

wt.lifecycle.LifeCycleException

augmentRoles

public wt.lifecycle.Phase augmentRoles(wt.lifecycle.LifeCycleManaged object)
                                throws WTException,
                                       wt.lifecycle.LifeCycleException

Given a LifeCycleManaged object, the current State of the Object and the RoleHolder (the phase object), change the role participants to reflect those in the RoleHolder2

Supported API: true

Specified by:

augmentRoles in interface LifeCycleService

Parameters:

object - The LifeCycleManaged object that the role/participant mapping is being added to

Returns:

Phase

Throws:

WTException

wt.lifecycle.LifeCycleException

getSuccessorState

public State getSuccessorState(wt.lifecycle.LifeCycleManaged lcmObject)
                        throws WTException,
                               wt.lifecycle.LifeCycleException

This operation determines the current state of the object and returns the successor state for the object. That is, the state the object will be in when promoted.

Supported API: true

Specified by:

getSuccessorState in interface LifeCycleService

Parameters:

lcmObject - The Life Cycle Managed object used to get the next state.

Returns:

State

Throws:

WTException

wt.lifecycle.LifeCycleException

getPredecessorState

public State getPredecessorState(wt.lifecycle.LifeCycleManaged lcmObject)
                          throws WTException,
                                 wt.lifecycle.LifeCycleException

This operation determines the current state of the object and returns the predecessor state for the object. That is, the state the object will be in when demoted

Supported API: true

Specified by:

getPredecessorState in interface LifeCycleService

Parameters:

lcmObject - The Life Cycle Managed object used to get the next state.

Returns:

State

Throws:

WTException

wt.lifecycle.LifeCycleException

augmentRoles

public void augmentRoles(wt.team.Team team)
                  throws WTException,
                         wt.lifecycle.LifeCycleException

Given a team, rebuild all the ad hoc acls for objects associated with the team.

Supported API: true

Specified by:

augmentRoles in interface LifeCycleService

Parameters:

team - The team being updated.

Throws:

WTException

wt.lifecycle.LifeCycleException

getLifeCycleTemplate

public wt.lifecycle.LifeCycleTemplate getLifeCycleTemplate(String aTemplateName,
                                                           WTContainerRef context)
                                                    throws wt.lifecycle.LifeCycleException,
                                                           WTException

Given a String representation of the LifeCycleTemplate name and a WTContainerRef, answer the LifeCycleTemplate. If no template is found, return null/code>.

Supported API: true

Specified by:

getLifeCycleTemplate in interface LifeCycleService

Parameters:

aTemplateName - the name of the LifeCycleTemplate to retrieve

context - the container to search for the lifecycle template

Returns:

LifeCycleTemplate

Throws:

wt.lifecycle.LifeCycleException

WTException

getLifeCycleTemplateReference

public wt.lifecycle.LifeCycleTemplateReference getLifeCycleTemplateReference(String aName,
                                                                             WTContainerRef context)
                                                                      throws wt.lifecycle.LifeCycleException,
                                                                             WTException

Given a String representation of the LifeCycleTemplater name and a WTContainerRef, find the latest iteration or working copy of the LifeCycleTemplate. Return a LifeCycleTemplateReference.

Supported API: true

Specified by:

getLifeCycleTemplateReference in interface LifeCycleService

Parameters:

aName - the name of the LifeCycleTemplate to retrieve

context - the container to search for the lifecycle template master

Returns:

LifeCycleTemplateReference

Throws:

wt.lifecycle.LifeCycleException

WTException

findAllTemplates

public Vector findAllTemplates(WTContainerRef context)
                        throws WTException,
                               wt.lifecycle.LifeCycleException

Answer a vector of all life cycle templates for the WTContainerRef passed. The latest iteration of each life cycle template will be returned. In this particular context, the definition of 'latest iteration' is either the current user's working copy, if one exists, or the latest iteration in the vault.

Supported API: true

Specified by:

findAllTemplates in interface LifeCycleService

Parameters:

context - the container to search for lifecycle templates

Returns:

Vector

Throws:

WTException

wt.lifecycle.LifeCycleException

getLifeCycleTemplateMaster

public wt.lifecycle.LifeCycleTemplateMaster getLifeCycleTemplateMaster(String aMasterName,
                                                                       WTContainerRef context)
                                                                throws wt.lifecycle.LifeCycleException,
                                                                       WTException

Given a String representation of the LifeCycleTemplateMaster name and a WTContainerRef, answer the LifeCycleTemplateMasterReference

Supported API: true

Specified by:

getLifeCycleTemplateMaster in interface LifeCycleService

Parameters:

aMasterName - the name of the LifeCycleTemplate to retrieve

context - the container to search for the lifecycle template master

Returns:

LifeCycleTemplateMaster

Throws:

wt.lifecycle.LifeCycleException

WTException

importTemplates

public void importTemplates(String fileName,
                            WTContainerRef context)
                     throws WTException,
                            wt.lifecycle.LifeCycleException

Given a WTContainerRef and a jar or zip file that contains a version of any number of LifeCycleTemplate objects, import these objects.

Supported API: true

Specified by:

importTemplates in interface LifeCycleService

Parameters:

fileName - the name of the jar or zip file that the xml version of the templates should be imported from

context - the container to import the lifecycle template into

Throws:

WTException

wt.lifecycle.LifeCycleException

reassign

public wt.lifecycle.LifeCycleManaged reassign(wt.lifecycle.LifeCycleManaged object,
                                              wt.lifecycle.LifeCycleTemplateReference lctRef,
                                              WTContainerRef context)
                                       throws WTException,
                                              wt.lifecycle.LifeCycleException

Reassign a life cycle managed object to a new life cycle in a certain WTContainerRef.

Supported API: true

Specified by:

reassign in interface LifeCycleService

Parameters:

object - the LifeCycleManaged object that should be assigned to a new life cycle

lctRef - a reference to a LifeCycleTemplate, the LifeCycleTemplate that the object should be reassigned to

context - the container where the objects associated workflow processes will be created

Returns:

LifeCycleManaged

Throws:

WTException

wt.lifecycle.LifeCycleException

saveLifeCycleTemplate

public TransactionResult saveLifeCycleTemplate(TransactionContainer aTran,
                                               WTContainerRef context)
                                        throws WTException,
                                               wt.lifecycle.LifeCycleException

Store or update a LifeCycleTemplate. This method accepts and processes a batch container of persistence assertions. If a WTContainerRef is passed, and it is different that that of this templates master; then a new master is created in the passed WTContainer, and this template becomes the first iteration.

Supported API: true

Specified by:

saveLifeCycleTemplate in interface LifeCycleService

Parameters:

aTran - a TransactionContainer that contains a set of LifeCycleTemplate, PhaseTemplate, AdHocAclSpec, Criterion and Transition assertions that need to be applied against one or more LifeCycleTemplate objects

context - the container the lifecycle template is being saved in

Returns:

TransactionResult

Throws:

WTException

wt.lifecycle.LifeCycleException

findCandidateMasterReferences

public Vector findCandidateMasterReferences(Class targetClass,
                                            WTContainerRef context)
                                     throws WTException,
                                            wt.lifecycle.LifeCycleException

Answer a vector of life cycle template references valid for the target class in the container.

Supported API: true

Specified by:

findCandidateMasterReferences in interface LifeCycleService

Parameters:

targetClass - the class used as search criteria in the retrieval of canidate LifeCycleTemplates

context - the container to search for lifecycle template masters

Returns:

Vector

Throws:

WTException

wt.lifecycle.LifeCycleException

findAllTemplateMasters

public QueryResult findAllTemplateMasters(WTContainerRef context)
                                   throws WTException,
                                          wt.lifecycle.LifeCycleException

Answer a vector of all life cycle template masters for the WTContainerRef passed. The latest iteration of each life cycle template will be returned. In this particular context, the definition of 'latest iteration' is either the current user's working copy, if one exists, or the latest iteration in the vault.

Supported API: true

Specified by:

findAllTemplateMasters in interface LifeCycleService

Parameters:

context - the container to search for lifecycle templates

Returns:

QueryResult

Throws:

WTException

wt.lifecycle.LifeCycleException

setRouting

public void setRouting(wt.lifecycle.LifeCycleTemplate aTemplate,
                       boolean routing)
                throws WTException,
                       wt.lifecycle.LifeCycleException

Set/reset the rouing attribute on the Life Cycle Template Master. This attribute denotes whether or not the template master can be used to route other objects

Supported API: true

Specified by:

setRouting in interface LifeCycleService

Parameters:

aTemplate - the template to set the routing statis on

routing - sets the routing flag to true or false

Throws:

WTException

wt.lifecycle.LifeCycleException

setRouting

public void setRouting(wt.lifecycle.LifeCycleTemplateMaster aMaster,
                       boolean routing)
                throws WTException,
                       wt.lifecycle.LifeCycleException

Set/reset the routing attribute of the Life Cycle Template Master. This attribute denotes whether or not the template master can be used to route other objects

Supported API: true

Specified by:

setRouting in interface LifeCycleService

Parameters:

aMaster - the lifecycle template master to set the routing status on

routing - sets the routing flag to true or false

Throws:

WTException

wt.lifecycle.LifeCycleException

findRoutingTemplates

public Vector findRoutingTemplates(WTContainerRef context)
                            throws WTException,
                                   wt.lifecycle.LifeCycleException

Return an Enumeration of all lifecycle templates for the WTContainerRef passed. The latest iteration of each life cycle template will be returned. In this particular context, the definition of 'latest iteration' is either the current user's working copy, if one exists, or the latest iteration in the vault.

Supported API: true

Specified by:

findRoutingTemplates in interface LifeCycleService

Parameters:

context - the container to search for lifecycle templates

Returns:

Vector

Throws:

WTException

wt.lifecycle.LifeCycleException

findAllTemplates

public Vector findAllTemplates(WTContainerRef context,
                               boolean routingOnly,
                               boolean keepFiltered)
                        throws WTException,
                               wt.lifecycle.LifeCycleException

Answer a vector of all life cycle templates for the WTContainerRef passed. If routingOnly is true, returns only those templates whose routing attribute is true. If keepFiltered is true, returns templates that have been hidden in the container context, otherwise only those templates that are visible in the container context are returned. The latest iteration of each life cycle template will be returned. In this particular context, the definition of 'latest iteration' is either the current user's working copy, if one exists, or the latest iteration in the vault.

Supported API: true

Specified by:

findAllTemplates in interface LifeCycleService

Parameters:

context - the container to search for lifecycle templates

routingOnly - specifies whether only the lifecycle templates marked as routing should be returned or it all enabled lifecycle templates should be returned

keepFiltered - Indicates whether or not filtered templates are to be returned. If true, return all templates, otherwise return only those templates that are visible in the container context.

Returns:

Vector

Throws:

WTException

wt.lifecycle.LifeCycleException

findAllTemplates

public Vector findAllTemplates(WTContainerRef context,
                               boolean routingOnly)
                        throws WTException,
                               wt.lifecycle.LifeCycleException

Answer a vector of all life cycle templates for the WTContainerRef passed. If routingOnly is true, returns only those templates whose routing attribute is true. The latest iteration of each life cycle template will be returned. In this particular context, the definition of 'latest iteration' is either the current user's working copy, if one exists, or the latest iteration in the vault. This API will call findAllTemplates(WTContainerRef context, boolean routingOnly, boolean keepFiltered) with a value of false for the keepFiltered argument.

Supported API: true

Specified by:

findAllTemplates in interface LifeCycleService

Parameters:

context - the container to search for lifecycle templates

routingOnly - specifies whether only the lifecycle templates marked as routing should be returned or it all enabled lifecycle templates should be returned

Returns:

Vector

Throws:

WTException

wt.lifecycle.LifeCycleException

copyTemplate

public wt.lifecycle.LifeCycleTemplate copyTemplate(wt.lifecycle.LifeCycleTemplate lifeCycleTemplate,
                                                   String copyName,
                                                   String folderLocation,
                                                   WTContainerRef context)
                                            throws WTException,
                                                   wt.lifecycle.LifeCycleException

Produces a copy of the LifeCycleTemplate object and persists it with the name passed as argument. If the name argument is "null", the name of the copied LifeCycleTemplate object is prefixed with 'copy of'. If the folder location is not specified, the object will be persisted in the orginal LifeCycleTemplates's folder location. If the context is null, the current container will be used. Note: The 'Copy Of' prefix is pulled from a Resource Bundle for localization purposes.

Supported API: true

Specified by:

copyTemplate in interface LifeCycleService

Parameters:

lifeCycleTemplate - the LifeCycleTemplate object that should be copied

copyName - the name of the new LifeCycleTemplate

folderLocation - the folder location of the new LifeCycleTemplate

context - the container where the copy should be stored

Returns:

LifeCycleTemplate

Throws:

WTException

wt.lifecycle.LifeCycleException

navigate

public Set navigate(wt.lifecycle.LifeCycleManaged lcmObject,
                    Transition name,
                    boolean successor)
             throws WTException

Navigate the transition of the current state of the LifeCycleManagedObject using the passed transition. Return a set of States

Supported API: true

Specified by:

navigate in interface LifeCycleService

Parameters:

lcmObject - LifeCycleManagedObject

name - Transition to navigate

successor - get Successors

Returns:

Set

Throws:

WTException

reassign

public WTList reassign(WTList list,
                       wt.lifecycle.LifeCycleTemplateReference lctRef,
                       WTContainerRef context,
                       boolean preserveState)
                throws WTException,
                       wt.lifecycle.LifeCycleException

Reassign all objects in a WTList to a lifecycle.

Supported API: true

Specified by:

reassign in interface LifeCycleService

Parameters:

list - the WtList of LifeCycleManaged objects that should be assigned to a new life cycle

lctRef - a reference to a LifeCycleTemplate, the LifeCycleTemplate that the object should be reassigned to

context - The container the object resides in. This may be null.

preserveState - If this is set to true, the existing state of objects will be preserved if the state is contained in the lifecycle template. Otherwise, the object will be set to the initial state of the lifecycle.

Returns:

WTList

Throws:

WTException

wt.lifecycle.LifeCycleException

reassign

public WTList reassign(WTList list,
                       wt.lifecycle.LifeCycleTemplateReference lctRef,
                       WTContainerRef context,
                       State state)
                throws WTException,
                       wt.lifecycle.LifeCycleException

Reassign the life cycle managed objects in a WTList to a new life cycle in a certain WTContainerRef.

Supported API: true

Specified by:

reassign in interface LifeCycleService

Parameters:

list - the WTList of LifeCycleManaged objects that should be assigned to a new life cycle

lctRef - a reference to a LifeCycleTemplate, the LifeCycleTemplate that the object should be reassigned to

context - The container which the object resides in.

state - The state the objects in the lifecycle should be assigned when reassigned to the lifecycle.

Returns:

WTList

Throws:

WTException

wt.lifecycle.LifeCycleException

setLifeCycleState

public WTList setLifeCycleState(WTList list,
                                State state,
                                boolean terminAssocRunningProcesses)
                         throws WTException,
                                wt.lifecycle.LifeCycleException

Set the state of the Life Cycle Managed objects and provide the option to terminate the associated workflows. If null is passed as the WfState, all processes are terminated.

Supported API: true

Specified by:

setLifeCycleState in interface LifeCycleService

Parameters:

list - The LifeCycleManaged objects whose state should be updated

state - The state to set the LifeCycleManaged object to.

terminAssocRunningProcesses - a flag that determines whether or not to terminate the wf processes associated with this phase that are OPEN_RUNNING

Returns:

WTList

Throws:

WTException

wt.lifecycle.LifeCycleException

navigate

public Set navigate(wt.lifecycle.LifeCycleTemplateReference lctRef,
                    State state,
                    Transition transition,
                    boolean successor)
             throws WTException

Navigate the transition from the passed state using the passed transition. Return a set of States

Supported API: true

Specified by:

navigate in interface LifeCycleService

Parameters:

lctRef - reference to the LifeCycleTemplate.

state - State of the LifeCycleTemplate.

transition - Transtion to navigate

successor - get Successors

Returns:

Set

Throws:

WTException

findSetStateCandidates

public WTKeyedMap findSetStateCandidates(WTCollection lcms)
                                  throws WTException

Determines the allowable states the session principal can set the objects in the collection to. The return type is a map with the lifecycle managed objects assigned as keys and the value is a HashSet containing the allowable states the user can assign to the object.

Supported API: true

Specified by:

findSetStateCandidates in interface LifeCycleService

Parameters:

lcms - a collection of lifecycle managed objects

Returns:

WTKeyedMap

Throws:

WTException

navigate

public Map navigate(WTCollection c,
                    Transition transition,
                    boolean successor)
             throws WTException,
                    wt.lifecycle.LifeCycleException

Navigate the PhaseSuccessors for the Transition for all objects in the WTCollection. Calls single-object navigate. Use multi-object instead.

Supported API: true

Specified by:

navigate in interface LifeCycleService

Parameters:

c - a collection of lifecycle managed objects

transition - the transition to navigate

successor - boolean value to indicate if the navigate should be to a successor state

Returns:

Map

Throws:

WTException

wt.lifecycle.LifeCycleException

setLifeCycleState

public wt.lifecycle.LifeCycleManaged setLifeCycleState(wt.lifecycle.LifeCycleManaged object,
                                                       State state,
                                                       boolean terminAssocRunningProcesses,
                                                       Timestamp timestamp)
                                                throws WTException,
                                                       wt.lifecycle.LifeCycleException

Set the state of the Life Cycle Managed object.

Supported API: true

Specified by:

setLifeCycleState in interface LifeCycleService

Parameters:

object - The LifeCycleManaged object whose state should be updated

state - The state to set the LifeCycleManaged object to.

terminAssocRunningProcesses - a flag that determines whether or not to terminate the wf processes associated with this phase that are OPEN_RUNNING

timestamp - An optional parameter that allows specification of the created and modified timestamps for the history objects.

Returns:

LifeCycleManaged

Throws:

WTException

wt.lifecycle.LifeCycleException

navigate

public Map navigate(WTKeyedMap c,
                    Transition transition,
                    boolean successor)
             throws WTException,
                    wt.lifecycle.LifeCycleException

Navigates the PhaseTemplate->PhaseSuccession using param transition. Returns a WTKeyedMap where the keys are the keys passed in param c and the values WTKeyedHashMap where the keys are PhaseTemplates and the values are sets of inflated PhaseSuccessions.

Usage:

WTKeyedHashMap map=new WTKeyedHashMap(); Set set = new Set[) state=State.toState("DESIGN") set.add(state) map.put(lifecycleManagedObject, set) WTKeyedHashSet returnMap = LifeCycleHelper.service.navigate(map, Transition.toTransition("SET_STATE"), true)

Supported API: true

Specified by:

navigate in interface LifeCycleService

Parameters:

c - A WTKeyedMap that contains as its keys LifecycleManagedObject or LifeCycleTemplates and the values are a set of states to navigate.

transition - the name of the transition to navigate

successor - specifies whether or not to return the successor state or the predessor.

Returns:

Map

Throws:

WTException

wt.lifecycle.LifeCycleException

getSeriesSelectors

public WTKeyedMap getSeriesSelectors(WTSet lcms)
                              throws WTException

Given a WTSet of objects, returns a WTKeyedMap whose keys are those elements of the argument set that are LifeCycleManaged and whose values are the keys' corresponding SeriesRangeSelector values for their current states, if applicable. If a key's current state does not have a SeriesRangeSelector, it is mapped to null.

Supported API: true

Specified by:

getSeriesSelectors in interface LifeCycleService

Parameters:

lcms - set of objects. Those that are not wt.lifecycle.LifeCycleManaged are ignored (and are excluded from the result).

Returns:

WTKeyedMap

Throws:

WTException

saveLifeCycleTemplate

public TransactionResult saveLifeCycleTemplate(TransactionContainer aTran,
                                               WTContainerRef context,
                                               boolean bypassDefaultTransitions)
                                        throws WTException,
                                               wt.lifecycle.LifeCycleException

Store or update a LifeCycleTemplate. This method accepts and processes a batch container of persistence assertions. If a WTContainerRef is passed, and it is different that that of this templates master; then a new master is created in the passed WTContainer, and this template becomes the first iteration.

Supported API: true

Specified by:

saveLifeCycleTemplate in interface LifeCycleService

Parameters:

aTran - a TransactionContainer that contains a set of LifeCycleTemplate, PhaseTemplate, AdHocAclSpec, Criterion and Transition assertions and transitions that need to be applied against one or more LifeCycleTemplate objects

context - the container the template is being saved in

bypassDefaultTransitions - specifies whether or not the default transitions should be created. if set to true, the transitions must be specified in the transaction container

Returns:

TransactionResult

Throws:

WTException

wt.lifecycle.LifeCycleException

setLifeCycleState

public WTList setLifeCycleState(WTList list,
                                Map stateMap,
                                WTList terminateList)
                         throws WTException,
                                wt.lifecycle.LifeCycleException

Set the state of the Life Cycle Managed objects in the WTList list. Set state values are in the Map stateMap where the key is the LCMO in list and the value is a State. Also this method will terminate any workflow processes accociated in WTList terminateList.

Supported API: true

Specified by:

setLifeCycleState in interface LifeCycleService

Parameters:

list - The LifeCycleManaged objects whose state should be updated

stateMap - The state to set the LifeCycleManaged object to. Key=LCMO, value State

terminateList - The LifeCycleManaged objects whose workflow processes should be terminated.

Returns:

WTList

Throws:

WTException

wt.lifecycle.LifeCycleException

findCandidateTemplates

public Vector findCandidateTemplates(Class targetClass,
                                     WTContainerRef containerRef)
                              throws WTException,
                                     wt.lifecycle.LifeCycleException

Answer a vector of enabled life cycle template references valid for the life cycle managed object and container context.

Supported API: true

Specified by:

findCandidateTemplates in interface LifeCycleService

Parameters:

targetClass - the LifeCycleManaged class used as search criteria in the retrieval of canidate LifeCycleTemplates

containerRef -

Returns:

Vector

Throws:

WTException

wt.lifecycle.LifeCycleException

reassign

public wt.lifecycle.LifeCycleManaged reassign(wt.lifecycle.LifeCycleManaged object,
                                              wt.lifecycle.LifeCycleTemplateReference lctRef,
                                              WTContainerRef context,
                                              String comments)
                                       throws WTException,
                                              wt.lifecycle.LifeCycleException

Reassign a life cycle managed object to a new life cycle in a certain WTContainerRef.

Supported API: true

Specified by:

reassign in interface LifeCycleService

Parameters:

object - the LifeCycleManaged object that should be assigned to a new life cycle

lctRef - a reference to a LifeCycleTemplate, the LifeCycleTemplate that the object should be reassigned to

context - the container where the objects associated workflow processes will be created

comments - Notes or comments for the lifecycle operation. Can be null.

Returns:

LifeCycleManaged

Throws:

WTException

wt.lifecycle.LifeCycleException

reassign

public WTList reassign(WTList list,
                       wt.lifecycle.LifeCycleTemplateReference lctRef,
                       WTContainerRef context,
                       State state,
                       String comments)
                throws WTException,
                       wt.lifecycle.LifeCycleException

Reassign the life cycle managed objects in a WTList to a new life cycle in a certain WTContainerRef.

Supported API: true

Specified by:

reassign in interface LifeCycleService

Parameters:

list - the WTList of LifeCycleManaged objects that should be assigned to a new life cycle

lctRef - a reference to a LifeCycleTemplate, the LifeCycleTemplate that the object should be reassigned to

context - The container which the object resides in.

state - The state the objects in the lifecycle should be assigned when reassigned to the lifecycle.

comments - Notes or comments for lifecycle operation. Can be null.

Returns:

WTList

Throws:

WTException

wt.lifecycle.LifeCycleException

reassign

public WTList reassign(WTList list,
                       wt.lifecycle.LifeCycleTemplateReference lctRef,
                       WTContainerRef context,
                       boolean preserveState,
                       String comments)
                throws WTException,
                       wt.lifecycle.LifeCycleException

Reassign all objects in a WTList to a lifecycle.

Supported API: true

Specified by:

reassign in interface LifeCycleService

Parameters:

list - the WtList of LifeCycleManaged objects that should be assigned to a new life cycle

lctRef - a reference to a LifeCycleTemplate, the LifeCycleTemplate that the object should be reassigned to

context - The container the object resides in. This may be null.

preserveState - If this is set to true, the existing state of objects will be preserved if the state is contained in the lifecycle template. Otherwise, the object will be set to the initial state of the lifecycle.

comments - Notes or comments for lifecycle operation. Can be null.

Returns:

WTList

Throws:

WTException

wt.lifecycle.LifeCycleException