如何:修改 Reporting Services 組態檔
Reporting Services 會將應用程式設定儲存在組態檔集合中。安裝程式會針對您所安裝的每個報表伺服器執行個體建立組態檔。在每個檔案內部,其值是在安裝期間設定,或當您使用工具和應用程式來設定作業的伺服器時設定。在某些情況下,您必須直接修改檔案,以便加入或修改進階設定。組態設定會指定為 XML 元素或屬性。如果您了解 XML 和組態檔,就可以使用文字或程式碼編輯器來修改可由使用者自訂的設定。
某些組態設定只能透過某個工具進行設定。您必須透過 Reporting Services 組態工具、安裝程式或 rsconfig 命令列公用程式來修改包含加密值的設定。您必須是本機管理員群組的成員才能執行這些工具。
重要事項 |
---|
修改組態檔時,請特別小心。如果您修改保留給內部使用的設定,可能會停用安裝程序。除非您嘗試解決特定問題,否則一般而言不建議您修改組態設定。如需有關哪些設定可安全變更的詳細資訊,請參閱<RSReportServer 組態檔>或<RSReportDesigner 組態檔>。如需有關組態檔的詳細資訊,請參閱 Microsoft.NET Framework 產品文件集。 |
讀取和使用組態值
當服務啟動時,以及每次系統儲存組態檔時,報表伺服器都會讀取組態檔。目前的應用程式網域過期之後,全新和修訂的值才會在新的應用程式網域中生效。系統會盡可能讓仍然在目前應用程式網域中處理的要求完成。不過,少數設定需要進行立即應用程式網域回收作業。在這種情況下,所有處理中的要求都會在新的應用程式網域中重新啟動。
如果報表伺服器偵測到無效的值,報表伺服器就會在 Windows 應用程式記錄中記錄錯誤,而且無法啟動或使用預設值 (視錯誤情況而定):
如果錯誤是不正確的 XML,則報表伺服器將不會啟動。如果您造成錯誤時,報表伺服器正在執行,報表伺服器就會忽略無效的組態檔,直到報表伺服器重新啟動或應用程式網域回收為止。偵測到錯誤之後,報表伺服器將不會再啟動。
如果錯誤是無效的組態值,伺服器將使用內部預設值並在追蹤記錄檔中記錄錯誤。在內部預設值無法使用的少數情況下,如果無效的組態設定對於伺服器作業很重要,伺服器將傳回 rsServerConfigurationError 錯誤。有關遺漏或無效重要設定的錯誤會以 HTML 錯誤頁面傳回用戶端應用程式並記錄在事件記錄中。
所有組態檔變更 (包括成功變更) 都會記錄在報表伺服器追蹤記錄檔中。只有錯誤會記錄在應用程式事件記錄中。
關於預設值
大部分組態設定都具有報表伺服器內部指定的預設值。如果使用者定義的值無效或未指定,報表伺服器就會使用這些值。如果由於組態設定無效而必須使用預設值,系統就會在追蹤記錄檔中寫入錯誤。
刪除組態設定
如果是有預設值的組態設定,從組態檔中移除此設定不會有任何作用。大部分組態設定實際上都會在內部定義及設定。如果您刪除組態檔中的項目,內部複本仍然可以使用,而且會使用為它定義的預設值。
編輯 Reporting Services 組態檔
尋找您想要編輯的組態檔:
RSReportServer.config 位於 \Program Files\Microsoft SQL Server\MSSQL.n\Reporting Services\ReportServer 資料夾中。
RSReportServerServices.exe.config 位於 \Reporting Services\Report Server\Bin 資料夾中。
RSReportDesigner.config 位於 \Program Files\Microsoft Visual Studio 8\Common7\IDE\PrivateAssemblies 資料夾中。
儲存檔案的副本,以防您需要回復變更。
在 [記事本] 或程式碼編輯器中開啟原始檔。請勿使用 Textpad,因為它會在儲存檔案之前設定檔案長度,進而導致系統在追蹤記錄檔中寫入無效字元錯誤。
輸入您想要加入或使用的元素或值。元素會區分大小寫。如果您要加入元素,請務必使用正確的大小寫字母。如果您要自訂轉譯延伸模組、驗證延伸模組或資料處理延伸模組,請使用編輯組態檔的特定指示。
儲存檔案。
檢查追蹤記錄檔,以便確認錯誤並未發生。如果您看見錯誤狀況,表示某項設定或其值的指定內容不正確。請檢閱<RSReportServer 組態檔>,以便取得導致錯誤發生之任何設定的有效值。如需有關如何檢視追蹤記錄的詳細資訊,請參閱<報表伺服器服務追蹤記錄>。