Dela via

Exportera sidnumrerad Power BI-rapport till XML (Power BI Report Builder)

  • Artikel

GÄLLER FÖR: Power BI Report Builder Power BI Desktop

XML-återgivningstillägget returnerar en sidnumrerad Power BI-rapport i XML-format. Schemat för rapportens XML är specifikt för rapporten och innehåller endast data. Layoutinformation återges inte och sidnumrering underhålls inte av XML-återgivningstillägget. XML-koden som genereras av det här tillägget kan importeras till en databas, användas som ett XML-datameddelande eller skickas till ett anpassat program.

Kommentar

Du kan skapa och ändra sidnumrerade rapportdefinitionsfiler (.rdl) i Power BI Report Builder.

Rapportobjekt

I följande tabell beskrivs hur rapportobjekt återges.

Artikel Återgivningsbeteende
Rapport Renderas som element på den översta nivån i XML-dokumentet.
Dataregioner Renderas som ett element i elementet för containern. Dataområden omfattar tabell, matris och lista som visar data som text och diagram, datastaplar, miniatyrdiagram, mätare och indikatorer som visualiserar data.
Grupp- och detaljavsnitt Varje instans återges som ett element i elementet för containern.
Text box Renderas som ett attribut eller element i containern.
Rektangel Renderas som ett element i containern.
Matriskolumngrupper Renderas som element i radgrupper.
Mappning Renderas som ett element i elementet för containern. Kartskikt är underordnade element på kartan och varje kartskikt innehåller element för sina kartmedlemmar och kartmedlemsattribut.
Diagram Renderas som ett element i elementet för containern. Serier är underordnade element i diagrammet och kategorier är underordnade element i en serie. Renderar alla diagrametiketter för varje diagramvärde. Etiketter och värden ingår som attribut.
Datafält Renderas som ett element i elementet för containern, ungefär som ett diagram. Vanligtvis innehåller ett datafält inte hierarkier eller etiketter, bara värden.
Miniatyrdiagram Renderas som ett element i elementet för containern, ungefär som ett diagram. Ett miniatyrdiagram innehåller vanligtvis inte hierarkier eller etiketter, bara värden.
Mätare Renderas som ett element i elementet för containern. Renderas som ett enda element med minimi- och maxvärdena för skalan, start- och slutvärdena för intervallet och värdet för pekaren som attribut.
Indikator Renderas som ett element i elementet för containern, ungefär som en mätare. Renderas som ett enda element med aktivt tillståndsnamn, tillgängliga tillstånd och datavärdet som attribut.

Rapporter som återges med XML-återgivningstillägget följer också dessa regler:

  • XML-element och -attribut återges i den ordning som de visas i rapportdefinitionen.

  • Sidnumrering ignoreras.

  • Sidhuvuden och sidfötter återges inte.

  • Dolda objekt som inte kan göras synliga genom att växla återges inte. Initialt återges synliga objekt och dolda objekt som kan göras synliga via en växlingsknapp.

  • Bilder, rader och anpassade rapportobjekt ignoreras.

Datatyper

Textruteelementet eller -attributet tilldelas en XSD-datatyp baserat på de värden som textrutan visar.

Om alla textrutevärden är Tilldelad datatyp är
Int16, Int32, Int64, UInt16, UInt32, UInt64, Byte, SByte xsd:heltal
Decimaler (eller decimaler och alla heltals- eller bytedatatyper) xsd:decimal
Flyttal (eller decimal och valfri heltals- eller bytedatatyp) xsd:float
Double (eller Decimal och valfri heltals- eller bytedatatyp) xsd:double
DateTime- eller DateTime-förskjutning xsd:dateTime
Tid xsd:string
Boolesk xsd:booleskt värde
Sträng, tecken xsd:string
Övrigt xsd:string

XML-specifika återgivningsregler

I följande avsnitt beskrivs hur XML-återgivningstilläggen tolkar objekten i rapporten.

Rapporttext

En rapport återges som rotelementet i XML-dokumentet. Namnet på elementet kommer från egenskapen DataElementName som anges i fönstret Egenskaper.

XML-namnområdesdefinitioner och schemareferensattribut ingår också i rapportelementet. Variabler anges med fet ansiktstyp:

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

Värdena för variablerna är följande:

Name Värde
Rapport Report.DataElementName
ReportURL URLEncoded absolut URL till rapporten på servern.
Schemanamn Report.SchemaName. Om värdet är null Report.Name. Om Report.Name används kodas den först med XmlConvert.EncodeLocalName.
ReportName Namnet på rapporten.

Textrutor

Textrutor återges som element eller attribut enligt RDL-egenskapen DataElementStyle. Namnet på elementet eller attributet kommer från RDL-egenskapen TextBox.DataElementName.

Diagram, datastaplar och miniatyrdiagram

Diagram, datastaplar och miniatyrdiagram återges i XML. Data är strukturerade.

Mätare och indikatorer

Mätare och indikatorer återges i XML. Data är strukturerade.

Underrapporter

En underrapport återges som ett element. Namnet på elementet hämtas från RDL-egenskapen DataElementName. Egenskapsinställningen TextBoxesAsElements för rapporten åsidosätter underrapportens. Namnrymds- och XSLT-attribut läggs inte till i underrapportelementet.

Rektanglar

En rektangel återges som ett element. Namnet på elementet hämtas från RDL-egenskapen DataElementName.

Anpassade rapportobjekt

CustomReportItems (CRI) är inte synliga för renderingstillägget. Om det finns ett anpassat rapportobjekt i rapporten återger återgivningstillägget det som ett konventionellt rapportobjekt.

Bilder

Bilder återges inte.

Rader

Linjer återges inte.

Tabeller, matriser och listor

Tabeller, matriser och listor återges som ett element. Namnet på elementet kommer från RDL-egenskapen Tablix DataElementName.

Rader och kolumner

Kolumner återges i rader.

Tablix-hörn

Hörnet återges inte. Endast innehållet i hörnet återges.

Tablix-celler

Tablix-celler återges som element. Namnet på elementet hämtas från cellens RDL-egenskap DataElementName.

Automatiska delsummor

Tablix automatiska delsummor återges inte.

Rad- och kolumnobjekt som inte upprepas med en grupp

Objekt som inte upprepas med en grupp, till exempel etiketter, delsummor och summor, återges som element. Namnet på elementet kommer från egenskapen TablixMember.DataElementName RDL.

Egenskapen TablixMember.DataElementOutput RDL styr om ett icke-upprepande objekt återges.

Om egenskapen DataElementName för Tablix-medlemmen inte anges genereras ett namn för det icke-upprepande objektet dynamiskt i det här formuläret:

RowX För icke-upprepande rader, där X är ett nollbaserat radindex inom det aktuella överordnade objektet.

ColumnY För icke-upprepande kolumner, där Y ix ett nollbaserat kolumnindex inom det aktuella överordnade objektet.

En icke-upprepande rubrik återges som en underordnad rad eller kolumn som inte upprepas med en grupp.

Om en icke-upprepande medlem inte har några motsvarande Tablix-celler återges den inte. Detta kan inträffa när det gäller en Tablix-cell där den sträcker sig över mer än en kolumn.

Rader och kolumner som upprepas med en grupp

Rader och kolumner som upprepas i en grupp återges enligt Tablix.DataElementOutput-regler. Namnet på elementet hämtas från egenskapen DataElementName.

Varje unikt värde i en grupp återges som ett underordnat element i gruppen. Namnet på elementet hämtas från egenskapen Group.DataElementName.

Om egenskapsvärdet DataElementOutput är lika med Utdata återges ett upprepande objekts huvud som underordnat till detaljelementet.

Anpassade format och XSL-transformeringar

XML-filer som skapas av XML-återgivningstillägget kan omvandlas till nästan vilket format som helst med XSL Transformations (XSLT). Den här funktionen kan användas för att skapa data i format som inte redan stöds av befintliga återgivningstillägg. Överväg att använda XML-återgivningstillägget och XSLT innan du försöker skapa ett eget återgivningstillägg.

Duplicerade namn

Om det finns duplicerade dataelementnamn inom samma omfång visar återgivningen ett felmeddelande.

XSLT-transformeringar

XML-renderaren kan använda en XSLT-transformering på serversidan för ursprungliga XML-data. När en XSLT tillämpas matar renderaren ut det transformerade innehållet i stället för de ursprungliga XML-data. Omvandlingen sker på servern, inte på klienten.

XSLT som ska tillämpas på utdata definieras antingen i rapportdefinitionsfilen med datatransformegenskapen för rapporten eller med parametern XSLT DeviceInfo . Om något av dessa värden anges sker transformeringen varje gång XML-renderaren används. När du använder prenumerationer måste XSLT definieras i egenskapen RDL DataTransform.

Om en XSLT-fil anges sker XSLT-filen först av både datatransformdefinitionsegenskapen och enhetens informationsinställning, följt av XSLT-uppsättningen med enhetsinformationsinställningarna.

XSLT-filen ska vara tillgänglig via Internet via https utan att behöva autentisering.

Inställningar för enhetsinformation

Du kan ändra vissa standardinställningar för den här återgivningen genom att ändra inställningarna för enhetsinformation, inklusive följande:

  • En transformering (XSLT) som ska tillämpas på XML.

  • MIME-typen för XML-dokumentet.

  • Om du vill använda formatsträngar för data.

  • Om XML-utdata ska dras in.

  • Om XML-schemanamnet ska inkluderas.

  • Kodningen för XML-dokumentet.

  • Filnamnstillägget för XML-dokumentet.

Mer information finns i INSTÄLLNINGAR för XML-enhetsinformation.

Relaterat innehåll