轉至MSDN:http://msdn.microsoft.com/zh-cn/vs2008/ms157273.aspx
瞭解RSReportServer 配置文件,用來自定義報表行爲。
RSReportServer.config 文件存儲報表管理器、報表服務器 Web 服務和後臺處理所用的設置。所有 Reporting Services 應用程序都在一個進程中運行,該進程讀取 RSReportServer.config 文件中存儲的配置設置。本主題介紹在此配置文件中的各個元素。有關應用程序運行時的上下文的詳細信息,請參閱服務體系結構 (Reporting Services)。
設置將按其顯示順序依次列出。有關如何編輯該文件的說明,請參閱如何修改 Reporting Services 配置文件。
下面的示例演示 RSReportServer.config 文件的基本結構。結尾部分的粗體元素是此示例中的其他部分,這些元素已摺疊起來,以便您更輕鬆地查看 XML 元素結構。若要直接轉到 URLReservations、Authentication、Service、UI 或 Extensions 的設置,請單擊以下鏈接:身份驗證、服務、UI、擴展插件和 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> |
下表提供有關在文件的第一部分顯示的配置設置的信息。將按設置在配置文件中的顯示順序依次列出:
設置 | 說明 |
---|---|
Dsn |
指定承載報表服務器數據庫的數據庫服務器的連接字符串。在創建報表服務器數據庫時,此值會進行加密並添加到配置文件中。 |
ConnectionType |
指定報表服務器用來連接報表服務器數據庫的憑據類型。有效值爲 Default 和 Impersonate。如果將報表服務器配置爲使用 SQL Server 登錄名或服務帳戶連接報表服務器數據庫,則指定 Default。如果報表服務器使用 Windows 帳戶連接報表服務器數據庫,則指定 Impersonate。 |
LogonUser、LogonDomain、LogonCred |
存儲報表服務器連接到報表服務器數據庫時所使用的域帳戶的域、用戶名和密碼。將報表服務器連接配置爲使用域帳戶時,會創建 LogonUser、LogonDomain 和 LogonCred 的值。有關報表服務器數據庫連接的詳細信息,請參閱配置報表服務器數據庫連接。 |
InstanceID |
報表服務器實例的標識符。報表服務器實例的名稱基於 SQL Server 實例的名稱。此值指定了 SQL Server 實例名稱。默認情況下,此值爲 MSRS10.<實例名稱>。請不要修改此設置。 |
InstallationID |
安裝程序創建的報表服務器安裝的標識符。此值設置爲 GUID。請不要修改此設置。 |
SecureConnectionLevel |
指定 Web 服務調用使用安全套接字層 (SSL) 時必須達到的級別。此設置用於報表服務器 Web 服務和報表管理器。當您在 Reporting Services 配置工具中配置 URL 以使用 HTTP 或 HTTPS 時將設置此值。有效值的範圍爲 0 到 3 之間,其中 0 的安全性最低。有關詳細信息,請參閱Using Secure Web Service Methods和配置報表服務器用於安全套接字層 (SSL) 連接。 |
CleanupCycleMinutes |
指定多少分鐘後從報告服務器數據庫刪除舊會話和過期快照。有效值的範圍爲 0 到最大整數之間。默認值爲 10。如果將值設置爲 0,將禁止數據庫清除進程。 |
SQLCommandTimeoutSeconds |
此設置未使用。 |
MaxActiveReqForOneUser |
指定一個用戶可以同時處理的報表的最大數目。達到此限制之後,將拒絕進一步的報表處理請求。有效值介於 0 到最大整數之間。默認值爲 20。 注意,大多數請求都處理得非常快,因此單個用戶在任意給定時間都不太可能擁有 20 個以上的打開連接。如果用戶同時打開了 15 個以上的佔用大量進程的報表,則最好增大此值。 對於在 SharePoint 集成模式下運行的報表服務器,將忽略此設置。有關服務器模式的詳細信息,請參閱規劃部署模式。 |
DatabaseQueryTimeout |
指定多少秒後與報表服務器數據庫的連接超時。此值將傳遞到 System.Data.SQLClient.SQLCommand.CommandTimeout 屬性。有效值介於 0 和 2147483647 之間。默認值爲 120。值 0 表示等待時間無限制,因此並不推薦使用該值。 |
RunningRequestsScavengerCycle |
指定取消孤立請求和過期請求的頻率。以秒爲單位指定此值。有效值的範圍爲 0 到最大整數之間。默認值爲 60。 |
RunningRequestsDbCycle |
指定報表服務器多長時間對正在運行的作業進行一次評估,以檢查這些作業是否超出了報表執行超時值,以及何時在報表管理器的“管理作業”頁中顯示正在運行的作業信息。以秒爲單位指定此值。有效值介於 0 和 2147483647 之間。默認值爲 60。 |
RunningRequestsAge |
指定間隔多長時間後正在運行的作業的狀態將從“新建”更改到“正在運行”(秒)。有效值介於 0 和 2147483647 之間。默認值爲 30。 |
MaxScheduleWait |
指定在請求“下次運行時間”時報表服務器 Windows 服務等待 SQL Server 代理服務更新計劃的秒數。有效值介於 0 和 2147483647 之間。默認值爲 5。 |
DisplayErrorLink |
指示發生錯誤時是否顯示 Microsoft 幫助和支持站點的鏈接。此鏈接將顯示在錯誤消息中。用戶單擊此鏈接可以打開此站點上的更新的錯誤消息內容。有效值包括 True(默認值)和 False。 |
WebServiceuseFileShareStorage |
指定是否在文件系統中存儲緩存報表和臨時快照(由報表服務器 Web 服務在用戶會話期間創建)。有效值爲 True 和 False(默認值)。如果該值設置爲 False,臨時數據將存儲在 reportservertempdb 數據庫中。 |
WatsonFlags |
指定對於報告給 Microsoft 的錯誤情況記錄多少信息。 |
WatsonDumpOnExceptions |
指定已爲其創建錯誤日誌的異常的列表。如果存在重複問題並希望爲要發送到 Microsoft 以進行分析的信息創建轉儲,此設置會非常有用。創建轉儲會影響性能,因此僅在診斷問題時才需更改此設置。 |
WatsonDumpExcludeIfContainsExceptions |
指定未爲其創建錯誤日誌的異常的列表。在診斷問題並且不希望服務器爲特定異常創建轉儲時,此設置非常有用。 |
URLReservations 定義 HTTP 以訪問當前實例的報表服務器 Web 服務和報表管理器。URL 會在配置報表服務器時保留和存儲在 HTTP.SYS 中。
請不要直接在該配置文件中修改 URL 保留。請始終使用 Reporting Services 配置工具或報表服務器 WMI 提供程序創建或修改 URL 保留。如果在配置文件中修改此值,則可能會破壞保留,這將導致服務器運行時錯誤或在卸載軟件時將孤立的保留留在未刪除的 HTTP.SYS 中。有關詳細信息,請參閱配置報表服務器 URL 和配置文件中的 URL (Reporting Services)。
URLReservations 是可選元素。如果在 RSReportServer.config 文件中沒有顯示該元素,則可能不用配置服務器。如果指定了該元素,則必須指定除 AccountName 以外的所有子元素。
設置 | 說明 |
---|---|
Application |
包含 Reporting Services 應用程序的設置。 |
Name |
指定 Reporting Services 應用程序。有效值爲 ReportServerWebService 或 ReportManager。 |
VirtualDirectory |
指定應用程序的虛擬目錄名稱。 |
URLs,URL |
包含應用程序的一個或多個 URL 保留。 |
UrlString |
指定適用於 HTTP.SYS 的 URL 語法。有關語法的詳細信息,請參閱 URL 保留語法 (Reporting Services)。 |
AccountSid |
指定已爲其創建 URL 保留項的帳戶的安全標識符 (SID)。該帳戶應爲報表服務器服務運行時所使用的帳戶。如果 SID 與服務帳戶不匹配,則報表服務器可能無法偵聽相應 URL 上的請求。 |
AccountName |
指定與 AccountSid 對應的可讀帳戶名稱。該名稱不會被使用,但它會顯示在文件中,這樣您便可以輕鬆確定用於相應 URL 保留項的帳戶的服務帳戶。 |
Authentication 指定報表服務器所接受的一個或多個身份驗證類型。默認設置和值是本節中介紹的設置和值的子集。只會自動添加默認設置。若要添加其他設置,必須使用文本編輯器將相應的元素結構添加到 RSReportServer.config 文件中並設置其值。
默認值包括 RSWindowsNegotiate 和 RSWindowsNTLM,其中 EnableAuthPersistance 設置爲 True:
<Authentication> <AuthenticationTypes> <RSWindowsNegotiate/> <RSWindowsNTLM/> </AuthenticationTypes> <EnableAuthPersistence>true</EnableAuthPersistence> </Authentication> |
必須手動添加所有其他值。有關詳細信息和示例,請參閱在 Reporting Services 中配置身份驗證。
設置 | 說明 |
---|---|
AuthenticationTypes |
指定一個或多個身份驗證類型。有效值爲 RSWindowsNegotiate、RSWindowsKerberos、RSWindowsNTLM、RSWindowsBasic 和 Custom。 類型 RSWindows 和 Custom 是互斥的。 RSWindowsNegotiate、RSWindowsKerberos、RSWindowsNTLM 和 RSWindowsBasic 是累積的並且可以一起使用,如本節前面的默認值示例所示。 如果預期會收到來自使用不同類型的身份驗證的各種客戶端應用程序和瀏覽器的請求,則必須指定多個身份驗證類型。 不要刪除 RSWindowsNTLM,否則會將瀏覽器支持限制爲部分受支持的瀏覽器類型。有關詳細信息,請參閱瀏覽器支持計劃。 |
RSWindowsNegotiate |
報表服務器接受 Kerberos 或 NTLM 安全令牌。如果報表服務器在本機模式下運行並且服務帳戶爲 Network Service,這便是默認設置。如果報表服務器在本機模式下運行並且服務帳戶已配置爲域用戶帳戶,將忽略該設置。 如果爲報表服務器服務帳戶配置了域帳戶但未爲報表服務器配置服務主體名稱 (SPN),則該設置可能會阻止用戶登錄該服務器。 |
RSWindowsNTLM |
服務器接受 NTLM 安全令牌。 如果刪除此設置,則會將瀏覽器支持限制爲部分受支持的瀏覽器類型。有關詳細信息,請參閱瀏覽器支持計劃。 |
RSWindowsKerberos |
服務器接受 Kerberos 安全令牌。 如果在約束委託身份驗證方案中使用 Kerberos 身份驗證,則將使用此設置或 RSWindowsNegotiate。 |
RSWindowsBasic |
如果建立連接時沒有使用憑據,則服務器會接受基本憑據,併發出質詢/響應。 基本身份驗證以明文形式在 HTTP 請求中傳遞憑據。如果使用基本身份驗證,則使用 SSL 對進出報表服務器的網絡通信進行加密。若要查看 Reporting Services 中基本身份驗證的示例配置語法,請參閱在 Reporting Services 中配置身份驗證。 |
Custom |
如果在報表服務器計算機上部署了自定義的安全擴展插件,請指定此值。有關詳細信息,請參閱Implementing a Security Extension。 |
LogonMethod |
該值指定 RSWindowsBasic 的登錄類型。如果指定 RSWindowsBasic,則此值是必需的。有效值爲 0、1、2 和 3,每個值的含義如下: 0 = 交互登錄,針對將交互訪問報表服務器的用戶。這是默認值。 1 = 批處理登錄,針對批處理服務器,在該服務器上系統將代表用戶在無直接干預的情況下啓動進程。 2 = 網絡登錄,針對要對純文本密碼進行身份驗證的高性能服務器 3 = 明文登錄,在此情況下,登錄憑據保留在隨各 HTTP 請求一起發送的身份驗證包中,這樣,該服務器在連接到網絡中的其他服務器時可以模擬該用戶。 |
Realm |
此值用於 RSWindowsBasic。它指定包含授權和身份驗證功能的資源分區,這些功能用於控制對組織中受保護資源的訪問。 |
DefaultDomain |
此值用於 RSWindowsBasic。它用於確定服務器用來對用戶進行身份驗證的域。此值是可選的。但如果忽略此值,報表服務器會將計算機名稱用作域。如果在域控制器上安裝了報表服務器,則所用的域爲該計算機控制的域。 |
EnableAuthPersistance |
確定針對連接還是針對各個請求執行身份驗證。 有效值爲 True(默認值)或 False。如果設置爲 True,則從同一連接發出的後續請求會採用第一個請求的模擬上下文。 如果使用代理服務器軟件(如 ISA 服務器)訪問報表服務器,則此值必須設置爲 False。如果使用代理服務器,則允許多個用戶使用來自代理服務器的單個連接。對於這種情況,您應禁用身份驗證持久性,以便可以對各個用戶請求單獨進行身份驗證。如果不將 EnableAuthPersistance 設置爲 False,則所有用戶都將使用第一個請求的模擬上下文進行連接。 |
Service 指定作爲一個整體應用於服務的應用程序設置。有關服務的內部組件的詳細信息,請參閱服務體系結構 (Reporting Services)。
設置 | 說明 |
---|---|
IsSchedulingService |
指定報表服務器是否維護一組與 Reporting Services 用戶創建的計劃和訂閱相對應的 SQL Server 代理作業。有效值包括 True(默認值)和 False。 在使用基於策略的管理的 Reporting Services 的外圍應用配置器方面啓用或禁用 Reporting Services 功能時,此設置將受到影響。有關詳細信息,請參閱啓動和停止報表服務器服務。 |
IsNotificationService |
指定報表服務器是否處理通知和傳遞。有效值包括 True(默認值)和 False。如果該值爲 False,則不傳遞訂閱。 在使用基於策略的管理的 Reporting Services 的外圍應用配置器方面啓用或禁用 Reporting Services 功能時,此設置將受到影響。有關詳細信息,請參閱啓動和停止報表服務器服務。 |
IsEventService |
指定服務是否處理事件隊列中的事件。有效值包括 True(默認值)和 False。如果該值爲 False,則報表服務器不會執行鍼對計劃或訂閱的操作。 在使用基於策略的管理的 Reporting Services 的外圍應用配置器方面啓用或禁用 Reporting Services 功能時,此設置將受到影響。有關詳細信息,請參閱啓動和停止報表服務器服務。 |
PollingInterval |
指定報表服務器輪詢事件表的間隔(秒)。有效值的範圍爲 0 到最大整數之間。默認值爲 10。 |
WindowsServiceUseFileShareStorage |
指定是否在文件系統中存儲緩存報表和臨時快照(由報表服務器服務爲用戶會話的持續期間創建)。有效值爲 True 和 False(默認值)。 |
MemorySafetyMargin |
指定 WorkingSetMaximum 的百分比,該百分比用於定義中壓情況和低壓情況之間的邊界。默認值爲 80。有關 WorkingSetMaximum 和配置可用內存的詳細信息,請參閱爲報表服務器應用程序配置可用內存。 |
MemoryThreshold |
指定 WorkingSetMaximum 的百分比,該百分比用於定義高壓情況和中壓情況之間的邊界。默認值爲 90。此值應大於爲 MemorySafetyMargin 設置的值。有關詳細信息,請參閱爲報表服務器應用程序配置可用內存。 |
RecycleTime |
指定應用程序域的回收時間(分鐘)。有效值的範圍爲 0 到最大整數之間。默認值爲 720。 |
MaxAppDomainUnloadTime |
指定在回收操作期間允許卸載應用程序域的時間間隔。如果在該時間段內沒有完成回收,則應用程序域中的所有處理將會停止。有關詳細信息,請參閱報表服務器應用程序的應用程序域。 以分鐘爲單位指定此值。有效值的範圍爲 0 到最大整數之間。默認值爲 30。 |
MaxQueueThreads |
指定報表服務器 Windows 服務同時處理訂閱和通知所用的線程數。有效值的範圍爲 0 到最大整數之間。默認值爲 0。如果選擇了 0,報表服務器將確定最大的線程數。如果指定了某個整數,則所指定的值將設置可以同時創建的線程數的上限。有關報表服務器 Windows 服務如何針對運行中的進程管理內存,請參閱爲報表服務器應用程序配置可用內存。 |
UrlRoot |
此設置由報表服務器傳遞擴展插件使用,用來編寫在電子郵件和文件共享訂閱中傳遞的報表使用的 URL。它必須是有效的指向報表服務器的 URL 地址,通過該地址可以訪問已發佈的報表。報表服務器使用此設置生成供脫機訪問或以無人蔘與方式訪問的 URL。這些 URL 用於導出的報表中,傳遞擴展插件使用它們來編寫包含在傳遞消息(例如電子郵件中的鏈接)中的 URL。 報表服務器基於以下行爲確定報表中的 URL:
|
UnattendedExecutionAccount |
指定報表服務器運行報表時所使用的用戶名、密碼和域。這些值已經過加密。可以使用 Reporting Services 配置工具或 rsconfig 實用工具來設置這些值。有關詳細信息,請參閱配置無人蔘與的執行帳戶。 |
PolicyLevel |
指定安全策略配置文件。有效值爲 Rssrvrpolicy.config。有關詳細信息,請參閱 使用 Reporting Services 安全策略文件。 |
IsWebServiceEnabled |
指定報表服務器 Web 服務是否響應 SOAP 和 URL 訪問請求。在使用基於策略的管理的 Reporting Services 的外圍應用配置器方面啓用或禁用服務時,設置此值。 |
IsReportManagerEnabled |
指定在報表服務器上是否可以使用報表管理器應用程序。有效值爲 True(默認值)和 False。如果將此值設置爲 True,則報表管理器將可用。請注意,還必須爲報表管理器配置 URL 保留項,這樣才能使用報表管理器。 |
FileShareStorageLocation |
指定文件系統中用於存儲臨時快照的單個文件夾。儘管可以將文件夾路徑指定爲 UNC 路徑,但不建議您這樣做。默認值爲 c:/program files/Microsoft SQL Server/ MSRS10.<instance_name>/Reporting Services/RSTempFiles。 |
IsRdceEnabled |
指定是否已啓用報表定義自定義擴展插件 (RDCE)。有效值爲 True 和 False。 |
UI 指定應用於報表管理器應用程序的配置設置。
設置 | 說明 |
---|---|
ReportServerUrl |
指定報表管理器連接到的報表服務器的 URL。僅當將報表管理器配置爲連接到其他實例中或遠程計算機上的報表服務器時,才修改此值。有關詳細信息,請參閱如何配置報表管理器。 |
ReportBuilderTrustLevel |
請不要修改此值,它是不可配置的。在 SQL Server 2008 Reporting Services 中,報表生成器僅在 FullTrust 下運行。有關這些信任級別的詳細信息,請參閱啓動報表生成器。有關不再使用的部分信任模式的詳細信息,請參閱 SQL Server Reporting Services 中停止使用的功能。 |
PageCountMode |
僅用於報表管理器,此設置指定在呈現報表之前或查看報表時報表服務器是否計算頁計數值。有效值爲 Estimate(默認值)和 Actual。在用戶查看報表時,使用 Estimate 計算頁計數信息。最初,頁計數設置爲 2(指當前頁再加上一頁),而當用戶在報表中翻頁時會上調。如果您想在顯示報表之前提前計算頁計數,請使用 Actual。提供 Actual 的目的是爲了向後兼容。請注意,如果將 PageCountMode 設置爲 Actual,則系統必須對整個報表進行處理後才能得到有效的頁計數,這會增加報表顯示之前所需等待的時間。 |
Extensions 指定以下 Reporting Services 安裝的可擴展模塊的配置設置:
- 傳遞擴展插件
- DeliveryUI 擴展插件
- 呈現擴展插件
- 數據處理擴展插件
- 語義查詢擴展插件(僅內部使用)
- 模型生成擴展插件(僅內部使用)
- 安全擴展插件
- 身份驗證擴展插件
- 事件處理擴展插件(僅內部使用)
- 報表定義自定義擴展插件
上述某些擴展插件嚴格控制爲供報表服務器內部使用。本文不介紹僅內部使用的擴展插件的配置設置。以下各節將介紹默認擴展插件的配置設置。如果您所使用的報表服務器具有自定義的擴展插件,則您的配置文件可能包含此處未介紹的設置。下面將按擴展插件的顯示順序依次列出。對於反覆出現在同一種擴展插件的多個實例中的設置,我們只介紹一次。
Delivery
指定用於通過訂閱傳遞報表的默認(可能爲自定義)傳遞擴展插件。RSReportServer.config 文件包含針對以下四種傳遞擴展插件的應用程序設置:報表服務器電子郵件、文件共享傳遞、用於在 SharePoint 集成模式下運行的報表服務器的報表報務器文檔庫,以及用於預加載報表緩存的 null 傳遞提供程序。有關傳遞擴展插件的詳細信息,請參閱訂閱和傳遞 (Reporting Services)。
所有傳遞擴展插件都具有 Extension Name、MaxRetries、SecondsBeforeRetry 以及 Configuration。下面首先介紹這些通用的設置,在第二個表中將介紹特定於擴展插件的設置。
設置 | 說明 |
---|---|
Extension Name |
指定傳遞擴展插件的友好名稱和程序集。請不要修改此值。 |
MaxRetries |
指定當首次傳遞嘗試操作沒有成功時報表服務器進行重試的次數。默認值爲 3。 |
SecondsBeforeRetry |
指定每次重試嘗試之間的時間間隔(秒)。默認值爲 900。 |
Configuration |
包含特定於各傳遞擴展插件的配置設置。 |
文件共享傳遞配置設置
文件共享傳遞會將已導出爲應用程序文件格式的報表發送到網絡上的共享文件夾中。有關詳細信息,請參閱 Reporting Services 中的文件共享傳遞。
設置 | 說明 |
---|---|
ExcludedRenderFormats,RenderingExtension |
這些設置用於特意排除那些無法與文件共享傳遞協同工作的導出格式。HTMLOWC、RGDI 和 Null 傳遞擴展插件都被排除。這些格式通常用於交互式報表、預覽或預加載報表緩存。它們無法生成便於桌面應用程序查看的應用程序文件。 |
報表服務器電子郵件配置設置
報表服務器電子郵件使用 SMTP 網絡設備向電子郵件地址發送報表。必須對此傳遞擴展插件進行配置才能使用。有關詳細信息,請參閱配置報表服務器以進行電子郵件傳遞和 Reporting Services 中的電子郵件傳遞。
設置 | 說明 |
---|---|
SMTPServer |
指定用於指示遠程 SMTP 服務器或轉發器的地址的字符串值。對於遠程 SMTP 服務,必須指定此值。它可以是 IP 地址、企業 Intranet 上計算機的 UNC 名稱或者完全限定域名。 |
SMTPServerPort |
指定一個整數值,該值指示 SMTP 服務用來發送外發郵件的端口。端口 25 通常用於發送電子郵件。 |
SMTPAccountName |
包含用於分配 Microsoft Outlook Express 帳戶名的字符串值。如果已將 SMTP 服務器配置爲以某種方式使用該帳戶名,則可設置此值,否則可將此項保留爲空白。使用 From 指定用於發送報表的電子郵件帳戶。 |
SMTPConnectionTimeout |
指定一個整數值,表示與 SMTP 服務的有效套接字連接等待多少秒後纔會超時。默認值爲 30 秒,但如果 SendUsing 設置爲 2,則將忽略此值。 |
SMTPServerPickupDirectory |
指定表示本地 SMTP 服務的拾取目錄的字符串值。此值必須爲完全限定的本地文件夾路徑(例如,d:/rs-emails)。 |
SMTPUseSSL |
指定一個布爾值,通過設置該值可以在通過網絡發送 SMTP 消息時使用安全套接字層 (SSL)。默認值爲 0(或 False)。當 SendUsing 元素設置爲 2 時可以使用此設置。 |
SendUsing |
指定發生消息所使用的方法。有效值包括: 1=通過本地 SMTP 服務拾取目錄發送消息。 2=通過網絡 SMTP 服務發送消息。 |
SMTPAuthenticate |
指定一個整數,表示通過 TCP/IP 連接向 SMTP 服務發送消息時使用的身份驗證類型。有效值包括: 0=無身份驗證。 1=(不支持)。 2= NTLM (NT LanMan) 身份驗證。使用報表服務器 Windows 服務的安全上下文連接到網絡 SMTP 服務器。 |
From |
指定發送報表所使用的電子郵件地址,格式爲 [email protected]。該地址顯示在外發電子郵件的“發件人”行中。如果使用遠程 SMTP 服務器,則必須指定此值。它應該是有權發送郵件的有效電子郵件帳戶。 |
EmbeddedRenderFormats,RenderingExtension |
指定在電子郵件正文中嵌入報表時所使用的呈現格式。報表中的圖像將隨後嵌入報表中。有效值爲 MHTML 和 HTML4.0。 |
PrivilegedUserRenderFormats |
指定當通過“管理所有訂閱”任務啓用訂閱時,用戶可以從中爲報表訂閱選擇的呈現格式。如果未設置此值,則可以使用所有未特意排除的呈現格式。 |
ExcludedRenderFormats,RenderingExtension |
特意排除無法與給定的傳遞擴展插件協同工作的格式。默認情況下,對於電子郵件傳遞和文件共享傳遞,將排除 HTMLOWC、RGDI 和 Null 傳遞擴展插件。但不能排除同一個呈現擴展插件的多個實例。如果排除多個實例,則在報表服務器讀取配置文件時將出現錯誤。 |
SendEmailToUserAlias |
此值與 DefaultHostName 一起使用。 如果將 SendEmailToUserAlias 設置爲 True,則自動將定義各個訂閱的用戶指定爲報表的收件人。並隱藏“收件人”字段。如果此值爲 False,則“收件人”字段可見。若要最大限度地控制報表分發,請將此值設置爲 True。有效值包括: True=使用創建訂閱的用戶的電子郵件地址。這是默認值。 False=可以指定任何電子郵件地址。 |
DefaultHostName |
此值與 SendEmailToUserAlias 一起使用。 指定一個字符串值,表示當 SendEmailToUserAlias 設置爲 True 時追加到用戶別名中的主機名。此值可以爲域名系統 (DNS) 名稱或 IP 地址。 |
PermittedHosts |
通過顯式指定哪些主機能夠接收電子郵件傳遞來限制報表分發。在 PermittedHosts 中,每個主機均指定爲一個 HostName 元素,其中值爲 IP 地址或 DNS 名稱。 只有爲這些主機定義的電子郵件帳戶纔是有效的收件人。如果指定 DefaultHostName,請確保在 PermittedHosts 的 HostName 元素中包括該主機。此值必須是一個或多個 DNS 名稱或 IP 地址。默認情況下,不設置此值。如果未設置該值,則對於可接收通過電子郵件發送的報表的用戶沒有任何限制。 |
報表服務器文檔庫
報表服務器文檔庫會將已導出爲應用程序文件格式的報表發送到文檔庫中。只有配置爲在 SharePoint 集成模式下運行的報表服務器才能使用此傳遞擴展插件。有關詳細信息,請參閱 Reporting Services 中的 SharePoint 庫傳遞。
設置 | 說明 |
---|---|
ExcludedRenderFormats,RenderingExtension |
這些設置用於特意排除那些無法與文檔庫傳遞協同工作的導出格式。HTMLOWC、RGDI 和 Null 傳遞擴展插件都被排除。這些格式通常用於交互式報表、預覽或預加載報表緩存。它們無法生成便於桌面應用程序查看的應用程序文件。 |
NULL
NULL 傳遞提供程序用於爲單個用戶預生成的報表預加載緩存。對於此傳遞擴展插件,沒有相應的配置設置。有關詳細信息,請參閱 Reporting Services 中的報表緩存功能。
DeliveryUI
指定包含用戶界面組件的傳遞擴展插件,在報表管理器中定義單個訂閱時,訂閱定義頁中顯示這些用戶界面組件。如果需創建和部署具有用戶定義選項的自定義傳遞擴展插件,並且要使用報表管理器,則必須註冊此處的傳遞擴展插件。默認情況下,存在報表服務器電子郵件和報表服務器文件共享的配置設置。僅用於數據驅動訂閱或 SharePoint 應用程序頁的傳遞擴展插件不具有此處的設置。
設置 | 說明 |
---|---|
DefaultDeliveryExtension |
此設置可確定哪個傳遞擴展插件會最先出現在訂閱定義頁的傳遞類型列表中。僅一個傳遞擴展插件可包含此設置。有效值包括 True 或 False。如果此值設置爲 True,則相應擴展插件爲默認選項。 |
配置 |
指定傳遞擴展插件的配置選項。可以設置每個傳遞擴展插件的默認呈現格式。有效值爲 rsreportserver.config 文件的呈現部分中描述的呈現擴展名。 |
DefaultRenderingExtension |
指定傳遞擴展插件是否爲默認值。報表服務器電子郵件是默認的傳遞擴展插件。有效值包括 True 或 False。如果有多個擴展插件包含 True 值,則將第一個擴展插件視爲默認擴展插件。 |
Render
指定用於呈現報表的默認(可能爲自定義)呈現擴展插件。默認呈現擴展插件包括 XML、NULL、CSV、PDF、RGDI、HTML4.0、MHTML、EXCEL、RPL 和 IMAGE。除非部署自定義的呈現擴展插件,否則不要修改此部分。有關詳細信息,請參閱Implementing a Rendering Extension。
Data
指定用於處理查詢的默認(可能爲自定義)數據處理擴展插件。默認數據處理擴展插件包括 SQL、OLEDB、OLEDB-MD、ORACLE、ODBC、XML、SAPBW、ESSBASE、SSIS 和 SAP。除非要添加自定義數據處理插件,否則不要修改此部分。有關詳細信息,請參閱Implementing a Data Processing Extension。有關如何將報表服務器配置爲使用默認情況下在 RSReportServer.config 文件中未指定的“現成的”數據處理擴展插件的說明,請參閱在 Reporting Services 中配置數據處理擴展插件。
Semantic Query
指定用於處理報表模型的語義查詢處理擴展插件。Reporting Services 附帶的語義查詢處理擴展插件支持 SQL Server 關係數據、Oracle 和 Analysis Services 多維數據。請不要修改此部分。查詢處理是不可擴展的。
ModelGeneration
指定用於從報表服務器上已發佈的共享數據源創建報表模型的模型生成擴展插件。可以從 SQL Server 關係數據、Oracle 和 Analysis Services 多維數據源生成模型。請不要修改此部分。模型生成是不可擴展的。
Security
指定 Reporting Services 所用的授權組件。該組件由 RSReportServer.config 文件的 Authentication 元素中註冊的身份驗證擴展插件使用。除非要實現自定義的身份驗證擴展插件,否則不要修改此部分。有關添加自定義安全功能的詳細信息,請參閱Implementing a Security Extension。有關身份驗證的詳細信息,請參閱 Authorization in Reporting Services。
Authentication
指定報表服務器使用的默認和自定義身份驗證擴展插件。默認的擴展插件基於 Windows 身份驗證。除非要實現自定義的身份驗證擴展插件,否則不要修改此部分。有關 Reporting Services 中身份驗證的詳細信息,請參閱 Authentication in Reporting Services和在 Reporting Services 中配置身份驗證。有關添加自定義安全功能的詳細信息,請參閱Implementing a Security Extension。
EventProcessing
指定默認的事件處理程序。請不要修改此部分。此部分不可擴展。
ReportDefinitionCustomization
指定修改報表定義的自定義擴展插件的名稱和類型。有關報表定義自定義擴展插件 (RDCE) 的詳細信息,請參閱針對報表服務器可編程性的新增功能。