Dela via

Inbyggda samlingar – Globaler och användarreferenser i en sidnumrerad rapport (Power BI Report Builder)

  • Artikel

GÄLLER FÖR: Power BI Report Builder Power BI Desktop

Den inbyggda fältsamlingen , som innehåller både global- och användarsamlingarna , representerar globala värden som tillhandahålls av Reporting Services när en sidnumrerad rapport bearbetas. Samlingen Globals innehåller värden som rapportens namn, tidpunkten då rapportbearbetningen påbörjades och aktuella sidnummer för rapportens sidhuvud eller sidfot. Användarsamlingen innehåller användaridentifierare och språkinställningar. Dessa värden kan användas i uttryck för att filtrera resultat i en rapport.

Använda samlingen Globals

Samlingen Globals innehåller de globala variablerna för rapporten. På designytan visas de här variablerna föregås av ett &tecken, [&ReportName]till exempel . I följande tabell beskrivs medlemmarna i samlingen Globals .

Medlem Typ Beskrivning
ExecutionTime Datetime Datum och tid då rapporten började köras.
Pagenumber Heltal Det aktuella sidnumret i förhållande till sidbrytningar som återställer sidnumret. I början av rapportbearbetningen anges det ursprungliga värdet till 1. Sidnumret ökar för varje renderad sida.

Om du vill numrera sidor inom sidbrytningar för en rektangel, en dataregion, en dataregiongrupp eller en karta, på egenskapen PageBreak, anger du egenskapen ResetPageNumber till True. Stöds inte i tablix-kolumnhierarkigrupper.

PageNumber kan bara användas i ett uttryck i sidhuvud eller sidfot.
TotalPages Heltal Det totala antalet sidor i förhållande till sidbrytningar som återställer PageNumber. Om inga sidbrytningar anges är det här värdet detsamma som OverallTotalPages.

TotalPages kan bara användas i ett uttryck i sidhuvud eller sidfot.
Sidnamn Sträng Namnet på sidan. I början av rapportbearbetningen anges det ursprungliga värdet från InitialPageName, en rapportegenskap. När varje rapportobjekt bearbetas ersätts det här värdet med motsvarande värde för PageName från en rektangel, en dataregion, en dataregionsgrupp eller en karta. Stöds inte i tablix-kolumnhierarkigrupper.

PageName kan bara användas i ett uttryck i sidhuvud eller sidfot.
OverallPageNumber Heltal Sidnumret för den aktuella sidan för hela rapporten. Det här värdet påverkas inte av ResetPageNumber.

OverallPageNumber kan bara användas i ett uttryck i sidhuvud eller sidfot.
OverallTotalPages Heltal Det totala antalet sidor för hela rapporten. Det här värdet påverkas inte av ResetPageNumber.

OverallTotalPages kan bara användas i ett uttryck i sidhuvud eller sidfot.
RenderFormat RenderFormat Information om den aktuella återgivningsbegäran.

Mer information finns i "RenderFormat" i nästa avsnitt.

Medlemmar i samlingen Globals returnerar en variant. Om du vill använda en medlem i den här samlingen i ett uttryck som kräver en specifik datatyp måste du först omvandla variabeln. Om du till exempel vill konvertera körningstidsvarianten till ett Datum-format använder du =CDate(Globals!ExecutionTime). Mer information finns i Datatyper i uttryck (Power BI Report Builder).

RenderFormat

I följande tabell beskrivs medlemmarna för RenderFormat.

Medlem Typ Beskrivning
Name Sträng Namnet på den registrerade återgivningen.

Tillgänglig under specifika delar av rapportbearbetnings-/återgivningscykeln.
IsInteractive Boolesk Om den aktuella återgivningsbegäran använder ett interaktivt återgivningsformat.
DeviceInfo Skrivskyddat namn/värdesamling Nyckel/värde-par för deviceinfo-parametrar för den aktuella återgivningsbegäran.

Strängvärden kan anges med hjälp av antingen nyckeln eller ett index i samlingen.

Exempel

Följande exempel visar hur du använder en referens till samlingen Globals i ett uttryck:

  • Det här uttrycket, som placeras i en textruta i sidfoten för en rapport, innehåller sidnumret och totalt antal sidor i rapporten:

    =Globals.PageNumber & " of " & Globals.TotalPages

  • Det här uttrycket innehåller namnet på rapporten och den tid då den kördes. Tiden formateras med Formateringssträngen för Microsoft .NET Framework för kort datum:

    =Globals.ReportName & ", dated " & Format(Globals.ExecutionTime, "d")

  • Det här uttrycket, som placeras i dialogrutan Kolumnsynlighet för en markerad kolumn, visar endast kolumnen när rapporten exporteras till Excel. Annars är kolumnen dold.

    EXCELOPENXML refererar till formatet för Excel som ingår i Office 2007. EXCEL refererar till formatet för Excel som ingår i Office 2003.

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

Använda användarsamlingen

Samlingen Användare innehåller data om den användare som kör rapporten. Du kan använda den här samlingen för att filtrera data som visas i en rapport, till exempel visa endast data för den aktuella användaren, eller för att visa UserID, till exempel i en rapportrubrik. På designytan visas de här variablerna föregås av ett &tecken, [&UserID]till exempel .

I följande tabell beskrivs medlemmarna i användarsamlingen.

Medlem Typ Beskrivning
Språk Sträng Språket för användaren som kör rapporten. Exempel: en-US
UserID Sträng ID:t för användaren som kör rapporten.

Använd nationella inställningar Inställningar

Du kan använda uttryck för att referera till nationella inställningar på en klientdator via värdet User.Language för att avgöra hur en rapport visas för användaren. Du kan till exempel skapa en rapport som använder ett annat frågeuttryck baserat på språkvariantvärdet. Frågan kan ändras för att hämta lokaliserad information från en annan kolumn beroende på vilket språk som returneras. Du kan också använda ett uttryck i språkinställningarna för rapporten eller rapportobjekten baserat på den här variabeln.

Kommentar

Du kan ändra språkinställningarna för en rapport, men du måste vara försiktig med eventuella visningsproblem som detta kan orsaka. Om du till exempel ändrar språkinställningen för rapporten kan du ändra datumformatet i rapporten, men det kan också ändra valutaformatet. Om det inte finns en konverteringsprocess för valutan kan det leda till att den felaktiga valutasymbolen visas i rapporten. Undvik detta genom att ange språkinformation om de enskilda objekt som du vill ändra, eller ange objektet med valutadata till ett visst språk.

Nästa steg