Conditional Wiring of Form Items

Conditional Wiring allows you to configure your form to show, hide, enable, disable, request and update the fields or buttons based on user selections.It can be thought of as conditional branching, where certain fields will branch from others based on the conditions you set.



A condition can have any number of actions and vice-versa. Following probabilities are possible in Conditional Wiring:

  • One condition wired to multiple actions.
  • Multiple conditions wired to one action. In this type, either all the conditions must match to perform the action if 'All' is selected or any one of the conditions must match to perform the action id 'Any' is selected.
  • Multiple conditions wired to multiple actions.

In the subsequent steps, let's lookat the details to apply Conditional Wiring Logic in Form Designer.

Example:

  1. Click Create > Form


      2. Create a form as per the requirement. In this example, a Register form is created using the form components.

     3.  Click the Conditional Wiring icon in the form designer screen.



      4.  Click Create New to create a new condition. To edit an existing condition, click the condition listed on the left pane.



      5.  For this example, let's set the Conditional Wiring logic to disable the I Agree terms & conditions check box if the Passwordis empty or if the Password is 123456. Configure the conditional wiring screen as per the              folllowing table:


Previous conditions and actions will be in collapsed state when a new condition is added.

#

Property

                                                                                           Description

Sample Values

1

                                                                                                                                                 Condition

2

If

Item ID of the form component for which the condition is set.

CHECK_BOX906

3

State

Enables the user to provide the state of the condition.

  • Equals - Executes the action if value of the form component equals the value mentioned in the condition.
  • Not equals - Executes the action if value of the form component does not equal the value mentioned in the condition.
  • Is selected - Executes the action if value of the form component mentioned in the value field is selected.
  • Is empty - Executes the action if value of the form component is empty.
  • Is not empty - Executes the action if value of the form component is not empty.

Is selected

4

Value

Value required for the form componentto execute the action based on thecondition set in State field.

N

5

Add another condition ( )

Click the icon to add another condition.

NA

6

All

Executes the action only if all the conditions match.


7

Any

Executes the action if any of the conditions match.

Selected

8




9

Action

If State of the form component match with value, following actions can be executed for the form component mention in the Field name:

  • Show
  • Hide
  • Enable
  • Disable

Disable

10

Field Name

Item ID of the form component which will show/hide/enable/disable if the condition is met.

CHECK_BOX906

11

Add another action ( )

Click the icon to add another action.


12

Save

Saves the Conditional Wiring configuration.