|
Process Class Relationships | ||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object | +--filenet.vw.api.VWEventDefinition
The VWEventDefinition class encapsulates methods and data that define events. Events are used in the Wait For Event instructions (class VWWFEInstruction) of a compound step definition.
When an event is evoked, the system compares the event's expression value against the F_Tag field of the current work object, using the event's comparison operator. If this comparison is true, the event occurs.
When an event occurs, it can cause the current work object
to move to a specified instruction sheet (map)
(method setCallISName(String)
). An event can also cause a series of
value assignments to occur (method setAssignments(String[][])
).
VWCompoundStepDefinition
,
VWInstructionDefinition
,
VWWFEInstruction
, Serialized FormField Summary | |
static int |
LVALUE
Value of 0: this constant can be used to subscript into the left-hand side values of an event assignment array. |
static int |
RVALUE
Value of 1: this constant can be used to subscript into right-hand side values of an event assignment array. |
Method Summary | |
java.lang.String[][] |
getAssignments()
Gets the assignments property value for the event. |
java.lang.String |
getCallISName()
Gets the name of the instruction sheet (map) which will be called when this event occurs. |
java.lang.String |
getComparisonOperator()
Gets this event's comparison operator. |
java.lang.String |
getValue()
Gets this event's value expression. |
java.lang.String |
getWorkClassName()
Gets the value of this event's work class name property. |
void |
setAssignments(java.lang.String[][] theAssignments)
Sets the assignments property value for the event. |
void |
setCallISName(java.lang.String theCallISName)
Changes the value of this event's instruction sheet call property. |
void |
setComparisonOperator(java.lang.String theOperator)
Changes the value of this event's comparison operator. |
void |
setValue(java.lang.String theValue)
Changes the value of this event's value expression property. |
void |
setWorkClassName(java.lang.String theWorkClassName)
Changes the value of this event's work class name property, which is the non-null name of the work class which contains this event. |
void |
toXML(java.lang.StringBuffer theBuffer)
Appends an XML string that represents this VWEventDefinition object to the buffer specified by the input parameter. |
void |
validate(VWSession theSession,
VWWorkflowDefinition theWorkflow,
java.util.Vector EDefVector,
VWCompoundStepDefinition myStep,
int instId,
int eventId)
Validate this VWEventDefinition object by appending VWValidationError objects to a vector. |
Methods inherited from class java.lang.Object |
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Field Detail |
public static final int LVALUE
public static final int RVALUE
Method Detail |
public java.lang.String getWorkClassName()
setWorkClassName(String)
public void setWorkClassName(java.lang.String theWorkClassName) throws VWException
theWorkClassName
- The new value of this event's
work class name property.VWException
- Thrown if an error occurs,
for example if the parameter is set to null.setComparisonOperator(String)
,
getWorkClassName()
,
setValue(String)
public java.lang.String getValue()
setComparisonOperator(String)
,
setValue(String)
public void setValue(java.lang.String theValue) throws VWException
theValue
- This event's value expression; it cannot be null.VWException
- Thrown if an error occurs, for example if
the passed-in parameter theValue is null.getValue()
,
setComparisonOperator(String)
,
VWWorkflowSignature.getFTagExpression()
public java.lang.String getCallISName()
setCallISName(String)
public void setCallISName(java.lang.String theCallISName) throws VWException
theCallISName
- The new name of the instruction sheet (map)
which will be called when this event occurs. Since calling an
instruction sheet when an event occurs is optional,
a null value is valid.VWException
- getCallISName()
public java.lang.String getComparisonOperator()
setComparisonOperator(String)
,
getValue()
,
setValue(String)
public void setComparisonOperator(java.lang.String theOperator) throws VWException
theOperator
- The new value of this event's comparison
operator.
The operator specified will be used to compare this event's value
property against the current value of the F_Tag field of the work
class containing this event. If this expression is true, the system
recognizes that this event has occurred.The operator value must be one among the following: "=", ">", "<", "<>", "<=", or ">=".
Note: The operator cannot be null.
VWException
- Thrown if an error occurs, for example if
the passed-in operator argument is null.getComparisonOperator()
,
getValue()
,
setValue(String)
public java.lang.String[][] getAssignments()
LVALUE
,
RVALUE
,
setAssignments(String[][])
public void setAssignments(java.lang.String[][] theAssignments) throws VWException
theAssignments
- A two-dimensional array of Strings that
contains pairs of left values and right values of assignment
operations.
Array Dimensionality. The grouping in pairs is accomplished by making the size of the second dimension of the array two, corresponding to the two items in a pair. The number of pairs is indicated by the size of the first dimension of the array. This dimensionality effectively organizes the array into two "columns".
Column organization. The first "column" (second subscript value=0) holds left-side values of the assignment operations, represented as string expressions. Left-side values are typically field names, often subscripted. Left-side values cannot be null.
The second "column" (second subscript value=1) holds the right-side values of the assignment. Right-side values can be any non-null, valid string expression recognized by the workflow server. Some examples of right-side expressions include the string "hello" or the number 75, as literal values. Other valid right-side expressions include field names, arithmetic and boolean expressions, and function calls.
Note: This parameter may be null, to signify that no assignments are made when the event occurs.
VWException
- Thrown if the theAssignments array is not
properly dimensioned, or if any individual array elements are null.LVALUE
,
RVALUE
,
getAssignments()
public void toXML(java.lang.StringBuffer theBuffer) throws VWException
Warning: This XML string is non-extensible, and cannot be modified in any way.
theBuffer
- A string buffer that this method will append with
XML content.VWException
- public void validate(VWSession theSession, VWWorkflowDefinition theWorkflow, java.util.Vector EDefVector, VWCompoundStepDefinition myStep, int instId, int eventId) throws VWException
theSession
- The session object, if the user is currently
logged on. This object is used for various parts of the
validation process. If not logged on, the session object parameter
is set to null, in which case the particular validation items that
require a logon will not undergo validation.EDefVector
- a Vector to which any VWValidationErrors found
during this call will be appended.myStep
- A reference to the containing VWCompoundStepDefinition.instId
- The instruction ID for the VWWFEInstruction that
contains this event.eventId
- The event ID of this event, which is its index into
the array of events that belongs to the containing VWWFEInstruction.VWException
- VWCompoundStepDefinition
,
VWValidationError
,
VWWFEInstruction
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |