Action Field Type

Created by Anthony Young, Modified on Tue, 14 Jun, 2022 at 1:46 PM by Anthony Young


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


InteractionParameter
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 SavingPertains only to Form screens. Allows the user to exit the form without saving.
Exit & Save ChangesPertains only to Form screens. Allows the user to save their changes and exit the form.
Force SyncForces 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 LocationGeneral
  • Start of Form
  • End of Form
  • Next Page
  • Previous Page

Repeats/Tables

  • Add New Repeat/Row
  • Next Repeat/Row
  • Previous Repeat/Row

Form Page

  • Page1, 2, 3, 4, 5...
Open DocTarget 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 ScreenTarget 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 AppLoads 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.

e.g. http://www.example.com?val1={{city}}

Refresh ScreenNA
Save Without ExitingPertains 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 PrintUploads the form and prints the form entry.
Upload FormUploads 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

Let us know how can we improve this article!

Select at least one of the reasons

Feedback sent

We appreciate your effort and will try to fix the article