Share via


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