Gepagineerd Power BI-rapport exporteren naar XML (Power BI Report Builder)

  • Artikel

VAN TOEPASSING OP: Power BI Report Builder Power BI Desktop

De XML-renderingextensie retourneert een gepagineerd Power BI-rapport in XML-indeling. Het schema voor de rapport-XML is specifiek voor het rapport en bevat alleen gegevens. Indelingsgegevens worden niet weergegeven en paginering wordt niet onderhouden door de XML-renderingextensie. De XML die door deze extensie wordt gegenereerd, kan worden geïmporteerd in een database, gebruikt als xml-gegevensbericht of verzonden naar een aangepaste toepassing.

Notitie

U kunt gepagineerde rapportdefinitiebestanden (.rdl) maken en wijzigen in Power BI Report Builder.

Rapportitems

In de volgende tabel wordt beschreven hoe rapportitems worden weergegeven.

Artikel Weergavegedrag
Rapport Wordt weergegeven als het element op het hoogste niveau van het XML-document.
Gegevensregio's Wordt weergegeven als een element in het element voor de container. Gegevensgebieden bevatten tabellen, matrix en lijsten die gegevens weergeven als tekst en grafiek, gegevensbalken, sparklines, meters en indicatoren die gegevens visualiseren.
Secties groeperen en detail Elk exemplaar wordt weergegeven als een element in het element voor de container.
Tekstvak Wordt weergegeven als een kenmerk of element in de container.
Rechthoek Wordt weergegeven als een element in de container.
Matrixkolomgroepen Wordt weergegeven als elementen in rijgroepen.
Overzicht Wordt weergegeven als een element in het element voor de container. Kaartlagen zijn onderliggende elementen van de kaart en elke kaartlaag bevat elementen voor hun kaartleden en kenmerken van kaartleden.
Grafiek Wordt weergegeven als een element in het element voor de container. Reeksen zijn onderliggende elementen van de grafiek en categorieën zijn onderliggend element van een reeks. Geeft alle grafieklabels weer voor elke grafiekwaarde. Labels en waarden worden opgenomen als kenmerken.
Gegevensbalk Wordt weergegeven als een element in het element voor de container, vergelijkbaar met een grafiek. Normaal gesproken bevat een gegevensbalk geen hiërarchieën of labels, alleen waarden.
Sparkline Wordt weergegeven als een element in het element voor de container, vergelijkbaar met een grafiek. Normaal gesproken bevat een sparkline geen hiërarchieën of labels, alleen waarden.
Meter Wordt weergegeven als een element in het element voor de container. Wordt weergegeven als één element met de minimum- en maximumwaarden van de schaal, begin- en eindwaarden van het bereik en de waarde van de aanwijzer als kenmerken.
Indicator Wordt weergegeven als een element in het element voor de container, vergelijkbaar met een meter. Wordt weergegeven als één element met de actieve statusnaam, beschikbare statussen en de gegevenswaarde als kenmerken.

Rapporten die worden weergegeven met behulp van de XML-renderingextensie, volgen ook deze regels:

  • XML-elementen en -kenmerken worden weergegeven in de volgorde waarin ze worden weergegeven in de rapportdefinitie.

  • Paginering wordt genegeerd.

  • Paginakopteksten en voetteksten worden niet weergegeven.

  • Verborgen items die niet zichtbaar kunnen worden gemaakt door te schakelen, worden niet weergegeven. In eerste instantie worden zichtbare items en verborgen items weergegeven die zichtbaar kunnen worden gemaakt via een wisselknop.

  • Afbeeldingen, lijnen en aangepaste rapportitems worden genegeerd.

Data types

Aan het tekstvakelement of kenmerk wordt een XSD-gegevenstype toegewezen op basis van de waarden die in het tekstvak worden weergegeven.

Als alle tekstvakwaarden zijn Toegewezen gegevenstype is
Int16, Int32, Int64, UInt16, UInt32, UInt64, Byte, SByte xsd:integer
Decimaal (of decimaal en een geheel getal of bytegegevenstype) xsd:decimal
Float (of Decimal en elk willekeurig geheel getal of bytegegevenstype) xsd:float
Dubbel (of Decimaal en een geheel getal of bytegegevenstype) xsd:double
Datum/tijd- of datum/tijd-verschuiving xsd:dateTime
Tijd xsd:string
Booleaanse waarde xsd:booleaanse waarde
Tekenreeks, teken xsd:string
Overige xsd:string

XML-specifieke renderingregels

In de volgende secties wordt beschreven hoe de XML-renderingextensies de items in het rapport interpreteren.

Hoofdtekst van rapport

Een rapport wordt weergegeven als het hoofdelement van het XML-document. De naam van het element is afkomstig van de eigenschap DataElementName die is ingesteld in het deelvenster Eigenschappen.

Definities van XML-naamruimten en schemareferentiekenmerken worden ook opgenomen in het rapportelement. Variabelen worden vermeld in vetgedrukt gezichtstype:

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

De waarden voor de variabelen zijn als volgt:

Naam Weergegeven als
Rapport Report.DataElementName
ReportURL URLEncoded absolute URL naar het rapport op de server.
SchemaName Report.SchemaName. Als null is, Report.Name. Als Report.Name wordt gebruikt, wordt deze eerst gecodeerd met XmlConvert.EncodeLocalName.
ReportName De naam van het rapport.

Tekstvakken

Tekstvakken worden weergegeven als elementen of kenmerken volgens de eigenschap DataElementStyle RDL. De naam van het element of kenmerk is afkomstig van de eigenschap TextBox.DataElementName RDL.

Grafieken, gegevensbalken en sparklines

Grafieken, gegevensbalken en sparklines worden weergegeven in XML. De gegevens zijn gestructureerd.

Meters en indicatoren

Meters en indicatoren worden weergegeven in XML. De gegevens zijn gestructureerd.

Subrapporten

Een subrapport wordt weergegeven als een element. De naam van het element wordt opgehaald uit de eigenschap DataElementName RDL. De eigenschap TextBoxesAsElements van het rapport overschrijft dat van het subrapport. Naamruimte- en XSLT-kenmerken worden niet toegevoegd aan het subrapportelement.

Rechthoeken

Een rechthoek wordt weergegeven als een element. De naam van het element wordt opgehaald uit de eigenschap DataElementName RDL.

Aangepaste rapportitems

CustomReportItems (CRI) zijn niet zichtbaar voor de renderingextensie. Als er een aangepast rapportitem in het rapport bestaat, wordt het weergegeven als een conventioneel rapportitem.

Afbeeldingen

Afbeeldingen worden niet weergegeven.

Regels

Lijnen worden niet weergegeven.

Tabellen, matrices en lijsten

Tabellen, matrices en lijsten worden weergegeven als een element. De naam van het element is afkomstig van de eigenschap Tablix DataElementName RDL.

Rijen en kolommen

Kolommen worden weergegeven in rijen.

Tablix-hoek

De hoek wordt niet weergegeven. Alleen de inhoud van de hoek wordt weergegeven.

Tablix-cellen

Tablix-cellen worden weergegeven als elementen. De naam van het element wordt opgehaald uit de eigenschap DataElementName RDL van de cel.

Automatische subtotalen

Automatische subtotalen van Tablix worden niet weergegeven.

Rij- en kolomitems die niet worden herhaald met een groep

Items die niet worden herhaald met een groep, zoals labels, subtotalen en totalen, worden weergegeven als elementen. De naam van het element is afkomstig van de eigenschap TablixMember.DataElementName RDL.

De eigenschap TablixMember.DataElementOutput RDL bepaalt of een niet-herhalend item wordt weergegeven.

Als de eigenschap DataElementName van het Tablix-lid niet is opgegeven, wordt in deze vorm een naam voor het niet-herhalende item dynamisch gegenereerd:

RowX Voor niet-herhalende rijen, waarbij X een op nul gebaseerde rijindex is binnen het huidige bovenliggende item.

ColumnY Voor niet-herhalende kolommen, waarbij Y ix een op nul gebaseerde kolomindex binnen het huidige bovenliggende item.

Een niet-herhalende koptekst wordt weergegeven als een onderliggend element van de rij of kolom die niet wordt herhaald met een groep.

Als een niet-herhalend lid geen bijbehorende Tablix-cellen heeft, wordt het niet weergegeven. Dit kan gebeuren in het geval van een Tablix-cel waarin deze meer dan één kolom omvat.

Rijen en kolommen die worden herhaald met een groep

Rijen en kolommen die binnen een groep worden herhaald, worden weergegeven volgens tablix.DataElementOutput-regels. De naam van het element wordt opgehaald uit de eigenschap DataElementName.

Elke unieke waarde binnen een groep wordt weergegeven als een onderliggend element van de groep. De naam van het element wordt opgehaald uit de eigenschap Group.DataElementName.

Als de eigenschapswaarde DataElementOutput gelijk is aan Uitvoer, wordt de koptekst van een herhalend item weergegeven als een onderliggend element van het detailelement.

Aangepaste indelingen en XSL-transformaties

XML-bestanden die worden geproduceerd door de XML-renderingextensie kunnen worden omgezet in vrijwel elke indeling met behulp van XSL-transformaties (XSLT). Deze functionaliteit kan worden gebruikt om gegevens te produceren in indelingen die nog niet worden ondersteund door bestaande renderingextensies. Overweeg om de XML-renderingextensie en XSLT te gebruiken voordat u uw eigen renderingextensie maakt.

Dubbele namen

Als er dubbele namen van gegevenselementen binnen hetzelfde bereik zijn, wordt in de renderer een foutbericht weergegeven.

XSLT-transformaties

De XML-renderer kan een XSLT-transformatie aan de serverzijde toepassen op de oorspronkelijke XML-gegevens. Wanneer een XSLT wordt toegepast, voert de renderer de getransformeerde inhoud uit in plaats van de oorspronkelijke XML-gegevens. De transformatie vindt plaats op de server, niet op de client.

De XSLT die moet worden toegepast op de uitvoer, wordt gedefinieerd in het rapportdefinitiebestand met de eigenschap DataTransform van het rapport of met de parameter XSLT DeviceInfo . Als een van deze waarden is ingesteld, wordt de transformatie uitgevoerd telkens wanneer de XML-renderer wordt gebruikt. Wanneer u abonnementen gebruikt, moet de XSLT worden gedefinieerd in de eigenschap RDL DataTransform.

Als er een XSLT-bestand is opgegeven, vindt de XSLT die is opgegeven in DataTransform eerst plaats, gevolgd door de XSLT die is ingesteld door de instellingen voor apparaatgegevens.

Instellingen voor apparaatgegevens

U kunt enkele standaardinstellingen voor deze renderer wijzigen door de instellingen voor apparaatgegevens te wijzigen, waaronder de volgende:

  • Een transformatie (XSLT) die moet worden toegepast op de XML.

  • Het MIME-type van het XML-document.

  • Of u opmaaktekenreeksen wilt toepassen op gegevens.

  • Of de XML-uitvoer moet worden ingesprongen.

  • Of u de naam van het XML-schema wilt opnemen.

  • De codering voor het XML-document.

  • De bestandsextensie van het XML-document.

Zie instellingen voor XML-apparaatinformatie voor meer informatie.

Gerelateerde inhoud