部署傳遞擴充套件外掛

iSQlServer發表於2008-12-18

傳遞擴充套件外掛以 XML 配置檔案的形式提供其配置資訊。該 XML 檔案符合為傳遞擴充套件外掛定義的 XML 架構。傳遞擴充套件外掛提供用於設定和修改配置檔案的基礎結構。

如果替換或升級某一傳遞擴充套件外掛,則引用該傳遞擴充套件外掛的所有訂閱仍保持有效。

在將 Reporting Services 傳遞擴充套件外掛寫入和編譯到某一 Microsoft .NET Framework 庫中後,必須將該擴充套件外掛複製到相應的目錄中,並且向適當的 Reporting Services 配置檔案新增一個條目,以便報表伺服器可以定位它。

 配置檔案擴充套件外掛元素
您部署到報表伺服器的傳遞擴充套件外掛需要作為配置檔案中的 Extension 元素輸入。用於報表伺服器的配置檔案是 RSReportServer.config。

下表介紹傳遞擴充套件外掛的 Extension 元素的屬性。

屬性  說明 
Name
 擴充套件外掛的唯一名稱(例如,“Report Server E-Mail”用於電子郵件傳遞擴充套件外掛,“Report Server FileShare”用於檔案共享傳遞擴充套件外掛)。Name 屬性的最大長度是 255 個字元。該名稱在配置檔案的 Extension 元素內的所有條目中必須唯一。如果存在重複的名稱,則報表伺服器返回錯誤。
 
Type
 以逗號分隔的列表,其中包含完全限定的名稱空間以及程式集的名稱。
 
Visible
 值為 false 指示在使用者介面中將不顯示傳遞擴充套件外掛。如果未包含此屬性,則預設值為 true。
 

有關 RSReportServer.config 檔案的詳細資訊,請參閱 配置檔案 (Reporting Services)。

 將擴充套件外掛部署到報表伺服器
報表伺服器使用傳遞擴充套件外掛處理和傳遞通知或報表。您應將傳遞擴充套件外掛程式集作為專用程式集部署到報表伺服器。還需要在報表伺服器配置檔案 RSReportServer.config 中生成一個條目。

將傳遞擴充套件外掛程式集部署到報表伺服器
將程式集從臨時位置複製到您要在其上使用此傳遞擴充套件外掛的報表伺服器的 bin 目錄中。報表伺服器 bin 目錄的預設位置為 C:\Program Files\Microsoft SQL Server\MSRS10.\Reporting Services\ReportServer\bin。

重要提示:
如果您在嘗試覆蓋現有傳遞擴充套件外掛程式集,則必須首先停止報表伺服器服務,然後複製更新的程式集。在複製程式集後重新啟動您的服務。
 


在複製程式集檔案後,開啟 RSReportServer.config 檔案。RSReportServer.config 檔案位於 ReportServer 目錄中。還需要在配置檔案中為傳遞擴充套件外掛程式集檔案生成一個條目。您可以使用 Microsoft Visual Studio 或諸如記事本之類的簡單文字編輯器開啟該配置檔案。

在 RSReportServer.config 檔案中找到 Delivery 元素。應當在以下位置為新建立的傳遞擴充套件外掛生成一個條目:

 

  
     
  

為您的傳遞擴充套件外掛新增一個條目。您的條目應包括具有用於 Name 和 Type 的值的 Extension 元素,如下所示:

 
Name 的值是傳遞擴充套件外掛的唯一名稱。Type 的值是逗號分隔的列表,包括實現 IDeliveryExtension 介面的類的完全限定名稱空間的條目,後隨程式集的名稱(不包括 .dll 副檔名)。預設情況下,傳遞擴充套件外掛是可見的。若要從使用者介面(如報表管理器)中隱藏擴充套件外掛,請將 Visible 屬性新增到 Extension 元素,並將其設定為 false。

最後,為您的自定義程式集新增一個程式碼組,以便為您的傳遞擴充套件外掛授予 FullTrust 許可權。為此,需要將程式碼組新增到 rssrvpolicy.config 檔案,該檔案預設位於 C:\Program Files\Microsoft SQL Server\MSRS10.\Reporting Services\ReportServer 中。您的程式碼組可能如下:

 
   version="1"
   PermissionSetName="FullTrust"
   Name="MyExtensionCodeGroup"
   Description="Code group for my delivery extension">
               version="1"
         Url="C:\Program Files\Microsoft SQL Server\MSRS10.\Reporting Services\ReportServer\bin\MyExtensionAssembly.dll"
       />
URL 成員身份僅是您可能為傳遞擴充套件外掛選擇的多個成員身份條件之一。有關 SSRS 中的程式碼訪問安全性的詳細資訊,請參閱安全開發 (Reporting Services)。

 將擴充套件外掛部署到報表管理器
如果您的傳遞擴充套件外掛實現 ISubscriptionBaseUIUserControl 介面,則該傳遞擴充套件外掛可用於報表管理器訂閱頁。為了使該訂閱使用者介面可用,需要將擴充套件外掛部署到報表管理器。

將傳遞擴充套件外掛程式集部署到報表管理器
將程式集從臨時位置複製到報表管理器的 bin 目錄中。報表管理器 bin 目錄的預設位置為 C:\Program Files\Microsoft SQL Server\MSRS10.\Reporting Services\ReportManager\bin。

在複製程式集檔案後,開啟 RSReportServer.config 檔案。RSReportServer.config 檔案位於 ReportServer 目錄中。還需要在配置檔案中為傳遞擴充套件外掛程式集檔案生成一個條目。您可以使用 Visual Studio .NET 或諸如記事本之類的簡單文字編輯器開啟此配置檔案。

在 RSReportServer.config 檔案中找到 DeliveryUI 元素。應當在以下位置為新建立的傳遞擴充套件外掛生成一個條目:

 

  
     
  

為您的傳遞擴充套件外掛新增一個條目。您的條目應包括具有用於 Name 和 Type 的值的 Extension 元素並且如下所示:

 
Name 的值是傳遞擴充套件外掛的唯一名稱。Type 的值是逗號分隔的列表,包括實現 ISubscriptionBaseUIUserControl 介面的類的完全限定名稱空間的條目,後隨程式集的名稱(不包括 .dll 副檔名)。

重要提示:
對於報表伺服器和報表管理器配置檔案條目,Name 屬性的值必須相同。如果它們不同,則您的伺服器配置將無效。
 


最後,為您的自定義程式集新增一個程式碼組,以便為您的傳遞擴充套件外掛授予 FullTrust 許可權。為此,需要將程式碼組新增到 RSmgrpolicy.config 檔案,該檔案預設位於 C:\Program Files\Microsoft SQL Server\MSRS10.\Reporting Services\ReportManager 中。您的程式碼組可能如下:

 
   version="1"
   PermissionSetName="FullTrust"
   Name="MyExtensionCodeGroup"
   Description="Code group for my delivery UI extension">
               version="1"
         Url="C:\Program Files\Microsoft SQL Server\MSRS10.\Reporting Services\ReportManager\bin\MyExtensionAssembly.dll"
       />
URL 成員身份僅是您可能為傳遞擴充套件外掛選擇的多個成員身份條件之一。有關 SSRS 中的程式碼訪問安全性的詳細資訊,請參閱安全開發 (Reporting Services)。

 驗證部署
您可以使用 Web 服務 ListExtensions 方法,驗證是否已向報表伺服器成功地部署了傳遞擴充套件外掛。還可以開啟報表管理器,並驗證您的擴充套件外掛是否包括在用於訂閱的可用傳遞擴充套件外掛列表中。有關報表管理器和訂閱的詳細資訊,請參閱訂閱和傳遞 (Reporting Services)。

 

來自 “ ITPUB部落格 ” ,連結:http://blog.itpub.net/16436858/viewspace-515961/,如需轉載,請註明出處,否則將追究法律責任。

相關文章