Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Section
Column

The Visual Rules Builder enables non-technical designers to add dynamic behaviors to a form/flow. Here are several behaviors that you can create:

  • Show/Hide a Control(s) based on a specified condition
  • Show/Hide Steps in a flow based on the step that the flow is currently executing
  • Dynamically setting default values and control properties such as valid, printable, required and more.
  • Compute a Subtotal and Total

  • Populate fields with the logged in user’s information

  • Concatenate field data

  • Populate a Date field when the user signs

and much more.... Refer to Rule Examples to see how to use the Visual Rule Builder to create common rules for real world situations.Image Removed

Image Added

 Watch this webinar for an overview of how to create dynamic forms/flows without writing code.

Column
width240px

 On this page:

Table of Contents
maxLevel1

...

If you want your rule to run Only when the form loads - check the Initialization Only checkbox at the top of the wizard. Typically, you would check this if there is some business logic that you want to to execute before the form/flow displays and users begin interacting with it.

...

When the rule displays in the Rule Builder tab, it will indicate that the rule has been flagged to run only when the form loads, if this checkbox is checked. This feature will be helpful for creating rules in future versions of the Visual Rule Builder.

Image Added

Rule Builder Wizards

The

Frevvoproduct
Rule Builder walks you thru through three easy steps to define your condition and actions.

...

The following functions are available in the Rule Builder for building expressions. Function names may be entered in any case (case insensitive).
Image Removed

Image Added

Functions are entered into the Enter an Expression field in the wizards.

Image Added

This field has two modes:

  • Lookup Mode
  • Help Mode

Lookup Mode

Lookup mode displays functions and controls from your form/flow. The functions matching the typed text are displayed first followed by the form/flow controls.

Lookup Mode can be triggered by:

  • Selecting the down arrow (must not be in Help Mode)
  • Entering text into the expression control.

is triggered as you enter text in the Value fields of the wizards.

Image Added

Help Mode

Help mode - syntax information and an example - Help Mode shows help text for the function in the expression control's dropdown area. The help information includes:

  • function syntax
  • summary info about the function
  • an example
  • parameter information.

Image Added

Operators
 

Use these operators to build useful expressions

Image RemovedImage Added

Action wizard 

...

Future Releases of the Visual Rule Builder

This is version 1 of the Rule Builder. More common rule patterns will be available in future releasesWe’re constantly working on improving our product to reduce the need to write code. Making JavaScript rules easier is one of the highest priority items.

Info

This version of the Visual Rule Builder does not currently support screenflows that use the Navigation toolbar to move back and forth between screenflow steps.

Examples

Expand
titleClick here for Example 1

Example 1:

You are designing a weekly Time Sheet that has fields where the user must enter the From and To dates for the reporting period.

Rule Requirement: If the date entered in Period To is equal to or earlier than the date entered in Period From field show this error message "Must be after From Date"

The Condition and Action wizards for this rule are show in the image.

Image Removed

This is how the rule displays in the Rule Builder tab.

Image Removed

If the user enters 3/7/2017 or a date before 3/7/2017 in the Period To field the error message displays.

Image Removed

Expand
titleClick here for Example 2

Example 2:

You are designing an Expense Report workflow that has a total of 3 steps. Steps 2 (Manager Approval step) and step 3 (Accounts Payable step) are Linked Steps.

  • Step 1 is filled in by the employee. When it is completed, the flow is routed to the employee's manager for Approval/Rejection
  • Step 2 is performed by the Manager. If the Manager approves, the workflow is routed to the Accounts Payable group for final processing.
  • Step 3 is performed by the first person in the Accounts Payable group to click the perform icon on their Task List for this workflow.

Rule Requirement: The section named Accounts Payable Only should only show if the workflow is on the Accounts Payable step. It should not be visible when the workflow is on the steps performed by the employee or the manager.

The Condition, Action and Else Action wizards for this rule are shown in the image. The dropdown for the current step value displays the linked steps as choices.

Image Removed

This is how the rule displays in the Rule Builder tab.

Image Removed

The image shows what the user sees when the workflow navigates to the Accounts Payable step.

Image Removed

...

titleClick here for Example 3

Let's take a look at a simple example. Imagine a form with 3 fields named Name, Status and Money.

Rule Requirement: If the Name field contains "John" and the Status field contains "satisfied" then populate the Money field with 50000.00 else populate the Money field with 1000.00.

One way to write this rule in JavaScript is to use nested if statements:

Code Block
languagejs
if(Name.value=='John')
{
	if(Status.value=='satisfied')
	{
		Money.value=50000;
	}
}
else
{
Money.value=1000;
} 

If you are using the Visual Rule Builder to achieve the same result, you will have to add two rules:

...

The Rule Examples chapter shows you how to use the Visual Rule Builder to create common rules for real world situations.

Info
  • The User Info, Numeric, Boolean and Date/Time functions, added to the Visual Rule Builder, are not available in the Precondition Rule Builder. Only the following operators are supported in precondition expressions:
    • + (add and concat)
    • -
    • * (multiply)
    • /