 | This section describes configuration parameters that affect how Aspose.Words for Reporting Services generates documents. |
Instance level configuration
You can specify configuration settings for a whole Reporting Services instance. All reports processed by this instance will be affected by these settings.
To configure Aspose.Words for Reporting Services at instance level, you need to edit an XML configuration file. The settings are the same in all cases, but the location and name of the configuration file is different depending on the host application.
| Host Application | Configuration File |
|---|---|
| Microsoft SQL Server 2000, 2005 or 2008 Reporting Services | C:\Program Files\Microsoft SQL Server\<Instance>\Reporting Services\ReportServer\rsreportserver.config |
| Microsoft Visual Studio 2005 or 2008 Report Designer | C:\Program Files\Microsoft Visual Studio <Version>\Common7\IDE\PrivateAssemblies\ RSReportDesigner.config |
| Microsoft Report Viewer 2005 or 2008 | Not configurable in this version. |
You can edit the configuration file in any text or XML editor. It is recommended that you make a backup copy of the configuration file before editing.
The renderer configuration is stored inside the <Extension> element corresponding to a particular renderer.
Every export format has its own configuration XML element. Therefore, if you want changes to apply to several export formats, you need to duplicate your changes accordingly. Most examples used in this section configure only the DOC format renderer.
<!--This is an example of an empty configuration file.--> <Render> … <Extension Name="AWDOC" Type="Aspose.Words.ReportingServices.DocRenderer,Aspose.Words.ReportingServices"> <!--Insert configuration elements for exporting to DOC here.--> </Extension> <Extension Name="AWRTF" Type="Aspose.Words.ReportingServices.RtfRenderer,Aspose.Words.ReportingServices"> <!--Insert configuration elements for exporting to RTF here.--> </Extension> <Extension Name="AWWML" Type="Aspose.Words.ReportingServices.WmlRenderer,Aspose.Words.ReportingServices"> <!--Insert configuration elements for exporting to WordML here.--> </Extension> <Extension Name="AWDOCX" Type="Aspose.Words.ReportingServices.DocxRenderer,Aspose.Words.ReportingServices"> <!--Insert configuration elements for exporting to OOXML here.--> </Extension> <Extension Name="AWHTML" Type="Aspose.Words.ReportingServices.HtmlRenderer,Aspose.Words.ReportingServices"> <!--Insert configuration elements for exporting to HTML here.--> </Extension> <Extension Name="AWMHTML" Type="Aspose.Words.ReportingServices.MhtmlRenderer,Aspose.Words.ReportingServices"> <!--Insert configuration elements for exporting to MHTML here.--> </Extension> <Extension Name="AWODT" Type="Aspose.Words.ReportingServices.OdtRenderer,Aspose.Words.ReportingServices"> <!--Insert configuration elements for exporting to ODT here.--> </Extension> <Extension Name="AWTXT" Type="Aspose.Words.ReportingServices.TxtRenderer,Aspose.Words.ReportingServices"> <!--Insert configuration elements for exporting to TXT here.--> </Extension> <Extension Name="AWXPS" Type="Aspose.Words.ReportingServices.XpsRenderer,Aspose.Words.ReportingServices"> <!--Insert configuration elements for exporting to XPS here.--> </Extension> <Extension Name="AWEPUB" Type="Aspose.Words.ReportingServices.EpubRenderer,Aspose.Words.ReportingServices"> <!--Insert configuration elements for exporting to EPUB here.--> </Extension> </Render>
Report level configuration
You can specify configuration settings for an individual report. In this case, the settings you specify will override the corresponding settings specified at instance level.
To specify configuration settings for an individual report, follow these steps:
- Add a textbox to any place in the report.
- Set textbox visibility to Hidden .
- Set textbox name to AWConfiguration .
- Set textbox text to the XML similar to that you would specify in the <Configuration> element of the configuration file. For example, to make this particular report be exported in positioned layout mode, set the text to <DocumentLayout>Positioned</DocumentLayout> . You can specify any number of any number of configuration settings in a sequence, for example <DocumentLayout>Positioned</DocumentLayout> <PageBreaks>OnEachPage</PageBreaks><SpacingFactor>0.75</SpacingFactor> .