RSWebApplication 配置文件

项目
12/15/2008

更新日期： 2006 年 7 月 17 日

RSWebApplication.config 文件存储报表管理器的配置设置。它指定报表分发所使用的设置以及每个用户打开的连接数。

文件位置

此文件位于 \Reporting Services\ReportManager 文件夹。

编辑指南

您可以对此文件进行编辑，以限制打开的连接数、更改默认传递扩展插件以及更改每个传递扩展插件的默认呈现格式。

默认配置示例

下面的示例显示 RSWebApplication.config 文件中的一些设置和默认值。

<Configuration>
     <UI>
     <ReportServerUrl></ReportServerUrl>
     <ReportServerVirtualDirectory>ReportServer</ReportServerVirtualDirectory>
     <ReportBuilderTrustLevel>FullTrust</ReportBuilderTrustLevel>
     </UI>
     <Extensions>
          <DeliveryUI>
               <Extension Name="Report Server Email" Type="Microsoft.ReportingServices.EmailDeliveryProvider.EmailDeliveryProviderControl,ReportingServicesEmailDeliveryProvider">
                    <DefaultDeliveryExtension>True</DefaultDeliveryExtension>
                    <Configuration>
                         <RSEmailDPConfiguration>
                              <DefaultRenderingExtension>MHTML</DefaultRenderingExtension>
                         </RSEmailDPConfiguration>
                    </Configuration>
               </Extension>
               <Extension Name="Report Server FileShare" Type="Microsoft.ReportingServices.FileShareDeliveryProvider.FileShareUIControl,ReportingServicesFileShareDeliveryProvider"/>
          </DeliveryUI>
     </Extensions>
     <Add Key="MaxActiveReqForOneUser" Value="20"/>
     <Add Key="DisplayErrorLink" Value="true"/>
</Configuration>

用于访问报表服务器端点的备用配置的示例

此示例显示如何使用 ReportServerUrl 而不是 ReportServerVirtualDirectory。

重要提示：
配置设置是区分大小写的。添加新条目时，务必完全按照所示内容键入设置。如果使用了不正确的大小写，将收到如下错误消息：“配置文件包含一个无效元素。ElementName 元素不是配置文件元素。”

<UI>
     <ReportServerUrl>https://www.adventure-works.com/ReportServer</ReportServerUrl>
     <ReportServerVirtualDirectory></ReportServerVirtualDirectory>
     <ReportBuilderTrustLevel>FullTrust</ReportBuilderTrustLevel>
</UI>

配置设置

下表提供了有关默认设置的信息。将按设置在配置文件中的显示顺序依次列出：如果使用自定义传递扩展插件，则配置文件还包括其他设置。

设置	说明
ReportServerVirtualDirectory	指定报表管理器使用的报表服务器的 SOAP 端点。该值为报表服务器虚拟目录名称。例如，如果报表服务器的 URL 为 http://adventure-works.com/reportserver，则 ReportserverVirtualDirectory 设置的值为 reportserver。此设置需要将报表管理器和报表服务器配置为使用同一个网站。如果它们使用不同的网站，请删除 ReportServerVirtualDirectory 的值并改用 ReportServerURL。有关 URL 和此设置的详细信息，请参阅配置报表服务器虚拟目录和配置用于 Internet 访问的报表服务器。
ReportServerUrl	提供了另一种指定报表管理器所用报表服务器的 SOAP 端点的方法。当报表管理器和报表服务器虚拟目录承载在不同的服务器或网站上时，或者当需要指定报表服务器的完全限定域名时，可以使用此设置，而不是使用 ReportServerVirtualDirectory。 ReportServerURL 和 ReportServerVirtualDirectory 是互斥的。如果指定了 ReportServerURL，则必须删除 ReportServerVirtualDirectory 的相应条目。若要指定此设置，必须手动编辑 RSWebApplication.config 文件。有效值包括 http://<服务器>/<报表服务器> 或者 https://<服务器>/<报表服务器>（如果使用证书）。如果在面向 Internet 的 Web 服务器上单独安装报表管理器，此值必须为可用来访问位于防火墙后面的报表服务器实例的完全限定域名。绝对不能将此值设置为 localhost。如果安装了安全套接字层 (SSL) 证书，则此值必须是为该证书注册的服务器的名称。如果您得到错误消息“基础连接已经关闭: 未能为 SSL/TLS 安全通道建立信任关系”，请将 ReportServerUrl 设置为颁发证书所针对的服务器的完全限定域名。例如，如果该证书注册到 https://adventure-works.com.onlinesales，则报表服务器 URL 应为 https://adventure-works.com.onlinesales/reportserver。若要查看如何使用此设置，请参阅此主题中提供的示例。有关 URL 和此设置的详细信息，请参阅配置报表服务器虚拟目录。
ReportBuilderTrustLevel	指定是以完全信任模式还是部分信任模式启动报表生成器。有效值为 FullTrust 和 PartialTrust。默认值为 FullTrust。有关这些信任级别的详细信息，请参阅启动报表生成器。
PassThroughCookies	默认情况下，配置文件中不包含此设置。若要使用该设置，则必须手动添加它。此设置用于将报表管理器配置为传输自定义身份验证 Cookie。如果希望获得详细信息，并希望查看如何指定配置设置的示例，请参阅配置报表管理器以传递自定义身份验证 Cookie
ReportServerExternalUrl	此设置不再使用。在以前的版本中，此设置用于将完全限定的报表服务器 URL 提供给需要将请求发送到防火墙之后的报表服务器的应用程序和内部进程。默认情况下，配置文件中不包含此设置。如果它是以手动方式添加到文件的，则既可以将其保留在文件中，也可以从文件中将其删除。注意，对于此版本，在面向 Internet 的报表服务器上部署报表生成器是一种未经测试的部署方案。如果您在过去使用此设置支持通过 Internet 访问报表生成器，那么现在应考虑使用其他策略。
DeliveryUI	指定可在订阅中使用的传递扩展插件。在此部分中指定的扩展名将在报表管理器的订阅定义页中显示为传递选项。Reporting Services 包括两个用于订阅的默认传递扩展插件：报表服务器电子邮件和报表服务器文件共享。有关详细信息，请参阅配置报表服务器以进行电子邮件传递和 Reporting Services 中的文件共享传递。
DefaultDeliveryExtension	指定传递扩展插件是否为默认值。报表服务器电子邮件是默认的传递扩展插件。有效值包括 True 或 False。如果有多个扩展插件包含 True 值，则将第一个扩展插件视为默认扩展插件。
Configuration	指定传递扩展插件的配置选项。可以设置每个传递扩展插件的默认呈现格式。有效值为 rsreportserver.config 文件的呈现部分中描述的呈现扩展名。
MaxActiveReqForOneUser	指定单个用户最多可同时打开多少个处于活动状态的报表管理器连接。达到此限制之后，将拒绝用户的进一步连接请求。此配置设置旨在减轻拒绝服务攻击。有效值介于 0 到最大整数之间。0 表示对连接数没有限制。默认值为 20。请注意，大多数请求都处理得非常快，因此单个用户在任意给定时间都不太可能拥有 20 个以上的打开连接。如果用户同时打开了 15 个以上的占用大量进程的报表，则可能需要增大此值。
DisplayErrorLink	显示指向“Microsoft 帮助和支持”站点的链接。此链接将显示在错误消息中。用户可以链接到此站点以查看更新的错误消息内容。有效值包括 true 或 false。默认值为 true。

请参阅

更改历史记录

发布日期	历史记录
2006 年 7 月 17 日	新增内容：添加了显示如何指定 ReportServerUrl 的示例。

通过