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 Microsoft 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.

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/*

Dn757124.security(en-us,NAV.90).gifSecurity Note
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

Other Resources

Developing for the Microsoft Dynamics NAV Tablet client
How to: Open the Microsoft Dynamics NAV Tablet Client from a Browser