About Events and Rules

When designing your app, you often want to provide logic for when X happens do Y. Apps provides the ability for these dynamic actions:

• X is called an Event.
• Y is called a Rule.

Here are a few examples:

• When the "Submit deposit" button is clicked, run an automation.
• When the value of the "Cash In" textbox changes, change the label color to red if the value is < 0.
• When the help icon is clicked, open the browser to show a documentation page.
• When a tab button is clicked, change the page container to show a different page.

By specifying what rules to execute when an event occurs, your app transforms from being a simple display of information to an interactive console.

Events

Events are triggers that happen when a user interacts with an app or control. Each control supports a single event:

Event	Control(s)
Clicked On	Button, Header, Label, Icon, Image
Value Changed	Checkbox, Date picker, Dropdown, Slider, Switch, Text Area, Textbox, List
Loaded	Page, Table

Rules

Rules allow your app to take an action when a certain event occurs. Below is a list of the rules that Apps provides:

Rule	Description
If-Then-Else	Provides support for conditional statements in the rules builder
Open a Page	Opens a page of the app as a pop-over or as the contents of a page container
Open URL	Opens a URL in the browser
Close Pop-Over/Bottom Sheet	Closes the current Pop-Over
Show Message	Show a message as a toast notification
Show/Hide Spinner	Show or hide a spinner overlay to show the app as busy
Set Values	Set the value of a property
Start Process	Starts an Automation
Rule: Upload file to Storage bucket	Uploads files to a selected storage bucket.
Rule: Get file from Storage bucket	Downloads files from a selected storage bucket.
Rule: Reset values	Reverts a control to a default value, or clears it if a default value is not configured.
Rule: Create/Update Entity Record	Create or updates an entity.
Rule: Delete Entity Record	Deletes an entity from Data Service.
Rule: Add to Queue	Adds an item to queue.

Reordering Rules

You can reorder rules by clicking and dragging the "gripper" on the colored chip next to the rule's name: