- Getting Started
- Before You Begin
- How To
- Build Your First App
- Build a Mobile-friendly App
- Embed Apps
- Embed Maps
- General User Experience Guidelines
- Hide Containers Using a Button
- Include Excel Charts in Apps
- Include MailTo Links
- Include Star Ratings
- Use Count With Choice Set Values
- Use Document Viewer
- Use Master Detail View
- Use Selected Values From a Table
- Use the Send Interim Result Activity
- Set External Context
- Work With Data Source and Value Bind
- Notifications
- Designing your App
- Events and Rules
- Rule: If-Then-Else
- Rule: Open a Page
- Rule: Open URL
- Rule: Close Pop-Over/Bottom Sheet
- Rule: Show Message
- Rule: Show/Hide Spinner
- Rule: Set Values
- Rule: Start Process
- Rule: Upload File to Storage Bucket
- Rule: Get File From Storage Bucket
- Rule: Reset Values
- Rule: Create/Update Entity Record
- Rule: Delete Entity Record
- Rule: Add to Queue
- Function: And, Or, Not
- Function: Concat
- Function: Contains
- Function: Count
- Function: EndsWith
- Function: If
- Function: IsBlank
- Function: Guid
- Function: Length
- Function: List
- Function: StartsWith
- Function: Sum
- Function: Sort
- Function: Now
- Function: Today
- Function: Time
- Function: Year
- Function: Month
- Function: Day
- Function: Hour
- Function: Minute
- Function: New
- Function: Lookup
- Function: Filter
- Leveraging RPA in your App
- Leveraging Entities in Your App
- Leveraging Queues in Your App
- Application Lifecycle Management (ALM)
- Basic Troubleshooting Guide
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 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 allow your app to take an action when a certain event occurs. Below is a list of the rules that Apps provides:
Rule |
Description |
---|---|
Provides support for conditional statements in the rules builder | |
Opens a page of the app as a pop-over or as the contents of a page container | |
Opens a URL in the browser | |
Closes the current Pop-Over | |
Show a message as a toast notification | |
Show or hide a spinner overlay to show the app as busy | |
Set the value of a property | |
Starts an Automation | |
Uploads files to a selected 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. |
Create or updates an entity. | |
Deletes an entity from Data Service. | |
Adds an item to queue. |