Our 'App Links' functionality provides users the ability to launch apps directly into specific screens using special URLs that are similar to web links. By clicking these links users are able to launch the app, providing it's already installed.

An app link looks something like this: app://somescreen?myfield=somevalue

We support app launching capability via an NFC scan on Android devices. Users can tap NFC tags to launch their app based on what is read off the tag.

Creating App Links

1. Using the navigation menu click on Apps and select App Setup from the drop down. 

2. Click on 'launch options'. From here you can create launch rules and app links that will launch the app directly into specified screens.


Incoming App Link

The incoming app link has two parts.

Firstly, the URL scheme. This is the part before the :// piece and is fixed and will not change. It's part of the app links you create. It may vary based on whether you are using our standard app, or if you have your own branded version of our native app technology. 

The second, editable portion above, is important because it's extracted by the app and evaluated against the rules you specify. This determines what screen to launch into. If no rules match the incoming value, the app will launch into the start screen by default.

We recommend that you use the target screen name to make your app links more descriptive, e.g. app://inspection.

App links can include parameters by using query string syntax,
e.g. app://inspection?site=1234&condition=2 

'site' is the first parameter's name and 1234 is its value.

Note: The first parameter requires a '?' in the front. Subsequent parameter sets must be separated with an '&'.

This is the target app screen that will be opened if the launch value matches the incoming app link, and optional formula is empty or evaluates to true.

This is used to pass launch parameter values into the target screen by using #{{parameterName}} syntax. For form targets, you can preset target fields with 'dataname:value', pipe seperated.

e.g. field1:#{{city}}|field4:#{{hello}} 

For listing & mapping 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 targets, pass a value to match the first column of the target data row.

e.g. #{{mychoice}}

In most cases, the app link will be distinct enough to define your launch rule. You may have times where the same app link will need to launch one of several screens based on the parameter values on the link.

Alternatively, you may want to make a launch rule condition based on user's metadata - e.g. only allow project managers to open the link.

To do this, you will need to define multiple rules against the same app link, and specify differing results using a formula that has a True/False result. The first rule with a true formula result will be executed by the app.

Refer to app link parameter values via #{{parameterName}} syntax. For example, if the incoming app link is: MESH://inspection?perform=Yes then a formula of: #{{perform}} = 'Yes' will be True.

Did this answer your question?