Eksporter paginert rapport i Power BI til XML (Power BI Report Builder)

  • Artikkel

GJELDER FOR: Power BI Report Builder Power BI Desktop

Xml-gjengivelsesutvidelsen returnerer en Paginert Power BI-rapport i XML-format. Skjemaet for XML-rapporten er spesifikt for rapporten, og inneholder bare data. Oppsettinformasjon gjengis ikke, og paginering opprettholdes ikke av XML-gjengivelsesutvidelsen. XML-filen som genereres av denne utvidelsen, kan importeres til en database, brukes som en XML-datamelding eller sendes til et egendefinert program.

Merk

Du kan opprette og endre paginerte rapportdefinisjonsfiler (RDL) i Power BI Report Builder.

Rapportelementer

Tabellen nedenfor beskriver hvordan rapportelementer gjengis.

Vare Gjengivelsesvirkemåte
Report Gjengis som elementet på øverste nivå i XML-dokumentet.
Dataområder Gjengis som et element i elementet for beholderen. Dataområder inkluderer tabeller, matriser og lister som viser data som tekst og diagram, datastolper, sparkline-grafikk, målere og indikatorer som visualiserer data.
Gruppe- og detaljinndelinger Hver forekomst gjengis som et element i elementet for beholderen.
Text box Gjengis som et attributt eller element i beholderen.
Rektangel Gjengis som et element i beholderen.
Matrisekolonnegrupper Gjengis som elementer i radgrupper.
Tilordne Gjengis som et element i elementet for beholderen. Kartlag er underordnede elementer i kartet, og hvert kartlag inneholder elementer for kartmedlemmene og tilordne medlemsattributter.
Diagram Gjengis som et element i elementet for beholderen. Serien er underordnede elementer i diagrammet, og kategorier er underordnede elementer i en serie. Gjengir alle diagrametiketter for hver diagramverdi. Etiketter og verdier inkluderes som attributter.
Datastolpe Gjengis som et element i elementet for beholderen, på samme måte som et diagram. Vanligvis inkluderer ikke en datastolpe hierarkier eller etiketter, bare verdier.
Sparkline Gjengis som et element i elementet for beholderen, på samme måte som et diagram. En sparkline inneholder vanligvis ikke hierarkier eller etiketter, bare verdier.
Måler Gjengis som et element i elementet for beholderen. Gjengis som ett enkelt element med minimums- og maksimumsverdiene for skalaen, start- og sluttverdiene i området og verdien for pekeren som attributter.
Indikator Gjengis som et element i elementet for beholderen, på samme måte som en måler. Gjengis som ett enkelt element med det aktive tilstandsnavnet, tilgjengelige tilstander og dataverdien som attributter.

Rapporter som gjengis ved hjelp av xml-gjengivelsesutvidelsen, følger også disse reglene:

  • XML-elementer og -attributter gjengis i den rekkefølgen de vises i rapportdefinisjonen.

  • Paginering ignoreres.

  • Topptekster og bunntekster på siden gjengis ikke.

  • Skjulte elementer som ikke kan gjøres synlige ved å veksle, gjengis ikke. I utgangspunktet gjengis synlige elementer og skjulte elementer som kan gjøres synlige gjennom en veksleknapp.

  • Bilder, linjer og egendefinerte rapportelementer ignoreres.

Datatyper

Tekstbokselementet eller -attributtet tilordnes en XSD-datatype basert på verdiene som tekstboksen viser.

Hvis alle tekstboksverdier er Tilordnet datatype er
Int16, Int32, Int64, UInt16, UInt32, UInt64, Byte, SByte xsd:heltall
Desimal (eller desimaltall og alle heltall eller bytedatatyper) xsd:desimal
Flyt (eller desimaltall og alle heltall eller bytedatatyper) xsd:float
Dobbel (eller Desimal og et hvilket som helst heltall eller byte-datatype) xsd:double
DateTime- eller DateTime-forskyvning xsd:dateTime
Time xsd:string
Boolsk xsd:boolean
Streng, tegn xsd:string
Annet xsd:string

XML-spesifikke gjengivelsesregler

Avsnittene nedenfor beskriver hvordan XML-gjengivelsesutvidelsene tolker elementene i rapporten.

Rapporttekst

En rapport gjengis som rotelementet i XML-dokumentet. Navnet på elementet kommer fra egenskapen DataElementName som er angitt i Egenskaper-ruten.

XML-navneområdedefinisjoner og skjemareferanseattributter er også inkludert i rapportelementet. Variabler er notert i fet ansiktstype:

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

Verdiene for variablene er som følger:

Name Verdi
Report Report.DataElementName
ReportURL URLEncoded absolute URL to the report on the server.
SchemaName Report.SchemaName. Hvis null, så Report.Name. Hvis Report.Name brukes, kodes den først med XmlConvert.EncodeLocalName.
ReportName Navnet på rapporten.

Tekstbokser

Tekstbokser gjengis som elementer eller attributter i henhold til RDL-egenskapen DataElementStyle. Navnet på elementet eller attributtet kommer fra TEXTBox.DataElementName RDL-egenskapen.

Diagrammer, datastolper og sparkline-grafikk

Diagrammer, datastolper og sparkline-grafikk gjengis i XML. Dataene er strukturert.

Målere og indikatorer

Målere og indikatorer gjengis i XML. Dataene er strukturert.

Delrapporter

En delrapport gjengis som et element. Navnet på elementet hentes fra RDL-egenskapen DataElementName. Egenskapsinnstillingen TextBoxesAsElements for rapporten overstyrer delrapporten. Namespace- og XSLT-attributter legges ikke til delrapportelementet.

Rektangler

Et rektangel gjengis som et element. Navnet på elementet hentes fra RDL-egenskapen DataElementName.

Egendefinerte rapportelementer

CustomReportItems (CRI) er ikke synlige for gjengivelsesutvidelsen. Hvis det finnes et egendefinert rapportelement i rapporten, gjengir gjengivelsesutvidelsen det som et vanlig rapportelement.

bilder

Bilder gjengis ikke.

Linjer

Linjer gjengis ikke.

Tabeller, matriser og lister

Tabeller, matriser og lister gjengis som et element. Navnet på elementet kommer fra TABlix DataElementName RDL-egenskapen.

Rader og kolonner

Kolonner gjengis i rader.

Tablix-hjørne

Hjørnet er ikke gjengitt. Bare innholdet i hjørnet gjengis.

Tablix-celler

Tablix-celler gjengis som elementer. Navnet på elementet hentes fra cellens DataElementName RDL-egenskap.

Automatiske delsummer

Tablix automatiske delsummer gjengis ikke.

Rad- og kolonneelementer som ikke gjentas med en gruppe

Elementer som ikke gjentas med en gruppe, for eksempel etiketter, delsummer og totalsummer, gjengis som elementer. Navnet på elementet kommer fra egenskapen TablixMember.DataElementName RDL.

Egenskapen TablixMember.DataElementOutput RDL kontrollerer om et ikke-gjentatt element gjengis.

Hvis Egenskapen DataElementName for Tablix-medlemmet ikke er angitt, genereres et navn for det ikke-gjentatte elementet dynamisk i dette skjemaet:

RowX For rader som ikke gjentas, der X er en nullbasert radindeks i gjeldende overordnede rad.

KolonneY for kolonner som ikke gjentas, der Y ix en nullbasert kolonneindeks i gjeldende overordnede kolonne.

En topptekst som ikke gjentas, gjengis som underordnet raden eller kolonnen som ikke gjentas med en gruppe.

Hvis et ikke-gjentatt medlem ikke har noen tilsvarende Tablix-celler, gjengis det ikke. Dette kan skje når det gjelder en Tablix-celle der den strekker seg over mer enn én kolonne.

Rader og kolonner som gjentas med en gruppe

Rader og kolonner som gjentas i en gruppe gjengis i henhold til Tablix.DataElementOutput-regler. Navnet på elementet hentes fra egenskapen DataElementName.

Hver unike verdi i en gruppe gjengis som et underordnet element i gruppen. Navnet på elementet hentes fra egenskapen Group.DataElementName.

Hvis egenskapsverdien DataElementOutput er lik Utdata, gjengis toppteksten til et gjentatt element som underordnet detaljelementet.

Egendefinerte formater og XSL-transformasjoner

XML-filer som produseres av xml-gjengivelsesutvidelsen, kan transformeres til nesten alle formater ved hjelp av XSL-transformasjoner (XSLT). Denne funksjonaliteten kan brukes til å produsere data i formater som ikke allerede støttes av eksisterende gjengivelsesutvidelser. Vurder å bruke XML-gjengivelsesutvidelsen og XSLT før du prøver å opprette din egen gjengivelsesutvidelse.

Duplikatnavn

Hvis det finnes dupliserte dataelementnavn innenfor samme omfang, viser gjengivelsen en feilmelding.

XSLT-transformasjoner

XML-gjengivelsen kan bruke en XSLT-transformasjon på serversiden på de opprinnelige XML-dataene. Når en XSLT brukes, sender gjengivelsen ut det transformerte innholdet i stedet for de opprinnelige XML-dataene. Transformasjonen skjer på serveren, ikke på klienten.

XSLT som skal brukes på utdataene, defineres enten i rapportdefinisjonsfilen med DataTransform-egenskapen for rapporten eller med XSLT DeviceInfo-parameteren . Hvis en av disse verdiene er angitt, skjer transformeringen hver gang XML-gjengivelsen brukes. Når du bruker abonnementer, må XSLT defineres i RDL DataTransform-egenskapen.

Hvis en XSLT-fil er angitt, forekommer XSLT som er angitt i både datatransformdefinisjonsegenskapen og enhetsinformasjonsinnstillingen, først som er angitt i DataTransform, etterfulgt av XSLT angitt av innstillingene for enhetsinformasjon.

Innstillinger for enhetsinformasjon

Du kan endre noen standardinnstillinger for denne gjengivelsen ved å endre innstillingene for enhetsinformasjon, inkludert følgende:

  • En transformasjon (XSLT) som skal brukes på XML-filen.

  • MIME-typen for XML-dokumentet.

  • Om du vil bruke formatstrenger på data.

  • Om xml-utdataene skal rykkes inn.

  • Om xml-skjemanavnet skal inkluderes.

  • Kodingen for XML-dokumentet.

  • Filtypen til XML-dokumentet.

Hvis du vil ha mer informasjon, kan du se informasjonsinnstillinger for XML-enheten.

Relatert innhold