使用內建的全域和使用者參考 (報表產生器 3.0 和 SSRS)
內建欄位集合包含 Globals 和 User 集合,代表在處理報表時 Reporting Services 所提供的全域值。Globals 集合提供的值包括報表名稱、開始處理報表的時間,以及報表頁首及頁尾的目前頁碼。User 集合則提供使用者識別碼和語言設定。您可以在運算式中使用這些值以在報表中篩選結果。
[!附註]
您可以在 Business Intelligence Development Studio 中的報表產生器 3.0 及報表設計師中建立及修改報表定義 (.rdl)。每一個撰寫環境都提供了不同的方式讓您建立、開啟,以及儲存報表和相關的項目。如需詳細資訊,請參閱在報表設計師及報表產生器 3.0 (SSRS) 中設計報表,位於 microsoft.com 網站上。
使用 Globals 集合
Globals 集合包含報表的全域變數。這些變數在設計介面上會顯示為具有前置的 & (連字號),例如 [&ReportName]。下表描述 Globals 集合的成員。
成員 |
類型 |
說明 |
---|---|---|
ExecutionTime |
DateTime |
報表開始執行的日期和時間。 |
PageNumber |
Integer |
相對於重設頁碼之分頁線的目前頁碼。在開始處理報表時,初始值設為 1。每個呈現之頁面的頁碼會遞增。 若要在分頁線內,為矩形、資料區、資料區群組或地圖的頁面編號,請在 PageBreak 屬性中,將 ResetPageNumber 屬性設為 True。在 Tablix 資料行階層群組上不支援。 PageNumber 只能用於頁首或頁尾中的運算式。 |
ReportFolder |
String |
報表所在之資料夾的完整路徑。這不包括報表伺服器 URL。 |
ReportName |
String |
報表存放在報表伺服器資料庫的名稱。 |
ReportServerUrl |
String |
執行報表之報表伺服器的 URL。 |
TotalPages |
Integer |
相對於重設 PageNumber 之分頁線的總頁碼。如果未設定任何分頁線,此值與 OverallTotalPages 相同。 TotalPages 只能用於頁首或頁尾中的運算式。 |
PageName |
String |
頁面名稱。在開始處理報表時,會從 InitialPageName 報表屬性設定初始值。當每個報表項目都經過處理之後,此值會從矩形、資料區、資料區群組或地圖取代為 PageName 的對應值。在 Tablix 資料行階層群組上不支援。 PageName 只能用於頁首或頁尾中的運算式。 |
OverallPageNumber |
Integer |
整個報表之目前頁面的頁碼。這個值不會受到 ResetPageNumber 的影響。 OverallPageNumber 只能用於頁首或頁尾中的運算式。 |
OverallTotalPages |
Integer |
整個報表的總頁數。這個值不會受到 ResetPageNumber 的影響。 OverallTotalPages 只能用於頁首或頁尾中的運算式。 |
RenderFormat |
RenderFormat |
目前轉譯要求的相關資訊。 如需詳細資訊,請參閱下一節中的<RenderFormat>。 |
Globals 集合的成員會傳回變數。如果要在需要特定資料類型的運算式中使用這個集合的成員,必須先轉換變數。例如,若要將執行時間變數轉換成日期格式,請使用 =CDate(Globals!ExecutionTime)。如需詳細資訊,請參閱<在運算式中使用資料類型 (報表產生器 3.0 和 SSRS)>。
RenderFormat
下表描述 RenderFormat 的成員。
成員 |
類型 |
說明 |
---|---|---|
名稱 |
String |
在 RSReportServer 組態檔中註冊之轉譯器的名稱。 可在報表處理/呈現週期的特定部分使用。 |
IsInteractive |
Boolean |
目前的轉譯要求是否使用互動式轉譯格式。 |
DeviceInfo |
唯讀名稱/值集合 |
目前轉譯要求之 deviceinfo 參數的索引鍵/值配對。 您可以使用索引鍵或索引指定集合中的字串值。 |
範例
下列範例說明如何在運算式中使用 Globals 集合的參考。
這個放在報表頁尾之文字方塊中的運算式,會提供報表的頁碼與總頁數:
=Globals.PageNumber & " of " & Globals.TotalPages
這個運算式提供報表的名稱及其執行時間。時間格式採用 Microsoft .NET Framework 的簡短日期格式字串:
=Globals.ReportName & ", dated " & Format(Globals.ExecutionTime, "d")
使用 User 集合
User 集合包含正在執行報表之使用者的相關資料。您可以利用此集合來篩選出現在報表中的資料 (例如,只顯示目前使用者的資料),或是在報表標題中顯示 UserID 或其他項目。這些變數在設計介面上會顯示為具有前置的 & (連字號),例如 [&UserID]。
下表描述 User 集合的成員。
成員 |
類型 |
說明 |
---|---|---|
Language |
String |
執行報表之使用者的語言。例如,en-US。 |
UserID |
String |
執行報表之使用者的識別碼。如果您是使用 Windows 驗證,此值為目前使用者的網域帳戶。這個值是由 Reporting Services 安全性延伸模組所決定,此延伸模組可使用 Windows 驗證或自訂驗證。 |
如需有關在報表中支援多國語言的詳細資訊,請參閱《SQL Server 線上叢書》中 Reporting Services 文件集的<適用於多語言或全域部署的解決方案設計考量>。
使用地區設定
若要決定對使用者顯示報表的方式,您可以利用運算式,透過 User.Language 值來參考用戶端電腦上的本機設定。例如,您可以建立報表來使用以本機值為基礎的不同查詢運算式。查詢可能會根據傳回的語言,從不同的資料行擷取當地語系化的資訊。您也可以在報表的語言設定或根據此變數的報表項目中使用運算式。
[!附註]
變更報表的語言設定時,您必須注意可能會造成的顯示問題。例如,變更報表的地區設定可能會變更報表中的日期格式,也可能會變更貨幣格式。除非有貨幣轉換程序,否則這可能會造成不正確的貨幣符號在報表中顯示。若要避免這種狀況,請您為每個要變更的項目個別設定其語言資訊,或將項目的貨幣資料設定為特定的語言。
識別快照集或歷程記錄報表的 UserID
在某些情況下,包含 User!UserID 變數的報表將無法顯示正在檢視報表之目前使用者特定的報表資料。如需詳細資訊,請參閱<報表疑難排解:報表處理>。