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/
 Security 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. |