An Action Result is a way to temporarily remember and recall a custom value within an object. This action will allow you to manually set a value to an action result.
Parameters
Description | |
Assign the value | This is a value you wish to store in the action result. This value can be typed in by you, pulled from an existing control on the screen, or pulled from the user's session values. |
Give it a name | Type the name you will give the action result so it can be referenced later on. |
⊕ Add another action result | Click to add more than one action result to define. |
NOTE: When you give it a name, a dropdown appears with "(New)" appended to it, as shown in the above image. You must click that dropdown option to create the action result else it will be empty and you will get an error.
Notes
Be descriptive when naming action results.
e.g. "result
" is not helpful but "resultContactName
" is.Action results only exist in the control they are created in.
e.g. an action result in one button is not visible in another button.Action results store the value temporarily.
e.g. navigating to a different screen will erase the action result.Although there is no character limit for an action result, there is a maximum of 10,000 characters that can be displayed using the action Show message.
When would we use it?
Action results are a basic function of app customization. As such, it is built into a number other actions. For example, the Math Function action will calculate two values and store the result in an action result.
However, if you want to store any value, you can use this action on its own. For example, my may want to store the current time to compare to a later time. You can use this action as pictured below:
In the above image, the current date and time will be stored in the Action Result resultStartDateTime
. We can reference this action result in a later action.
Assign value to action result can also be used to clear or initialize an action result. For example, you can use an action result as a counter and you would use Assign value to action result to start the counter at zero.