The Action field is an advanced dynamic field that allows for the customization of up to 5 buttons with user interactions. In addition, simply set the field's value based on which button is pressed to drive other field conditional properties like visibility, read-only, or required, etc.
The user interactions available vary from simply uploading a form, navigating between form pages, opening links or launching other screens, and passing parameters, to mention a few.
User Interactions
Interaction | Parameter |
Create Email To | Launches the default mail client. Specify the desired email address to create an email, using static text or field values. Pass values from fields in this Form by using {{dataname}} syntax. |
Create SMS To | Launches the default messaging app. Specify the desired phone number to create SMS for, using static text or field values. Pass values from fields in this Form by using {{dataname}} syntax. |
Dial Phone Number | Launches the default phone dialer. Specify the desired phone number to dial, using static text or field values. Pass values from fields in this Form by using {{dataname}} syntax. |
Exit Without Saving | Pertains only to Form screens. Allows the user to exit the form without saving. |
Exit & Save Changes | Pertains only to Form screens. Allows the user to save their changes and exit the form. |
Force Sync | Forces the mobile app to synchronize with the server. |
Geocode Address | Geocoding attempts to convert address text into decimal latitude/longitude coordinates. The geocoded co-ordinate result (if any) is populated into this Interaction field. Result is "lat lon", e.g. -13.3823724 153.9832837 Specify the address to geocode with static text or use Form fields with {{dataname}} syntax. e.g. 5 My Road, My City, My Post Code, Country or {{number}}, {{road}}, {{city}}, {{countrycode}} |
Jump To Form Location | General
Repeats/Tables
Form Page
|
Open Doc | Target a published Files & Doc or load dynamically by specifying the unique ID or external ID of the Doc to open, using static text or field values. Pass values from fields in this Form by using {{dataname}} syntax. |
Open Entry | Specify the Entry ID for the target Form Entry. Reference columns from the App Entry Drafts or App Entry History data source by using {{this[column]}} syntax. e.g. {{this[2]}} will pass the 3rd column's value for the current selected row. Including Reload On Return options. |
Open Screen | Target a published screen and send parameters to the target screen, passing values from fields in this Form by using {{dataname}} syntax. For Form targets, you can preset target fields with "dataname:value", pipe separated. e.g. field1:{{city}}|field4:hello For Listing & Map targets, you can pass in a formula for filtering the target rows. Use {{target[column]}} for target columns. e.g. {{target[3]}} >= {{price}} For Detail and Task Details targets, pass the identifier of the target data row or Task. For data rows, the identifier must match the first column's value e.g. {{mychoice}} Including Reload On Return options. |
Open Task | Specify the Task ID for the target Task. Reference columns from the App Tasks data source by using {{this[column]}} syntax. e.g. {{this[2]}} will pass the 3rd column's value for the current selected row. Including Reload On Return options. |
Open URL in App | Loads the given web page URL directly within the app, provided the user has network connectivity at the time of opening. |
Open Link in Web Browser | Specify the web address to open, using static text or field values. Pass values from fields in this Form by using {{dataname}} syntax. |
Refresh Screen | NA |
Save Without Exiting | Pertains only to Form screens. Saves the form entry without exiting the form. |
Show Address On Map | Specify the address text to open, using static text or field values. Pass values from fields in this Form by using {{dataname}} syntax. e.g. 5 My Road, City, Post Code, Country or {{myaddressfield}}, {{mycityfield}}, {{mycountrycode}} |
Show Co-ordinates on Map | Specify the map latitude and longitude coordinates, space-separated, using static text or field values. Pass values from fields in this Form by using {{dataname}} syntax. e.g. -12.345678 76.54321 or {{mylocationfield}} |
Upload Form and Print | Uploads the form and prints the form entry. |
Upload Form | Uploads the form to the server. |
Coupled with numerous user interactions the Action field has a few unique properties that can be useful, scenario depending.
Layout & Styling | |
Flexible Columns | By default, buttons are shown in fixed positions on the screen. This option will instead use flexible columns, which means positions will be determined by the number of buttons. |
Advanced Options | |
Always Trigger On Button Press | By default, buttons will only trigger dependent formulae once; on the first time a user taps. Use this option to specify that formulae must be triggered every time the button is pressed. This is useful for scenarios such as counters/clickers where the field's value increments on each button press. e.g. a Number field with Dynamic Value of: IF(NOTBLANK({{button}}), VAL('numfield')+1, 0) |
Interaction Result | By default, this field is populated with the title of the button last pressed by the user. This option lets you specify a static answer value that is always set into this field, no matter which button is pressed. |
Display Result To User | Whether or not to display this field's result to the user as inline text below the buttons. The value displayed would either be the title of the last button pressed or the Interaction Result (if specified). |
Was this article helpful?
That’s Great!
Thank you for your feedback
Sorry! We couldn't be helpful
Thank you for your feedback
Feedback sent
We appreciate your effort and will try to fix the article