s
menu menu

Login  |  Register search:   
Search Blog
Enterprise Forms Blog
Nov27

Written by:EThuongmai Support
11/27/2008 9:27 PM 

Conditional evaluation is a unique feature in Enterprise Forms whereby certain functions within Enterprise Forms can be executed based on values or conditions from multiple sources.  Conditional Evaluation is used in the following areas

  • Visibility of form fields and pages – ability to show/hide/enable/disable fields and pages using conditional evaluation
  • Visibility of workflow actions (new in version 5.0) – ability to show/hide workflow actions (buttons that can trigger workflow processes) using conditional evaluation
  • Execution of Advanced Workflow Processing tasks – ability to execute Advanced Workflow Processing tasks using conditional evaluation
  • Execution of Workflow path/direction – ability to progress to different workflow paths using conditional evaluation
  • Databinding of form field – ability to bind data to form field using conditional evaluation

 

Common Properties

Conditional evaluation generally follows a common expression of

FIELD  OPERATOR VALUE

Where

  • Visibility/Databind Field:  This property dynamically generates a list all the data-captured fields available in the form.  The value of the selected field is used for comparing to the value provided from the Value property.  For some selected Operator this property is not required and ignored.
  • Visibility/Databind Operator:  This property contains a list of support comparison operators.  Refer to table below for more details
  • Visibility/Databind Value:  This property is used as the right side of the comparison operator when evaluation the conditional expression.  The property also support single bracket tokens

 

Supported Operators

OperatorDescription
EqualsEvaluates to true if Field and Value are exact match.  This is a case-sensitive comparison.
Not EqualsEvaluates to true if Field and Value are not equal.  This is a case-sensitive comparison.
Less ThanEvaluates to true if Field is less than Value.  Generally used for numeric value comparison only.  When a non-numeric value is provided the value will be converted to 0 for use in the comparison.
Less Than or EqualsEvaluates to true if Field is less than or equals to Value.  Generally used for numeric value only.
Greater ThanEvaluates to true if Field is greater than Value.  Generally used for number value comparison only. 
Greater Than or EqualsEvaluates to true if Field is greater than or equals to Value.  Generally used for number value comparison only. 
ContainsEvaluates to true if Value exists in Field.
Empty or EqualsEvaluates to true if Field is empty or equals to Value.
Empty or Not EqualsEvaluates to true if Field is empty or not equals to Value.
Empty or ContainsEvaluates to true if Field is empty or contains Value.
Not ContainsEvaluates to true if Field does not contain Value. 
Empty or Not ContainsEvaluates to true if Field is empty or not contains Value.
In ListEvaluates to true if Field is contained in the provided Value list.  Each item in the list must be separated by a coma (,). 

For example, the following conditional expression evaluates to false
Field:  34
Value: 23,43,46
Not In ListEvaluates to true if Field is NOT in the provided Value list.  Each item in the list must be separated by a coma (,).
State In ListEvaluates to true if the Current Workflow State is in the provided Value list.  Each item in the list must be separated by a coma (,).  The Field property is ignored when this operator is selected.

For example, the following conditional expression evaluates to true
Current State: Submitted
Value: New, Submitted, Closed
State Not In ListEvaluates to true if the Current Workflow State is NOT in the provided Value list.  Each item in the list must be separated by a coma (,).  The Field property is ignored when this operator is selected.
DNN Role In ListEvaluates to true if the one of the DNN Roles of the current logged on user belongs to the provided Value list.  Each item in the list must be separated by a coma (,).  The Field property is ignored when this operator is selected.
DNN Role Not In ListEvaluates to true if the one of the DNN Roles of the current logged on user does NOT belong to the provided Value list.  Each item in the list must be separated by a coma (,).  The Field property is ignored when this operator is selected.
Custom Role In ListEvaluates to true if the one of the Custom Form Roles of the current logged on user belongs to the provided Value list.  Each item in the list must be separated by a coma (,).  The Field property is ignored when this operator is selected.
Custom Role Not In ListEvaluates to true if the one of the Custom Form Roles of the current logged on user belongs to the provided Value list.  Each item in the list must be separated by a coma (,).  The Field property is ignored when this operator is selected.
Boolean ExpressionProvides an advanced method conditional evaluation.  Click here for more details.

Tags:
footer
Update :: July 31, 2010