Process Class Relationships

filenet.vw.api
Class VWWFEInstruction

java.lang.Object
  |
  +--filenet.vw.api.VWInstructionDefinition
        |
        +--filenet.vw.api.VWWFEInstruction
All Implemented Interfaces:
java.io.Serializable

public final class VWWFEInstruction
extends VWInstructionDefinition
implements java.io.Serializable

Class encapsulates wait for event instructions in a compound step definition.

Since:
VWWS4.20
See Also:
VWException, Serialized Form

Method Summary
 VWEventDefinition createEvent(java.lang.String theWCName, java.lang.String theOperator, java.lang.String theValue)
          Create an event in this VWWFEInstruction instance.
 java.lang.String getEventNumLoc()
          Get the value of this instructions's eventNumLoc expression property.
 VWEventDefinition[] getEvents()
          Gets the events contained in this VWWFEInstruction instance.
 java.lang.String getTimeOut()
          Get the value of this instructions's timeOut expression property.
 void setEventNumLoc(java.lang.String theEventNumLoc)
          Change the value of this instructions's eventNumLoc expression property.
 void setEvents(VWEventDefinition[] theEvents)
          Sets the events contained in this VWWFEInstruction instance.
 void setTimeOut(java.lang.String theTimeOut)
          Change the value of this instructions's timeOut expression property.
 java.lang.String toString()
          Gets the name of this rollback instruction
 void toXML(java.lang.StringBuffer theBuffer)
          Appends an XML string that represents this VWWFEInstruction object to the buffer specified by the input parameter.
 void validate(VWSession theSession, java.util.Vector EDefVector, VWCompoundStepDefinition myStep)
          Validate this VWWFEInstruction object.
 
Methods inherited from class filenet.vw.api.VWInstructionDefinition
getAction, getInstructionId
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Method Detail

getTimeOut

public java.lang.String getTimeOut()
Get the value of this instructions's timeOut expression property.
Returns:
The value of this instructions's timeOut expression.

setTimeOut

public void setTimeOut(java.lang.String theTimeOut)
                throws VWException
Change the value of this instructions's timeOut expression property.
Parameters:
theTimeOut - The new value of this instructions's timeOut expression property. A time expression representing the maximum number of minutes to wait for an event to occur. A value of "0" means wait for ever. This Parameter cannot be null. Details of time expressions are described in the "Expressions" book of the Reference section of the Designer User documentation.
Throws:
VWException - if an error occurs.

getEventNumLoc

public java.lang.String getEventNumLoc()
Get the value of this instructions's eventNumLoc expression property.
Returns:
The value of this instructions's eventNumLoc expression.

setEventNumLoc

public void setEventNumLoc(java.lang.String theEventNumLoc)
                    throws VWException
Change the value of this instructions's eventNumLoc expression property.
Parameters:
theEventNumLoc - The new value of this instructions's eventNumLoc expression property. A numeric Lvalue expression which is the location where the row number of the event causing the wait for event to wake up will be stored.
Throws:
VWException - if an error occurs.

getEvents

public VWEventDefinition[] getEvents()
                              throws VWException
Gets the events contained in this VWWFEInstruction instance.
Returns:
An array of all VWEventDefinition objects contained in this VWCompoundStepDefinition object. The returned array has the same number of elements as the number of events in the wait for event instructions; there are no empty elements in the array. If there are no events defined in the WFEInstruction, the method returns null.
Throws:
VWException - Thrown if it cannot get the events.

setEvents

public void setEvents(VWEventDefinition[] theEvents)
               throws VWException
Sets the events contained in this VWWFEInstruction instance.
Parameters:
theEvents - An array of VWEventDefinition objects. The array may not contain any null elements. The array may be null.
Throws:
VWException - Thrown if it cannot set the events.

createEvent

public VWEventDefinition createEvent(java.lang.String theWCName,
                                     java.lang.String theOperator,
                                     java.lang.String theValue)
                              throws VWException
Create an event in this VWWFEInstruction instance.
Parameters:
theWCName - The new value of this event's WorkClass name property. This parameter is the name of the work class which will trigger this event.
This Parameter cannot be null.
theOperator - The new value of this event's comparison operator property. The operator will be used to compare this events value property against the F_Tag field of the WorkClass which triggered this event, to decide if the event has occurred.
The operator must be one of the following - "=", ">", "<", "<>", "<=", or ">=".
This Parameter cannot be null.
theValue - The new value of this event's value expression property. The value will be compared against the F_Tag field of the WorkClass which triggered this event, using the comparison operator in this event, to decide if the event has occurred.
This Parameter cannot be null.
Returns:
the new VWEventDefinition object.
Throws:
VWException - Thrown if it cannot create the event.

toXML

public void toXML(java.lang.StringBuffer theBuffer)
           throws VWException
Appends an XML string that represents this VWWFEInstruction object to the buffer specified by the input parameter.
Overrides:
toXML in class VWInstructionDefinition
Parameters:
theBuffer - A string buffer that this method will append with XML content.
Throws:
VWException -  
See Also:
VWXMLUtil

validate

public void validate(VWSession theSession,
                     java.util.Vector EDefVector,
                     VWCompoundStepDefinition myStep)
              throws VWException
Validate this VWWFEInstruction object.
Overrides:
validate in class VWInstructionDefinition
Parameters:
theSession - The session object if logged on. This object is needed for various parts of the validation process. The object may be null, but areas of validation that require a logon will not be validated.
EDefVector - a Vector to which will be added any VWValidationErrors found during this call, the Vector may already contain some validation errors errors from previous calls to validate on other objects.
myStep - a reference to the containing VWCompoundStepDefinition
Returns:
void, but the EDefVector will be updated to contain any validation errors found during this call.
Throws:
VWException - If an error occurs during the validation

toString

public java.lang.String toString()
Gets the name of this rollback instruction
Overrides:
toString in class VWInstructionDefinition
Returns:
A string representing this rollback instruction.

Process Class Relationships

Copyright © 2002 FileNET Corporation. All rights reserved.