Exporting to Microsoft Word (Report Builder and SSRS)

The Word rendering extension renders reports to the native format of Microsoft Word 2007-2010. The format is Office Open XML.

The Word renderer is compatible Microsoft Word 2007-2010 as well as Microsoft Word 2003 with the Microsoft Office Compatibility Pack for Word, Excel, and PowerPoint installed. For more information about the Compatibility Pack, see Microsoft Office Compatibility Pack for Word, Excel, and PowerPoint.

The content type of files generated by this renderer is application/vnd.openxmlformats-officedocument.wordprocessingml.document and the file extension of files is .docx.

The previous version of the Word rendering extension, compatible with Microsoft Word 2003, is renamed to Word 2003. Only the Word rendering extension is available by default. You must update the Reporting Services configuration files to make the Word 2003 rendering extension available. The content type of files generated by the Word 2003 renderer is application/vnd.ms-word and the file name extension of files is .doc.

Important

The Microsoft Word 2003 rendering extension is deprecated. For more information, see Deprecated Features in SQL Server Reporting Services in SQL Server 2012.

After the report is exported to a Word document, you can change the contents of your report and design document-style reports such as mailing labels, purchase orders, or form letters.

Note

You can create and modify report definitions (.rdl) in Report Builder and in Report Designer in SQL Server Data Tools. Each authoring environment provides different ways to create, open, and save reports and related items. For more information, see Designing Reports in Report Designer and Report Builder (SSRS) on the Web at microsoft.com.

In This Article

Report Items in Word

Pagination

Document Properties

Page Headers and Footers

Interactivity

Word Style Rendering

Squiggly Lines in Exported Reports

Word Limitations

Benefits of Using the Word Renderer

Backward Compatibility of Exported Reports

Availability of the Word 2003 Renderer

Differences Between the Word and Word 2003 Renderers

Device Information Settings

Report Items in Word

Reports exported to Word appear as a nested table that represents the report body. A tablix data region is rendered as a nested table that reflects the structure of the data region in the report. Text boxes and rectangles are each rendered as a cell within the table. The text box value is displayed inside the cell.

Images, charts, data bars, sparklines, maps, indicators, and gauges are each rendered as a static image within a table cell. Hyperlinks and drillthrough links on these report items are rendered. Maps and areas that can be clicked within a chart are not supported.

Newsletter-style column reports are not rendered in Word. Report body and page background images and colors are not rendered.

Back to Top

Pagination

After the report is opened in Word, Word repaginates the entire report again based on the page size. Repagination may cause page breaks to be inserted in locations where you did not intend to add them and, in some instances, may cause the exported report to have two successive page breaks in a row or add blank pages. You can try to change Word's pagination by adjusting the page margins.

This renderer supports only logical page breaks.

Page Sizing

When the report is rendered, the Word page height and width are set by the following RDL properties: paper size height and width, left and right page margins, and the top and bottom page margins.

Page Width

Word supports page widths that are up to 22 inches wide. If the report is wider than 22 inches, the renderer will still render the report; however, Word will not display the report contents while in print layout view or reading layout view. To view the data, switch to normal view or Web layout view. In these views, Word reduces the amount of whitespace, thereby displaying more of your report contents.

When rendered, the report grows as wide as required, up to 22 inches, to display the contents. The minimum width of the report is based on the RDL Width property in the Properties pane.

Back to Top

Document Properties

The Word renderer writes the following metadata to the DOCX file.

Report Element properties	Description
Report Title (report title)	Title
Report.Author	Author
Report.Description	Comments

Back to Top

Page Headers and Footers

Page headers and footers are rendered as header and footer regions in Word. If a report page number or an expression that indicates the total number of report pages appears in the page header or footer, they are translated to a Word field so that the accurate page number is displayed in the rendered report. If the header or footer height is set in the report, Word cannot support this setting. The PrintOnFirstPage property can under some circumstances specify whether text in a page header page footer prints on the first page of a report. If the rendered report has multiple pages and each page contains only a single section, then you can set PrintOnFirstPage to False and the text is suppressed on the first and page; otherwise, the text prints regardless of the value of the PrintOnFirstPage property.

The Word renderer attempts to parse all expressions in page headers and footers when reports are exported to Word. Many forms of expressions parse successfully and the expected values appear in page footers and headers on all report pages.

However, when a page footer or page header contains a complex expression that evaluates to different values on different pages of a report, the same value might display on all report pages. The page numbers in the following two expressions do not increment in the exported report. The page number translates to the same value on all report pages.

• ="Page: " + Globals!PageNumber.ToString + " of " + Globals!TotalPages.ToString

• =Avg(Fields!YTDPurchase.Value, "Sales") & " Page Number " & Globals!PageNumber

This occurs because Word renderer parses the report for fields related to pagination such as PageNumber and TotalPages and handles only simple reference, not calls to a function. In this case, the expression calls the ToString function. The following two expressions are equivalent and both render correctly when you preview the report in Report Builder or Report Designer or render the published report in Report Manager or a SharePoint library. However, the Word renderer parses only the second expression successfully and renders the correct page numbers.

• Complex expression: Expression is ="Average Sales " & Avg(Fields!YTDPurchase.Value, "Sales") & " Page Number " & Globals!PageNumber

• Expression with Text Runs: Text, Average Sales, and expression, =Avg(Fields!YTDPurchase.Value, "Sales), and text, Page Number, and expression =Globals!PageNumber

To avoid this problem, use multiple text runs instead of one complex expression when you use expressions in footers and headers. The following two expressions are equivalent. The first one is a complex expression the second one uses text runs. The Word renderer parses only the second expression successfully.

Back to Top

Interactivity

Some interactive elements are supported in Word. The following is a description of specific behaviors.

Show and Hide

The Word renderer renders report items based on their state when rendered. If a report item's state is hidden, the report item is not rendered in the Word document. If a report item's state is shown, the report item is rendered in the Word document. Toggle functionality is not supported in Word.

Document Map

If any document map labels exist in the report, they are rendered as Word Table of Contents (TOC) labels on the respective report items and groups. The document map label is used as the label text for the TOC labels. The target link is positioned near the item on which the label is set. While a TOC is not created for you in the Word document, you can build your own TOC using the document map labels that are rendered in the report.

Hyperlink and Drillthrough Links

Hyperlinks and drillthrough links on text box and image report items are rendered as hyperlinks in the Word document. When you click the hyperlink, the default Web browser opens and navigates to the URL. When you click the drillthrough hyperlink, the originating report server is accessed.

Interactive Sorting

The report contents are rendered based on how they are currently sorted within the report data region. Word does not support interactive sorting. After the report is rendered, you can apply table sorting within Word.

Bookmarks

Bookmarks in the report are rendered as Word bookmarks. Bookmark links are rendered as hyperlinks that connect to the bookmark labels within the document. Bookmark labels must be less than 40 characters long. The only special character that can be used in a bookmark label is an underscore (_). Unsupported special characters are stripped from the bookmark label name and, if the name is longer than 40 characters, the name is truncated. If there are duplicate bookmark names in the report, the bookmarks are not rendered in Word.

Back to Top

Word Style Rendering

The following is a brief description of how styles are rendered in Word.

Color Palette

Colors rendered in the report are rendered in the Word document.

Border

Borders for report items, other than the page border, are rendered as Word table cell borders.

Back to Top

Squiggly Lines in Exported Reports

When exported and viewed in Word, report data or constants might be underlined by red or green squiggly lines. The red squiggly lines identify spelling errors. The green squiggly lines identify grammar errors. This occurs when the report includes words that do not comply with the proofing (spelling and grammar) of the editing language that is specified in Word. For example, English report column titles will likely be underlined by red squiggly lines when the report is rendered in a Spanish version of Word. Perceived spelling errors are more common in reports than perceived grammar errors because reports typically include only short text, not complete sentences or paragraphs.

The presence of squiggly lines in reports implies the report has errors, which it likely does not. You can remove the squiggly lines by changing the proofing language for the report. To change the proofing language, select the content of the report and then specify the appropriate language for the content. You can select all or part of the content. In Word 2010, the language option, Set Proofing Language, is in the Language area is on the Review tab. After you update the content, you need to resave the document.

Depending on the language version of your Office program, the proofing tools (for example, dictionary) of the language that you chose is included with the program or provided in a Microsoft Office language pack that you purchase.

The following topics provide additional information about setting Office and Word options.

• Change the editing language in Microsoft Office 2010 Language Preferences or Word Options dialog box in Word. For more information, see Enable the use of other languages in your Office programs.

• Add Office language packs and then change the editing language. For more information, see Enable the use of other languages in your Office programs and Office 2010 Language Options.

Note

When you change the editing language in Microsoft Office 2010 Language Preferences or the Word Options dialog box in Word, the change applies to all Office programs.

Back to Top

Word Limitations

The following limitations are applied by Microsoft Word:

• Word tables support a maximum of 63 columns. If your report has more than 63 columns and you try to render it, Word splits the table. The additional columns are placed adjacent to the 63 columns displayed in the report body. Therefore, the report columns may not line up as expected.

• Word supports a maximum page width of 22 inches wide and 22 inches high. If your content is wider than 22 inches, some data may not be displayed in Print Layout view.

• Word ignores page header and footer height settings.

• After the report is exported, Word paginates the report again. This may cause additional page breaks to be added to the rendered report.

• Word does not repeat header rows on page two and greater, although you set the RepeatOnNewPage property of the static header row in a tablix (table, matrix, or list) to True. You can define explicit page breaks in your report to force header rows to appear on new pages. However, because Word applies its own pagination to the rendered report exported to Word, results might vary and the header row might not repeat predictably. The static header row is the row that contains the column headings.

• Text boxes grow when they contain non-breaking spaces.

• When text is exported to Word, text with font decoration in certain fonts may generate unexpected or missing glyphs in the rendered report.

Back to Top

Benefits of Using the Word Renderer

In addition to making the features that are new in Microsoft Word 2007-2010 available to exported reports, *.docx files of exported reports tend to be smaller. Reports exported by using the Word renderer are typically significantly smaller than the same reports exported by using the Word 2003 renderer.

Back to Top

Backward Compatibility of Exported Reports

You can select a Word compatibility mode and set compatibility options. The Word renderer creates documents with compatibility mode turned on. Resaving the documents with compatibility mode turned off might affect the layout of the document.

If you turn off compatibility mode and then resave a report, the report layout might change in unexpected ways.

Availability of the Word 2003 Renderer

In SQL Server 2012 Reporting Services, the default Word renderer is the version that renders to the native format of Microsoft Word 2007-2010. This is the Word option that the Export menus in Report Manager and SharePoint list. The earlier version, compatible only with Microsoft Word 2003, is now named Word 2003 and is listed on menus using that name. The Word 2003 menu option is not visible by default, but an administrator can make it visible by updating the RSReportServer configuration file. To export reports from SQL Server Data Tools (SSDT) using the Word 2003 renderer, you update the RSReportDesigner configuration file. However, making the Word 2003 renderer visible does not make it available in all scenarios. Because the RSReportServer configuration file resides on the report server, the tools or products from where you export reports must be connected to a report server to read the configuration file. If you use tools or products in disconnected or local mode, making the Word 2003 renderer visible has no effect. The Word 2003 menu option remains unavailable. If you make the Word 2003 renderer visible in the RSReportDesigner configuration file, the Word 2003 menu option is always available in SQL Server Data Tools (SSDT) report preview.

The Word 2003 menu option is never visible in the following scenarios:

• Report Builder in disconnected mode and you preview a report in Report Builder. This occurs in both the ClickOnce and stand-alone versions of Report Builder.

• Report Viewer Web Part in local mode and the SharePoint farm is not integrated with a Reporting Services report server. For more information, see Render Local Mode Reports in the Report Viewer (Reporting Services in SharePoint Mode)

If the Word 2003 renderer is configured to be visible, both the Word and Word 2003 menu options are available in the following scenarios:

• Report Manager when Reporting Services is installed in native mode.

• SharePoint site when Reporting Services is installed in SharePoint integrated mode.

• SQL Server Data Tools (SSDT) and you preview reports.

• Report Builder connected to a report server. This can be a ClickOnce or stand-alone version of Report Builder.

• The Report Viewer Web Part in remote mode.

The following XML shows the elements for the two Word rendering extensions in the RSReportServer and RSReportDesigner configuration files:

<Extension Name="WORDOPENXML" Type="Microsoft.ReportingServices.Rendering.WordRenderer.WordOpenXmlRenderer.WordOpenXmlDocumentRenderer,Microsoft.ReportingServices.WordRendering"/>

<Extension Name="WORD" Type="Microsoft.ReportingServices.Rendering.WordRenderer.WordDocumentRenderer,Microsoft.ReportingServices.WordRendering" Visible="false"/>

The WORDOPENXML extension defines the Word renderer for Microsoft Word 2007-2010. The WORD extension defines the Microsoft Word 2003 version. Visible = “false” indicates the Word 2003 renderer is hidden. For more information, see RSReportServer Configuration File and RSReportDesigner Configuration File.

Back to Top

Differences Between the Word and Word 2003 Renderers

Reports, rendered by using the Word or Word 2003 renderers tend to be visually indistinguishable. However, you might notice minor differences between the two the Word or Word 2003formats.

Back to Top

Device Information Settings

You can change some default settings for this renderer, such as omit hyperlinks and drillthrough links or expand all items that can be toggled regardless of the original state of the item when rendered, by changing the device information settings. For more information, see Word Device Information Settings.

Back to Top

See Also

Concepts

Pagination in Reporting Services (Report Builder and SSRS)

Rendering Behaviors (Report Builder and SSRS)

Interactive Functionality for Different Report Rendering Extensions (Report Builder and SSRS)

Rendering Report Items (Report Builder and SSRS)

Tables, Matrices, and Lists (Report Builder and SSRS)