Linking to Microsoft Dynamics NAV for Tablets

The protocol handler for Microsoft Dynamics NAV Tablet client allows you to construct a URL for launching Microsoft Dynamics NAV for tablets on a device. You can then distribute this URL by email or from a web page to your users.

The Microsoft Dynamics NAV Tablet client will register the ms-dynamicsnav scheme on the device and launch it with the provided parameters.

Constructing the URL

To enable launching Microsoft Dynamics NAV Tablet client 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 Tablet client link is very similar to links for the Microsoft Dynamics NAV Web client and looks like this:

ms-dynamicsnav://<Server>:<Port>/<Instance>/[?tenant=<Tenant>&company=<Company>]

Parameter Description

Server

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

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

URL Examples

The following examples demonstrate how to use the parameters from the table above:

  • 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, so the Microsoft Dynamics NAV Tablet 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 with <encoded username>@. Examples are:

  • *ms-dynamicsnav://demouser%40mycompany.com@myserver/myinstance/*

  • *ms-dynamicsnav://user1:@myserver/myinstance/*

Dn757124.security(en-us,NAV.80).gifSecurity Note
We recommend that you do not share a user name in URLs. 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

Tasks

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

Concepts

Developing for the Microsoft Dynamics NAV Tablet Client