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 和此設定的詳細資訊，請參閱＜設定報表伺服器虛擬目錄＞和＜設定報表伺服器以供網際網路存取＞。
ReportServerUrl	提供另一種替代方法來指定「報表管理員」所使用之報表伺服器的 SOAP 端點。在個別伺服器或網站上主控「報表管理員」和報表伺服器虛擬目錄時，或者當您需要為報表伺服器指定完整的網域名稱時，可以使用這項設定來取代 ReportServerVirtualDirectory。 ReportServerURL 和 ReportServerVirtualDirectory 互斥。如果您指定 ReportServerURL，就必須刪除 ReportServerVirtualDirectory 的項目。若要指定此設定，您必須手動編輯 RSWebApplication.config 檔案。如果您是使用憑證，則有效值包括 http://<server>/<reportserver> 或 https://<server>/<reportserver>。如果報表管理員分開安裝在連接網際網路的 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 給傳送要求至防火牆後面之報表伺服器所需的應用程式和內部處理序。依預設，此設定不會包含在組態檔中。如果您手動加入此設定，可以將它保留在檔案中，也可以將它移除。請注意，在這一版中，於供網際網路存取的報表伺服器上部署「報表產生器」是未經過測試的部署狀況。如果您過去使用這項設定來支援「報表產生器」的網際網路存取，現在應該考慮改用替代的策略。
DeliveryUI	指定可以搭配訂閱使用的傳遞延伸模組。您在這個區段中指定的延伸模組名稱，會在報表管理員的 [訂閱定義] 頁面中顯示為傳遞選項。Reporting Services 包含兩個預設的訂閱傳遞延伸模組：報表伺服器電子郵件和報表伺服器 FileShare。如需詳細資訊，請參閱＜設定報表伺服器的電子郵件傳遞＞和＜Reporting Services 中的檔案共用傳遞＞。
DefaultDeliveryExtension	指定傳遞延伸模組是否為預設。報表伺服器電子郵件是預設的傳遞延伸模組。有效值包括 True 或 False。如果有多個延伸模組包含 True 值，就會將第一個延伸模組視為預設的延伸模組。
Configuration	指定傳遞延伸模組的組態選項。您可以針對每一個傳遞延伸模組設定預設轉譯格式。有效值是在 rsreportserver.config 檔案的轉譯區段中，所註明的轉譯延伸模組名稱。
MaxActiveReqForOneUser	指定單一使用者在「報表管理員」上可開啟之同時與進行中的連接數目上限。一旦達到限制，會拒絕使用者進一步的連接要求。此組態設定之目的，是要減少阻絕服務 (Denial of Service，DoS) 的攻擊。有效值為 0 到最大整數。0 指出連接的數目沒有限制。預設值是 20。請注意，大部分要求的處理速度很快，因此單一使用者不太可能同時擁有 20 個以上的開啟連接。如果使用者同時開啟超過 15 個密集處理的報表，您可能需要增加此值。
DisplayErrorLink	顯示「Microsoft 說明及支援」網站的連結。此連結出現在錯誤訊息中。使用者可連結到網站，以檢視最新錯誤訊息內容。有效值包括 true 或 false。預設值是 true。

請參閱

變更歷程記錄

版本	歷程記錄
2006 年 7 月 17 日	新增內容：已新增示範如何指定 ReportServerUrl 的範例。

共用方式為