共用方式為


部署轉譯延伸模組

在您撰寫 Reporting Services 報表轉譯延伸模組並將其編譯成 .NET Framework 程式庫之後,需要使其可供報表伺服器和報表設計師探索。若要這樣做,請將延伸模組複製到適當的目錄,並將項目加入適當的 Reporting Services 組態檔。

組態檔轉譯延伸模組元素

一旦將轉譯延伸模組編譯成 DLL,就可以將項目加入 rsreportserver.config 檔,如果在安裝期間選取預設的安裝位置,這個檔案會位於 C:\Program Files\Microsoft SQL Server\MSRS10.<InstanceName>\Reporting Services\ReportServer\Bin 資料夾。父元素是 <Render>。每個轉譯延伸模組在 Render 元素之下是 Extension 元素。Extension 元素包含兩個屬性:Name 與 Type。

下表描述轉譯延伸模組之 Extension 元素的屬性。

屬性

描述

Name

例如,延伸模組的唯一名稱,Microsoft Excel 轉譯延伸模組的 "EXCEL"。Name 屬性的最大長度為 255 個字元。該名稱在組態檔之 Extensions 元素的所有項目中,必須是唯一的。如果重複的名稱存在,報表伺服器會傳回錯誤。

Type

以逗號分隔的清單,包括完整的命名空間以及組件的名稱。

Visible

false 值指出在使用者介面中應該看不到轉譯延伸模組。如果沒有包括此屬性,預設值是 true。

LogAllExecutionRequests

false 值表示只會針對工作階段中的第一個報表執行記錄項目。如果沒有包括此屬性,預設值是 true。

例如,這項設定會決定只針對報表中轉譯的第一個頁面記錄項目 (當此值為 false 時),還是針對報表中轉譯的每個頁面記錄項目 (當此值為 true 時)。

如需有關 RSReportServer.config 檔的詳細資訊,請參閱<RSReportServer 組態檔>。

將延伸模組部署到報表伺服器

報表伺服器使用轉譯延伸模組將報表匯出至其他格式。您應該將轉譯延伸模組組件部署到報表伺服器做為私用組件。也需要在報表伺服器組態檔 rsreportserver.config 中建立項目。

若要部署組件

  1. 將組件從執行位置複製到您要在其上使用轉譯延伸模組之報表伺服器的 bin 目錄。報表伺服器 Bin 目錄的預設位置是 C:\Program Files\Microsoft SQL Server\MSRS10.<InstanceName>\Reporting Services\ReportServer\Bin。

  2. 在複製組件檔之後,開啟 rsreportserver.config 檔。rsreportserver.config 檔也位於報表伺服器的 bin 目錄中。您需要在延伸模組組件檔的組態檔中建立項目。您可以使用 Microsoft Visual Studio .NET 或簡單的文字編輯器 (如 [記事本]) 開啟檔案。

    如需詳細資訊,請參閱<RSReportServer 組態檔>。

  3. 在 Rsreportserver.config 檔中,找出 Render 元素。應該針對您新建立的延伸模組,在下列位置建立項目:

    <Extensions>
       <Render>
          <Your extension configuration information goes here>
       </Render>
    </Extensions>
    
  4. 針對您的傳遞延伸模組加入項目。您的項目應該包含具有 NameType 値的元素,且看起來可能如下所示:

    <Extension Name="My Rendering Extension Name" Type="CompanyName.ExtensionName.MyRenderingProvider, AssemblyName" />
    

    Name 值是轉譯延伸模組的唯一名稱。Type 的値是以逗號分隔的清單,包括 IRenderingExtension 實作的完整命名空間項目,後面接著組件的名稱 (不包含 .dll 副檔名)。根據預設,轉譯延伸模組是可見的。若要在使用者介面中隱藏延伸模組 (例如報表管理員),請將 Visible 屬性加入 Extension 元素,並將其設定為 false。

確認部署

您可以使用 Web 服務 ListExtensions 方法來確認轉譯延伸模組是否已成功部署到報表伺服器。您也可以開啟報表管理員,然後確認延伸模組是否包含在報表可用匯出類型的清單中。