Navigation:  Appendix >

Conditional Evaluation

Previous pageReturn to chapter overviewNext page

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

 

Operator

Description

Equals

Evaluates to true if Field and Value are exact match. This is a case-sensitive comparison.

Not Equals

Evaluates to true if Field and Value are not equal. This is a case-sensitive comparison.

Less Than

Evaluates 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 Equals

Evaluates to true if Field is less than or equals to Value. Generally used for numeric value only.

Greater Than

Evaluates to true if Field is greater than Value. Generally used for number value comparison only.

Greater Than or Equals

Evaluates to true if Field is greater than or equals to Value. Generally used for number value comparison only.

Contains

Evaluates to true if Value exists in Field.

Empty or Equals

Evaluates to true if Field is empty or equals to Value.

Empty or Not Equals

Evaluates to true if Field is empty or not equals to Value.

Empty or Contains

Evaluates to true if Field is empty or contains Value.

Not Contains

Evaluates to true if Field does not contain Value.

Empty or Not Contains

Evaluates to true if Field is empty or not contains Value.

In List

Evaluates 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 List

Evaluates to true if Field is NOT in the provided Value list. Each item in the list must be separated by a coma (,).

State In List

Evaluates 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 List

Evaluates 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 List

Evaluates 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 List

Evaluates 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 List

Evaluates 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 List

Evaluates 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 Expression

Provides an advanced method conditional evaluation. Click here for more details.