Del via

RDL (Report Definition Language)

  • Artikel

GÆLDER FOR: Power BI Report Builder Power BI Desktop

RDL (Report Definition Language) er en XML-repræsentation af en sideinddelt rapportdefinition. En rapportdefinition indeholder oplysninger om datahentning og layout for en rapport. RDL består af XML-elementer, der svarer til en XML-grammatik, der er oprettet til Power BI. Du kan tilføje dine egne brugerdefinerede funktioner til styring af værdier, typografier og formatering for rapportelementet ved at få adgang til kodeblokke i rapportdefinitionsfiler.

RDL fremmer interoperabiliteten af kommercielle rapporteringsprodukter ved at definere et fælles skema, der muliggør udveksling af rapportdefinitioner. Alle protokoller eller programmatiske grænseflader, der fungerer sammen med XML, kan bruges sammen med RDL. RDL er:

  • Et XML-skema til rapportdefinitioner.
  • Et udvekslingsformat til virksomheder og tredjeparter.
  • Et skema, der kan udvides og åbnes, og som understøtter yderligere navneområder og brugerdefinerede elementer.

RDL-specifikationer

Hvis du vil downloade specifikationer for bestemte skemaversioner, skal du se Sprogspecifikation for rapportdefinition.

Definition af RDL XML-skema

RDL-filen (Report Definition Language) valideres ved hjælp af en XSD-fil (XML Schema Definition). Skemaet definerer reglerne for, hvor RDL-elementer kan forekomme i en .rdl-fil. Et element indeholder datatypen og kardinaliteten, dvs. antallet af tilladte forekomster. Et element kan være enkelt eller komplekst. Et simpelt element har ikke underordnede elementer eller attributter. Et komplekst element har underordnede og eventuelt attributter.

Skemaet indeholder f.eks. RDL-elementet ReportParameters, som er den komplekse type ReportParametersType. Efter konvention er en kompleks type for et element navnet på elementet, der følger efter ordet Type. Et ReportParameters-element kan være indeholdt i rapportelementet (en kompleks type) og kan indeholde ReportParameter-elementer. En ReportParameterType er en simpel type, der kun kan være en af følgende værdier: Boolesk, DateTime, Integer, Float eller String. Du kan få flere oplysninger om XML-skemadatatyper i XML-skemadel 2: Datatypes Second Edition.

Opretter RDL

På grund af RDL'ens åbne og udvidelige karakter kan der oprettes en række værktøjer og programmer, der genererer RDL baseret på XML-skemaet.

Power BI Report Builder er den foretrukne måde at oprette RDL-baserede sideinddelte rapporter på.

En af de nemmeste måder at generere RDL fra et program på er ved at bruge Microsoft Microsoft .NET Framework klasser i System.Xml navneområdet og System.Linq navneområdet. Især én klasse, Klassen XmlTextWriter , kan bruges til at skrive RDL. Med XmlTextWriter kan du generere en komplet rapportdefinition fra start til slut i et Microsoft .NET Framework program. Udviklere kan også udvide RDL ved at tilføje brugerdefinerede rapportelementer med brugerdefinerede egenskaber. Du kan få mere at vide om klassen XmlTextWriter og System.Xml navneområdet i Microsoft Microsoft .NET Framework Developer's Guide. Du kan finde flere oplysninger om LINQ (Language-Integrated Query) ved at søge efter "LINQ to XML" på MSDN.

Standardfiludvidelsen for rapportdefinitionsfiler er .rdl. MIME-typen er tekst/xml.

RDL-typer

I følgende tabel vises de typer, der bruges i RDL-elementer og -attributter.

Skriv Description
Binær En egenskab med en base-64-kodet binær værdi.
Boolesk En egenskab med true eller false som værdien af objektet. Medmindre andet er angivet, er værdien af et udeladt valgfrit boolesk objekt False.
Dato En egenskab med en fuldt angivet dato- eller datetime-værdi angivet i ISO8601 datoformat: ÅÅÅÅ-MM-DD[THH:MM[:SS[. S]]].
Optæller En egenskab med en strengtekstværdi, der skal være en af en liste over angivne værdier.
Flyde En egenskab med en flydende værdi. Et punktum (.) bruges som valgfri decimalseparator.
Heltal En egenskab med en heltalsværdi (int32).
Sprog En egenskab med en tekstværdi, der indeholder en sprog- og kulturkode, f.eks. "en-us" for amerikansk engelsk. Værdien skal enten være et bestemt sprog eller et neutralt sprog, som der er defineret et standardsprog for i Microsoft Microsoft .NET Framework.
Navn En egenskab med en strengtekstværdi. Navne skal være entydige i navneområdet for elementet. Hvis det ikke er angivet, er navneområdet for et element det inderste objekt, der indeholder et navn.
Normaliseret streng En egenskab med en strengtekstværdi, der er normaliseret.
Størrelse Et størrelseselement skal indeholde et tal (med et punktumtegn, der bruges som valgfri decimalseparator). Tallet skal efterfølges af en designator for en CSS-længdeenhed, f.eks. cm, mm, in, pt eller pc. Et mellemrum mellem tallet og designatoren er valgfrit. Du kan få flere oplysninger om størrelsesdesignere under Reference til CSS-værdier og enheder.

I RDL er den maksimale værdi for Size 160 in. Minimumstørrelsen er 0 in.
Streng En egenskab med en strengtekstværdi.
Usigneretint En egenskab med en usigneret heltalsværdi (uint32).
Variant En egenskab med en hvilken som helst simpel XML-type.

RDL-datatyper

Optællingen DataType definerer datatypen for en attribut, et udtryk eller en parameter i RDL. I følgende tabel kan du se, hvordan CLR-datatyper (Common Language Runtime) svarer til RDL-datatyper.

CLR-type(r) Tilsvarende datatype
Boolean Boolean
DateTime, DateTimeOffset Dato/klokkeslæt
Int16, Int32, UInt16, Byte, SByte Heltal
Enkelt, dobbelt Flyde
String, Char, GUID, Timespan String

Relateret indhold