URL Access Syntax

SQL Server 2008 Books Online (October 2009)

URL Access Syntax

You can access the report server by using a URL. URL requests can contain multiple parameters that are listed in any order. Parameters are separated by an ampersand (&) and name/value pairs are separated by an equal sign (=).

Syntax


            protocol://
            server
            /
            virtualroot
            ?[/
            pathinfo
            ]&prefix:param=value[&prefix:param=value]...n]

Arguments

protocol: The protocol of the URL. For example, http:// or https://.

server: The name of the computer on which the report server is running. This can include a fully qualified domain name, for example: machine.adventure-works.com.

vitualroot: The name of the virtual root of the report server.

?: The item path and parameter portion of the URL.

[/ pathinfo ]: The full path name of the item being accessed in the report server database.

&: Used to separate name and value pairs of parameters.

prefix

Optional. A parameter prefix (for example, rs: or rc:) that accesses a specific process running within the report server. If a parameter prefix for a parameter is not included, the parameter is processed by the report server as a report parameter.

Note:
If you include a report parameter in a URL, do not preface the report parameter with a parameter prefix.

param: The parameter name.

value: URL text corresponding to the value of the parameter being used.

Example

The following example renders a report in HTML 4.0 format.

http://servername/reportserver?/SampleReports/Employee Sales Summary&rs:Command=Render&rs:format=HTML4.0

Note:
Any space characters in the URL string are replaced with the characters "%20," according to URL encoding standards. Similarly, a space character in the parameter portion of the URL is replaced with a plus character (+), and a semicolon in any portion of the string is replaced with the characters "%3A." Browsers should automatically perform the proper URL encoding. You do not have to encode any of the characters manually.

Note:

Any space characters in the URL string are replaced with the characters "%20," according to URL encoding standards. Similarly, a space character in the parameter portion of the URL is replaced with a plus character (+), and a semicolon in any portion of the string is replaced with the characters "%3A." Browsers should automatically perform the proper URL encoding. You do not have to encode any of the characters manually.

Reference

Concepts

Other Resources

Help and Information