Share via


Opening a Report in the Microsoft Dynamics NAV Web Client by Using a URL

You can open a specific report in the Microsoft Dynamics NAV Web client by typing the report's URL in the address of a web browser. After you have the URL of a report, you can use it as a hyperlink to the report, which you can include in other sources, such as emails or Word documents, or send to other users.

Important

Certain data in the URL, such as company name, could be considered sensitive information. Use discretion if you distribute URLs that contain the company name, or if it is possible, exclude this information from the URL.

This topic includes the following sections:

  • Example

  • Report Address Syntax

  • Building the Report Address

  • Report Address Parameters

Example

The following address displays report 5 Receivables – Payables for the CRONUS International Ltd. company. The page is displayed in a Microsoft Dynamics NAV Web client that is running on port 8080 of a computer that has the name MyWebServer.

http://MyWebServer:8080/DynamicsNAV80/WebClient/report.aspx?report=5&company=CRONUS%20International%20Ltd. 

There are several parameters that define the URL for the report. These parameters are described in the URL Parameters section of this topic.

Note

Unlike pages, you cannot filter the data in a report using the URL.

Report Address Syntax

The address for opening a report in the Microsoft Dynamics NAV Web client has the following syntax.

<http|https>://<webserver>[:<port>]/<webserverinstance>/WebClient/report.aspx?report=<ID>&[tenant=<tenantID>]&[company=<companyname>]

Syntax Key

The following table describes the notation that is used to indicate address syntax.

Notation Description

Text without brackets

Parameters that you must type as shown.

<>

A placeholder for values that you must supply. Do not include the brackets in the address.

[ ]

Optional parameters. Do not include the brackets in the address.

|

A set of values from which to choose. Use one of the options and do not include | in the address.

Building the Report Address

Use the following guidelines to write report URL syntax and create a URL:

  • Place parameters in any order after report.aspx? because the order is not important. For example, report.aspx?company=CRONUS%20International%20Ltd.&report=5 yields the same as report.aspx? report=5&company=CRONUS%20International%20Ltd..

  • Separate parameters after aspx? with the ampersand symbol (&).

  • Use %20 for any spaces in values and names.

Report Address Parameters

The following table describes the parameters of the URL for displaying a report.

Parameter Description

http|https

Specifies the Internet protocol to use. Valid options are http and https.

The https protocol helps secure the Microsoft Dynamics NAV data that is transmitted over the Internet. To use https, Secure Sockets Layer (SSL) must be enabled on the connection to Microsoft Dynamics NAV Web client. For more information, see How to: Configure SSL to Secure the Connection to Microsoft Dynamics NAV Web Client.

webserver

Specifies the name of the computer that is running Microsoft Dynamics NAV Web client.

port

Specifies the server port on which the Microsoft Dynamics NAV Web client is running. The default port is 8080.

webserverinstance

Specifies the name of the web server instance for the Microsoft Dynamics NAV Web client. On IIS, this is the alias of the virtual directory of the web server instance.

When you install the Microsoft Dynamics NAV Web client using Microsoft Dynamics NAV Setup, the web server instance is given the same name as the Microsoft Dynamics NAV Server instance that it connects to. If you use the New-NAVWebServerInstance cmdlet to add Microsoft Dynamics NAV Web client instances, then you specify the web server instance name. For more information, see How to: Set Up Multiple Web Server Instances for the Microsoft Dynamics NAV Web Client.

report.aspx

Specifies the name of the active server page (.aspx) file to use to display the report.

Hh997062.note(en-us,NAV.80).gifNote
Instead of report.aspx, you can also use any of the following aspx files that are associated with pages: card.aspx, list.aspx, or blank.aspx. Microsoft Dynamics NAV Web client will automatically redirect to the report.aspx, regardless of the type that you set.

ID

The ID of the report in Microsoft Dynamics NAV.

tenant

Specifies the ID of the tenant to connect to. You must provide this parameter when Microsoft Dynamics NAV is deployed in multitenant architecture. The tenant that you specify must be mounted on the Microsoft Dynamics NAV Server instance that the Microsoft Dynamics NAV Web client connects to. For more information, see Multitenant Deployment Architecture.

company

The name of the company in Microsoft Dynamics NAV for which you want to display the page.

If you do not choose a company, then Microsoft Dynamics NAV Web client uses the company that is defined in the web.config file. If no company is defined in the web.config file, then the last company opened by the user is displayed.

See Also

Tasks

How to: Install the Web Server Components
How to: Open the Microsoft Dynamics NAV Web Client

Concepts

Deploying the Microsoft Dynamics NAV Web Server Components
Developing for the Microsoft Dynamics NAV Web Client