Process API

filenet.vw.api
Class VWInvokeInstruction

java.lang.Object
  extended by filenet.vw.api.VWInstructionDefinition
      extended by filenet.vw.api.VWInvokeInstruction
All Implemented Interfaces:
filenet.vw.api.IVWHasFault, java.io.Serializable, java.lang.Cloneable

public final class VWInvokeInstruction
extends VWInstructionDefinition
implements java.io.Serializable, filenet.vw.api.IVWHasFault

Use this class to invoke an external Web Service. This class defines a workflow step instruction that allows the Process Engine to communicate with a Web Service as part of a workflow compound step instruction process.

Create an instance of this class with VWCompoundStepDefinition.createInvokeInstruction.

Types of Message Management

This class provides two groups of methods for communication over a partner link, depending on the type of message management desired. An instance of this class should use message management methods from one group or the other, but not both. The two types of partner link-related message management schemes that this class handles are the following:

Methods in this class for handling the Business Process Execution type of message management include:

Methods in this class for handling the Process Engine parameter type of message management include:

Parameters for the Web Service methods are specified like any Process Engine workflow method parameter, and must have a data type that is a Process Engine field type.

See Also:
Business Process Execution Language for Web Services Version 1.1, VWInstructionDefinition, VWReceiveInstruction, VWReplyInstruction, Serialized Form

Method Summary
static java.lang.String _get_FILE_AUTHOR()
          For FileNet internal use only, do not call.
static java.lang.String _get_FILE_DATE()
          For FileNet internal use only, do not call.
static java.lang.String _get_FILE_REVISION()
          For FileNet internal use only, do not call.
 VWFaultDefinition createFault(java.lang.String theName, java.lang.String theFaultMessage, java.lang.String theFaultMapName)
          Creates a fault in this instance.
 VWWebServiceParameterDefinition createInComingParameter(java.lang.String theName, java.lang.String theValue, int theType, boolean theIsArray)
          Creates an incoming parameter with name, direction, value, and type information.
 VWWebServiceParameterDefinition createOutGoingParameter(java.lang.String theName, java.lang.String theValue, int theType, boolean theIsArray)
          Creates an outgoing parameter with name, direction, value, and type information.
 void deleteAllInComingParameters()
          Deletes all incoming parameter definitions for this instance.
 void deleteAllOutGoingParameters()
          Deletes all outgoing parameter definitions for this instance.
 void deleteAllParameters()
          Deletes all incoming and outgoing parameter definitions for this instance.
 void deleteInComingParameter(int theSequenceNumber)
          Deletes a parameter definition from the set of incoming parameter definitions stored in this instance.
 void deleteOutGoingParameter(int theSequenceNumber)
          Deletes a parameter definition from the set of outgoing parameter definitions stored in this instance.
 VWFaultDefinition getCatchAllFault()
          Gets the general fault-handling (catch all) fault for this instance.
 java.lang.String getCatchAllMap()
          Gets the general fault-handling (catch all) fault map for this instance.
 java.lang.String getCatchAllMessage()
          Gets the general fault-handling (catch all) fault message location from this instance.
 VWFaultDefinition getFault(java.lang.String theName)
          Retrieves a fault definition, specified by name.
 VWFaultDefinition[] getFaults()
          Gets the faults contained in this instance.
 VWWebServiceParameterDefinition getInComingParameterDefinition(int theSequenceNumber)
          Gets a parameter definition from the set of incoming parameter definitions stored in this instance.
 VWWebServiceParameterDefinition[] getInComingParameterDefinitions()
          Gets the incoming parameter definitions stored in this instance.
 java.lang.String getInputCorrelationSetName()
          Gets the input correlation set name for this instance.
 java.lang.String[][] getInputCorrelationSetProperties()
          Gets the input correlation set properties for this instance.
 java.lang.String getInputMsgExpr()
          Gets the input message expression for this instance.
 java.lang.String getInputMsgName()
          Gets the input message name for this instance .
 java.lang.String getOperationName()
          Gets the operation name for this instance.
 VWWebServiceParameterDefinition getOutGoingParameterDefinition(int theSequenceNumber)
          Gets a parameter definition from the set of outgoing parameter definitions stored in this instance.
 VWWebServiceParameterDefinition[] getOutGoingParameterDefinitions()
          Gets the outgoing parameter definitions stored in this instance.
 java.lang.String getOutputCorrelationSetName()
          Gets the output correlation set name for this instance.
 java.lang.String[][] getOutputCorrelationSetProperties()
          Gets the output correlation set properties for this instance.
 java.lang.String getOutputMsgExpr()
          Gets the output message expression for this instance.
 java.lang.String getOutputMsgName()
          Gets the output message name for this instance.
 java.lang.String getPartnerLinkName()
          Gets the partner link name for this instance.
 java.lang.String getTimeoutExpr()
          Gets the timeout expression for this instance.
 java.lang.String getTimeoutMapName()
          Gets the timeout map name for this instance.
 boolean getUseReliableMessaging()
          Indicates whether reliable messaging is used this invoke instruction.
 void setCatchAllMap(java.lang.String theMapName)
          Sets the general fault-handling (catch all) map name.
 void setCatchAllOutput(java.lang.String theOutput)
          Sets the general fault-handling (catch all) output expression that will hold the fault information.
 void setFaults(VWFaultDefinition[] theFaults)
          Sets the faults contained in this instance.
 void setInputCorrelationSetName(java.lang.String theName)
          Sets the input correlation set name for this instance.
 void setInputCorrelationSetProperties(java.lang.String[][] theProps)
          Sets the input correlation set properties for this instance.
 void setInputMsgExpr(java.lang.String theInputMsgExpr)
          Sets the input message expression for this instance.
 void setInputMsgName(java.lang.String theInputMsgName)
          Sets the input message name for this instance.
 void setOperationName(java.lang.String theOperationName)
          Sets the operation name for this instance.
 void setOutputCorrelationSetName(java.lang.String theName)
          Sets the output correlation set name for this instance.
 void setOutputCorrelationSetProperties(java.lang.String[][] theProps)
          Sets the output correlation set properties for this instance.
 void setOutputMsgExpr(java.lang.String theOutputMsgExpr)
          Sets the output message expression for this instance.
 void setOutputMsgName(java.lang.String theOutputMsgName)
          Sets the output message name for this instance.
 void setPartnerLinkName(java.lang.String thePartnerLinkName)
          Sets the partner link name for this instance.
 void setTimeoutExpr(java.lang.String theTimeoutExpr)
          Sets the timeout expression for this instance.
 void setTimeoutMapName(java.lang.String theTimeoutMapName)
          Sets the timeout map name for this instance.
 void setUseReliableMessaging(boolean theUseReliableMessagingFlag)
          Specifies that reliable messaging (the WS-ReliableMessaging protocol) is to be used for this invoke instruction.
 java.lang.String toString()
          Returns a String representation of this instance.
 void toXML(java.lang.StringBuffer theBuffer)
          Appends an XML string representing this instance to the StringBuffer specified.
 void toXPDL(java.lang.String indentA, java.lang.StringBuffer theBuffer)
          Appends an XPDL string representing this instance to the StringBuffer specified.
 void validate(VWSession theSession, java.util.Vector EDefVector, VWCompoundStepDefinition myStep)
          Validates this instance, appending any validation errors found to the specified Vector object.
 
Methods inherited from class filenet.vw.api.VWInstructionDefinition
getAction, getInstructionId, getStep
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, wait, wait, wait
 
Methods inherited from interface filenet.vw.api.IVWHasFault
getStep
 

Method Detail

_get_FILE_DATE

public static java.lang.String _get_FILE_DATE()
For FileNet internal use only, do not call.


_get_FILE_AUTHOR

public static java.lang.String _get_FILE_AUTHOR()
For FileNet internal use only, do not call.


_get_FILE_REVISION

public static java.lang.String _get_FILE_REVISION()
For FileNet internal use only, do not call.


createFault

public VWFaultDefinition createFault(java.lang.String theName,
                                     java.lang.String theFaultMessage,
                                     java.lang.String theFaultMapName)
                              throws VWException
Creates a fault in this instance.

Parameters:
theName - A String containing the fault name property.
theFaultMessage - A String containing the fault message field where the fault message can be stored.
theFaultMapName - A String containing the name of the fault map. This can be null.
Returns:
A VWFaultDefinition object containing the specified fault information.
Throws:
VWException

setCatchAllOutput

public void setCatchAllOutput(java.lang.String theOutput)
                       throws VWException
Sets the general fault-handling (catch all) output expression that will hold the fault information.

Parameters:
theOutput - A left-side String expression: a String expression that is valid on the left side of an assignment statement, such as the name of a String field in this workflow. This can be null.
Throws:
VWException
See Also:
VWFaultDefinition, setCatchAllMap(java.lang.String)

setCatchAllMap

public void setCatchAllMap(java.lang.String theMapName)
                    throws VWException
Sets the general fault-handling (catch all) map name.

Parameters:
theMapName - A String containing the name of the workflow map to be called if a specific fault for the current condition does not exist for this invoke instruction. This can be null.
Throws:
VWException
See Also:
VWFaultDefinition, createFault(java.lang.String, java.lang.String, java.lang.String)

getCatchAllFault

public VWFaultDefinition getCatchAllFault()
                                   throws VWException
Gets the general fault-handling (catch all) fault for this instance.

Returns:
A VWFaultDefinition object containing the general fault-handling (catch all) fault definition for this invoke instruction. This may be null.
Throws:
VWException
See Also:
VWFaultDefinition

getCatchAllMap

public java.lang.String getCatchAllMap()
                                throws VWException
Gets the general fault-handling (catch all) fault map for this instance.

Returns:
A String containing the name of the general fault-handling (catch all) fault map for this invoke instruction. This will be null if the fault map was not specified in setCatchAllMap.
Throws:
VWException
See Also:
VWFaultDefinition

getCatchAllMessage

public java.lang.String getCatchAllMessage()
                                    throws VWException
Gets the general fault-handling (catch all) fault message location from this instance. This is a left-side expression that evaluates to the location, (usually a field name) where the message can be stored.

Returns:
A VWFaultDefinition object containing the general fault-handling (catch all) fault message for this invoke instruction. This may be null.
Throws:
VWException
See Also:
VWFaultDefinition

getFaults

public VWFaultDefinition[] getFaults()
                              throws VWException
Gets the faults contained in this instance.

Returns:
An array of all VWFaultDefinition objects contained in this VWInvokeInstruction object, with one element per fault in the invoke instruction. If there are no faults defined in the VWInvokeInstruction, this method returns null.
Throws:
VWException
See Also:
createFault(java.lang.String, java.lang.String, java.lang.String), getFault(java.lang.String)

setFaults

public void setFaults(VWFaultDefinition[] theFaults)
               throws VWException
Sets the faults contained in this instance.

Parameters:
theFaults - An array of VWFaultDefinition objects. The array cannot contain any null elements, but this parameter can be null.
Throws:
VWException - Thrown for various causes, including when the input array contains a null element.
See Also:
createFault(java.lang.String, java.lang.String, java.lang.String), getCatchAllFault(), VWFaultDefinition

getFault

public VWFaultDefinition getFault(java.lang.String theName)
                           throws VWException
Retrieves a fault definition, specified by name.

Specified by:
getFault in interface filenet.vw.api.IVWHasFault
Parameters:
theName - A String containing the name of the fault definition.
Returns:
The WFaultDefinition object specified in the theName parameter.
Throws:
VWException - Thrown for various causes, including when the fault name does not correctly specify any faults for this VWInvokeInstruction instance.
See Also:
createFault(java.lang.String, java.lang.String, java.lang.String), VWFaultDefinition

setTimeoutExpr

public void setTimeoutExpr(java.lang.String theTimeoutExpr)
                    throws VWException
Sets the timeout expression for this instance.

Parameters:
theTimeoutExpr - A String containing the timeout expression value. This must be a valid time expression (see time expression for an example).
Throws:
VWException

getTimeoutExpr

public java.lang.String getTimeoutExpr()
Gets the timeout expression for this instance.

Returns:
A String containing the timeout expression value for this invoke instruction.
See Also:
setTimeoutExpr(String)

setTimeoutMapName

public void setTimeoutMapName(java.lang.String theTimeoutMapName)
                       throws VWException
Sets the timeout map name for this instance.

Parameters:
theTimeoutMapName - A String containing the new timeout map name for this invoke instruction. The timeout map name should be a name of a map in the containing workflow definition. This can be null.
Throws:
VWException

getTimeoutMapName

public java.lang.String getTimeoutMapName()
Gets the timeout map name for this instance.

Returns:
Timeout map name for this invoke instruction. This will be null if a timeout map name was not specified for setTimeoutMapName.

setInputMsgExpr

public void setInputMsgExpr(java.lang.String theInputMsgExpr)
                     throws VWException
Sets the input message expression for this instance.

Parameters:
theInputMsgExpr - A String containing the XML input message expression value for this invoke instruction (must meet the Web Service WSDL requirements). This can be used in place of parameters for supplying data.
Throws:
VWException
See Also:
setInputCorrelationSetName(String), setInputCorrelationSetProperties(String[][]), getInputMsgExpr(), Types Of Message Management, setInputCorrelationSetName(String)

getInputMsgExpr

public java.lang.String getInputMsgExpr()
Gets the input message expression for this instance.

Returns:
A String containing the input message expression for this invoke instruction.
See Also:
Types Of Message Management, setInputCorrelationSetName(String), setInputCorrelationSetProperties(String[][]), setInputMsgExpr(String)

setOutputMsgExpr

public void setOutputMsgExpr(java.lang.String theOutputMsgExpr)
                      throws VWException
Sets the output message expression for this instance. The output message expression must be a left-side string expression, such as the name of a String field in this workflow that will receive output from the invoked Web Service.

Parameters:
theOutputMsgExpr - A left-side String expression (a String expression that is valid on the left side of an assignment statement), such as the name of a String field in this workflow.
Throws:
VWException
See Also:
Types Of Message Management, setOutputCorrelationSetName(String), setOutputCorrelationSetProperties(String[][]), getOutputMsgExpr()

getOutputMsgExpr

public java.lang.String getOutputMsgExpr()
Gets the output message expression for this instance.

Returns:
Output A String containing the message expression for this invoke instruction.
See Also:
Types Of Message Management, setOutputCorrelationSetName(String), setOutputCorrelationSetProperties(String[][]), setOutputMsgExpr(String)

setPartnerLinkName

public void setPartnerLinkName(java.lang.String thePartnerLinkName)
                        throws VWException
Sets the partner link name for this instance. The partner link name must be the name of a partner link in the same workflow definition that contains this invoke instruction.

Parameters:
thePartnerlinkName - A String containing the partner link name for this invoke instruction.
Throws:
VWException
See Also:
VWPartnerLinkDefinition, VWWorkflowDefinition

getPartnerLinkName

public java.lang.String getPartnerLinkName()
Gets the partner link name for this instance.

Returns:
A String containing the partner link name.
See Also:
VWPartnerLinkDefinition, VWWorkflowDefinition, setPartnerLinkName(java.lang.String)

setOperationName

public void setOperationName(java.lang.String theOperationName)
                      throws VWException
Sets the operation name for this instance. This must be the name of an operation on the port type defined in the associated partner link.

Parameters:
theOperationName - A String containing the operation name.
Throws:
VWException
See Also:
VWPartnerLinkDefinition

getOperationName

public java.lang.String getOperationName()
Gets the operation name for this instance. This must be the name of an operation on the port type defined in the associated partner link.

Returns:
A String containing the operation name.
See Also:
setOperationName(java.lang.String), VWPartnerLinkDefinition

createInComingParameter

public VWWebServiceParameterDefinition createInComingParameter(java.lang.String theName,
                                                               java.lang.String theValue,
                                                               int theType,
                                                               boolean theIsArray)
                                                        throws VWException
Creates an incoming parameter with name, direction, value, and type information. This method is designed for situations involving simple data transfer with a Web Service. Parameters may be used in place of the (usually) more complex Business Processing Execution type of message management.

Parameters:
theName - A String containing the name of the parameter.
theValue - A String containing the parameter definition value.
theType - An integer specifying the field type that applies to the value expression.
theIsArray - A boolean value of true indicates the value expression is an array; false otherwise.
Returns:
Parameter definition.
Throws:
VWException - Various causes, including the following:
  • Invalid symbol in the theName parameter
  • Parameter with a name that already exists
  • Invalid field type
See Also:
VWWebServiceParameterDefinition, VWModeType

createOutGoingParameter

public VWWebServiceParameterDefinition createOutGoingParameter(java.lang.String theName,
                                                               java.lang.String theValue,
                                                               int theType,
                                                               boolean theIsArray)
                                                        throws VWException
Creates an outgoing parameter with name, direction, value, and type information. Designed for situations involving simple data transfer with a Web Service. Parameters may be used in place of the (usually) more complex Business Processing Execution type of message management.

Parameters:
theName - A String containing the name of the parameter.
theMode - An integer specifying the mode of the parameter.
theValue - A String containing the parameter definition value.
theType - An integer specifying the field type that applies to the value expression.
theIsArray - A boolean value of true indicates the value expression is an array; false otherwise.
Returns:
A VWWebServiceParameterDefinition object containing the parameter specification.
Throws:
VWException - Various causes, including the following:
  • Invalid symbol in the theName parameter
  • Parameter with a name that already exists
  • Invalid field type
  • Invalid mode type
See Also:
VWWebServiceParameterDefinition, VWModeType

deleteOutGoingParameter

public void deleteOutGoingParameter(int theSequenceNumber)
                             throws VWException
Deletes a parameter definition from the set of outgoing parameter definitions stored in this instance.

Parameters:
theSequenceNumber - An integer identifying the parameter definition to be deleted as an index into the array of outgoing parameter definitions.
Throws:
VWException - Thrown for various causes, including when the input parameter name is invalid.
See Also:
VWWebServiceParameterDefinition

deleteInComingParameter

public void deleteInComingParameter(int theSequenceNumber)
                             throws VWException
Deletes a parameter definition from the set of incoming parameter definitions stored in this instance.

Parameters:
theSequenceNumber - An integer identifying the parameter definition to be deleted as an index into the array of incoming parameter definitions.
Throws:
VWException - Thrown for various causes, including when the input parameter name is invalid.
See Also:
VWWebServiceParameterDefinition

deleteAllParameters

public void deleteAllParameters()
                         throws VWException
Deletes all incoming and outgoing parameter definitions for this instance.

Throws:
VWException
See Also:
VWWebServiceParameterDefinition

deleteAllInComingParameters

public void deleteAllInComingParameters()
                                 throws VWException
Deletes all incoming parameter definitions for this instance.

Throws:
VWException
See Also:
VWWebServiceParameterDefinition

deleteAllOutGoingParameters

public void deleteAllOutGoingParameters()
                                 throws VWException
Deletes all outgoing parameter definitions for this instance.

Throws:
VWException
See Also:
VWWebServiceParameterDefinition

getOutGoingParameterDefinition

public VWWebServiceParameterDefinition getOutGoingParameterDefinition(int theSequenceNumber)
                                                               throws VWException
Gets a parameter definition from the set of outgoing parameter definitions stored in this instance.

Parameters:
theSequenceNumber - An integer identifying the parameter definition to be deleted as an index into the array of outgoing parameter definitions.
Returns:
A VWWebServiceParameterDefinition object for the parameter definition indicated in theSequenceNumber.
Throws:
VWException
See Also:
VWWebServiceParameterDefinition

getInComingParameterDefinition

public VWWebServiceParameterDefinition getInComingParameterDefinition(int theSequenceNumber)
                                                               throws VWException
Gets a parameter definition from the set of incoming parameter definitions stored in this instance.

Parameters:
theSequenceNumber - An integer identifying the parameter definition to be deleted as an index into the array of incoming parameter definitions.
Returns:
A VWWebServiceParameterDefinition object for the parameter definition indicated in theSequenceNumber.
Throws:
VWException
See Also:
VWWebServiceParameterDefinition

getOutGoingParameterDefinitions

public VWWebServiceParameterDefinition[] getOutGoingParameterDefinitions()
                                                                  throws VWException
Gets the outgoing parameter definitions stored in this instance.

Returns:
An array of VWWebServiceParameterDefinition objects containing the parameter definitions for this instance.
Throws:
VWException
See Also:
VWWebServiceParameterDefinition

getInComingParameterDefinitions

public VWWebServiceParameterDefinition[] getInComingParameterDefinitions()
                                                                  throws VWException
Gets the incoming parameter definitions stored in this instance.

Returns:
An array of VWWebServiceParameterDefinition objects containing the parameter definitions for this instance.
Throws:
VWException
See Also:
VWWebServiceParameterDefinition

toString

public java.lang.String toString()
Returns a String representation of this instance.

Specified by:
toString in class VWInstructionDefinition
Returns:
A String representing this instance.
See Also:
VWActionType

validate

public void validate(VWSession theSession,
                     java.util.Vector EDefVector,
                     VWCompoundStepDefinition myStep)
              throws VWException
Validates this instance, appending any validation errors found to the specified Vector object.

Specified by:
validate in class VWInstructionDefinition
Parameters:
theSession - The current VWSession object if logged on. This is needed for various parts of the validation process. This can be null; however, areas of validation requiring a logon will not be validated.
EDefVector - A Vector to which will be added a VWValidationError object for each validation error found. This can be null; in this case, a new Vector is used.

Note: Because validate methods having EDefVector in the signature also occur on other classes, the existing Vector can contain validation errors from previous validation calls.

myStep - The VWCompoundStepDefinition object containing this event.
Throws:
VWException - Thrown if an error occurs during the validation.

toXML

public void toXML(java.lang.StringBuffer theBuffer)
           throws VWException
Appends an XML string representing this instance to the StringBuffer specified.

Warning: This XML string is nonextensible, and cannot be modified.

Specified by:
toXML in class VWInstructionDefinition
Parameters:
theBuffer - A StringBuffer that will be appended with XML content representing this instance.
Throws:
VWException - Thrown when the parameter is null.
See Also:
VWXMLUtil

toXPDL

public void toXPDL(java.lang.String indentA,
                   java.lang.StringBuffer theBuffer)
            throws VWException
Appends an XPDL string representing this instance to the StringBuffer specified.

Warning: This XPDL string is nonextensible, and cannot be modified in any way.

Parameters:
indentA - A String specifying the initial indentation for this XPDL section.
theBuffer - A StringBuffer that is to be appended with the XPDL content.
Throws:
VWException - Thrown when a parameter is null.
See Also:
VWXMLUtil

setInputCorrelationSetName

public void setInputCorrelationSetName(java.lang.String theName)
                                throws VWException
Sets the input correlation set name for this instance. A correlation set stores the message state value so that a work item can be matched with a particular message.

Parameters:
theName - A String containing the correlation set name. This can be null. A null value signifies there is no correlation set name, normally because another type of message management is used, or because a state value is not needed. The length of the name must not exceed 24 characters. Correlation set names can contain only alphanumeric and underscore ("_") characters.
Throws:
VWException - Thrown when the specified name exceeds 24 characters, or when an invalid character is included in the name.
See Also:
getInputCorrelationSetName(), setInputCorrelationSetProperties(java.lang.String[][]), setInputMsgExpr(java.lang.String)

getInputCorrelationSetName

public java.lang.String getInputCorrelationSetName()
Gets the input correlation set name for this instance.

Returns:
A String containing the correlation set name.
See Also:
setInputCorrelationSetName(java.lang.String), setInputCorrelationSetProperties(java.lang.String[][]), setInputMsgExpr(java.lang.String), Types Of Message Management, setInputCorrelationSetName(java.lang.String)

setOutputCorrelationSetName

public void setOutputCorrelationSetName(java.lang.String theName)
                                 throws VWException
Sets the output correlation set name for this instance. A correlation set stores the message state value, so that a work item can be matched with a particular message.

Parameters:
theName - A String containing the correlation set name. This can be null. A null value signifies there is no correlation set name, normally because another type of message management is used, or because a state value is not needed. The length of the name must not exceed 24 characters. Correlation set names can contain only alphanumeric and underscore ("_") characters.
Throws:
VWException - Thrown when the specified name exceeds 24 characters, or when an invalid character is included in the name.
See Also:
getOutputCorrelationSetName(), setOutputCorrelationSetProperties(java.lang.String[][]), setOutputMsgExpr(java.lang.String)

getOutputCorrelationSetName

public java.lang.String getOutputCorrelationSetName()
Gets the output correlation set name for this instance.

Returns:
A String containing the output correlation set name.
See Also:
Types Of Message Management, setOutputCorrelationSetName(java.lang.String), setOutputCorrelationSetProperties(java.lang.String[][]), setOutputMsgExpr(java.lang.String)

setInputCorrelationSetProperties

public void setInputCorrelationSetProperties(java.lang.String[][] theProps)
                                      throws VWException
Sets the input correlation set properties for this instance. A correlation set stores the message state value, so that the work item can be matched with a particular message.

Parameters:
theProps - A two-dimensional String array of correlation set properties. Each correlation set property is comprised of a property name and its corresponding Process Engine expression query.
Throws:
VWException - Thrown when the array dimension is incorrect (there are not an number of elements in the arrays), or when one of the arrays contains a null element.
See Also:
Types Of Message Management, setInputCorrelationSetName(java.lang.String), getInputCorrelationSetProperties(), setInputMsgExpr(java.lang.String)

getInputCorrelationSetProperties

public java.lang.String[][] getInputCorrelationSetProperties()
Gets the input correlation set properties for this instance.

Returns:
A two-dimensional String array of correlation set properties. Each correlation set property is comprised of a property name and its corresponding Process Engine expression query.
See Also:
Types Of Message Management, setInputCorrelationSetName(java.lang.String)

setOutputCorrelationSetProperties

public void setOutputCorrelationSetProperties(java.lang.String[][] theProps)
                                       throws VWException
Sets the output correlation set properties for this instance. A correlation set stores the message state value, so that the work item can be matched with a particular message.

Parameters:
theProps - A two-dimensional String array of correlation set properties. Each correlation set property is comprised of a property name and its corresponding Process Engine expression query.
Throws:
VWException - Thrown when the array dimension is incorrect (there are not an number of elements in the arrays), or when one of the arrays contains a null element.
See Also:
Types Of Message Management, setOutputCorrelationSetName(java.lang.String), getOutputCorrelationSetProperties(), setOutputMsgExpr(java.lang.String)

getOutputCorrelationSetProperties

public java.lang.String[][] getOutputCorrelationSetProperties()
Gets the output correlation set properties for this instance.

Returns:
A two-dimensional String array of correlation set properties. Each correlation set property is comprised of a property name and its corresponding Process Engine expression query.
See Also:
Types Of Message Management, setOutputCorrelationSetName(java.lang.String), setOutputCorrelationSetProperties(java.lang.String[][]), setOutputMsgExpr(java.lang.String)

setInputMsgName

public void setInputMsgName(java.lang.String theInputMsgName)
                     throws VWException
Sets the input message name for this instance.

Parameters:
theInputMsgName - A String containing the input message name. This can be null.
Throws:
VWException
See Also:
setInputCorrelationSetName(java.lang.String), setInputCorrelationSetProperties(java.lang.String[][]), getInputMsgName(), Types Of Message Management, setInputCorrelationSetName(java.lang.String)

getInputMsgName

public java.lang.String getInputMsgName()
Gets the input message name for this instance .

Returns:
A String containing the input message name.
See Also:
Types Of Message Management, setInputCorrelationSetName(java.lang.String), setInputCorrelationSetProperties(java.lang.String[][]), setInputMsgName(java.lang.String)

setOutputMsgName

public void setOutputMsgName(java.lang.String theOutputMsgName)
                      throws VWException
Sets the output message name for this instance.

Parameters:
theOutputMsgName - A String containing the output message name. This can be null.
Throws:
VWException
See Also:
Types Of Message Management, setOutputCorrelationSetName(String), setOutputCorrelationSetProperties(String[][]), getOutputMsgName()

getOutputMsgName

public java.lang.String getOutputMsgName()
Gets the output message name for this instance.

Returns:
Output A String containing the message name.
See Also:
Types Of Message Management, setOutputCorrelationSetName(String), setOutputCorrelationSetProperties(String[][]), setOutputMsgName(String)

setUseReliableMessaging

public void setUseReliableMessaging(boolean theUseReliableMessagingFlag)
                             throws VWException
Specifies that reliable messaging (the WS-ReliableMessaging protocol) is to be used for this invoke instruction. If the Web service does not support the WS-ReliableMessaging protocol, non-reliable messaging is used.

Parameters:
theUseReliableMessagingFlag - A boolean value of true enables reliable messaging for this invoke instruction; false otherwise.
Throws:
VWException

getUseReliableMessaging

public boolean getUseReliableMessaging()
                                throws VWException
Indicates whether reliable messaging is used this invoke instruction. If the Web service does not support the WS-ReliableMessaging protocol, non-reliable messaging is used.

Returns:
A boolean value of true if reliable messaging is enabled for this invoke instruction.
Throws:
VWException

Process API

© Copyright IBM Corporation 2002, 2008. All rights reserved.