共用方式為

內建集合 - 編頁報告中的 Globals 和 User 參考 (Power BI Report Builder)

  • 發行項

適用於： Power BI Report Builder Power BI Desktop

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

使用 Globals 集合

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

成員 型別 說明
ExecutionTime DateTime 報表開始執行的日期和時間。
PageNumber 整數 相對於重設頁碼之分頁線的目前頁碼。 在開始處理報表時，初始值設為 1。 每個呈現之頁面的頁碼會遞增。

若要在分頁線內，為矩形、資料區、資料區群組或地圖的頁面編號，請在 PageBreak 屬性中，將 ResetPageNumber 屬性設為 True。 在 Tablix 資料行階層群組上不支援。

PageNumber 只能用於頁首或頁尾中的運算式。
TotalPages 整數 相對於重設 PageNumber 之分頁線的總頁碼。 如果未設定任何分頁線，此值與 OverallTotalPages 相同。

TotalPages 只能用於頁首或頁尾中的運算式。
PageName String 頁面名稱。 在開始處理報表時，會從 InitialPageName 報表屬性設定初始值。 當每個報表項目都經過處理之後，此值會從矩形、資料區、資料區群組或地圖取代為 PageName 的對應值。 在 Tablix 資料行階層群組上不支援。

PageName 只能用於頁首或頁尾中的運算式。
OverallPageNumber 整數 整個報表之目前頁面的頁碼。 這個值不會受到 ResetPageNumber 的影響。

OverallPageNumber 只能用於頁首或頁尾中的運算式。
OverallTotalPages 整數 整個報表的總頁數。 這個值不會受到 ResetPageNumber 的影響。

OverallTotalPages 只能用於頁首或頁尾中的運算式。
RenderFormat RenderFormat 目前轉譯要求的相關資訊。

如需詳細資訊，請參閱下一節中的＜RenderFormat＞。

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

RenderFormat

下表描述 RenderFormat的成員。

member 類型 Description
Name String 已註冊轉譯器的名稱。

可在報表處理/呈現週期的特定部分使用。
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 執行報表之使用者的識別碼。

使用地區設定

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

注意

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

下一步