ATLAS FormBuilder - Introduction to Conditional Statements

This document explains conditional statements and their use in different areas of FormBuilder.

In multiple locations across FormBuilder, settings provide the ability to create conditional statements, which are used to specify when certain form functions trigger or how they operate, based on a customizable set of conditions.

Conditional statements operate on boolean logic, meaning that they read data from the form, compare that data to their condition(s), and then evaluate it as either "true" or "false." If the statement evaluates as true, the related form setting will trigger in relation to the read data.

The areas of FormBuilder where settings involving conditional statements can be found are:

  • Routing triggers

    • The "Trigger Condition" field of each routing trigger's editing menu comes in the form of a conditional statement, which is used to determine when the routing trigger should execute its routing actions.

      The "Trigger Condition" field of a form's routing trigger.

  • Phase permissions

    • Checking the "This permission only applies to forms with the following properties" checkbox in the editing menu of a phase permission causes the appearance of a conditional statement entry field, whose condition(s) must be met for the permission to be granted to its listed users.

      The optional conditional statement in the editing menu of a phase permission.
  • Aggregate form views

    • Checking the "Additional Filtering" checkbox in the "Filter Responses By" section of an aggregate form view's edit page will cause the appearance of a conditional statement entry field, which will filter the aggregate view down to only include responses that meet its condition(s).

      The optional conditional statement of the "Additional Filtering" field in a form's aggregate form view.

  • Reports

    • When running a report of any type from a form's "Export Data" page, an optional checkbox called "Additional Filtering" will be provided. Checking this checkbox causes the appearance of a conditional statement entry field, which will filter the report down to only include responses that meet its condition(s).

      The "Run Report" page of a form's report, with its optional conditional statement active.

Conditional statement fields provide a dropdown list that includes a wide variety of condition types and related options to choose from. Each condition type provides at least one additional field when selected, the customization of which allows the selection of the specific condition needed. For information on the full list of options provided by a conditional statement field, visit ATLAS FormBuilder - Trigger Conditions Explained.

While only one condition can be selected by default, a conditional statement field's dropdown list also includes options known as logical operators, which can be used to chain together more complex conditional statements. For detailed information on logical operators, visit ATLAS FormBuilder - Logical Operators in Conditional Statements.


For more tutorials on the ATLAS FormBuilder application, visit FormBuilder - Homepage.



Keywords:
ATLAS, FormBuilder, conditional, condition, statement, setting, boolean, phase, permission, routing, trigger, form, view, and, or, not, app, application 
Doc ID:
81653
Owned by:
Beckett A. in University of Illinois LAS
Created:
2018-04-18
Updated:
2024-12-17
Sites:
University of Illinois Liberal Arts and Sciences