Eksportér sideinddelt Power BI-rapport til XML (Power BI Report Builder)

  • Artikel

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

XML-gengivelsesudvidelsen returnerer en sideinddelt Power BI-rapport i XML-format. Skemaet for xml-rapporten er specifikt for rapporten og indeholder kun data. Layoutoplysninger gengives ikke, og sideinddeling vedligeholdes ikke af XML-gengivelsesudvidelsen. Den XML-fil, der genereres af denne udvidelse, kan importeres til en database, bruges som en XML-datameddelelse eller sendes til et brugerdefineret program.

Bemærk

Du kan oprette og redigere sideinddelte rapportdefinitionsfiler (.rdl) i Power BI Report Builder.

Rapportelementer

I følgende tabel beskrives det, hvordan rapportelementer gengives.

Artikel Gengivelsesfunktionsmåde
Report Gengives som elementet på øverste niveau i XML-dokumentet.
Dataområder Gengives som et element i elementet for dets objektbeholder. Dataområder omfatter tabel, matrix og liste, der viser data som tekst og diagram, datalinjer, minidiagrammer, målere og indikatorer, der visualiserer data.
Gruppér og detaljesektioner Hver forekomst gengives som et element i elementet for dets objektbeholder.
Text box Gengives som en attribut eller et element i objektbeholderen.
Rektangel Gengives som et element i objektbeholderen.
Matrixkolonnegrupper Gengives som elementer i rækkegrupper.
Tilknytning Gengives som et element i elementet for dets objektbeholder. Kortlag er underordnede elementer i kortet, og hvert kortlag indeholder elementer til deres kortmedlemmer og attributter for kortmedlemmer.
Diagram Gengives som et element i elementet for dets objektbeholder. Serier er underordnede elementer i diagrammet, og kategorier er underordnede elementer i en serie. Gengiver alle diagramnavne for hver diagramværdi. Navne og værdier medtages som attributter.
Datalinje Gengives som et element i elementet for dets objektbeholder på samme måde som et diagram. En datalinje indeholder normalt ikke hierarkier eller navne, kun værdier.
Minidiagram Gengives som et element i elementet for dets objektbeholder på samme måde som et diagram. Et minidiagram indeholder typisk ikke hierarkier eller mærkater, kun værdier.
Måler Gengives som et element i elementet for dets objektbeholder. Gengives som et enkelt element med minimum- og maksimumværdierne for skalaen, start- og slutværdierne for området og værdien af markøren som attributter.
Indikator Gengives som et element i elementet for dets objektbeholder på samme måde som en måler. Gengives som et enkelt element med det aktive tilstandsnavn, tilgængelige tilstande og dataværdien som attributter.

Rapporter, der gengives ved hjælp af XML-gengivelsesudvidelsen, følger også disse regler:

  • XML-elementer og -attributter gengives i den rækkefølge, de vises i rapportdefinitionen.

  • Sideinddeling ignoreres.

  • Sidehoveder og sidefødder gengives ikke.

  • Skjulte elementer, der ikke kan gøres synlige ved at skifte mellem dem, gengives ikke. Indledningsvist gengives synlige elementer og skjulte elementer, der kan gøres synlige via en til/fra-knap.

  • Billeder, linjer og brugerdefinerede rapportelementer ignoreres.

Datatyper

Tekstfeltelementet eller -attributten tildeles en XSD-datatype baseret på de værdier, som tekstfeltet viser.

Hvis alle tekstfeltværdier er Den tildelte datatype er
Int16, Int32, Int64, UInt16, UInt32, UInt64, Byte, SByte xsd:integer
Decimal (eller Decimal og alle heltals- eller bytedatatyper) xsd:decimal
Flydende (eller Decimal og alle heltals- eller bytedatatyper) xsd:float
Dobbelt (eller Decimal og alle heltals- eller bytedatatyper) xsd:double
DateTime eller DateTime-forskydning xsd:dateTime
Time xsd:string
Boolesk xsd:boolesk
Streng, tegn xsd:string
Andet xsd:string

XML-specifikke gengivelsesregler

I følgende afsnit beskrives det, hvordan XML-gengivelsesudvidelserne fortolker elementerne i rapporten.

Brødtekst i rapport

En rapport gengives som rodelementet i XML-dokumentet. Navnet på elementet kommer fra egenskaben DataElementName, der er angivet i ruden Egenskaber.

Definitioner af XML-navneområder og skemareferenceattributter er også inkluderet i rapportelementet. Variabler er angivet med fed ansigtstype:

<Rapport xmlns="SchemaName" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="SchemaNameReportURL&rc%3aSchema=true" Name="ReportName">

Værdierne for variablerne er som følger:

Navn Værdi
Report Report.DataElementName
ReportURL URLEncoded absolut URL-adresse til rapporten på serveren.
SchemaName Report.SchemaName. Hvis null, Report.Name. Hvis Report.Name bruges, kodes den først med XmlConvert.EncodeLocalName.
ReportName Navnet på rapporten.

Tekstbokse

Tekstfelter gengives som elementer eller attributter i henhold til RDL-egenskaben DataElementStyle. Navnet på elementet eller attributten kommer fra egenskaben TextBox.DataElementName RDL.

Diagrammer, datalinjer og minidiagrammer

Diagrammer, datalinjer og minidiagrammer gengives i XML. Dataene er struktureret.

Målere og indikatorer

Målere og indikatorer gengives i XML. Dataene er struktureret.

Underrapporter

En underrapport gengives som et element. Navnet på elementet hentes fra egenskaben DataElementName RDL. Indstillingen af egenskaben TextBoxesAsElements for rapporten tilsidesætter indstillingen for underrapporten. Navneområde- og XSLT-attributter føjes ikke til underrapportelementet.

Rektangler

Et rektangel gengives som et element. Navnet på elementet hentes fra egenskaben DataElementName RDL.

Brugerdefinerede rapportelementer

CRI (CustomReportItems) er ikke synlige for gengivelsesudvidelsen. Hvis der findes et brugerdefineret rapportelement i rapporten, gengives det som et traditionelt rapportelement i gengivelsesudvidelsen.

Billeder

Billeder gengives ikke.

Linjer

Linjer gengives ikke.

Tabeller, matrixer og lister

Tabeller, matrixer og lister gengives som et element. Navnet på elementet kommer fra egenskaben Tablix DataElementName RDL.

Rækker og kolonner

Kolonner gengives i rækker.

Tablixhjørne

Hjørnet gengives ikke. Det er kun indholdet af hjørnet, der gengives.

Tablixceller

Tablixceller gengives som elementer. Navnet på elementet hentes fra cellens RDL-egenskab DataElementName.

Automatiske subtotaler

Automatiske tablix-subtotaler gengives ikke.

Række- og kolonneelementer, der ikke gentages med en gruppe

Elementer, der ikke gentages med en gruppe, f.eks. navne, subtotaler og totaler, gengives som elementer. Navnet på elementet kommer fra egenskaben TablixMember.DataElementName RDL.

Egenskaben TablixMember.DataElementOutput RDL styrer, om et element, der ikke gentages, gengives.

Hvis egenskaben DataElementName for Tablix-medlemmet ikke angives, genereres der dynamisk et navn for det element, der ikke gentages, i denne form:

RowX For rækker, der ikke gentages, hvor X er et nulbaseret rækkeindeks i det aktuelle overordnede.

ColumnY For ikke-gentagne kolonner, hvor Y ix et nulbaseret kolonneindeks i det aktuelle overordnede.

En overskrift, der ikke gentages, gengives som underordnet til den række eller kolonne, der ikke gentages med en gruppe.

Hvis et ikke-gentaget medlem ikke har nogen tilsvarende Tablix-celler, gengives det ikke. Dette kan ske i tilfælde af en Tablix-celle, hvor den strækker sig over mere end én kolonne.

Rækker og kolonner, der gentages med en gruppe

Rækker og kolonner, der gentages i en gruppe, gengives i henhold til regler for Tablix.DataElementOutput. Elementets navn hentes fra egenskaben DataElementName.

Hver entydige værdi i en gruppe gengives som et underordnet element i gruppen. Elementets navn hentes fra egenskaben Group.DataElementName.

Hvis egenskabsværdien DataElementOutput er lig med Output, gengives overskriften for et gentaget element som underordnet til detaljeelementet.

Brugerdefinerede formater og XSL-transformationer

XML-filer, der oprettes af XML-gengivelsesudvidelsen, kan transformeres til næsten ethvert format ved hjælp af XSL-transformationer (XSLT). Denne funktionalitet kan bruges til at oprette data i formater, der ikke allerede understøttes af eksisterende gengivelsesudvidelser. Overvej at bruge XML-gengivelsesudvidelsen og XSLT, før du forsøger at oprette din egen gengivelsesudvidelse.

Duplikerede navne

Hvis der er dublerede navne på dataelementer inden for samme område, vises der en fejlmeddelelse i gengivelsen.

XSLT-transformationer

XML-gengivelsesprogrammet kan anvende en XSLT-transformation på serversiden på de oprindelige XML-data. Når der anvendes en XSLT, returnerer gengivelsen det transformerede indhold i stedet for de oprindelige XML-data. Transformationen sker på serveren, ikke på klienten.

Den XSLT, der skal anvendes på outputtet, er defineret enten i rapportdefinitionsfilen med egenskaben DataTransform for rapporten eller med parameteren XSLT DeviceInfo . Hvis en af disse værdier er angivet, sker transformationen, hver gang XML-gengivelsen bruges. Når du bruger abonnementer, skal XSLT være defineret i egenskaben RDL DataTransform.

Hvis der er angivet en XSLT-fil af både definitionsegenskaben DataTransform og indstillingen for enhedsoplysninger, sker den XSLT, der er angivet i DataTransform, først efterfulgt af XSLT, der er angivet af indstillingerne for enhedsoplysninger.

Indstillinger for enhedsoplysninger

Du kan ændre nogle standardindstillinger for denne gengivelse ved at ændre indstillingerne for enhedsoplysninger, herunder følgende:

  • En transformation (XSLT), der skal anvendes på XML.

  • MIME-typen for XML-dokumentet.

  • Angiver, om formatstrenge skal anvendes på data.

  • Om XML-outputtet skal indrykkes.

  • Angiver, om XML-skemanavnet skal medtages.

  • Kodningen for XML-dokumentet.

  • Filtypenavnet for XML-dokumentet.

Du kan få flere oplysninger under Indstillinger for XML-enhedsoplysninger.

Relateret indhold