Smart Forms now support Deep Linking Elements. This will allow users to be redirected to other apps on the device.
This is implemented via the x-callback-url library, see their documentation here for more information
NOTE: Not all applications on your device may support Deep Linking so make sure to check their documentation
Adding Deep Link Element to Smart Form
The 'Deep Link' element can be found at the bottom of the Toolbox in the Form Designer.
Figure 1 - Form Designer: Deep Link Element
This element will have a General Tab (Name, Label, Description) and a Visibility Tab where users can define visibility logic for the element. The last tab 'Deep Link' is unique to the Deep Link Element.
Figure 2 - Edit Deep Link Element
Fields on Deep Link Element:
| Fields | Description | Note |
| Scheme | This is the Target Application that will be opened once clicking the deep link | The scheme may not be the app name, please refer to the applications documentation for the correct scheme name |
| Action | This is the action taken by the Target Application | Not all Deep Links require an action, please refer to the applications documentation for more information |
| Action Label Formula | The label for the button in App on the Smart Form | |
| Source | The application that the Deep Link is run from | Always "Axsy Mobile" |
| Host | The host of the Deep link | Always "x-callback-url" |
| Parameters | Any additional information that should be passed into the target application | This information can be found in the Target Application's documentation |
| Debug | Displays the Deep Link URL alongside the Action Label in App |
Table 1 - Fields on Deep Link Element
Populating Deep Link Fields with Example
Figures 3 and 4 show an example of a working Deep Link. This example will redirect the user to Google Maps to view a given location (in this case Buckingham Palace).
Figure 3 - Deep Link Element Fields: Part 1/2
Figure 4 - Deep Link Element Fields: Part 2/2
Populated Fields on Deep Link Element Example:
| Field | Value | Note | |||
| Scheme | comgooglemaps-x-callback | See the Application's Documentation | |||
| Action | In this case the Action is left blank as the parameters will define the action to be taken, as per the Google Maps Documentation | ||||
| Action Label Formula | Open Google Maps | Figure 5 shows how this manifests in the Axsy Mobile App | |||
| Source | Axsy Mobile | Default Value | |||
| Host | x-callback-url | Default Value | |||
| Parameters |
|
Table 2 - Deep Link Element Fields: Populated Example
Figure 5 shows the Deep Link in a Smart Form. Clicking the highlighted button will redirect the user to Google Maps as shown in Figure 6.
Figure 5 - Deep Link Example in Axsy Mobile
Figure 6 - Deep Link Result Example