Del via

Rapportdefinisjonsspråk (RDL)

  • Artikkel

GJELDER FOR: Power BI Report Builder Power BI Desktop

Rdl (Report Definition Language) er en XML-representasjon av en paginert rapportdefinisjon. En rapportdefinisjon inneholder informasjon om datahenting og oppsett for en rapport. RDL består av XML-elementer som samsvarer med en XML-grammatikk som er opprettet for Power BI. Du kan legge til dine egne egendefinerte funksjoner for å kontrollere verdier, stiler og formatering for rapportelementer ved å få tilgang til kodeblokker i rapportdefinisjonsfiler.

RDL fremmer interoperabiliteten til kommersielle rapporteringsprodukter ved å definere et felles skjema som muliggjør utveksling av rapportdefinisjoner. Alle protokoller eller programmatiske grensesnitt som fungerer med XML, kan brukes med RDL. RDL er:

  • Et XML-skjema for rapportdefinisjoner.
  • Et utvekslingsformat for bedrifter og tredjeparter.
  • Et utvidbart og åpent skjema som støtter flere navneområder og egendefinerte elementer.

RDL-spesifikasjoner

Hvis du vil laste ned spesifikasjoner for bestemte skjemaversjoner, kan du se Rapportdefinisjonsspråkspesifikasjon.

RDL XML-skjemadefinisjon

RDL-filen (Report Definition Language) valideres ved hjelp av en XSD-fil (XML Schema Definition). Skjemaet definerer reglene for hvor RDL-elementer kan forekomme i en RDL-fil. Et element inkluderer datatypen og kardinaliteten, det vil eksempelvis antall forekomster som er tillatt. Et element kan være enkelt eller komplekst. Et enkelt element har ikke underordnede elementer eller attributter. Et komplekst element har underordnede og eventuelt attributter.

Skjemaet inneholder for eksempel RDL-elementet ReportParameters, som er den komplekse typen ReportParametersType. Etter konvensjon er en kompleks type for et element navnet på elementet etterfulgt av ordet Type. Et ReportParameters-element kan inneholdes av rapportelementet (en kompleks type), og kan inneholde ReportParameter-elementer . En ReportParameterType er en enkel type som bare kan være én av følgende verdier: Boolsk, DateTime, Heltall, Flyt eller Streng. Hvis du vil ha mer informasjon om XML-skjemadatatyper, kan du se XML-skjema del 2: Datatyper second edition.

Oppretter RDL

På grunn av RDLs åpne og utvidbare natur kan en rekke verktøy og programmer bygges som genererer RDL basert på XML-skjemaet.

Power BI Report Builder er den foretrukne måten å redigere RDL-baserte paginerte rapporter på.

En av de enkleste måtene å generere RDL fra et program på, er å bruke Microsoft .NET Framework-klassene i navneområdet System.Xml og System.Linq navneområdet. Spesielt én klasse, XmlTextWriter-klassen , kan brukes til å skrive RDL. Med XmlTextWriter kan du generere en fullstendig rapportdefinisjon fra start til slutt i et hvilket som helst .NET Framework-program. Utviklere kan også utvide RDL ved å legge til egendefinerte rapportelementer med egendefinerte egenskaper. Hvis du vil ha mer informasjon om XmlTextWriter-klassen og navneområdet System.Xml , kan du se utviklerveiledningen for Microsoft .NET Framework. Hvis du vil ha mer informasjon om språkintegrert spørring (LINQ), kan du søke etter LINQ til XML på MSDN.

Standard filtype for rapportdefinisjonsfiler er RDL. MIME-typen er tekst/xml.

RDL-typer

Tabellen nedenfor viser typer som brukes i RDL-elementer og -attributter.

Type Bekrivelse
Binær En egenskap med en grunntall-64-kodet binærverdi.
Boolsk En egenskap med sann eller usann som verdien for objektet. Med mindre annet er angitt, er verdien for et utelatt valgfritt boolsk objekt Usann.
Dato En egenskap med en fullstendig angitt dato- eller datetime-verdi angitt i ISO8601 datoformat: YYYY-MM-DD[THH:MM[:SS[. S]]].
Opplisting En egenskap med en strengtekstverdi som må være én av en liste med angitte verdier.
Flyte En egenskap med en flytverdi. Et punktum (.) brukes som valgfritt desimalskilletegn.
Heltall En egenskap med en heltallsverdi (int32).
Språk En egenskap med en tekstverdi som inneholder en språk- og kulturkode, for eksempel «en-us» for amerikansk engelsk. Verdien må enten være et bestemt språk eller et nøytralt språk som et standardspråk er definert for i Microsoft .NET Framework.
Navn En egenskap med en strengtekstverdi. Navn må være unike i navneområdet for elementet. Hvis det ikke er angitt, er navneområdet for et element det innerste som inneholder et objekt som har et navn.
NormalizedString En egenskap med en strengtekstverdi som er normalisert.
Størrelse Et størrelseselement må inneholde et tall (med et punktumstegn som brukes som et valgfritt desimalskilletegn). Tallet må etterfølges av en utformingsenhet for en CSS-lengdeenhet, for eksempel cm, mm, in, pt eller pc. Et mellomrom mellom tallet og utformingstegnet er valgfritt. Hvis du vil ha mer informasjon om størrelsesutpekere, kan du se CSS-verdier og enhetsreferanse.

I RDL er maksimumsverdien for Størrelse 160 i. Minimumsstørrelsen er 0 i.
Streng En egenskap med en strengtekstverdi.
UnsignedInt En egenskap med en ikke-signert heltallsverdi (uint32).
Variant En egenskap med en enkel XML-type.

RDL-datatyper

DataTypeopplisting definerer datatypen for et attributt, uttrykk eller parameter i RDL. Tabellen nedenfor viser hvordan vanlige datatyper for språkkjøring (CLR) samsvarer med RDL-datatyper.

CLR-type(er) Tilsvarende datatype
Boolean Boolean
DateTime, DateTimeOffset DateTime
Int16, Int32, UInt16, Byte, SByte Integer
Enkel, dobbel Float
Streng, tegn, GUID, tidsrom Streng

Relatert innhold