將 Reporting Services 報表轉譯延伸模組撰寫並編譯成 .NET Framework 連結庫之後,您必須讓報表伺服器和報表設計師能夠探索它。 若要這樣做,請將擴充功能複製到適當的目錄,並將專案新增至適當的 Reporting Services 組態檔。
組態檔轉譯延伸模組元素
將轉譯延伸模塊編譯成.DLL之後,您會將專案新增至 rsreportserver.config 檔案。 根據預設,位置會 %ProgramFiles%\Microsoft SQL Server\MSRS10_50。<InstanceName>\Reporting Services\ReportServer。 父元素為 <Render>。 在 Render 元素下,是每個轉譯延伸模組的 Extension 元素。 元素 Extension 包含兩個屬性:Name 和 Type。
下表描述轉譯延伸模組之 Extension 元素的屬性:
| 屬性 | 說明 |
|---|---|
| 名稱 | 延伸模組的唯一名稱。 Name 屬性的最大長度為 255 個字元。 名稱在組態檔的 Extensions 元素內的所有專案之間必須是唯一的。 如果存在重複的名稱,報表伺服器會傳回錯誤。 |
| 型別 | 包含完整命名空間以及元件名稱的逗號分隔清單。 |
| 可見 | 的值 false 表示轉譯延伸模組不應該顯示在使用者介面中。 如果未包含 屬性,則預設值為 true。 |
| LogAllExecutionRequests | 的值 false 表示專案只會記錄會話中的第一個報表執行。 如果未包含 屬性,則預設值為 true。例如,此設定會決定只記錄報表中轉譯之第一頁的專案(當) false或報表中轉譯的每個頁面的專案(當 時 true)。 |
如需詳細資訊,請參閱 RSReportServer 組態檔。
將擴充功能部署至報表伺服器
報表伺服器會使用轉譯延伸模組,將報表導出至其他格式。 您應該將轉譯延伸模組元件部署至報表伺服器作為私用元件。 您也需要在報表伺服器組態檔中建立專案,rsreportserver.config。
部署元件
將元件從預備位置複製到您想要使用轉譯延伸模組之報表伺服器的 bin 目錄。 報表伺服器 Bin 目錄的預設位置為 \%ProgramFiles%\Microsoft SQL Server\MSRS10_50。<InstanceName>\Reporting Services\ReportServer\Bin。
複製元件檔案之後,請開啟 rsreportserver.config 檔案。 rsreportserver.config 檔案也位於報表伺服器 bin 目錄中。 您必須在延伸模組元件檔的組態檔中建立專案。 您可以使用 Visual Studio 或簡單的文字編輯器開啟檔案。
如需詳細資訊,請參閱 RSReportServer 組態檔。
找出 Rsreportserver.config 檔案中的 Render 元素。 您應該在下列位置建立新建立的延伸模組專案:
<Extensions> <Render> <extension configuration> </Render> </Extensions>新增轉譯延伸模組的專案。 您的項目應該包含具有 Name 和 Type 值的 元素,而且看起來可能如下所示:
<Extension Name="My Rendering Extension Name" Type="CompanyName.ExtensionName.MyRenderingProvider, AssemblyName" />Name 的值是轉譯延伸模組的唯一名稱。 Type 的值是以逗號分隔的清單,其中包含實IRenderingExtension作完整命名空間的專案,後面接著元件的名稱(不包括 .dll 擴展名)。 根據預設,會顯示轉譯延伸模組。 若要隱藏使用者介面的延伸模組,例如報表管理員,請將 Visible 屬性新增至
Extension元素,並將它設定為false。
驗證部署
您也可以開啟報表管理員,並確認您的延伸模組包含在報表的可用匯出類型清單中。