Actions: Utility
answer dialog
Displays a dialog box with a given message and 1-3 choices as buttons.
| Argument | Description |
|---|---|
| interfaceTextColor | The color of the header and buttons (variable or input). If the argument is empty, the default dialog text color in the player settings will be used. |
| iconID | The ID of the blob that will be displayed as an icon on the answer dialog. If the argument is empty, the icon set in the player settings will be used. |
| Title | The text displayed in the header (variable or input). |
| Choice1 | A variable or input to be displayed as a button in the dialog box. |
| Choice2 | A variable or input to be displayed as a button in the dialog box. |
| Output | The location where the selection will go (variable or text or field element). |
| Message | A variable or input to be displayed in the dialog box. |
| Choice3 | A variable or input to be displayed as a button in the dialog box. |
| interfaceColor | The color of the header and buttons (variable or input). If the argument is empty, the default dialog interface color in the player settings will be used. |
blank action
This is an action you can type into to quickly filter from the list of all Appli actions. Clicking or pressing enter in the auto-completion field turns the blank action into the selected action. Any remaining blank actions get deleted when you press ‘Apply’ .
check internet status
Checks the status of the internet connection, and returns ‘true’ or ‘false’.
| Argument | Description |
|---|---|
| Output | The location where the internet connection status will go (variable or element) |
combine multiple values
Combines two or more values together and places the result in a Variable or Text element.
| Argument | Description |
|---|---|
| Value6 | A variable, input, text or field element to be combined. |
| Value4 | A variable, input, text or field element to be combined. |
| Separator | A separator placed between the values being combined. Use ‘LF’ for a line feed. |
| Value1 | A variable, input, text or field element to be combined. |
| Value3 | A variable, input, text or field element to be combined. |
| Output | The location where the combine value will be stored (variable, element). |
| Value2 | A variable, input, text or field element to be combined. |
| Value5 | A variable, input, text or field element to be combined. |
combine values
Combines two values (input, variable, text or field element) and stores the result in a specified variable.
| Argument | Description |
|---|---|
| Value1 | A variable, input, text or field element to be combined. |
| Separator | A separator placed between the two values being combined. Use ‘LF’ for a line feed. |
| Value2 | A variable, input, text or field element to be combined. |
| Output | The location where the combination of the two values will be stored (variable, element). |
comment
Add a helpful comment to your code.
| Argument | Description |
|---|---|
| TheComment | The comment string to display |
compose text message
Compose a text to send to the recipient with the given text body.
| Argument | Description |
|---|---|
| Recipient | The recipient of the text’. You can seperate multiple addresses using a comma. |
| Text | The text to send to the recipient |
count down timer
Start a countdown on the selected element until it reaches 0.
| Argument | Description |
|---|---|
| Element | The field or text element to count down. |
create UUID
Create a random UUID (v4).
| Argument | Description |
|---|---|
| Variable | The variable that will store the UUID |
dispatch event
Have Appli process an event anywhere in the current app.
| Argument | Description |
|---|---|
| Event | Select an event to dispatch. |
| Target | A target screen or element that contains the event you want to activate. |
| Result | Optional output to a variable or element containing details about how the dispatch was processed: handled, unhandled, or passed. |
| CustomEvent | The custom event name to be dispatched. |
email pdf
Emails the specified element’s rectangular boundary of a given screen as a pdf file.
| Argument | Description |
|---|---|
| Subject | The subject of the email. |
| Body | The body of the email. |
| Screen | The screen to be emailed. |
| Element | An element whose rectangular boundary specifies the area of the screen to be emailed as a pdf. |
| Recipient | The email where the pdf will be sent. |
| FromEmail | The email that will be displayed as the sender’s email. |
filter duplicate lines
Removes duplicate lines from a list.
| Argument | Description |
|---|---|
| Input | The variable or text or field element that contains a line-delimited list. |
| Output | The location to store the filtered list (variable or text or field element). |
filter lines
Filter lines from a list.
| Argument | Description |
|---|---|
| ListToFilter | A variable that contains a line-delimited list. |
| Operator | Which operator (with or without) to filter the lines by. |
| Filter | A variable that contains a line-delimited list. |
| Output | The variable to store the filtered list. |
get character count
Retrieves the number of characters in the specified text.
| Argument | Description |
|---|---|
| Input | The variable or field or text element whose characters will be counted. |
| Output | The location where the result will go (variable or field or text element). |
get element value
Retrieves the value of the specified element.
| Argument | Description |
|---|---|
| Element | The element (dropdown, field, radio, slider, switch, date, time, checkbox, or text) whose value will be retrieved. |
| Output | The location where the result will go (variable or dropdown, field, radio, slider, switch, date, time, checkbox, or text element). |
get orientation
Retrieves the current orientation of the screen (portrait or landscape).
| Argument | Description |
|---|---|
| Output | The location where the result will go (variable or text or field element). |
get platform
Retrieves the specific platform of the current device (Windows, MacOS, iOS, Android).
| Argument | Description |
|---|---|
| Output | The location where the result will go (variable). |
get platform color
Retrieves the color of the platform’s background.
| Argument | Description |
|---|---|
| Output | The location where the result will go (variable or field or text element). |
get playground info
Get useful information about the state of Appli’s playground. lastMouseClickLoc, lastClickLoc H, lastClickLoc V, lastMouseLoc, lastClickLine, playgroundWidth, playgroundHeight.
| Argument | Description |
|---|---|
| VariableName | The array variable that will contain the playground information keys. |
get screen rect
Retrieves the dimensions of the screen’s rectangle of the current device. If there are multiple screens, the rectangle of the screen containing the app’s center location is returned. Results are output in the format width,height in pixels.
| Argument | Description |
|---|---|
| Output | The location where the result will go (variable or field or text element). |
get tax
Retrieves the tax rate of a given location.
| Argument | Description |
|---|---|
| Address | A variable containing the address of the location. |
| City | A variable containing the city of the location. |
| Zip | A variable containing the zip of the location. |
| Output | The location where the result will go (variable or text or field element). |
get text offset
Retrieves the character position of the first occurrence of the text to find in the text to search.
| Argument | Description |
|---|---|
| Output | The location where the result will go (variable or field or text element). |
| TextToFind | The input, variable, or field or text element whose text you want to find. |
| TextToSearch | The variable or field or text element whose text will be searched. |
get version
Retrieves the current version of Appli IDE or Appli Player the device is running.
| Argument | Description |
|---|---|
| Output | The location where the result will go (variable or text element). |
hide element
Hide an element.
| Argument | Description |
|---|---|
| Element | The element to hide |
hide loading
Hides the loading dialog box.
lock screen
Locks the screen to prevent actions from being visible on the screen.
play audio clip
Plays a sound from a file. Supported formats are WAV & MP3.
| Argument | Description |
|---|---|
| AudioFilePath | The path to the audio file to play. |
remove whitespace
Removes leading and trailing whitespace from the specified input.
| Argument | Description |
|---|---|
| Input | A variable or a text or field element whose contents will have its leading and trailing whitespace removed. |
| Output | A variable or a text or field element where the result will go. |
replace text
Replaces the specified text from the provided source with other text and stores the result in a variable or text or field elenent.
| Argument | Description |
|---|---|
| textToReplace | A variable, input, text or field element containing the piece of text that will be replaced. |
| replacementText | A variable, input, text or field element containing the replacement text. Use ‘LF’ for a line feed. |
| originalText | A variable, input, text or field element containing the original text that will be modified. |
| Output | The location where the modified text will be stored (variable, text or field element). |
reset element
Resets the specified element to its default state. Supported elements: field, radio, search, dropdown, login, create account, image.
| Argument | Description |
|---|---|
| Element | The element to reset. |
set element value
Sets the value of the specified element.
| Argument | Description |
|---|---|
| Element | The element (dropdown, field, radio, slider, switch, date, time, checkbox, or text) whose value will be set. |
| Value | The value the specified element will store (input, variable or dropdown, field, radio, slider, switch or text element). |
set item separator
Set the item separator for this code block.
| Argument | Description |
|---|---|
| Separator | Specify the string character(s) that will act as an item separator within (this) event’s code |
set platform color
Sets the color of the platform’s background.
| Argument | Description |
|---|---|
| Color | The color or a variable storing a color (RGB or hex code) to set the platform’s background to. |
show element
Show an element.
| Argument | Description |
|---|---|
| Element | The element to hide |
show loading
Displays a dialog box with a given message and a loading spinner.
| Argument | Description |
|---|---|
| Message | A variable or input to be displayed in the dialog box. |
sort lines
Sorts lines from a list.
| Argument | Description |
|---|---|
| Input | The variable or text or field element that contains a line-delimited list. |
| Direction | Which direction (ascending or descending) to sort the lines by. |
| SortType | The type of data stored in each line to sort by. |
| Output | The location to store the sorted list (variable or text or field element). |
stop count down timer
Stops all countdown timers.
timer log
Record timestamped logs to time how long things take.
| Argument | Description |
|---|---|
| Label | Label/name for this timer instance |
| Action | Choose whether to start or stop the timer |
| TimerLogVariable | Variable to store the timer log entries |
| LogString | Additional text to include in the log entry |
toggle password
Show or hide password input in a field element. The “password” property must be on for this action to occur.
| Argument | Description |
|---|---|
| Element | The field element to have its password input shown or hidden. |
unlock screen
Unlocks and renders the updated screen.
wait
Wait for a specific amount of time, in milliseconds. (The wait is non-blocking).
| Argument | Description |
|---|---|
| Number | Specify the number of milliseconds to wait |
This chapter was last updated on Fri 18 Apr 2025 13:55:00 BST