部署轉譯延伸模組

  • 發行項

將 Reporting Services 報表轉譯延伸模組寫入 .NET Framework 連結庫並編譯之後，您必須讓報表伺服器和 報表設計師 加以探索。 若要這樣做，請將延伸模組複製到適當的目錄，並將項目新增到適當的 Reporting Services 設定檔。

組態檔轉譯 Extension 元素

轉譯延伸模塊編譯成 .DLL 之後，您會將專案新增至 rsreportserver.config 檔案。 根據預設，位置為 %ProgramFiles%\Microsoft SQL Server\MSRS10_50.\<InstanceName>\Reporting Services\ReportServer。 父元素為 \<Render>。 在 Render 元素下，是每個轉譯延伸模組的 Extension 元素。 Extension 元素包含兩個屬性：Name 與 Type。

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

屬性 描述
名稱 延伸模組的唯一名稱。 Name 屬性的最大長度為 255 個字元。 該名稱在組態檔之 Extensions 元素的所有項目中，必須是唯一的。 如果重複的名稱存在，報表伺服器會傳回錯誤。
型別 以逗號分隔的清單，包括完整的命名空間以及組件的名稱。
Visible false 值表示轉譯延伸模組不應該顯示在使用者介面中。 如果未包含屬性，則預設值為 true。
LogAllExecutionRequests 值若為 false 表示只會針對工作階段中的第一項報表執行作業記錄項目。 如果未包含屬性，則預設值為 true。

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

如需詳細資訊，請參閱 RsReportServer.config 組態檔。

將擴充功能部署至報表伺服器

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

部署元件

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

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

    如需詳細資訊，請參閱 RsReportServer.config 組態檔。

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

    <Extensions>  
   <Render>  
      <extension configuration>  
   </Render>  
</Extensions>

  4. 針對您的傳遞延伸模組加入項目。 您的項目應該包含具有 Name 和 Type值的元素，且看起來可能如下所示：

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

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

檢查部署

您也可以開啟報表管理員，然後確認延伸模組是否包含在報表可用匯出類型的清單中。

相關內容