2014年4月1日星期二

[SQL Server 2008R2][SSRS] URL Access 概說

SSRS 可使用 URL Access 的方式，將報表嵌入應用程式之中，讓 SSRS 在開發有了延伸能力上的彈性。在 Resporting Services 2008 R2 提供了多種開發 API 之中，最簡便的一種稱之為「URL Access」，透過 URL 以 HTTP GET 以及 POST 的方式即可呼叫 SSRS，以取得指定的報表內容，並轉譯為所需要的報表格式。在應用程式整合報表服務時，只要利用程式直接組合出 URL 字串，即可存取對應的報表物件，甚至可以透過 Session 以及認證的管理，在實作單一登入整合的需求。
使用 URL Access 的優點：

可自行客製化瀏覽報表介面，並與網頁程式整合
語法直覺易懂
屬性設定比傳統報表管理員介面更加豐富
最節省開發人力成本的整合報表方案

但還是有其缺點：

參數透過 URL 傳遞，若未透過 HTTPS 傳遞，可能有安全性的疑慮
參數過多、使用複選或是中文值作為參數時，會因 URL 超過預設長度 ( 一般是 256 字元 )，而造成失敗。目前新版的報表檢視器已經有所改良，畫面上只呈現首次登入時的 URL，因此發生失敗的機會已大幅減少。

URL Access 的句型結構
http://報表伺服器/虛擬目錄?[/路徑資訊]&prefix:param=value[&prefix:param=value]...n]

URL Access 的通訊協定可以是 HTTP 或 HTTPS。

報表伺服器
報表伺服器所在電腦主機名稱，可以是 IP 位置、主機名稱、或包含完整網域的主機名稱，需視網路架構以及報表伺服器設定值而定。

虛擬目錄
報表伺服器下的虛擬目錄名稱。

?
放在虛擬目錄名稱之後，標示報表物件屬性宣告的開始。

[/路徑資訊]
存取報表伺服器資料庫的完整路徑名稱。

&
分開各個參數名稱及值的符號。

Prefix
參數前置詞，為選擇性項目，用來指示報表伺服器執行特定的動作，假如語法中的參數前面沒有包括參數前置詞，會被認為是報表參數。

rc：指定報表轉譯模組所需的設定資訊，以及控制報表服務 HTML 瀏覽器的功能設定。
rs：指定執行報表伺服器命令的所需條件。
dsu：指定存取資料來源的使用者名稱。
dsp：指定存取資料來源的密碼。

Param

報表參數名稱。

Value

報表參數值。

例如：
http://10.50.12.119/ReportServer?/Reports/Report3
不帶入任何參數，沒有指定數值，若原報表有設定預設值，則會自動帶入預設值。而 URL 會自動轉換為 http://10.50.12.119/ReportServer/Pages/ReportViewer.aspx?/Reports/Report3
所以使用轉換後的 URL 也可以組合出 URL Access 的網址

http://10.50.12.119/ReportServer?/Reports/Report3&YEAR=2010
帶入YEAR參數，參數值為 2010

對 SSRS 而言，參數大小寫是有差異的。
錯誤訊息會如下

Reporting Services 錯誤

嘗試設定未於此報表中定義的報表參數 'year'。 (rsUnknownReportParameter)

SQL Server Reporting Services

在使用 URL Access 傳遞參數時，有幾點注意事項：

如果要傳遞的參數為空值，需使用「參數名:isnull=true」的句型結構，例如：YEAR:isnull=true。
傳遞報表參數前方需要加入「&」。
對 SSRS 而言，參數大小寫是有差異的。
參數值不論是字串或數值，都不用加上單引號或雙引號。
如果參數複選時，則是需要將選項一再重複，如：http://10.50.12.119/ReportServer?/Reports/Report3&YEAR=2010&YEAR=2011&YEAR=2012
傳遞報表參數的數量必須與原本報表的參數數量一致，如原本報表有三個參數，用 URL 傳遞時也必須有三個參數，除非參數已經有預設值且提示屬性 ( Prompt Property ) 為 False，才能在 URL 省略放置此報表參數。
傳遞參數時要注意參數的型別，如日期型別、整數型別或者字串型別，例如，客戶 ID 原本設定為整數型別，若傳遞時放入英文字母，則執行時會傳回錯誤訊息。

※傳遞報表參數時，如果直接輸入中文參數值或參數是中文或路徑資訊有中文，都會造成 URL 無法解析而回傳錯誤結果。

因此，建議在設計表時，參數的顯示內容可以使用中文，但是實際傳遞的參數值則用數字或是英文字母。如果不得已參數必須使用中文時，可在前端系統組成 URL Access 的階段中，使用 System.Web.HttpUtility.Urlencode ( 中文參數值 ) 的方式將中文參數值轉換為 UNICOD，如此就能正常傳遞參數內容。

報表物件存取
除了瀏覽報表外，URL Access 還可以用來存取報表伺服器中的各項物件，包括