Linking to the Microsoft Dynamics NAV Universal App
The protocol handler for the Microsoft Dynamics NAV Universal App lets you construct a URL for starting the Microsoft Dynamics NAV Universal App on a device. You can then distribute this URL by e-mail or from a Web page to the users.
The ms-dynamicsnav scheme is registered automatically when the app is installed. From this point onward, invoking a URL based on this URI scheme will start the app with the provided parameters.
Constructing the URL
To enable starting the Microsoft Dynamics NAV Universal App from a link, construct a URL with the ms-dynamicsnav scheme pointing to your Dynamics NAV Web server.
The structure of a Microsoft Dynamics NAV Universal App link is very similar to links for the Microsoft Dynamics NAV Web client and resembles this:
ms-dynamicsnav://<Server>:<Port>/<Instance>/[?tenant=<Tenant>&company=<Company>]/?profile=/?page=
| Parameter | Description |
|---|---|
| Server | Optional. The public address for your Microsoft Dynamics NAV Web client server. |
| Port | Optional. The port number for your Microsoft Dynamics NAV Web client server. If not provided, the standard SSL port (443) is used. |
| Instance | Optional. The Microsoft Dynamics NAV Web client instance that you want to connect to. |
| Tenant | Optional. The tenant that you want to connect to. If not provided, the default tenant is used. |
| Company | Optional. The company that you want to connect to. If not provided, the default company is used. |
| Profile | Optional. The profile that you want to connect with. If not provided, the default profile is used. |
| Page | Optional. The ID of the page that you want to open directly. |
| Redirect | Optional. When users run the Microsoft Dynamics NAV Web client in a browser, they will be presented with an option to download the Microsoft Dynamics NAV Universal App instead in order to improve the user experience. However, if this is not a wanted scenario, this experience can be manually overridden by adding the parameter ?redirect=0 to the URL. |
Note
It is not possible to specify which client type to open up the URL in; the last used client will open up when clicking the URL.
Warning
The URL ms-dynamicsnav:///?page=21 will open the server that you last connected to on the specified page.
URL Examples
The following examples demonstrate how to use the parameters from the table earlier in this section:
ms-dynamicsnav://myserver/myinstance/
ms-dynamicsnav://myserver:440/myinstance/
ms-dynamicsnav://myserver/myinstance/?company=MyOtherCompany
ms-dynamicsnav://myserver/myinstance/?tenant=myTenant2&company=MyCompany2
Important
The ms-dynamicsnav scheme only translates to a secure server connection. Therefore the Microsoft Dynamics NAV Tablet client and Microsoft Dynamics NAV Phone client must be exposed through an https connection. For more information, see How to: Configure SSL to Secure the Connection to Microsoft Dynamics NAV Web Client.
Adding Username to the URL
The ms-dynamicsnav scheme also supports sending the user name in the URL for prefilling the user name. The password must be entered by the user. To send the user name, you must URL encode the value and prefix the server address by using <encoded username>@. Examples are as follows:
ms-dynamicsnav://demouser%40mycompany.com@myserver/myinstance/
ms-dynamicsnav://user1:@myserver/myinstance/
Important
We recommend that you do not share a user name in the URL. This technique should only be used in demonstration scenarios and other instances where the accidental sharing of a URL will not compromise the system.
See Also
Developing for the Microsoft Dynamics NAV Universal App
How to: Open the Microsoft Dynamics NAV Tablet or Phone Client from a Browser