Udtryk i Power BI Report Builder
GÆLDER FOR: 
Power BI Report Builder 
Power BI Desktop
Udtryk bruges i vid udstrækning i sideinddelte rapporter i Power BI Report Builder til at hente, beregne, vise, gruppere, sortere, filtrere, parameterisere og formatere data.
Mange egenskaber for rapportelement kan angives til et udtryk. Udtryk hjælper dig med at styre indholdet, designet og interaktiviteten i din rapport. Udtryk skrives i Microsoft Visual Basic, gemmes i rapportdefinitionen og evalueres af rapportbehandleren, når du kører rapporten.
I modsætning til programmer som Microsoft Excel, hvor du arbejder med data direkte i et regneark, arbejder du i en rapport med udtryk, der er pladsholdere for data. Hvis du vil se de faktiske data fra de evaluerede udtryk, skal du få vist rapporten. Når du kører rapporten, evaluerer rapportbehandleren hvert udtryk, da det kombinerer rapportdata og rapportlayoutelementer, f.eks. tabeller og diagrammer.
Når du designer en rapport, angives der mange udtryk for rapportelementer for dig. Når du f.eks. trækker et felt fra dataruden til en tabelcelle i rapportdesignområdet, angives tekstfeltværdien til et simpelt udtryk for feltet. I følgende figur viser ruden Rapportdata felterne ID, Navn, SalesTerritory, Code og Sales. Der er føjet tre felter til tabellen: [Name], [Code]og [Sales]. Notationen [Name] i designområdet repræsenterer det underliggende udtryk =Fields!Name.Value.
Når du får vist rapporten, kombinerer rapportbehandleren tabeldataområdet med de faktiske data fra dataforbindelsen og viser en række i tabellen for hver række i resultatsættet.
Hvis du vil angive udtryk manuelt, skal du vælge et element i designområdet og bruge genvejsmenuer og dialogbokse til at angive egenskaberne for elementet. Når du ser knappen (fx) eller værdien <Expression> på en rulleliste, ved du, at du kan angive egenskaben til et udtryk.
Forstå enkle og komplekse udtryk
Udtryk begynder med et lighedstegn (=) og skrives i Microsoft Visual Basic. Udtryk kan omfatte en kombination af konstanter, operatorer og referencer til indbyggede værdier (felter, samlinger og funktioner) og til ekstern eller brugerdefineret kode.
Du kan bruge udtryk til at angive værdien af mange egenskaber for rapportelementet. De mest almindelige egenskaber er værdier for tekstfelter og pladsholdertekst. Hvis et tekstfelt kun indeholder ét udtryk, er udtrykket typisk værdien af egenskaben for tekstfeltet. Hvis et tekstfelt indeholder flere udtryk, er hvert udtryk værdien af pladsholdertekst i tekstfeltet.
Udtryk vises som standard i rapportdesignområdet som simple eller komplekse udtryk.
Simpelt: Et simpelt udtryk indeholder en reference til et enkelt element i en indbygget samling, f.eks. et datasætfelt, en parameter eller et indbygget felt. I designområdet vises et simpelt udtryk i kantede parenteser. Svarer f.eks
[FieldName]. til det underliggende udtryk=Fields!FieldName.Value. Enkle udtryk oprettes automatisk for dig, når du opretter rapportlayoutet og trækker elementer fra ruden Rapportdata til designområdet. Du kan få flere oplysninger om de symboler, der repræsenterer forskellige indbyggede samlinger, under Forstå præfikssymboler for simple udtryk.Kompleks: Et komplekst udtryk indeholder referencer til flere indbyggede referencer, operatorer og funktionskald. Et komplekst udtryk vises, som
<<Expr>>når udtryksværdien indeholder mere end en simpel reference. Hvis du vil have vist udtrykket, skal du holde markøren over det og bruge værktøjstippet. Hvis du vil redigere udtrykket, skal du åbne det i dialogboksen Udtryk .
Følgende figur viser typiske enkle og komplekse udtryk for både tekstfelter og pladsholdertekst.
Hvis du vil have vist eksempelværdier i stedet for tekst til udtryk, skal du anvende formatering på tekstfeltet eller pladsholderteksten. Følgende figur viser rapportdesignområdet slået til for at vise eksempelværdier:
Forstå præfikssymboler i simple udtryk
Simple udtryk bruger symboler til at angive, om referencen er til et felt, en parameter, en indbygget samling eller Samlingen ReportItems . I følgende tabel vises eksempler på visnings- og udtrykstekst:
| Artikel | Eksempel på visning af tekst | Eksempel på udtrykstekst |
|---|---|---|
| Datasætfelter | [Sales] [SUM(Sales)] [FIRST(Store)] |
=Fields!Sales.Value=Sum(Fields!Sales.Value)=First(Fields!Store.Value) |
| Rapportparametre | [@Param] [@Param.Label] |
=Parameters!Param.Value =Parameters!Param.Label |
| Indbyggede felter | [&ReportName] |
=Globals!ReportName.Value |
| Konstanttegn, der bruges til visning af tekst | \[Sales\] |
[Sales] |
Skriv komplekse udtryk
Udtryk kan indeholde referencer til funktioner, operatorer, konstanter, felter, parametre, elementer fra indbyggede samlinger og til integreret brugerdefineret kode eller brugerdefinerede assemblies.
I følgende tabel vises de typer referencer, du kan medtage i et udtryk:
| Referencer | Beskrivelse | Eksempel |
|---|---|---|
| Konstanter | Beskriver de konstanter, du kan få interaktiv adgang til for egenskaber, der kræver konstante værdier, f.eks. skriftfarver. | ="Blue" |
| Operatorer | Beskriver de operatorer, du kan bruge til at kombinere referencer i et udtryk. Operatoren & bruges f.eks. til sammenkædning af strenge. | ="The report ran at: " & Globals!ExecutionTime & "." |
| Indbyggede samlinger | Beskriver de indbyggede samlinger, som du kan inkludere i et udtryk, f.eks Fields. , Parametersog Variables. |
=Fields!Sales.Value=Parameters!Store.Value=Variables!MyCalculation.Value |
| Indbyggede rapport- og aggregeringsfunktioner | Beskriver de indbyggede funktioner, f.eks Sum . eller Previous, som du kan få adgang til fra et udtryk. |
=Previous(Sum(Fields!Sales.Value)) |
| Brugerdefinerede kode- og assemblyreferencer i udtryk i Report Builder | Beskriver, hvordan du kan få adgang til de indbyggede CLR-klasser xref:System.Math og xref:System.Convert, andre CLR-klasser, Biblioteksfunktioner til kørsel i Visual Basic eller metoder fra en ekstern assembly.Beskriver, hvordan du kan få adgang til brugerdefineret kode, der er integreret i din rapport, eller som du kompilerer og installerer som en brugerdefineret assembly på både rapportklienten og rapportserveren. |
=Sum(Fields!Sales.Value)=CDate(Fields!SalesDate.Value)=DateAdd("d",3,Fields!BirthDate.Value) =Code.ToUSD(Fields!StandardCost.Value) |
Valider udtryk
Når du opretter et udtryk for en bestemt rapportelementegenskab, afhænger de referencer, du kan medtage i et udtryk, af de værdier, som egenskaben for rapportelementet kan acceptere, og det omfang, som egenskaben evalueres i. Eksempler:
Udtrykket beregner som standard
[Sum]summen af data, der er i området på det tidspunkt, hvor udtrykket evalueres. For en tabelcelle afhænger omfanget af medlemskaber af række- og kolonnegrupper.Værdien for egenskaben Font skal evalueres til navnet på en skrifttype.
Udtrykssyntaks valideres på designtidspunktet. Validering af udtryksområde finder sted, når du publicerer rapporten. I forbindelse med validering, der afhænger af de faktiske data, kan der kun registreres fejl på kørselstidspunktet. Nogle af disse udtryk producerer #Error som en fejlmeddelelse i den gengivne rapport.