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:

Updated 4 months ago