Tuesday, November 27, 2018

Visibility Condition

Introduction

Visibility Condition allows the workflow designer to show or hide other fields based the value entered by the end-user in one field.
TIP: Visibility Condition is only available if your organization subscribes to Advanced or Ultimate plan.

Using Visibility Condition

Steps to add Visibility Condition to a field on the form design screen
1. Open the "Properties" panel of the field you want to determine the visibility based on other fields.

2. Enter the expression into the designated input

You can switch between Basic and Advanced mode while entering the expression. The expression uses Javascript expression syntax (click here to learn more).

Enter Visibility Condition in Basic Mode

In Basic mode, you can also use placeholders whose values are calculated at run-time, in your expression. For example, to show "Arrival Date" only if "Should we pick you up?" is set to "Yes, pick me up on arrival", the workflow design can use this expression: {{pickUp.value}} === "1".

"Should we pick you up?" field has Code as "pickUp"

Type {{ to show the list of available placeholders

Enter the expression
The following animation shows how this setup works when the end-user interacts with the form:

Enter Visibility Condition in Advanced Mode

TIP: Advanced Mode is only available if your organization subscribes to Ultimate plan. 

The Advanced Mode in Visibility Condition (and other similar configurations in Rethink Workflow) allow workflow designer to write advanced logic using Javascript syntax. Though it offers an extremely powerful feature, the workflow designer should consider it as the last option because of effort and programming knowledge requirement. 

The expression entered in Advanced Mode should return a boolean value to determine the visibility of the control. Only when the return value is truthy, the control will be displayed. 

The following example demonstrates how to show "Address" field only when the value entered to the "Email Address" field ends with "aduyng.com".
Once published, the following animation shows how the end-user interacts with this logic: 

3 comments:

  1. how do you input expression "or" in Basic mode. Say you have a few fields in the pickup.value. ==="1' or "2" doesn't seems to work

    ReplyDelete
  2. You can do something like this:
    {{pickup.value}} === "1" || {{pickup.value}} === "2"

    The visibility condition is following javascript syntax. Let us know if you needs more help via our support request form: https://support.rethinkworkflow.com/2019/05/how-do-i-submit-support-request.html

    ReplyDelete
  3. Thank you... that works like a charm...

    ReplyDelete

Note: Only a member of this blog may post a comment.