Deep Link Mobile¶

The insight mobile app supports the call of functions within the app. This is realized by deep linking via URL-Scheme. These links can be forced from web pages, emails or barcode scanner apps.

Note

Every colon outside of the scheme must be URL encoded. In value text special characters like & must be URL encoded (only in value strings).

special characters	URL encoded
`:`	`%3A`
`&`	`%26`
`"`	`%22`

deep link
`insightmobile://`		Open the app and is the scheme insight is listening for
`insightmobile://server%3Ahttps%3A//my-insight-server.com`		Set the insight server
`insightmobile://config%3A{%22clientConfigUrl%22%3A%22https%3A//my-insight-server.com%22}`		Set the client configuration. The quotation marks and colon inside the rounded brackets must be URL encoded.
`insightmobile://details%3Aworkorder/WORKORDER/4408`		Show details for a record
	`4408`	is the primary key (WORKORDERID) of the workorder record
	`workorder`	is the name of the tree configuration
`insightmobile://details%3Aworkorder?WONUM=1847&SITEID=HD`		Show details by filter criteria. The first found record is opened
`insightmobile://create%3Aworkorder/WORKORDER?DESCRIPTION=Predefined text`		Show create formular with predefined values
`insightmobile://list%3Aworkorder`		Show a list
`insightmobile://list%3Aworkorder?WOPRIORITY=2`		Show a list with filter criteria

Example HTML file:

<!DOCTYPE html>
<html>
    <head>
        <meta charset="utf-8" />
        <title>Page Title</title>
        <meta name="viewport" content="width=device-width, initial-scale=1" />
    </head>

    <body>
        <a href="insightmobile://">Open my app</a><br /><br />

        <a href="insightmobile://server%3Ahttps%3A//my-insight-server.com"
            >Set server</a
        ><br /><br />

        <a
            href="insightmobile://config%3A{%22clientConfigUrl%22%3A%22https%3A%2F%2Fmy-insight-server.com%22}"
            >Set initial Config</a
        ><br /><br />

        <a href="insightmobile://details%3Aworkorder/WORKORDER/4408"
            >Open details</a
        ><br /><br />

        <a href="insightmobile://details%3Aworkorder?WONUM=1847&SITEID=HD"
            >Open details with queryParams</a
        ><br /><br />

        <a href="insightmobile://create%3Aworkorder/WORKORDER?DESCRIPTION=foo"
            >Create with predefined description</a
        ><br /><br />

        <a href="insightmobile://list%3Aworkorder">List</a><br /><br />

        <a href="insightmobile://list%3Aworkorder?ASSETNUM=M06032015"
            >List with Asset</a
        ><br /><br />

        <a href="insightmobile://list%3Aworkorder?WOPRIORITY=2"
            >List with Prio</a
        ><br /><br />
    </body>
</html>