|
1 | 1 | --- |
2 | | -title: "Export a report by using URL access" |
3 | | -description: "Learn how to export a report using URL access by specifying the format in which to render a report by using the rs:Format URL parameter." |
| 2 | +title: "Export a report by using the rs:Format URL parameter" |
| 3 | +description: "Learn how to export a report from SQL Server Reporting Services (SSRS) in different file formats by using the rs:Format URL parameter." |
4 | 4 | author: maggiesMSFT |
5 | 5 | ms.author: maggies |
6 | | -ms.date: 03/01/2017 |
| 6 | +ms.date: 07/17/2024 |
7 | 7 | ms.service: reporting-services |
8 | 8 | ms.subservice: reporting-services |
9 | 9 | ms.topic: conceptual |
10 | 10 | ms.custom: updatefrequency5 |
11 | 11 | helpviewer_keywords: |
12 | 12 | - "formats [Reporting Services], URL rendering" |
13 | 13 | - "URL access [Reporting Services], rendering formats" |
| 14 | +#customer intent: As a SQL Server report user or administrator, I want to learn about the rs:Format parameter so I can export reports in different file formats. |
14 | 15 | --- |
15 | 16 | # Export a report by using URL access |
16 | | - You can optionally specify the format in which to render a report by using the ``rs:Format`` URL parameter. The HTML4.0 and HTM5 formats (rendering extension) render in the browser and for other formats, the browser prompts to save the report output to a local file. |
| 17 | + |
| 18 | +Learn how you can export reports from SQL Server Reporting Services (SSRS) by using URL access and the `rs:Format` URL parameter. This method allows you to render reports in various file formats, such as PDF and PPTX, directly from the report server. |
| 19 | + |
| 20 | +## Prerequisites |
| 21 | + |
| 22 | +- Access to an SSRS report server. |
| 23 | +- URLs of the reports you want to export. |
| 24 | +- Appropriate rendering extensions installed on your report server. |
| 25 | + |
| 26 | +## Specify the export format |
| 27 | + |
| 28 | +Specify the format in which to render a report by using the `rs:Format` URL parameter. The HTML4.0 and HTML 5 formats render in the browser, while other formats prompt you to save the report output to a local file. |
| 29 | + |
| 30 | +## Export a PDF report |
17 | 31 |
|
18 | | - For example, to get a PDF copy of a report directly from a native mode report server: |
| 32 | +To get a PDF copy of a report directly from a native mode report server, use the following URL command in your browser: |
19 | 33 |
|
20 | 34 | ``` |
21 | 35 | https://myrshost/ReportServer?/myreport&rs:Format=PDF |
22 | 36 | ``` |
23 | 37 |
|
24 | 38 | ::: moniker range="=sql-server-2016" |
25 | 39 |
|
26 | | - And, from a SharePoint integrated mode report server: |
| 40 | +And, from a SharePoint integrated mode report server, use the following URL command in your browser: |
27 | 41 |
|
28 | 42 | ``` |
29 | 43 | https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/myrereport.rdl&rs:Format=PDF |
30 | 44 | ``` |
31 | 45 |
|
32 | 46 | ::: moniker-end |
| 47 | + |
| 48 | +## Export a PPTX report |
33 | 49 |
|
34 | | - For example the following URL command in your browser exports a PPTX report from a named instance of the report server: |
| 50 | +To export a PPTX report from a named instance of the report server, use the following URL command in your browser: |
35 | 51 |
|
36 | 52 | ``` |
37 | 53 | https://servername/ReportServer_THESQLINSTANCE/Pages/ReportViewer.aspx?%2freportfolder%2freport+name+with+spaces&rs:Format=pptx |
38 | 54 | ``` |
| 55 | + |
| 56 | +## Common values for the `rs:Format` parameter |
| 57 | + |
| 58 | +The `rs:Format` parameter accepts the following common values based on the report rendering extensions installed on the report server: |
| 59 | + |
| 60 | +- HTML4.0 |
| 61 | +- HTML5 |
| 62 | +- MHTML |
| 63 | +- IMAGE |
| 64 | +- EXCELOPENXML (xlsx) |
| 65 | +- WORDOPENXML (docx) |
| 66 | +- CSV |
| 67 | +- PDF |
| 68 | +- XML |
| 69 | +- NULL |
| 70 | + |
| 71 | +If a specified rendering extension isn't installed on the report server, an error displays in the browser. |
39 | 72 |
|
40 | | - Valid values for this parameter are based on the report rendering extensions that are installed on the report server being accessed. Common extensions are HTML4.0, MHTML, IMAGE, EXCELOPENXML (xlsx), WORDOPENXML (docx), CSV, PDF, XML, and NULL. If a specified rendering extension isn't installed on the report server, the report isn't rendered and an error is generated and displayed in the browser. |
41 | | - |
42 | | - If you don't include the *Format* parameter as part of the URL, the report server detects the browser and renders the report in the appropriate HTML format. |
| 73 | +If you don't include the `rs:Format` parameter as part of the URL, the report server detects the browser and renders the report in the appropriate HTML format. |
43 | 74 |
|
44 | 75 | ## Related content |
45 | 76 |
|
|
0 commit comments