wt.workflow.definer
Class WfDefinerServiceFwd

java.lang.Object
  wt.workflow.definer.WfDefinerServiceFwd

All Implemented Interfaces:

RemoteAccess, Serializable, WfDefinerService

public class WfDefinerServiceFwd

extends Object

implements RemoteAccess, WfDefinerService, Serializable

The WfDefinerService is an interface containing the methods used both in the client and server to define workflow definitions.

Supported API: false

Extendable: false

See Also:

Serialized Form

Field Summary

private static String	CLASSNAME
private static String	FC_RESOURCE
(package private) static boolean	SERVER

Fields inherited from interface wt.method.RemoteAccess

versionID

Constructor Summary

WfDefinerServiceFwd()

Method Summary

WfConnectorTemplate	addConnectorTemplate(WfContainerTemplate def, WfConnectorFunction function, WfConnectorType type) Adds a connector template to a process template.
NodeTemplateLink	addLinkTemplate(WfNodeTemplate source, WfNodeTemplate destination) Creates a link between two definition nodes.
WfTemplateObject	addStepTemplate(WfContainerTemplate process_def, WfTemplateObject step) Adds an activity step to an existing process template.
boolean	canCreateWorkflowTemplate(WTUser user, WTContainerRef context_ref) Determines if a given user is entitled to create Workflow Templates.
WfExpression	compileExpression(WfExpression expression) Compiles and, if compilation is successful, loads expression.
WfExpression	compileExpression(WfExpression expression, ProcessDataInfo signature) Compiles the expression passed as argument with the given signature.
WfTemplateObject	copyTemplateObject(WfTemplateObject template, String copyName) Produces a copy of the template object and persists it with the name passed as argument.
WfTemplateObject	copyTemplateObject(WfTemplateObject template, String copyName, WTContainerRef context_ref) Produces a copy of the template object and persists it with the name passed as argument.
WfBlockTemplate	createBlockTemplate(String name, Vector node_set) Takes a set of nodes and builds a block out of the nodes.
WfExpression	createRouterExpression(WfNodeTemplate template) Deprecated. Use instead PersistenceHelper.manager.save (WfExpression.newWfExpression (WfNodeTemplate, WfExpression.ROUTER_EXPRESSION))
WfExpression	createTransitionExpression(WfTemplateObject template, Object transition) Deprecated. Use instead PersistenceHelper.manager.save (WfExpression.newWfExpression (node, transition))
void	deleteExpression(WfTemplateObject template, Object event) Supported API: false
void	deleteProcessTemplate(WfProcessTemplate process_def) Deletes process template passed as argument.
void	demoteBlockTemplate(WfBlockTemplate block_template) Removes a block and place its constituents directly into the host process.
Object	executeExpression(WfExpression expression, Object[] values) Evaluates the expression for the given array of values.
void	exportTemplates(Vector wfProcessTemplateVector, String fileName, boolean appendFlag) Populate a file with the csv equivalent of the Workflow Template objects Supported API: false
Vector	findExportImportFileNames() Retrieve a vector of file names from the Import/Export directory Supported API: false
Vector	getAccessibleNodes(WfContainerTemplate template, WfNodeTemplate start_template) Returns all nodes (activities and connectors) that can be reached from the node passed as argument.
Enumeration	getActivityTemplates(WfTemplateCategory category) Returns all activity templates of the category passed as argument.
Enumeration	getAllExpressions(WfNodeTemplate template) Returns all expressions associated with template (transition and router).
Enumeration	getAllTemplates() Returns an enumeration containing all process templates.
QueryResult	getAllTemplates(WTContainerRef context_ref) Returns an enumeration containing all process templates for the passes WTContainerRef.
WfExpression	getBlockExpression(WfBlockTemplate block_template) Returns the expression associated to the block template passed as parameter.
Enumeration	getConnectorTemplates(WfContainerTemplate process_def) Returns all connector templates associated with a given process template.
Enumeration	getDirectlyUsedByTemplates(WfProcessTemplate template) Returns all process templates that directly uses the process template passed as argument.
Enumeration	getDirectlyUsedTemplates(WfProcessTemplate template) Returns all process templates that are directly used in the process template passed as argument.
Enumeration	getEnabledTemplates() Returns an enumeration containing all enabled process templates.
QueryResult	getEnabledTemplates(WTContainerRef context_ref) Returns an enumeration containing all enabled process templates in the passed WTContainer.
Enumeration	getEndConnectorTemplates(WfContainerTemplate process_def) Returns an enumeration containing the end connector templates associated with the process template.
WfProcessTemplate	getLatestIteration(WfProcessTemplateMaster master) Given a WfProcessTemplateMaster, return the latest iteration (WfProcessTemplate) Supported API: false
WfProcessTemplateReference	getLatestIteration(WfProcessTemplateMasterReference master) Given a WfProcessTemplateMasterReference, return the latest iteration (WfProcessTemplateReference) Supported API: false
Enumeration	getLinkTemplates(WfContainerTemplate process_def) Returns an enumeration (of type NodeTemplateLink) containing all link templates defined for the process.
Enumeration	getLinkTemplates(WfNode source, WfNode destination) Return an enumeration (of type NodeTemplateLink) containing all link templates between two node templates.
private static Manager	getManager()
WfProcessDefinition	getProcessDefinition(String process_identity) Returns a process definition given its identity.
WfProcessDefinition	getProcessDefinition(String process_identity, WTContainerRef context_ref) Returns a process definition given its identity.
WfProcessDefinition	getProcessDefinition(String process_identity, WTContainerRef context_ref, boolean hierarchical_lookup) Returns a process definition given its identity, container reference and whether or not the process definition should be looked up hierarchically or not.
Vector	getProcessRoles(WfContainerTemplate process_def) Returns a Vector of Role objects used by the process/block template passed as argument.
ProcessStepTemplateLink	getProcessStepTemplateLink(WfContainerTemplate process_def, WfTemplateObject step) Deprecated. use getProcessTemplateLink (WfTemplateObject) instead
ProcessStepTemplateLink	getProcessStepTemplateLink(WfTemplateObject step) Returns the link between a node template and the containing process template.
WfExpression	getRobotExpression(WfRobotActivityTemplate template) Returns router expression associated with template if it exists.
WfExpression	getRouterExpression(WfNodeTemplate template) Returns router expression associated with template if it exists.
WfConnectorTemplate	getStartConnectorTemplate(WfContainerTemplate process_def) Returns the start connector template associated with the process template.
Enumeration	getStepTemplates(WfContainerTemplate process_def, WfTemplateObjectType type) Returns an enumeration with existing definition objects that are contained in the process template passed as argument.
WfExpression	getSynchExpression(WfRobotActivityTemplate template) Returns the fileter expression associated with template if it exists.
Enumeration	getTemplateObjects(WfTemplateObjectType type, WfTemplateCategory category) Returns an enumeration containing existing definition objects of the type and category passed as arguments.
WfExpression	getTransitionExpression(WfNodeTemplate template, Object transition) Returns the expression associated with a given process or activity template object and transiiton.
Enumeration	getUsedByTemplates(WfProcessTemplate template) Returns all process templates that uses the process template passed as argument.
Enumeration	getUsedTemplates(WfProcessTemplate template) Returns all process templates that are used in the process template passed as argument.
void	importTemplates(String fileName) Given a file that contains a csv version of any number of Wf Process Template objects, import these objects Supported API: false
boolean	isTemplateInUse(ObjectReference process_template_ref) Returns true if template is in use; false otherwise.
int	removeLinkTemplate(WfNodeTemplate source, WfNodeTemplate destination) Deletes all links between two step templates in a process process.
WfTemplateObject	removeStepTemplate(WfTemplateObject step_def) Removes step template from its containing process.
TransactionResult	saveProcessTemplate(TransactionContainer aTran) Store or update a WfProcessTemplate.
TransactionResult	saveProcessTemplate(TransactionContainer aTran, WTContainerRef context_ref) Store or update a WfProcessTemplate.
WfProcessTemplate	saveProcessTemplate(WfProcessTemplate process_def) Saves a process template in the database.
WfProcessTemplate	saveProcessTemplate(WfProcessTemplate process_def, WTContainerRef context_ref) Saves a process template in the database.
void	setEnabled(WfProcessDefinition process, boolean enabled) Enables or disables the process template master.
void	setIgnoreDelete(Object obj) Supported API: false
WfNodeTemplate	setParentTemplate(WfNodeTemplate node_template, WfContainerTemplate container_template) Sets the parent template of a node template.
Vector	verifyTemplate(WfProcessTemplate process_def, boolean recurse) Returns a report of defects in the process template.
Vector	whereUsed(ProjectReference project, boolean returnOnlyFirstOccurence) Returns a vector of references to any engine objects that use a particular Project object.
Vector	whereUsed(TeamReference teamRef, boolean returnOnlyFirstOccurence) Returns a vector of references to any engine objects that use a particular Team object.
Vector	whereUsed(TeamTemplateReference teamTemplateRef, boolean returnOnlyFirstOccurence) Returns a vector of references to any engine objects that use a particular Team Template object.

Methods inherited from class java.lang.Object

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

Field Detail

SERVER

static final boolean SERVER

FC_RESOURCE

private static final String FC_RESOURCE

See Also:

Constant Field Values

CLASSNAME

private static final String CLASSNAME

Constructor Detail

WfDefinerServiceFwd

public WfDefinerServiceFwd()

Method Detail

getManager

private static Manager getManager()
                           throws WTException

Returns:

Manager

Throws:

WTException

addConnectorTemplate

public WfConnectorTemplate addConnectorTemplate(WfContainerTemplate def,
                                                WfConnectorFunction function,
                                                WfConnectorType type)
                                         throws WTException

Adds a connector template to a process template.

Supported API: false

Specified by:

addConnectorTemplate in interface WfDefinerService

Parameters:

def -

function -

type -

Returns:

WfConnectorTemplate

Throws:

WTException

addLinkTemplate

public NodeTemplateLink addLinkTemplate(WfNodeTemplate source,
                                        WfNodeTemplate destination)
                                 throws WTException

Creates a link between two definition nodes. Additional link information can be set after the link is created. For example, the event-action map for activity-activity links or the conditional code for conditional router links. Throws an InvalidDestination exception when a WfRouterTemplate is passed as the destination node of a connector or router template.

Supported API: false

Specified by:

addLinkTemplate in interface WfDefinerService

Parameters:

source -

destination -

Returns:

NodeTemplateLink

Throws:

WTException

addStepTemplate

public WfTemplateObject addStepTemplate(WfContainerTemplate process_def,
                                        WfTemplateObject step)
                                 throws WTException

Adds an activity step to an existing process template. The activity step may be any definition object, that is, another process template, a robot activity template or an assigned activity template.

The method returns the step template (which is modified to hold a reference to the parent and another to the link). Use 'getProcessStepTemplateLink' to get the link.

Supported API: false

Specified by:

addStepTemplate in interface WfDefinerService

Parameters:

process_def -

step -

Returns:

WfTemplateObject

Throws:

WTException

canCreateWorkflowTemplate

public boolean canCreateWorkflowTemplate(WTUser user,
                                         WTContainerRef context_ref)
                                  throws WTException

Determines if a given user is entitled to create Workflow Templates. Returns 'true' if the user is an Org Administrator or an Exhange Administrator.

Supported API: false

Specified by:

canCreateWorkflowTemplate in interface WfDefinerService

Parameters:

user -

context_ref -

Returns:

boolean

Throws:

WTException

compileExpression

public WfExpression compileExpression(WfExpression expression)
                               throws WTException

Compiles and, if compilation is successful, loads expression. In case of failure, one may get the message quirying directly the expression.

Supported API: false

Specified by:

compileExpression in interface WfDefinerService

Parameters:

expression -

Returns:

WfExpression

Throws:

WTException

See Also:

WfExpression

compileExpression

public WfExpression compileExpression(WfExpression expression,
                                      ProcessDataInfo signature)
                               throws WTException

Compiles the expression passed as argument with the given signature. If compilation is successful, loads expression. In case of failure, one may get the message quirying directly the expression.

Supported API: false

Specified by:

compileExpression in interface WfDefinerService

Parameters:

expression -

signature -

Returns:

WfExpression

Throws:

WTException

See Also:

WfExpression, ProcessDataInfo

copyTemplateObject

public WfTemplateObject copyTemplateObject(WfTemplateObject template,
                                           String copyName)
                                    throws WTException

Produces a copy of the template object and persists it with the name passed as argument. If the template is a process template all contained obejcts (steps, connectors, links and expressions) are copied as well. If name is "null" the name of the copied template is taken to be the name of the copied template object for activity templates; for process templates a prefix 'copy of' is used.

Supported API: false

Specified by:

copyTemplateObject in interface WfDefinerService

Parameters:

template -

copyName -

Returns:

WfTemplateObject

Throws:

WTException

copyTemplateObject

public WfTemplateObject copyTemplateObject(WfTemplateObject template,
                                           String copyName,
                                           WTContainerRef context_ref)
                                    throws WTException

Produces a copy of the template object and persists it with the name passed as argument. If the template is a process template all contained obejcts (steps, connectors, links and expressions) are copied as well. If name is "null" the name of the copied template is taken to be the name of the copied template object for activity templates; for process templates a prefix 'copy of' is used.

Supported API: false

Specified by:

copyTemplateObject in interface WfDefinerService

Parameters:

template -

copyName -

context_ref -

Returns:

WfTemplateObject

Throws:

WTException

createBlockTemplate

public WfBlockTemplate createBlockTemplate(String name,
                                           Vector node_set)
                                    throws WTException

Takes a set of nodes and builds a block out of the nodes. The desired block name and the set of nodes are passed as argument. The method assumes that node_set elements are WfNode and that there is an 'initial' node and a 'final' node, such that:

• These two nodes are the only ones linked to nodes outside node_set.
• The initial node is the destination of a link such that the source is outside the set of nodes.
• The final node is the source of a link such that the destination is outside the set of nodes.
• The initial and final nodes have each one of them has exactly one link outside the set of nodes.

Failure to meet these requirements causes an exception to be thrown. All links joining node_set nodes are included in the block. The block has no associated expression.

Supported API: false

Specified by:

createBlockTemplate in interface WfDefinerService

Parameters:

name -

node_set -

Returns:

WfBlockTemplate

Throws:

WTException

createRouterExpression

public WfExpression createRouterExpression(WfNodeTemplate template)
                                    throws WTException

Deprecated. Use instead PersistenceHelper.manager.save (WfExpression.newWfExpression (WfNodeTemplate, WfExpression.ROUTER_EXPRESSION))

Creates an empty expression associated with a given conditional router template. Throws an ExpressionAlreadyExists exception if there is already an expression for the for the router template passed as argument.

Supported API: false

Specified by:

createRouterExpression in interface WfDefinerService

Parameters:

template -

Returns:

WfExpression

Throws:

WTException

createTransitionExpression

public WfExpression createTransitionExpression(WfTemplateObject template,
                                               Object transition)
                                        throws WTException

Deprecated. Use instead PersistenceHelper.manager.save (WfExpression.newWfExpression (node, transition))

Creates an empty expression associated with a given process or activity template object and transition. If there is already an expression for the template/transition passed as argument then this expression is returned.

Supported API: false

Specified by:

createTransitionExpression in interface WfDefinerService

Parameters:

template -

transition -

Returns:

WfExpression

Throws:

WTException

deleteExpression

public void deleteExpression(WfTemplateObject template,
                             Object event)
                      throws WTException

Supported API: false

Specified by:

deleteExpression in interface WfDefinerService

Parameters:

template -

event -

Throws:

WTException

deleteProcessTemplate

public void deleteProcessTemplate(WfProcessTemplate process_def)
                           throws WTException

Deletes process template passed as argument. This method allows process templates to be deleted without requiring the current user to have modify rights over folders.

Supported API: false

Specified by:

deleteProcessTemplate in interface WfDefinerService

Parameters:

process_def -

Throws:

WTException

demoteBlockTemplate

public void demoteBlockTemplate(WfBlockTemplate block_template)
                         throws WTException

Removes a block and place its constituents directly into the host process. This operation will delete the block's expression. In other words, the iteration is lost when this method is used.

This operation will only be possible if links to the block are mapped to the START action. Links to the block will be directed to the start connector in the following way: links of the form A -> B, where B is a block, is transformed into A -> S, where S is the start connector of B and the action is FIRE. In the case of links from the block: B -> C, it also wise to restrict the event to COMPLETE. The transformed link is: E -> C, in which the action is FIRE.

The start connector is transformed into a simple OR connector and the end connector into a simple AND connector.

Note: A block can be the target of a change of state other than START even if there is no incoming link with this action. This happens, for example, when the process completes/is suspended ... It issues commands to all contained activities to do the same. In this case a block instance behaves like a sub-process, issuing similar commands.

Supported API: false

Specified by:

demoteBlockTemplate in interface WfDefinerService

Parameters:

block_template -

Throws:

WTException

executeExpression

public Object executeExpression(WfExpression expression,
                                Object[] values)
                         throws WTException

Evaluates the expression for the given array of values. Returns an object that is the result of the evaluation. This method is mostly to be used to check if the expression is correct.

Supported API: false

Specified by:

executeExpression in interface WfDefinerService

Parameters:

expression -

values -

Returns:

Object

Throws:

WTException

See Also:

WfExpression

exportTemplates

public void exportTemplates(Vector wfProcessTemplateVector,
                            String fileName,
                            boolean appendFlag)
                     throws WTException

Populate a file with the csv equivalent of the Workflow Template objects

Supported API: false

Specified by:

exportTemplates in interface WfDefinerService

Parameters:

wfProcessTemplateVector - a vector of Wf Process Template 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

findExportImportFileNames

public Vector findExportImportFileNames()
                                 throws WTException

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

Supported API: false

Specified by:

findExportImportFileNames in interface WfDefinerService

Returns:

Vector

Throws:

WTException

getAccessibleNodes

public Vector getAccessibleNodes(WfContainerTemplate template,
                                 WfNodeTemplate start_template)
                          throws WTException

Returns all nodes (activities and connectors) that can be reached from the node passed as argument.

Supported API: false

Specified by:

getAccessibleNodes in interface WfDefinerService

Parameters:

template -

start_template -

Returns:

Vector

Throws:

WTException

getActivityTemplates

public Enumeration getActivityTemplates(WfTemplateCategory category)
                                 throws WTException

Returns all activity templates of the category passed as argument. If 'null' is passed as argument returns all activity templates, irrespective of the category.

Supported API: false

Specified by:

getActivityTemplates in interface WfDefinerService

Parameters:

category -

Returns:

Enumeration

Throws:

WTException

getAllExpressions

public Enumeration getAllExpressions(WfNodeTemplate template)
                              throws WTException

Returns all expressions associated with template (transition and router).

Supported API: false

Specified by:

getAllExpressions in interface WfDefinerService

Parameters:

template -

Returns:

Enumeration

Throws:

WTException

See Also:

WfExpression

getAllTemplates

public Enumeration getAllTemplates()
                            throws WTException

Returns an enumeration containing all process templates. The process templates returned are the working copies if they exist or the vault's latest iteration.

Supported API: false

Specified by:

getAllTemplates in interface WfDefinerService

Returns:

Enumeration

Throws:

WTException

See Also:

getEnabledTemplates

getAllTemplates

public QueryResult getAllTemplates(WTContainerRef context_ref)
                            throws WTException

Returns an enumeration containing all process templates for the passes WTContainerRef. The process templates returned are the working copies if they exist or the vault's latest iteration.

Supported API: false

Specified by:

getAllTemplates in interface WfDefinerService

Parameters:

context_ref -

Returns:

QueryResult

Throws:

WTException

See Also:

getEnabledTemplates

getBlockExpression

public WfExpression getBlockExpression(WfBlockTemplate block_template)
                                throws WTException

Returns the expression associated to the block template passed as parameter. Returns null if expression hasn't been created yet.

Supported API: false

Specified by:

getBlockExpression in interface WfDefinerService

Parameters:

block_template -

Returns:

WfExpression

Throws:

WTException

getConnectorTemplates

public Enumeration getConnectorTemplates(WfContainerTemplate process_def)
                                  throws WTException

Returns all connector templates associated with a given process template.

Supported API: false

Specified by:

getConnectorTemplates in interface WfDefinerService

Parameters:

process_def -

Returns:

Enumeration

Throws:

WTException

getDirectlyUsedByTemplates

public Enumeration getDirectlyUsedByTemplates(WfProcessTemplate template)
                                       throws WTException

Returns all process templates that directly uses the process template passed as argument. A process template "A" directly uses another process template "B" when B is a sub-process of A or there is a proxy in A that references B.

Supported API: false

Specified by:

getDirectlyUsedByTemplates in interface WfDefinerService

Parameters:

template -

Returns:

Enumeration

Throws:

WTException

getDirectlyUsedTemplates

public Enumeration getDirectlyUsedTemplates(WfProcessTemplate template)
                                     throws WTException

Returns all process templates that are directly used in the process template passed as argument. A process template "A" directly uses another process template "B" when B is a sub-process of A or there is a proxy in A that references B.

Supported API: false

Specified by:

getDirectlyUsedTemplates in interface WfDefinerService

Parameters:

template -

Returns:

Enumeration

Throws:

WTException

getEnabledTemplates

public Enumeration getEnabledTemplates()
                                throws WTException

Returns an enumeration containing all enabled process templates. The process templates returned are the working copies if they exist or the vault's latest iteration.

Supported API: false

Specified by:

getEnabledTemplates in interface WfDefinerService

Returns:

Enumeration

Throws:

WTException

See Also:

getAllTemplates

getEnabledTemplates

public QueryResult getEnabledTemplates(WTContainerRef context_ref)
                                throws WTException

Returns an enumeration containing all enabled process templates in the passed WTContainer. The process templates returned are the working copies if they exist or the vault's latest iteration.

Supported API: false

Specified by:

getEnabledTemplates in interface WfDefinerService

Parameters:

context_ref -

Returns:

QueryResult

Throws:

WTException

See Also:

getAllTemplates

getEndConnectorTemplates

public Enumeration getEndConnectorTemplates(WfContainerTemplate process_def)
                                     throws WTException

Returns an enumeration containing the end connector templates associated with the process template.

Supported API: false

Specified by:

getEndConnectorTemplates in interface WfDefinerService

Parameters:

process_def -

Returns:

Enumeration

Throws:

WTException

getLatestIteration

public WfProcessTemplate getLatestIteration(WfProcessTemplateMaster master)
                                     throws WTException

Given a WfProcessTemplateMaster, return the latest iteration (WfProcessTemplate)

Supported API: false

Specified by:

getLatestIteration in interface WfDefinerService

Parameters:

master -

Returns:

WfProcessTemplate

Throws:

WTException

getLatestIteration

public WfProcessTemplateReference getLatestIteration(WfProcessTemplateMasterReference master)
                                              throws WTException

Given a WfProcessTemplateMasterReference, return the latest iteration (WfProcessTemplateReference)

Supported API: false

Specified by:

getLatestIteration in interface WfDefinerService

Parameters:

master -

Returns:

WfProcessTemplateReference

Throws:

WTException

getLinkTemplates

public Enumeration getLinkTemplates(WfContainerTemplate process_def)
                             throws WTException

Returns an enumeration (of type NodeTemplateLink) containing all link templates defined for the process.

Supported API: false

Specified by:

getLinkTemplates in interface WfDefinerService

Parameters:

process_def -

Returns:

Enumeration

Throws:

WTException

getLinkTemplates

public Enumeration getLinkTemplates(WfNode source,
                                    WfNode destination)
                             throws WTException

Return an enumeration (of type NodeTemplateLink) containing all link templates between two node templates.

Supported API: false

Specified by:

getLinkTemplates in interface WfDefinerService

Parameters:

source -

destination -

Returns:

Enumeration

Throws:

WTException

getProcessDefinition

public WfProcessDefinition getProcessDefinition(String process_identity)
                                         throws WTException

Returns a process definition given its identity. May return either the master process template or a specific iteration. Returns 'null' if no process definition is found that has the identity passed as argument.

Tries first to find a master with the identity equal to the one passed as argument; if not found, searches for an iteration.

Supported API: false

Specified by:

getProcessDefinition in interface WfDefinerService

Parameters:

process_identity -

Returns:

WfProcessDefinition

Throws:

WTException

getProcessDefinition

public WfProcessDefinition getProcessDefinition(String process_identity,
                                                WTContainerRef context_ref)
                                         throws WTException

Returns a process definition given its identity. May return either the master process template or a specific iteration. Returns 'null' if no process definition is found that has the identity passed as argument.

Tries first to find a master with the identity equal to the one passed as argument; if not found, searches for an iteration.

Supported API: false

Specified by:

getProcessDefinition in interface WfDefinerService

Parameters:

process_identity -

context_ref -

Returns:

WfProcessDefinition

Throws:

WTException

getProcessRoles

public Vector getProcessRoles(WfContainerTemplate process_def)
                       throws WTException

Returns a Vector of Role objects used by the process/block template passed as argument.

Supported API: false

Specified by:

getProcessRoles in interface WfDefinerService

Parameters:

process_def -

Returns:

Vector

Throws:

WTException

getProcessStepTemplateLink

public ProcessStepTemplateLink getProcessStepTemplateLink(WfContainerTemplate process_def,
                                                          WfTemplateObject step)
                                                   throws WTException

Deprecated. use getProcessTemplateLink (WfTemplateObject) instead

Returns the link between a node template and the containing process template. The link returned contains the mapping betweenlocal and process variables. Returns null if the step template is not contained in the process template.

Supported API: false

Specified by:

getProcessStepTemplateLink in interface WfDefinerService

Parameters:

process_def -

step -

Returns:

ProcessStepTemplateLink

Throws:

WTException

getProcessStepTemplateLink

public ProcessStepTemplateLink getProcessStepTemplateLink(WfTemplateObject step)
                                                   throws WTException

Returns the link between a node template and the containing process template. The link returned contains the mapping between local and process variables. Returns null if the step is not embedded in a container template.

Supported API: false

Specified by:

getProcessStepTemplateLink in interface WfDefinerService

Parameters:

step -

Returns:

ProcessStepTemplateLink

Throws:

WTException

getRobotExpression

public WfExpression getRobotExpression(WfRobotActivityTemplate template)
                                throws WTException

Returns router expression associated with template if it exists. Returns null otherwise.

Supported API: false

Specified by:

getRobotExpression in interface WfDefinerService

Parameters:

template -

Returns:

WfExpression

Throws:

WTException

See Also:

WfExpression

getRouterExpression

public WfExpression getRouterExpression(WfNodeTemplate template)
                                 throws WTException

Returns router expression associated with template if it exists. Returns null otherwise.

Supported API: false

Specified by:

getRouterExpression in interface WfDefinerService

Parameters:

template -

Returns:

WfExpression

Throws:

WTException

See Also:

WfExpression

getStartConnectorTemplate

public WfConnectorTemplate getStartConnectorTemplate(WfContainerTemplate process_def)
                                              throws WTException

Returns the start connector template associated with the process template.

Supported API: false

Specified by:

getStartConnectorTemplate in interface WfDefinerService

Parameters:

process_def -

Returns:

WfConnectorTemplate

Throws:

WTException

getStepTemplates

public Enumeration getStepTemplates(WfContainerTemplate process_def,
                                    WfTemplateObjectType type)
                             throws WTException

Returns an enumeration with existing definition objects that are contained in the process template passed as argument.

Supported API: false

Specified by:

getStepTemplates in interface WfDefinerService

Parameters:

process_def -

type -

Returns:

Enumeration

Throws:

WTException

getSynchExpression

public WfExpression getSynchExpression(WfRobotActivityTemplate template)
                                throws WTException

Returns the fileter expression associated with template if it exists. Returns null otherwise.

Supported API: false

Specified by:

getSynchExpression in interface WfDefinerService

Parameters:

template -

Returns:

WfExpression

Throws:

WTException

See Also:

WfExpression

getTemplateObjects

public Enumeration getTemplateObjects(WfTemplateObjectType type,
                                      WfTemplateCategory category)
                               throws WTException

Returns an enumeration containing existing definition objects of the type and category passed as arguments. If type is null then all types are returned; likewise, if category is null, template objects of all categories are returned.

Supported API: false

Specified by:

getTemplateObjects in interface WfDefinerService

Parameters:

type -

category -

Returns:

Enumeration

Throws:

WTException

getTransitionExpression

public WfExpression getTransitionExpression(WfNodeTemplate template,
                                            Object transition)
                                     throws WTException

Returns the expression associated with a given process or activity template object and transiiton. Returns null if such expression doesn't exists.

Supported API: false

Specified by:

getTransitionExpression in interface WfDefinerService

Parameters:

template -

transition -

Returns:

WfExpression

Throws:

WTException

See Also:

WfExpression

getUsedByTemplates

public Enumeration getUsedByTemplates(WfProcessTemplate template)
                               throws WTException

Returns all process templates that uses the process template passed as argument. A process template "A" uses another process template "B" when A directly uses B or A directly uses a template "C" that uses B.

Supported API: false

Specified by:

getUsedByTemplates in interface WfDefinerService

Parameters:

template -

Returns:

Enumeration

Throws:

WTException

getUsedTemplates

public Enumeration getUsedTemplates(WfProcessTemplate template)
                             throws WTException

Returns all process templates that are used in the process template passed as argument. A process template "A" uses another process template "B" when A directly uses B or A directly uses a template "C" that uses B.

Supported API: false

Specified by:

getUsedTemplates in interface WfDefinerService

Parameters:

template -

Returns:

Enumeration

Throws:

WTException

importTemplates

public void importTemplates(String fileName)
                     throws WTException

Given a file that contains a csv version of any number of Wf Process Template objects, import these objects

Supported API: false

Specified by:

importTemplates in interface WfDefinerService

Parameters:

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

Throws:

WTException

isTemplateInUse

public boolean isTemplateInUse(ObjectReference process_template_ref)
                        throws WTException

Returns true if template is in use; false otherwise.

Supported API: false

Specified by:

isTemplateInUse in interface WfDefinerService

Parameters:

process_template_ref -

Returns:

boolean

Throws:

WTException

removeLinkTemplate

public int removeLinkTemplate(WfNodeTemplate source,
                              WfNodeTemplate destination)
                       throws WTException

Deletes all links between two step templates in a process process. Returns the number of links deleted.

Supported API: false

Specified by:

removeLinkTemplate in interface WfDefinerService

Parameters:

source -

destination -

Returns:

int

Throws:

WTException

removeStepTemplate

public WfTemplateObject removeStepTemplate(WfTemplateObject step_def)
                                    throws WTException

Removes step template from its containing process. Returns the step template removed.

Supported API: false

Specified by:

removeStepTemplate in interface WfDefinerService

Parameters:

step_def -

Returns:

WfTemplateObject

Throws:

WTException

saveProcessTemplate

public TransactionResult saveProcessTemplate(TransactionContainer aTran)
                                      throws WTException,
                                             WfException

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

Supported API: false

Specified by:

saveProcessTemplate in interface WfDefinerService

Parameters:

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

Returns:

TransactionResult

Throws:

WTException

WfException

saveProcessTemplate

public TransactionResult saveProcessTemplate(TransactionContainer aTran,
                                             WTContainerRef context_ref)
                                      throws WTException,
                                             WfException

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

Supported API: false

Specified by:

saveProcessTemplate in interface WfDefinerService

Parameters:

aTran -

context_ref -

Returns:

TransactionResult

Throws:

WTException

WfException

saveProcessTemplate

public WfProcessTemplate saveProcessTemplate(WfProcessTemplate process_def)
                                      throws WTException

Saves a process template in the database. This method allows process templates to be created without requiring the current user to have modify rights over folders.

Supported API: false

Specified by:

saveProcessTemplate in interface WfDefinerService

Parameters:

process_def -

Returns:

WfProcessTemplate

Throws:

WTException

saveProcessTemplate

public WfProcessTemplate saveProcessTemplate(WfProcessTemplate process_def,
                                             WTContainerRef context_ref)
                                      throws WTException

Saves a process template in the database. This method allows process templates to be created without requiring the current user to have modify rights over folders.

Supported API: false

Specified by:

saveProcessTemplate in interface WfDefinerService

Parameters:

process_def -

context_ref -

Returns:

WfProcessTemplate

Throws:

WTException

setEnabled

public void setEnabled(WfProcessDefinition process,
                       boolean enabled)
                throws WTException

Enables or disables the process template master. In case of disabling, throws exception if it is used by an enabled template or it is vetoed by another service.

Supported API: false

Specified by:

setEnabled in interface WfDefinerService

Parameters:

process -

enabled -

Throws:

WTException

setIgnoreDelete

public void setIgnoreDelete(Object obj)
                     throws WTException

Supported API: false

Specified by:

setIgnoreDelete in interface WfDefinerService

Parameters:

obj -

Throws:

WTException

setParentTemplate

public WfNodeTemplate setParentTemplate(WfNodeTemplate node_template,
                                        WfContainerTemplate container_template)
                                 throws WTException

Sets the parent template of a node template. The object is not persisted.

Supported API: false

Specified by:

setParentTemplate in interface WfDefinerService

Parameters:

node_template -

container_template -

Returns:

WfNodeTemplate

Throws:

WTException

verifyTemplate

public Vector verifyTemplate(WfProcessTemplate process_def,
                             boolean recurse)
                      throws WTException

Returns a report of defects in the process template.

Supported API: false

Specified by:

verifyTemplate in interface WfDefinerService

Parameters:

process_def -

recurse -

Returns:

Vector

Throws:

WTException

whereUsed

public Vector whereUsed(ProjectReference project,
                        boolean returnOnlyFirstOccurence)
                 throws WTException

Returns a vector of references to any engine objects that use a particular Project object.

Supported API: false

Specified by:

whereUsed in interface WfDefinerService

Parameters:

project -

returnOnlyFirstOccurence - this boolean parameter determines whether to return all objects that use the Project object or only the first usage. This parameter was added for performance reasons and the occasional need to only know that the project is used.

Returns:

Vector

Throws:

WTException

whereUsed

public Vector whereUsed(TeamReference teamRef,
                        boolean returnOnlyFirstOccurence)
                 throws WTException

Returns a vector of references to any engine objects that use a particular Team object.

Supported API: false

Specified by:

whereUsed in interface WfDefinerService

Parameters:

teamRef -

returnOnlyFirstOccurence - this boolean parameter determines whether to return all objects that use the Project object or only the first usage. This parameter was added for performance reasons and the occasional need to only know that the project is used.

Returns:

Vector

Throws:

WTException

whereUsed

public Vector whereUsed(TeamTemplateReference teamTemplateRef,
                        boolean returnOnlyFirstOccurence)
                 throws WTException

Returns a vector of references to any engine objects that use a particular Team Template object.

Supported API: false

Specified by:

whereUsed in interface WfDefinerService

Parameters:

teamTemplateRef -

returnOnlyFirstOccurence - this boolean parameter determines whether to return all objects that use the Project object or only the first usage. This parameter was added for performance reasons and the occasional need to only know that the project is used.

Returns:

Vector

Throws:

WTException

getProcessDefinition

public WfProcessDefinition getProcessDefinition(String process_identity,
                                                WTContainerRef context_ref,
                                                boolean hierarchical_lookup)
                                         throws WTException

Returns a process definition given its identity, container reference and whether or not the process definition should be looked up hierarchically or not. May return either the master process template or a specific iteration. Returns 'null' if no process definition is found that has the identity passed as argument.

Tries first to find a master with the identity equal to the one passed as argument; if not found, searches for an iteration.

Supported API: false

Specified by:

getProcessDefinition in interface WfDefinerService

Parameters:

process_identity -

context_ref -

hierarchical_lookup -

Returns:

WfProcessDefinition

Throws:

WTException