內建集合 - 編頁報表中的全域和使用者參考 (報表產生器)

發行項
03/13/2024

適用於：✅Microsoft 報表產生器 (SSRS) ✅ Power BI 報表產生器 ✅ SQL Server Data Tools 中的報表設計師

內建欄位集合包含 Globals 和 User 集合，代表在處理編頁報表時 Reporting Services 所提供的全域值。 Globals 集合提供的值包括報表名稱、開始處理報表的時間，以及報表頁首及頁尾的目前頁碼。 User 集合則提供使用者識別碼和語言設定。您可以在運算式中使用這些值以在報表中篩選結果。

注意

您可以在 Microsoft 報表產生器、Power BI 報表產生器，以及 SQL Server Data Tools 的報表設計師中，建立和修改編頁報表定義 (.rdl) 檔案。

使用 Globals 集合

Globals 集合包含報表的全域變數。這些變數在設計介面上會顯示為具有前置的 & (與號)，例如 [&ReportName] 。下表描述 Globals 集合的成員。

成員	型別	說明
ExecutionTime	DateTime	報表開始執行的日期和時間。
PageNumber	整數	相對於重設頁碼之分頁線的目前頁碼。在開始處理報表時，初始值設為 1。每個呈現之頁面的頁碼會遞增。若要在分頁線內，為矩形、資料區、資料區群組或地圖的頁面編號，請在 PageBreak 屬性中，將 ResetPageNumber 屬性設為 True。在 Tablix 資料行階層群組上不支援。 PageNumber 只能用於頁首或頁尾中的運算式。
ReportFolder	String	報表所在之資料夾的完整路徑。這不包括報表伺服器 URL。
ReportName	String	報表存放在報表伺服器資料庫的名稱。
ReportServerUrl	String	執行報表之報表伺服器的 URL。
TotalPages	整數	相對於重設 PageNumber 之分頁線的總頁碼。如果未設定任何分頁線，此值與 OverallTotalPages 相同。 TotalPages 只能用於頁首或頁尾中的運算式。
PageName	String	頁面名稱。在開始處理報表時，會從 InitialPageName 報表屬性設定初始值。當每個報表項目都經過處理之後，此值會從矩形、資料區、資料區群組或地圖取代為 PageName 的對應值。在 Tablix 資料行階層群組上不支援。 PageName 只能用於頁首或頁尾中的運算式。
OverallPageNumber	整數	整個報表之目前頁面的頁碼。這個值不會受到 ResetPageNumber 的影響。 OverallPageNumber 只能用於頁首或頁尾中的運算式。
OverallTotalPages	整數	整個報表的總頁數。這個值不會受到 ResetPageNumber 的影響。 OverallTotalPages 只能用於頁首或頁尾中的運算式。
RenderFormat	RenderFormat	目前轉譯要求的相關資訊。如需詳細資訊，請參閱下一節中的＜RenderFormat＞。

Globals 集合的成員會傳回變數。如果要在需要特定資料類型的運算式中使用這個集合的成員，必須先轉換變數。例如，若要將執行時間變數轉換成日期格式，請使用 =CDate(Globals!ExecutionTime)。如需詳細資訊，請參閱運算式中的資料類型 (報表產生器及 SSRS)。

RenderFormat

下表描述 RenderFormat的成員。

member	類型	Description
名稱	String	在 RSReportServer 組態檔中註冊之轉譯器的名稱。可在報表處理/呈現週期的特定部分使用。
IsInteractive	布林值	目前的轉譯要求是否使用互動式轉譯格式。
DeviceInfo	唯讀名稱/值集合	目前轉譯要求之 deviceinfo 參數的索引鍵/值配對。您可以使用索引鍵或索引指定集合中的字串值。

範例

下列範例說明如何在運算式中使用 Globals 集合的參考。

這個放在報表頁尾之文字方塊中的運算式，會提供報表的頁碼與總頁數：

=Globals.PageNumber & " of " & Globals.TotalPages
這個運算式提供報表的名稱及其執行時間。時間格式採用 Microsoft .NET Framework 的簡短日期格式字串：

=Globals.ReportName & ", dated " & Format(Globals.ExecutionTime, "d")
這個放在所選資料行之 [資料行可見性] 對話方塊中的運算式，只會在報表匯出至 Excel 之後顯示資料行；其他時候則會隱藏資料行。

EXCELOPENXML 是指 Office 2007 隨附的 Excel 格式。 EXCEL 是指 Office 2003 隨附的 Excel 格式。

=IIF(Globals!RenderFormat.Name = "EXCELOPENXML" OR Globals!RenderFormat.Name = "EXCEL", false, true)

使用 User 集合

User 集合包含正在執行報表之使用者的相關資料。您可以利用此集合來篩選出現在報表中的資料 (例如，只顯示目前使用者的資料)，或是在報表標題中顯示 UserID 或其他項目。這些變數在設計介面上會顯示為具有前置的 & (與號)，例如 [&UserID] 。

下表描述 User 集合的成員。

成員	型別	說明
語言	String	執行報表之使用者的語言。例如： `en-US` 。
UserID	String	執行報表之使用者的識別碼。如果您是使用 Windows 驗證，此值為目前使用者的網域帳戶。這個值是由報表產生器安全性延伸模組所決定，此延伸模組可使用 Windows 驗證或自訂驗證。

使用地區設定

若要決定對使用者顯示報表的方式，您可以利用運算式，透過 User.Language 值來參考用戶端電腦上的本機設定。例如，您可以建立報表來使用以本機值為基礎的不同查詢運算式。查詢可能會根據傳回的語言，從不同的資料行擷取當地語系化的資訊。您也可以在報表的語言設定或根據此變數的報表項目中使用運算式。

注意

變更報表的語言設定時，您必須注意可能會造成的顯示問題。例如，變更報表的地區設定可能會變更報表中的日期格式，也可能會變更貨幣格式。除非有貨幣轉換程序，否則這可能會造成不正確的貨幣符號在報表中顯示。若要避免這種狀況，請您為每個要變更的項目個別設定其語言資訊，或將項目的貨幣資料設定為特定的語言。

識別快照集或歷程記錄報表的 UserID

在某些情況下，包含 User!UserID 變數的報表將無法顯示正在檢視報表之目前使用者特定的報表資料。

另請參閱

運算式 (報表產生器及 SSRS)
運算式對話方塊 (報表產生器)
運算式中的資料類型 (報表產生器及 SSRS)
格式化數字和日期 (報表產生器及 SSRS)
運算式範例 (報表產生器及 SSRS)