Wbudowane kolekcje — odwołania globalne i odwołania użytkowników w raporcie podzielonym na strony (Power BI Report Builder)
DOTYCZY: Power BI Report Builder
Power BI Desktop
Wbudowana kolekcja pól, która zawiera zarówno kolekcje Globalne, jak i Kolekcje użytkowników, reprezentują wartości globalne udostępniane przez usługi Reporting Services po przetworzeniu raportu podzielonego na strony. Kolekcja Globals zawiera wartości, takie jak nazwa raportu, czas rozpoczęcia przetwarzania raportu i bieżące numery stron nagłówka lub stopki raportu. Kolekcja Użytkownik udostępnia identyfikator użytkownika i ustawienia języka. Te wartości mogą być używane w wyrażeniach do filtrowania wyników w raporcie.
Korzystanie z kolekcji Globals
Kolekcja Globals zawiera zmienne globalne raportu. Na powierzchni projektowej te zmienne są poprzedzone prefiksem i (ampersand), na przykład [&ReportName]
. W poniższej tabeli opisano elementy członkowskie kolekcji Globals .
Członek | Type | Opis |
---|---|---|
Czas wykonywania | Data/godzina | Data i godzina rozpoczęcia działania raportu. |
Numer strony | Wartość całkowita | Bieżący numer strony względem podziałów stron, które resetuje numer strony. Na początku przetwarzania raportu początkowa wartość jest ustawiona na 1. Liczba stron zwiększa się dla każdej renderowanej strony. Aby numerować strony w podziałach stron dla prostokąta, regionu danych, grupy regionów danych lub mapy, we właściwości PageBreak ustaw właściwość ResetPageNumber na true. Nieobsługiwane w grupach hierarchii kolumn elementu tablix. PageNumber można używać tylko w wyrażeniu w nagłówku strony lub stopce strony. |
TotalPages | Wartość całkowita | Całkowita liczba stron w stosunku do podziałów stron, które zresetuj wartość PageNumber. Jeśli nie ustawiono podziałów stron, ta wartość jest taka sama jak w kolumnie OverallTotalPages. Wartości TotalPages można używać tylko w wyrażeniu w nagłówku strony lub stopce strony. |
Nazwa strony | ciąg | Nazwa strony. Na początku przetwarzania raportu początkowa wartość jest ustawiana z InitialPageName, właściwości raportu. W miarę przetwarzania każdego elementu raportu ta wartość jest zastępowana odpowiednią wartością PageName z prostokąta, regionu danych, grupy regionów danych lub mapy. Nieobsługiwane w grupach hierarchii kolumn elementu tablix. PageName można używać tylko w wyrażeniu w nagłówku strony lub stopce strony. |
OverallPageNumber | Wartość całkowita | Numer strony bieżącej strony dla całego raportu. Ta wartość nie ma wpływu na wartość ResetPageNumber. Parametr OverallPageNumber może być używany tylko w wyrażeniu w nagłówku strony lub stopce strony. |
OverallTotalPages | Wartość całkowita | Łączna liczba stron dla całego raportu. Ta wartość nie ma wpływu na wartość ResetPageNumber. Wartości OverallTotalPages można używać tylko w wyrażeniu w nagłówku strony lub stopce strony. |
RenderFormat | RenderFormat | Informacje o bieżącym żądaniu renderowania. Aby uzyskać więcej informacji, zobacz "RenderFormat" w następnej sekcji. |
Członkowie kolekcji Globals zwracają wariant. Jeśli chcesz użyć elementu członkowskiego tej kolekcji w wyrażeniu, które wymaga określonego typu danych, musisz najpierw rzutować zmienną. Aby na przykład przekonwertować wariant czasu wykonywania na format Daty, użyj polecenia =CDate(Globals!ExecutionTime)
. Aby uzyskać więcej informacji, zobacz Typy danych w wyrażeniach (Power BI Report Builder).
RenderFormat
W poniższej tabeli opisano składowe elementu RenderFormat.
Element członkowski | Type | opis |
---|---|---|
Nazwa/nazwisko | ciąg | Nazwa zarejestrowanego modułu renderowania. Dostępne w określonych częściach cyklu przetwarzania/renderowania raportu. |
IsInteractive | Wartość logiczna | Określa, czy bieżące żądanie renderowania używa interaktywnego formatu renderowania. |
Informacje o urządzeniu | Kolekcja nazwa/wartość tylko do odczytu | Pary klucz/wartość dla parametrów deviceinfo dla bieżącego żądania renderowania. Wartości ciągów można określić przy użyciu klucza lub indeksu w kolekcji. |
Przykłady
W poniższych przykładach pokazano, jak używać odwołania do kolekcji Globals w wyrażeniu:
To wyrażenie, umieszczone w polu tekstowym w stopce raportu, zawiera numer strony i łączną liczbę stron w raporcie:
=Globals.PageNumber & " of " & Globals.TotalPages
To wyrażenie zawiera nazwę raportu i czas jego uruchomienia. Godzina jest formatowana za pomocą ciągu formatowania programu Microsoft .NET Framework dla daty krótkiej:
=Globals.ReportName & ", dated " & Format(Globals.ExecutionTime, "d")
To wyrażenie, umieszczone w oknie dialogowym Widoczność kolumny dla wybranej kolumny, wyświetla kolumnę tylko wtedy, gdy raport jest eksportowany do programu Excel. W przeciwnym razie kolumna jest ukryta.
EXCELOPENXML
odnosi się do formatu programu Excel zawartego w pakiecie Office 2007.EXCEL
odnosi się do formatu programu Excel zawartego w pakiecie Office 2003.=IIF(Globals!RenderFormat.Name = "EXCELOPENXML" OR Globals!RenderFormat.Name = "EXCEL", false, true)
Korzystanie z kolekcji użytkowników
Kolekcja użytkownika zawiera dane dotyczące użytkownika, który uruchamia raport. Za pomocą tej kolekcji można filtrować dane wyświetlane w raporcie, na przykład pokazując tylko dane bieżącego użytkownika lub wyświetlać identyfikator UserID, na przykład w tytule raportu. Na powierzchni projektowej te zmienne są poprzedzone prefiksem i (ampersand), na przykład [&UserID]
.
W poniższej tabeli opisano elementy członkowskie kolekcji Użytkownik .
Członek | Type | Opis |
---|---|---|
Język | ciąg | Język użytkownika uruchamiającego raport. Na przykład en-US . |
UserID | ciąg | Identyfikator użytkownika uruchamiającego raport. |
Korzystanie z ustawień regionalnych
Wyrażenia umożliwiają odwoływanie się do ustawień regionalnych na komputerze klienckim za pomocą wartości User.Language w celu określenia sposobu wyświetlania raportu użytkownikowi. Możesz na przykład utworzyć raport, który używa innego wyrażenia zapytania na podstawie wartości ustawień regionalnych. Zapytanie może ulec zmianie w celu pobrania zlokalizowanych informacji z innej kolumny w zależności od zwracanego języka. Możesz również użyć wyrażenia w ustawieniach języka elementów raportu lub raportu na podstawie tej zmiennej.
Uwaga
Chociaż możesz zmienić ustawienia języka raportu, należy zachować ostrożność w przypadku wszelkich problemów z wyświetlaniem, które mogą to spowodować. Na przykład zmiana ustawień regionalnych raportu może zmienić format daty w raporcie, ale może również zmienić format waluty. Jeśli nie istnieje proces konwersji waluty, może to spowodować wyświetlenie niepoprawnego symbolu waluty w raporcie. Aby tego uniknąć, ustaw informacje o języku dotyczące poszczególnych elementów, które chcesz zmienić, lub ustaw element z danymi walutowymi na określony język.