oracle.ifs.fdk
Interface WorkflowManager

public interface WorkflowManager

FDK interface for managing Workflow operations.

Method Summary

Item	getRequestForWorkflowProcess(long workflowPid, AttributeRequest[] attrs) Returns a Request corresponding to a given WorkflowProcess id.
Item	getWorkflowConfiguration(long id, java.lang.String operation, boolean direct, AttributeRequest[] attrs) Returns the WorkflowConfiguration of the specified type that is associated with the given item ID, or null if no WorkflowConfiguration of the specified type exists for the given item ID.
Item[]	getWorkflowConfigurations(long id, AttributeRequest[] attrs) Returns every WorkflowConfiguration that is associated directly with the given Item ID, or null if no WorkflowConfigurations exist directly on the given Item ID.
Item[]	listWorkflows(AttributeRequest[] attributes) Returns all Workflow instances that have been registered.
void	removeWorkflowConfiguration(long id, java.lang.String type) Removes the given Item ID's WorkflowConfiguration of the specified type.
void	setWorkflowConfiguration(long id, java.lang.String operation, NamedValue[] config) Sets a WorkflowConfiguration for an Item, replacing any existing WorkflowConfiguration of the same operation type.
java.lang.String	validateWorkflowParameterValue(long workflowId, java.lang.String paramName, java.lang.String value) Validates that the value for the parameter name is correct according to the validator defined for that parameter.

Method Detail

getRequestForWorkflowProcess

public Item getRequestForWorkflowProcess(long workflowPid,
                                         AttributeRequest[] attrs)
                                  throws FdkException

Returns a Request corresponding to a given WorkflowProcess id.

Parameters:

workflowPid - ID of the workflow process.

Returns:

The Request corresponding to workflow processid.

Throws:

FdkException - if the operation fails.

getWorkflowConfiguration

public Item getWorkflowConfiguration(long id,
                                     java.lang.String operation,
                                     boolean direct,
                                     AttributeRequest[] attrs)
                              throws FdkException

Returns the WorkflowConfiguration of the specified type that is associated with the given item ID, or null if no WorkflowConfiguration of the specified type exists for the given item ID.

Parameters:

id - ID of the Item from which to retrieve the WorkflowConfiguration of the specified type.

operation - the operation to configure (the type of WorkflowConfiguration) (see Attributes.WORKFLOW_CONFIGURATION_OPERATION and Attributes.WORKFLOW_OPERATIONS).

direct - whether to only retrieve the WorkflowConfiguration of the specified type directly from the given Item ID; if false and the given Item ID does not have a direct WorkflowConfiguration of the specified type, then this method retrieves the WorkflowConfiguration from the closest parent of the Item ID that does have one.

attrs - the requested attributes (see setWorkflowConfiguration).

Throws:

FdkException - if the operation fails.

getWorkflowConfigurations

public Item[] getWorkflowConfigurations(long id,
                                        AttributeRequest[] attrs)
                                 throws FdkException

Returns every WorkflowConfiguration that is associated directly with the given Item ID, or null if no WorkflowConfigurations exist directly on the given Item ID.

Parameters:

id - ID of the Item from which to retrieve WorkflowConfiguration instances.

attrs - the requested attributes (see setWorkflowConfiguration).

Throws:

FdkException - if the operation fails.

listWorkflows

public Item[] listWorkflows(AttributeRequest[] attributes)
                     throws FdkException

Returns all Workflow instances that have been registered.

Parameters:

attributes - the requested attributes.

Returns:

an array of Workflow items.

Throws:

FdkException - if the operation fails.

removeWorkflowConfiguration

public void removeWorkflowConfiguration(long id,
                                        java.lang.String type)
                                 throws FdkException

Removes the given Item ID's WorkflowConfiguration of the specified type.

Parameters:

id - ID of the Item from which to remove the WorkflowConfiguration.

Throws:

FdkException - if the operation fails.

setWorkflowConfiguration

public void setWorkflowConfiguration(long id,
                                     java.lang.String operation,
                                     NamedValue[] config)
                              throws FdkException

Sets a WorkflowConfiguration for an Item, replacing any existing WorkflowConfiguration of the same operation type.

Parameters:

id - ID of the item on which to set the WorkflowConfiguration.

operation - the operation to configure (the type of WorkflowConfiguration) (see Attributes.WORKFLOW_CONFIGURATION_OPERATION and Attributes.WORKFLOW_OPERATIONS).

Throws:

FdkException - if the operation fails.

validateWorkflowParameterValue

public java.lang.String validateWorkflowParameterValue(long workflowId,
                                                       java.lang.String paramName,
                                                       java.lang.String value)
                                                throws FdkException

Validates that the value for the parameter name is correct according to the validator defined for that parameter.

Parameters:

workflowId - ID of the Workflow on which the parameter is defined.

paramName - name of the workflow parameter.

value - value to verify.

Returns:

the normalized value (which may be simply the input value provided).

Throws:

FdkException - if the operation fails, or if the validation fails.