frevvo Latest - This documentation is for frevvo v10.0. Not for you? Earlier documentation is available too.
The Visual Rules Builder enables non-technical designers to add dynamic behaviors to a form/workflow. Here are several behaviors that you can create:
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....
Watch this webinar for an overview of how to create dynamic forms/workflows without writing code.
On this page:
Business Rules are executed under the following conditions:
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 execute before the form/workflow 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.
The frevvo Rule Builder walks you through three easy steps to define your condition and actions.
Describe the conditions under which a set of actions should be executed. You can specify more than one condition in the same rule but you do not need a condition.
Each condition consists of the following:
Part | Description |
---|---|
Field or current step (Optional) | What field or current workflow step do you want to evaluate? |
Operator | What condition do you want to test to see if it is true? Select to from the choices to use an expression or function in your rule |
Value (Optional) | What value do you want to compare the Field or current step to? What function/operator do you want to use to build the expression? |
The left side Field and right side Value must be of a matching type. For example, you cannot use numeric expressions with text controls. If you've selected an incompatible value type, Help Mode will show an error to help you correct it.
When you use the VRB "contains" condition on a checkbox control, you must set the literal value to the full, exact option value. On radio and dropdown controls, partial values work, but since the Checkbox value is an array, the rule is looking for the entire option value in the array and cannot find any partial value.
For example, checkbox "C" has options "Option_1", "Option_2", "Option_3". If you use the VRB rule When C contains "1", it always evaluates to false. If you change the condition to When C contains "Option_1" the rule works as expected.
The following functions are available in the Rule Builder for building expressions. Function names may be entered in any case (case insensitive).
Functions are entered into the Enter an Expression field in the wizards.
This field has two modes:
Lookup mode displays functions and controls from your form/workflow. The functions matching the typed text are displayed first followed by the form/workflow controls.
Lookup Mode is triggered as you enter text in the Value fields of the wizards.
Help mode shows help text for the function in the dropdown area. The help information includes:
Use these operators to build useful expressions:
In versions prior to v9.1, the '+' operator was used for both addition and concatenation. With the v9.1 upgrade, any '+' operators used for concatenation will be automatically updated to use the concat() function. Designers should use the concat() function for concatenation of text strings, and the '+' operator only for addition of numeric values. Using the '+' operator for concatenation will return an error prompting the designer to use concat() instead.
Declare the actions that should be taken when the condition is true. The Functions/Operators listed above can also be selected as the value in this wizard.
Declare the actions that should be taken when the condition is false. The Functions/Operators listed above can also be selected as the value in this wizard. Else Actions are optional as not all rules require them. You cannot add FALSE actions if you do not have a condition specified in the rule.
Select the Value, expression or function(optional). To enter a text value, slide the
toggle switch icon to the right and a field displays to the right.If current step is selected as the condition for a workflow designed using Linked Steps, the value dropdown displays the names of the linked steps as choices. Workflows designed with individual forms as steps (not linked) will only show that step in the current step value dropdown.
For example,
Once completed, the entire rule can be viewed in the Rule Builder tab.
Click the action menu for the rule you want to delete and select
Delete. You will be asked to confirm.It's easy to change the order of your rules. You may want to group your rules by workflow step, action or control type. Simply click and hold any rule, and drag it to the place in the list you want to move it. You may also use the "Move down," "Move Up," "Move Top," and "Move bottom" options in the rule's Action Menu.
The frevvo Rule Builder allows you to create a rule that has more than one condition. You can write a rule that performs actions based on the values of more than one field. As you select conditions, a logic expression is built and displayed at the bottom of the screen. Notice the expression uses the AND operation by default. There may be business rules that require a change to the logic expression.
Rules created with the Rule Builder are automatically converted to JavaScript and co-exist with existing JavaScript rules. Of course, you can still add JavaScript directly or edit the generated code to make manual changes to your rule once you have created it with the Rule Builder.
Clicking the Edit Code button permanently disables the Rule Builder for this rule.
We’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.
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.
The Rule Examples chapter shows you how to use the Visual Rule Builder to create common rules for real world situations.