RSReportServer Configuration File
The RSReportServer.config file stores settings that are used by Report Manager, the Report Server Web service, and background processing. All Reporting Services applications run within a single process that reads configuration settings stored in the RSReportServer.config file. This topic describes each element in the configuration file. For more information about the context in which the applications run, see Service Architecture (Reporting Services).
Settings are presented in the order in which they appear. For instructions on how to edit this file, see How to: Modify a Reporting Services Configuration File.
Configuration File Structure
The following example illustrates the basic structure of the RSReportServer.config file. The bold elements at the end represent additional sections that are collapsed in this example so that you can view the XML element structure more easily. To go directly to the settings for URLReservations, Authentication, Service, UI, or Extensions, click the following links: Authentication, Service, UI, Extensions and URLReservations.
<Configuration>
<Dsn></Dsn>
<ConnectionType>Default</ConnectionType>
<LogonUser></LogonUser>
<LogonDomain></LogonDomain>
<LogonCred></LogonCred>
<InstanceId></InstanceId>
<InstallationID>{00000000-0000-0000-0000-000000000001}</InstallationID>
<Add Key="SecureConnectionLevel" Value="0" />
<Add Key="CleanupCycleMinutes" Value="10" />
<Add Key="SQLCommandTimeoutSeconds" Value="60" />
<Add Key="MaxActiveReqForOneUser" Value="20" />
<Add Key="DatabaseQueryTimeout" Value="120" />
<Add Key="RunningRequestsScavengerCycle" Value="60" />
<Add Key="RunningRequestsDbCycle" Value="60" />
<Add Key="RunningRequestsAge" Value="30" />
<Add Key="MaxScheduleWait" Value="5" />
<Add Key="DisplayErrorLink" Value="true" />
<Add Key="WebServiceUseFileShareStorage" Value="false" />
<!-- <Add Key="WatsonFlags" Value="0x0430" /> full dump-->
<!-- <Add Key="WatsonFlags" Value="0x0428" /> minidump -->
<!-- <Add Key="WatsonFlags" Value="0x0002" /> no dump-->
<Add Key="WatsonFlags" Value="0x0428" />
<Add Key="WatsonDumpOnExceptions" Value="Microsoft.ReportingServices.Diagnostics.Utilities.InternalCatalogException,Microsoft.ReportingServices.Modeling.InternalModelingException" />
<Add Key="WatsonDumpExcludeIfContainsExceptions" Value="System.Data.SqlClient.SqlException,System.Threading.ThreadAbortException" />
<URLReservations></URLReservations> <Authentication></Authentication> <Service></Service> <UI></UI> <Extensions></Extensions>
</Configuration>
Configuration Settings
The following table provides information about configuration settings that appear in the first part of the file. Settings are presented in the order in which they appear in the configuration file.
Setting |
Description |
|---|---|
Dsn |
Specifies the connection string to the database server that hosts the report server database. This value is encrypted and is added to the configuration file when you create the report server database. |
ConnectionType |
Specifies the type of credentials that the report server uses to connect to the report server database. Valid values are Default and Impersonate. Default is specified if the report server is configured to use a SQL Server login or the service account to connect to the report server database. Impersonate is specified if the report server uses a Windows account to connect to the report server database. |
LogonUser, LogonDomain, LogonCred |
Stores the domain, user name, and password of a domain account that is used by a report server to connect to a report server database. Values for LogonUser, LogonDomain, and LogonCred are created when the report server connection is configured to use a domain account. For more information about a report server database connection, see Configuring a Report Server Database Connection. |
InstanceID |
An identifier for the report server instance. Report server instance names are based on SQL Server instance names. This value specifies a SQL Server instance name. By default, this value is MSRS10.<instancename>. Do not modify this setting. |
InstallationID |
An identifier for the report server installation that Setup creates. This value is set to a GUID. Do not modify this setting. |
SecureConnectionLevel |
Specifies the degree to which Web service calls must us Secure Sockets Layer (SSL). This setting is used for both the Report Server Web service and Report Manager. This value is set when you configure a URL to use HTTP or HTTPS in the Reporting Services Configuration tool. Valid values range from 0 through 3, where 0 is least secure. For more information, see Using Secure Web Service Methods and Configuring a Report Server for Secure Sockets Layer (SSL) Connections. |
CleanupCycleMinutes |
Specifies the number of minutes after which old sessions and expired snapshots are removed from the report server databases. Valid values range from 0 to maximum integer. The default is 10. Setting the value to 0 disables the database clean up the process. |
SQLCommandTimeoutSeconds |
This setting is not used. |
MaxActiveReqForOneUser |
Specifies the maximum number of reports that one user can process at the same time. Once the limit is reached, further report processing requests are denied. Valid values are 0 to a maximum integer. The default is 20. Note that most requests process very quickly so it is unlikely that a single user will have more than 20 open connections at any given time. If users are opening more than 15 process-intensive reports at the same time, you might need to increase this value. This setting is ignored for report servers that run in SharePoint integrated mode. For more information about server modes, see Planning a Deployment Mode. |
DatabaseQueryTimeout |
Specifies the number of seconds after which a connection to the report server database times out. This value is passed to the System.Data.SQLClient.SQLCommand.CommandTimeout property. Valid values range from 0 to 2147483647. The default is 120. A value of 0 specifies an unlimited wait time and therefore is not recommended. |
RunningRequestsScavengerCycle |
Specifies how often orphaned and expired requests are canceled. This value is specified in seconds. Valid values range from 0 to maximum integer. The default is 60. |
RunningRequestsDbCycle |
Specifies how often the report server evaluates running jobs to check whether they have exceeded report execution time outs, and when to present running job information in the Manage Jobs page of Report Manager. This value is specified in seconds. Valid values range from 0 to 2147483647. The default is 60. |
RunningRequestsAge |
Specifies an interval in seconds after which the status of a running job changes from new to running. Valid values range from 0 to 2147483647. The default is 30. |
MaxScheduleWait |
Specifies the number of seconds the Report Server Windows service waits for a schedule to be updated by SQL Server Agent service when Next Run Time is requested. Valid values range from 0 to 2147483647. The default is 5. |
DisplayErrorLink |
Indicates whether a link to the Microsoft Help and Support site is displayed when errors occur. This link appears in error messages. Users can click the link to open updated error message content on the site. Valid values include True (default) and False. |
WebServiceuseFileShareStorage |
Specifies whether to store cached reports and temporary snapshots (created by the Report Server Web service for the duration of a user session) on the file system. Valid values are True and False (default). If the value is set to false, temporary data is stored in the reportservertempdb database. |
WatsonFlags |
Specifies how much information is logged for error conditions that are reported to Microsoft. |
WatsonDumpOnExceptions |
Specifies a list of exceptions that you want to report in an error log. This is useful when you have a recurring issue and want to create a dump with information to send to Microsoft for analysis. Creating dumps affects performance, so change this setting only when you are diagnosing a problem. |
WatsonDumpExcludeIfContainsExceptions |
Specifies a list of exceptions that you do not want to report in an error log. This is useful when you are diagnosing a problem and do not want the server to create dumps for a specific exception. |
URLReservations (RSReportServer.config file)
URLReservations defines HTTP access to the Report Server Web service and Report Manager for the current instance. URLs are reserved and stored in HTTP.SYS when you configure the report server.
Do not modify URL reservations in the configuration file directly. Always use the Reporting Services Configuration tool or the Report Server WMI provider to create or modify URL reservations. If you modify the values in the configuration file, you might corrupt the reservation, which will cause server errors at run time or leave orphan reservations in HTTP.SYS that are not removed if you uninstall the software. For more information, see Configuring Report Server URLs and URLs in Configuration Files (Reporting Services).
URLReservations is an optional element. If it is not present in the RSReportServer.config file, the server might not be configured. If it is specified, all child elements except for AccountName are required.
Setting |
Description |
|---|---|
Application |
Contains settings for Reporting Services applications. |
Name |
Specifies the Reporting Services applications. Valid values are ReportServerWebService or ReportManager. |
VirtualDirectory |
Specifies the virtual directory name of the application. |
URLs, URL |
Contains one or more URL reservations for the application. |
UrlString |
Specifies URL syntax that is valid for HTTP.SYS. For more information about the syntax, see URL Reservation Syntax (Reporting Services). |
AccountSid |
Specifies the security identifier (SID) of the account for which the URL reservation was created. This should be the account under which the Report Server service runs. If the SID does not match the service account, the report server might not be able to listen for requests on that URL. |
AccountName |
Specifies a readable account name that corresponds to the AccountSid. It is not used, but it appears in the file so that you can easily determine the service account for the account that is used for URL reservation. |
Authentication (RSReportServer.config file)
Authentication specifies one or more authentication types accepted by the report server. The default settings and values are a subset of the settings and values that are possible for this section. Only the default settings are added automatically. To add other settings, you must use a text editor to add the element structure to the RSReportServer.config file and set the values.
Default values include RSWindowsNegotiate and RSWindowsNTLM with EnableAuthPersistance set to True:
<Authentication>
<AuthenticationTypes>
<RSWindowsNegotiate/>
<RSWindowsNTLM/>
</AuthenticationTypes>
<EnableAuthPersistence>true</EnableAuthPersistence>
</Authentication>
All other values must be added manually. For more information and examples, see Configuring Authentication in Reporting Services.
Setting |
Description |
|---|---|
AuthenticationTypes |
Specifies one or more authentication types. Valid values are: RSWindowsNegotiate, RSWindowsKerberos, RSWindowsNTLM, RSWindowsBasic, and Custom. RSWindows types and Custom are mutually exclusive. RSWindowsNegotiate, RSWindowsKerberos, RSWindowsNTLM, and RSWindowsBasic are cumulative and can be used together, as illustrated in the default value example earlier in this section. Specifying multiple authentication types is necessary if you expect requests from a variety of client applications or browsers that use different types of authentication. Do not remove RSWindowsNTLM, otherwise you will limit browser support to a portion of the supported browser types. For more information, see Planning for Browser Support. |
RSWindowsNegotiate |
The report server accepts either Kerberos or NTLM security tokens. This is the default setting when the report server is running in native mode and the service account is Network Service. This setting is omitted when the report server is running in native mode and the service account is configured as a domain user account. If a domain account is configured for the Report Server Service account and a Service Principle Name (SPN) is not configured for the report server, this setting might prevent users from logging on to the server. |
RSWindowsNTLM |
The server accepts NTLM security tokens. If you remove this setting, browser support will be limited for some of the supported browser types. For more information, see Planning for Browser Support. |
RSWindowsKerberos |
The server accepts Kerberos security tokens. Use this setting or RSWindowsNegotiate when you use Kerberos authentication in a constrained delegation authentication scheme. |
RSWindowsBasic |
The server accepts Basic credentials and issues a challenge/response when a connection is made without credentials. Basic authentication passes credentials in the HTTP requests in clear text. If you use Basic authentication, use SSL to encrypt network traffic to and from the report server. To view example configuration syntax for Basic authentication in Reporting Services, see Configuring Authentication in Reporting Services. |
Custom |
Specify this value if you deployed a custom security extension on the report server computer. For more information, see Implementing a Security Extension. |
LogonMethod |
This value specifies the logon type for RSWindowsBasic. If you specify RSWindowsBasic, this value is required. Valid values are 2 or 3, where each value represents the following: 2 = Network logon high performance servers to authenticate plaintext passwords 3 = Cleartext logon, which preserves logon credentials in the authentication package that is sent with each HTTP request, allowing the server to impersonate the user when connecting to other servers in the network. .gif "Note") Note
Values 0 (for interactive logon) and 1 (for batch logon) are not supported in SQL Server 2008Reporting Services.
|
Realm |
This value is used for RSWindowsBasic. It specifies a resource partition that includes authorization and authentication features used to control access to protected resources in your organization. |
DefaultDomain |
This value is used for RSWindowsBasic. It is used to determine the domain used by the server to authenticate the user. This value is optional, but if you omit it the report server will use the computer name as the domain. If you installed the report server on a domain controller, the domain used is the one controlled by the computer. |
EnableAuthPersistance |
Determines whether authentication is performed on the connection or for every request. Valid values are True (default) or False. If set to True, subsequent requests from the same connection assume the impersonation context of the first request. This value must be set to False if you are using proxy server software (such as ISA Server) to access the report server. Using a proxy server allows a single connection from the proxy server to be used by multiple users. For this scenario, you should disable authentication persistence so that each user request can be authenticated separately. If you do not set EnableAuthPersistance to False, all users will connect using the impersonation context of the first request. |
Service (RSReportServer.config file)
Service specifies the application settings that apply to the service as a whole. For more information about the internal components of the service, see Service Architecture (Reporting Services).
Setting |
Description |
|---|---|
IsSchedulingService |
Specifies whether the report server maintains a set of SQL Server Agent jobs that correspond to schedules and subscriptions created by Reporting Services users. Valid values include True (default) and False. This setting is affected when you enable or disable Reporting Services features using the Surface Area Configuration for Reporting Services facet of Policy-Based Management. For more information, see Starting and Stopping the Report Server Service. |
IsNotificationService |
Specifies whether the report server processing notifications and deliveries. Valid values include True (default) and False. When the value is False, subscriptions are not delivered. This setting is affected when you enable or disable Reporting Services features using the Surface Area Configuration for Reporting Services facet of Policy-Based Management. For more information, see Starting and Stopping the Report Server Service. |
IsEventService |
Specifies whether service processes events in the event queue. Valid values include True (default) and False. When the value is False, the report server does not perform operations for schedules or subscriptions. This setting is affected when you enable or disable Reporting Services features using the Surface Area Configuration for Reporting Services facet of Policy-Based Management. For more information, see Starting and Stopping the Report Server Service. |
PollingInterval |
Specifies the interval, in seconds, between polls of the event table by the report server. Valid values range from 0 to maximum integer. The default is 10. |
WindowsServiceUseFileShareStorage |
Specifies whether to store cached reports and temporary snapshots (created by the Report Server service for the duration of a user session) on the file system. Valid values are True and False (default). |
MemorySafetyMargin |
Specifies a percentage of WorkingSetMaximum that defines the boundary between medium and low pressure scenarios. The default value is 80. For more information about WorkingSetMaximum and configuring available memory, see Configuring Available Memory for Report Server Applications. |
MemoryThreshold |
Specifies a percentage of WorkingSetMaximum that defines the boundary between high and medium pressure scenarios. The default value is 90. This value should be greater than the value set for MemorySafetyMargin. For more information, see Configuring Available Memory for Report Server Applications. |
RecycleTime |
Specifies a recycle time for the application domain, measured in minutes. Valid values range from 0 to maximum integer. The default is 720. |
MaxAppDomainUnloadTime |
Specifies an interval during which the application domain is allowed to unload during a recycle operation. If recycling does not complete during this time period, all processing in the application domain is stopped. For more information, see Application Domains for Report Server Applications. This value is specified in minutes. Valid values range from 0 to maximum integer. The default is 30. |
MaxQueueThreads |
Specifies the number of threads used by the Report Server Windows service for concurrent processing of subscriptions and notifications. Valid values range from 0 to maximum integer. The default is 0. If you choose 0, the report server determines the maximum number of threads. If you specify an integer, the value you specify sets the upper limit on threads that can be created at one time. For more information about how the Report Server Windows service manages memory for running processes, see Configuring Available Memory for Report Server Applications. |
UrlRoot |
Used by the report server delivery extensions to compose URLs that are used by reports delivered in e-mail and file share subscriptions. The value must be a valid URL address to the report server from which the published report is accessed. Used by the report server to generate URLs for offline or unattended access. These URLs are used in exported reports, and by delivery extensions to compose a URL that is included in delivery messages such as links in e-mails. The report server determines URLs in reports based on the following behavior:
|
UnattendedExecutionAccount |
Specifies a user name, password, and domain used by the report server to run a reports. These values are encrypted. Use the Reporting Services Configuration tool or the rsconfig utility to set these values. For more information, see Configuring the Unattended Execution Account. |
PolicyLevel |
Specifies the security policy configuration file. The valid value is Rssrvrpolicy.config. For more information, see Using Reporting Services Security Policy Files. |
IsWebServiceEnabled |
Specifies whether the Report Server Web service responds to SOAP and URL access requests. This value is set when you enable or disable service using the Surface Area Configuration for Reporting Services facet of Policy-Based Management. |
IsReportManagerEnabled |
Specifies whether the Report Manager application is available on the report server. Valid values are True (default) and False. If the value is set to True, Report Manager is available. Note that you must still configure a URL reservation for Report Manager before you can use it. |
FileShareStorageLocation |
Specifies a single folder on the file system for storing temporary snapshots. Although you can specify the folder path as a UNC path, doing so is not recommended. The default value is c:\program files\Microsoft SQL Server\ MSRS10.<instance_name>\Reporting Services\RSTempFiles. |
IsRdceEnabled |
Specifies whether Report Definition Customization Extension (RDCE) is enabled. Valid values are True and False. |
UI (RSReportServer.config file)
UI specifies configuration settings that apply to the Report Manager application.
Setting |
Description |
|---|---|
ReportServerUrl |
Specifies the URL of the report server that Report Manager connects to. Only modify this value if you are configuring Report Manager to connect to a report server in another instance or on a remote computer. For more information, see How to: Configure Report Manager. |
ReportBuilderTrustLevel |
Do not modify this value; it not configurable. In SQL Server 2008 Reporting Services, Report Builder only runs in FullTrust. For more information about these trust levels, see Starting Report Builder 1.0. For more information about discontinuing partial trust mode, see Discontinued Functionality in SQL Server Reporting Services. |
PageCountMode |
For Report Manager only, this setting specifies whether the report server calculates a page count value before the report is rendered, or as the report is viewed. Valid values are Estimate (default) and Actual. Use Estimate to calculate page count information as the user views the report. Initially, the page count is set to 2 (for the current page plus one additional page), but adjusts upwards as the user pages through the report. Use Actual if you want to calculate page count in advance before the report is displayed. Actual is provided for backward compatibility. Note that if you set PageCountMode to Actual, the entire report must be processed to get a valid page count, increasing wait time before the report is displayed. |
Extensions (RSReportServer.config file)
Extensions specifies configuration settings for the following extensible modules of a Reporting Services installation:
Delivery extensions
DeliveryUI extensions
Rendering extensions
Data processing extensions
Semantic query extensions (internal only)
Model generation extensions (internal only)
Security extensions
Authentication extensions
Event processing extensions (internal only)
Report definition customization extensions
Some of these extensions are strictly for internal use by the report server. Configuration settings for internal-use-only extensions are not documented. The following sections describe configuration settings for the default extensions. If you are using report server that has custom extensions, your configuration files might contain settings that are not described here. This section lists the extensions in the order in which they appear. Settings that occur repeatedly for multiple instances of the same kind of extension are described once.
Delivery
Specifies default (and possibly custom) delivery extensions used to deliver reports through subscriptions. The RSReportServer.config file includes application settings for four delivery extensions: report server e-mail, file share delivery, report server document library used for a report server that runs in SharePoint integrated mode, and the null delivery provider used to preload the report cache. For more information about delivery extensions, see Subscription and Delivery (Reporting Services).
All delivery extensions have Extension Name, MaxRetries, SecondsBeforeRetry, and Configuration. These shared settings are documented first. Descriptions of extension-specific settings follow in a second table.
Setting |
Description |
|---|---|
Extension Name |
Specifies a friendly name and assembly of the delivery extension. Do not modify this value. |
MaxRetries |
Specifies the number of times a report server will retry a delivery if the first attempt does not succeed. The default value is 3. |
SecondsBeforeRetry |
Specifies the interval of time (in seconds) between each retry attempt. The default value is 900. |
Configuration |
Contains the configuration settings that are specific to each delivery extension. |
File Share Delivery Configuration Settings
File Share delivery sends a report that has been exported to an application file format to a shared folder on the network. For more information, see File Share Delivery in Reporting Services.
Setting |
Description |
|---|---|
ExcludedRenderFormats, RenderingExtension |
These settings are used to intentionally exclude export formats that do not work well with file share delivery. HTMLOWC, RGDI, and Null delivery extensions are excluded. These formats are typically used for interactive reporting, preview, or to preload the report cache. They do not produce application files that can be easily viewed from a desktop application. |
Report Server E-mail Configuration Settings
Report Server Email uses an SMTP network device to send reports to e-mail addresses. This delivery extension must be configured before it can be used. For more information, see Configuring a Report Server for E-Mail Delivery and E-Mail Delivery in Reporting Services.
Setting |
Description |
|---|---|
SMTPServer |
Specifies a string value indicating the address of a remote SMTP server or forwarder. This value is required for remote SMTP service. It can be an IP address, a UNC name of a computer on your corporate intranet, or a fully qualified domain name. |
SMTPServerPort |
Specifies an integer value indicating the port on which the SMTP service uses to send outgoing mail. Port 25 is typically used to send e-mail. |
SMTPAccountName |
Contains a string value that assigns Microsoft Outlook Express account name. You can set this value if your SMTP server is configured to use it in some way; otherwise you can leave it blank. Use From to specify an e-mail account used to send reports. |
SMTPConnectionTimeout |
Specifies an integer value indicating the number of seconds to wait for a valid socket connection with the SMTP service before timing out. The default is 30 seconds, but this value is ignored if SendUsing is set to 2. |
SMTPServerPickupDirectory |
Specifies a string value indicating the pickup directory for the local SMTP service. This value must be a fully qualified local folder path (for example, d:\rs-emails). |
SMTPUseSSL |
Specifies a Boolean value that can be set to use Secure Sockets Layer (SSL) when sending an SMTP message over the network. The default value is 0 (or false). This setting can be used when the SendUsing element is set to 2. |
SendUsing |
Specifies which method to use for sending messages. Valid values are: 1=Sends a message from the local SMTP service pickup directory. 2=Sends the message from the network SMTP service. |
SMTPAuthenticate |
Specifies an integer value that indicates the kind of authentication to use when sending messages to an SMTP service over a TCP/IP connection. Valid values are: 0=No authentication. 1= (not supported). 2= NTLM (NT LanMan) authentication. The security context of the Report Server Windows service is used to connect to the network SMTP server. |
From |
Specifies an e-mail address from which reports are sent in the format abc@host.xyz. The address appears on the From line of an outgoing e-mail message. This value is required if you are using a remote SMTP server. It should be a valid e-mail account that has permission to send mail. |
EmbeddedRenderFormats, RenderingExtension |
Specifies the rendering format used to encapsulate a report within the body of an e-mail message. Images within the report are subsequently embedded within the report. Valid values are MHTML and HTML4.0. |
PrivilegedUserRenderFormats |
Specifies rendering formats that a user can select from for a report subscription when subscribing is enabled through the "Manage all subscriptions" task. If this value is not set, all render formats that are not intentionally excluded are available to use. |
ExcludedRenderFormats, RenderingExtension |
Purposely excludes formats that do not work well with a given delivery extension. By default, HTMLOWC, RGDI, and Null delivery extensions are excluded for e-mail delivery and file share delivery. You cannot exclude multiple instances of the same rendering extension. Excluding multiple instances will result in an error when the report server reads the configuration file. |
SendEmailToUserAlias |
This value works with DefaultHostName. When SendEmailToUserAlias is set to True, users who define individual subscriptions are automatically specified as recipients of the report. The To field is hidden. If this value is False, the To field is visible. Set this value to True if you want maximum control over report distribution. Valid values include the following: True=The e-mail address of the user creating the subscription is used. This is the default value. False=Any e-mail address can be specified. |
DefaultHostName |
This value works with SendEmailToUserAlias. Specifies a string value indicating the host name to append to the user alias when the SendEmailToUserAlias is set to true. This value can be a Domain Name System (DNS) name or IP address. |
PermittedHosts |
Limits report distribution by explicitly specifying which hosts can receive e-mail delivery. Within PermittedHosts, each host is specified as a HostName element, where the value is either an IP address or a DNS name. Only e-mail accounts defined for the host are valid recipients. If you specified DefaultHostName, be sure to include that host as HostName element of PermittedHosts. This value must be one or more DNS names or IP addresses. By default, this value is not set. If the value is not set, there are no restrictions on who can receive e-mailed reports. |
Report Server Document Library
Report Server Document Library sends a report that has been exported to an application file format to a document library. This delivery extension can only be used by a report server that is configured to run in SharePoint integrated mode. For more information, see SharePoint Library Delivery in Reporting Services.
Setting |
Description |
|---|---|
ExcludedRenderFormats, RenderingExtension |
These settings are used to intentionally exclude export formats that do not work well with document library delivery. HTMLOWC, RGDI, and Null delivery extensions are excluded. These formats are typically used for interactive reporting, preview, or to preload the report cache. They do not produce application files that can be easily viewed from a desktop application. |
NULL
The NULL delivery provider is used to preload the cache with pre-generated reports for individual users. There are no configuration settings for this delivery extension. For more information, see Report Caching in Reporting Services.
DeliveryUI
Specifies delivery extensions that contain a user interface component that appears in the subscription definition pages used when defining individual subscriptions in Report Manager. If you create and deploy a custom delivery extension that has user-defined options and you want to use Report Manager, you must register the delivery extension in this section. By default, there are configuration settings for Report Server E-mail and Report Server File Share. Delivery extensions used only in data-driven subscriptions or in SharePoint application pages do not have settings in this section.
Setting |
Description |
|---|---|
DefaultDeliveryExtension |
This setting determines which delivery extension appears first in the list of delivery types in the subscription definition page. Only one delivery extension can contain this setting. Valid values include True or False. When this value is set to True, that extension is default selection. |
Configuration |
Specifies configuration options for a delivery extension. You can set a default rendering format for each delivery extension. Valid values are the rendering extension names noted in the render section of the rsreportserver.config file. |
DefaultRenderingExtension |
Specifies whether a delivery extension is the default. Report Server E-Mail is the default delivery extension. Valid values include True or False. If more than one extension contains a value of True, the first extension is considered the default extension. |
Render
Specifies default (and possibly custom) rendering extensions used in report presentation. Default rendering extensions include XML, NULL, CSV, PDF, RGDI, HTML4.0, MHTML, EXCEL, RPL, and IMAGE. For information about the attributes for the child <Extension> element under <Render>, see Deploying a Rendering Extension. Do not modify this section unless you are deploying a custom rendering extension. For more information, see Implementing a Rendering Extension.
Data
Specifies default (and possibly custom) data processing extensions used to process queries. Default data processing extensions include SQL, OLEDB, OLEDB-MD, ORACLE, ODBC, XML, SAPBW, ESSBASE, SSIS, and SAP. Do not modify this section unless you are adding custom data processing extensions. For more information, see Implementing a Data Processing Extension. For instructions about how to configure a report server to use "off the shelf" data processing extensions that are not specified in the RSReportServer.config file by default, see Configuring Data Processing Extensions in Reporting Services.
Semantic Query
Specifies semantic query processing extension used to process report models. The semantic query processing extensions included with Reporting Services provide support for SQL Server relational data, Oracle, and Analysis Services multidimensional data. Do not modify this section. Query processing is not extensible.
ModelGeneration
Specifies a model generation extension used to create report models from a shared data source that is already published on a report server. You can generate models for SQL Server relational data, Oracle, and Analysis Services multidimensional data sources. Do not modify this section. Model generation is not extensible.
Security
Specifies the authorization component used by Reporting Services. This component is used by the authentication extension registered in the Authentication element of the RSReportServer.config file. Do not modify this section unless you are implementing a custom authentication extension. For more information about adding custom security features, see Implementing a Security Extension. For more information about authorization, see Authorization in Reporting Services.
Authentication
Specifies the default and custom authentication extensions used by the report server. The default extension is based on Windows Authentication. Do not modify this section unless you are implementing a custom authentication extension. For more information about authentication in Reporting Services, see Authentication in Reporting Services and Configuring Authentication in Reporting Services. For more information about adding custom security features, see Implementing a Security Extension.
EventProcessing
Specifies default event handlers. Do not modify this section. This section is not extensible.
ReportDefinitionCustomization
Specifies the name and type of a custom extension that modifies a report definition. For more information about Report Definition Customization Extension (RDCE), see What's New in Report Server Programmability.
See Also