You can open a specific page in the Microsoft Dynamics NAV Web client by typing the page's URL in the address of a web browser. You can use the URL as a hyperlink to the page, which you can include in other sources, such as emails or Word documents, or you can it 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 address. |
This topic includes the following sections:
Example
The following URL displays page 9305 Sales Order List 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.
Copy Code | |
---|---|
http://MyWebServer:8080/list.aspx?company=CRONUS%20International%20Ltd.&page=9305 |
There are several parameters that define the address for the page. These parameters are described in the URL Parameters section of this topic. You can also filter the data on specific fields of the page. For information about how to filter the data, see Filtering Data on the Page.
Page Address Syntax
The address to open a page in the Microsoft Dynamics NAV Web client has the following syntax.
Copy Code | |
---|---|
<http|https>://<webserver>[:<port>][/<site>]/<card|list|blank>.aspx?<page>=<ID>&[company=<companyname>]&[mode=<View|Edit|Create>] |
The URL consists of two parts: web server part and the Microsoft Dynamics NAV content part. The web server part targets a specific site on the computer that running Microsoft Dynamics NAV Web Server components and includes the following syntax.
Copy Code | |
---|---|
<http|https>://<webserver>[:<port>]/[<site>]/ |
The Microsoft Dynamics NAV content part includes the rest of the
address after /[<site>]/
. This part of the
address is composed of an active server page extended (ASPX) file
and a query string that specifies the page to display.
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 |
Building the Page Address
Use the following guidelines to write page URL syntax and create a URL:
- Place parameters in any order after
aspx?
because the order is not important. For example, the following URLs will yield the same results.
Copy Code http://MyWebServer:8080/list.aspx?company=CRONUS%20International%20Ltd.&page=9305&mode=View
Copy Code http://MyWebServer:8080/list.aspx?page=9305&mode=View&company=CRONUS%20International%20Ltd.
- Separate parameters after
aspx?
with&
. - Use
%20
for any spaces in values and names. - Enclose values in single quotation marks
''
.
URL Parameters
The following table describes the parameters of the URL for displaying a page.
Parameter | Description | ||||||
---|---|---|---|---|---|---|---|
|
Specifies the Internet protocol to use. Valid options are
The |
||||||
|
Specifies the name of the computer that is running Microsoft Dynamics NAV Web client. |
||||||
|
Specifies the server port on which the Microsoft Dynamics NAV Web client is running. The default port is 8080. |
||||||
|
Specifies the URL path and name of the sub-site in which to display the page. If you do not specify a site, then the root or top-level site is served. A Microsoft Dynamics NAV Web client application can consist of a collection of one or more sites. For example, a company can have different Microsoft Dynamics NAV Web client sites for each department. Each site has its own path and name on the port it is run. For more information, see How to: Set Up Multiple Microsoft Dynamics NAV Web Client Applications on a Website. |
||||||
|
Specifies the name of the active server page file to use to
display the page. You can use any of the following types,
regardless what the page type is: The type that you set is not important because the Microsoft Dynamics NAV Web client will automatically redirect to the appropriate page. For example, if you use card.aspx to display a List type page, then URL is automatically redirected to the list.aspx.
|
||||||
|
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 its web.config file. If no company is defined in the web.config file, then the company last opened by the user is used. |
||||||
|
Specifies a specific record in the underlying table of the page. The value of a bookmark is an alphanumeric string of characters, for example, 27%3bEgAAAAJ7CDAAMQA5ADAANQA4ADkAMw%3d%3. For the page types Card, CardPart, and Document, the bookmark specifies the record that is shown in the page. For page types List, ListPart, and Worksheet, the bookmark specifies the record that is selected in the list on the page.
|
||||||
|
The ID of the page in Microsoft Dynamics NAV.
|
||||||
|
Specifies the mode in which to display the page.
|
Filtering Data on the Page
You can filter the data that is displayed in the page by using the filter parameter in the address. The filter parameter enables you to display only records from the underlying table of the page that have specific values for one or more fields.
Example
The following address displays data in page 9305 only for the customer who has the Sell-to Customer No. 10000 and the Location Code Blue.
Copy Code | |
---|---|
http://MyWebServer:8080/list.aspx?company=CRONUS%20International%20Ltd.&page=9305&filter='Sell-to%20Customer%20No.'%20IS%20'10000'%20AND%20'Location%20Code'%20IS%20'BLUE' |
Filter Syntax
The filter has the following syntax.
Copy Code | |
---|---|
&filter='<field>'%20IS%20'<value>'[%20AND%20'<field>'%20IS%20'<value>'] |
You can add the filter anywhere in the address after
.aspx?
.
Tip |
---|
The filter syntax for a page in the Microsoft Dynamics NAV Web client is the same as page in the Microsoft Dynamics NAV Windows client, which you can see by choosing the Copy Link to Page action on the Application menu in the Microsoft Dynamics NAV Windows client. |
Filter parameters
The following table describes the filter parameters.
Parameter | Description |
---|---|
|
The name of the table field on which to filter. |
|
Specifies the equal operator. |
|
The value of the table field on which to filter. |
|
Use this parameter to specify more than one filter. It specifies
an “and” operator for adding additional filters. Place
To be included in the page data, the table record must match values for all fields in the filter. |