Uttryck i Power BI Report Builder

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

Uttryck används ofta i sidnumrerade Power BI Report Builder-rapporter för att hämta, beräkna, visa, gruppera, sortera, filtrera, parameterisera och formatera data.

Många egenskaper för rapportobjekt kan anges till ett uttryck. Uttryck hjälper dig att styra innehållet, designen och interaktiviteten i rapporten. Uttryck skrivs i Microsoft Visual Basic, sparas i rapportdefinitionen och utvärderas av rapportprocessorn när du kör rapporten.

Till skillnad från program som Microsoft Excel där du arbetar med data direkt i ett kalkylblad arbetar du i en rapport med uttryck som är platshållare för data. Om du vill se faktiska data från de utvärderade uttrycken måste du förhandsgranska rapporten. När du kör rapporten utvärderar rapportprocessorn varje uttryck eftersom den kombinerar rapportdata och rapportlayoutelement som tabeller och diagram.

När du utformar en rapport anges många uttryck för rapportobjekt åt dig. När du till exempel drar ett fält från datafönstret till en tabellcell på rapportens designyta, är textrutevärdet inställt på ett enkelt uttryck för fältet. I följande bild visar fönstret Rapportdata fälten ID, Namn, SalesTerritory, Kod och Försäljning. Tre fält har lagts till i tabellen: [Name], [Code]och [Sales]. Notationen [Name] på designytan representerar det underliggande uttrycket =Fields!Name.Value.

När du förhandsgranskar rapporten kombinerar rapportprocessorn tabelldataregionen med faktiska data från dataanslutningen och visar en rad i tabellen för varje rad i resultatuppsättningen.

Om du vill ange uttryck manuellt väljer du ett objekt på designytan och använder snabbmenyer och dialogrutor för att ange objektets egenskaper. När du ser knappen (fx) eller värdet <Expression> i en listruta vet du att du kan ange egenskapen till ett uttryck.

Förstå enkla och komplexa uttryck

Uttryck börjar med ett likhetstecken (=) och skrivs i Microsoft Visual Basic. Uttryck kan innehålla en kombination av konstanter, operatorer och referenser till inbyggda värden (fält, samlingar och funktioner) och till extern eller anpassad kod.

Du kan använda uttryck för att ange värdet för många egenskaper för rapportobjekt. De vanligaste egenskaperna är värden för textrutor och platshållartext. Om en textruta bara innehåller ett uttryck är uttrycket vanligtvis värdet för textruteegenskapen. Om en textruta innehåller flera uttryck är varje uttryck värdet för platshållartext i textrutan.

Som standard visas uttryck på rapportdesignytan som enkla eller komplexa uttryck.

• Enkelt: Ett enkelt uttryck innehåller en referens till ett enskilt objekt i en inbyggd samling, till exempel ett datauppsättningsfält, en parameter eller ett inbyggt fält. På designytan visas ett enkelt uttryck inom hakparenteser. Motsvarar till exempel [FieldName] det underliggande uttrycket =Fields!FieldName.Value. Enkla uttryck skapas automatiskt när du skapar rapportlayouten och drar objekt från fönstret Rapportdata till designytan. Mer information om de symboler som representerar olika inbyggda samlingar finns i Förstå prefixsymboler för enkla uttryck.

• Komplext: Ett komplext uttryck innehåller referenser till flera inbyggda referenser, operatorer och funktionsanrop. Ett komplext uttryck visas som <<Expr>> när uttrycksvärdet innehåller mer än en enkel referens. Om du vill visa uttrycket hovra över det och använda knappbeskrivningen. Om du vill redigera uttrycket öppnar du det i dialogrutan Uttryck .

Följande bild visar typiska enkla och komplexa uttryck för både textrutor och platshållartext.

Om du vill visa exempelvärden i stället för text för uttryck använder du formatering för textrutan eller platshållartexten. Följande bild visar rapportdesignytan växlad för att visa exempelvärden:

Förstå prefixsymboler i enkla uttryck

Enkla uttryck använder symboler för att ange om referensen är till ett fält, en parameter, en inbyggd samling eller ReportItems-samlingen . I följande tabell visas exempel på visnings- och uttryckstext:

Artikel	Exempel på visningstext	Exempel på uttryckstext
Datauppsättningsfält	[Sales] [SUM(Sales)] [FIRST(Store)]	=Fields!Sales.Value =Sum(Fields!Sales.Value) =First(Fields!Store.Value)
Rapportparametrar	[@Param] [@Param.Label]	=Parameters!Param.Value =Parameters!Param.Label
Inbyggda fält	[&ReportName]	=Globals!ReportName.Value
Literaltecken som används för visningstext	\[Sales\]	[Sales]

Skriva komplexa uttryck

Uttryck kan innehålla referenser till funktioner, operatorer, konstanter, fält, parametrar, objekt från inbyggda samlingar och till inbäddad anpassad kod eller anpassade sammansättningar.

I följande tabell visas de typer av referenser som du kan inkludera i ett uttryck:

Referenser	beskrivning	Exempel
Konstanter	Beskriver de konstanter som du kan komma åt interaktivt för egenskaper som kräver konstanta värden, till exempel teckensnittsfärger.	="Blue"
Operatorer	Beskriver de operatorer som du kan använda för att kombinera referenser i ett uttryck. Till exempel används operatorn & för att sammanfoga strängar.	="The report ran at: " & Globals!ExecutionTime & "."
Inbyggda samlingar	Beskriver de inbyggda samlingar som du kan inkludera i ett uttryck, till exempel Fields, Parametersoch Variables.	=Fields!Sales.Value =Parameters!Store.Value =Variables!MyCalculation.Value
Inbyggda rapport- och aggregeringsfunktioner	Beskriver de inbyggda funktioner, till exempel eller Previous, som Sum du kan komma åt från ett uttryck.	=Previous(Sum(Fields!Sales.Value))
Anpassade kod- och sammansättningsreferenser i uttryck i Report Builder	Beskriver hur du kan komma åt de inbyggda CLR-klasserna xref:System.Math och xref:System.Convert, andra CLR-klasser, Visual Basic-körningsbiblioteksfunktioner eller metoder från en extern sammansättning. Beskriver hur du kan komma åt anpassad kod som är inbäddad i rapporten eller som du kompilerar och installerar som en anpassad sammansättning på både rapportklienten och rapportservern.	=Sum(Fields!Sales.Value) =CDate(Fields!SalesDate.Value) =DateAdd("d",3,Fields!BirthDate.Value) =Code.ToUSD(Fields!StandardCost.Value)

Verifiera uttryck

När du skapar ett uttryck för en specifik rapportobjektegenskap beror de referenser som du kan inkludera i ett uttryck på de värden som egenskapen för rapportobjektet kan acceptera och det omfång som egenskapen utvärderas i. Till exempel:

• Som standard beräknar uttrycket [Sum] summan av data som finns i omfånget när uttrycket utvärderas. För en tabellcell beror omfånget på rad- och kolumngruppsmedlemskap.

• För värdet för en teckensnittsegenskap måste värdet utvärderas till namnet på ett teckensnitt.

• Uttryckssyntax verifieras vid designtillfället. Verifiering av uttrycksomfång sker när du publicerar rapporten. För validering som är beroende av faktiska data kan fel bara identifieras vid körning. Vissa av dessa uttryck skapar #Error som ett felmeddelande i den renderade rapporten.

Nästa steg

• Vad är sidnumrerade rapporter i Power BI?