Share via


Többoldalas Power BI-jelentés exportálása XML-be (Power BI Jelentéskészítő)

A következőkre vonatkozik: Power BI Jelentéskészítő Power BI Desktop

Az XML-renderelési bővítmény egy többoldalas Power BI-jelentést ad vissza XML formátumban. A jelentés XML-sémája a jelentésre jellemző, és csak adatokat tartalmaz. Az elrendezési információk nem jelennek meg, és az XML-renderelési bővítmény nem tartja karban a lapozást. A bővítmény által létrehozott XML importálható egy adatbázisba, használható XML-adatüzenetként, vagy elküldhető egy egyéni alkalmazásnak.

Feljegyzés

Lapszámozott jelentésdefiníciós (.rdl) fájlokat hozhat létre és módosíthat a Power BI Jelentéskészítő.

Jelentéselemek

Az alábbi táblázat a jelentéselemek megjelenítésének módját ismerteti.

Tétel Renderelési viselkedés
Jelentés Az XML-dokumentum legfelső szintű elemeként jelenik meg.
Adatrégiók Elemként jelenik meg a tároló elemében. Az adatrégiók közé tartozik a táblázat, a mátrix és a lista, amely szövegként és diagramként jeleníti meg az adatokat, adatsávokat, értékgörbéket, mérőműszereket és adatokat megjelenítő mutatókat.
Csoportosítási és részletszakaszok Minden példány elemként jelenik meg a tároló elemében.
Szövegmező Attribútumként vagy elemként jelenik meg a tárolóban.
Téglalap Elemként jelenik meg a tárolóban.
Mátrixoszlopcsoportok A sorcsoportokon belüli elemekként jelenik meg.
Térkép Elemként jelenik meg a tároló elemében. A térképrétegek a térkép gyermekelemei, és minden térképréteg tartalmazza a térképtagok elemeit és a térképtag attribútumait.
Diagram Elemként jelenik meg a tároló elemében. A sorozatok a diagram gyermekelemei, a kategóriák pedig egy sorozat gyermekelemei. Megjeleníti az egyes diagramértékek összes diagramfeliratát. A címkék és az értékek attribútumokként vannak feltüntetve.
Adatsáv A diagramhoz hasonló elemként jelenik meg a tároló elemében. Az adatsávok általában nem tartalmaznak hierarchiákat vagy címkéket, csak értékeket.
Értékgörbe A diagramhoz hasonló elemként jelenik meg a tároló elemében. Az értékgörbe általában nem tartalmaz hierarchiákat vagy címkéket, csak értékeket.
Kijelző Elemként jelenik meg a tároló elemében. Egyetlen elemként jeleníti meg a tartomány skálázási, kezdő- és végpontértékeit, valamint a mutató attribútumként megadott értékét.
Kijelző A tároló elemen belüli elemként jelenik meg, hasonlóan a mérőműszerhez. Egyetlen elemként jeleníti meg az aktív állapot nevét, az elérhető állapotokat és az adatértéket attribútumként.

Az XML-renderelési bővítmény használatával renderelt jelentések az alábbi szabályokat is követik:

  • Az XML-elemek és -attribútumok a jelentésdefinícióban megjelenő sorrendben jelennek meg.

  • A rendszer figyelmen kívül hagyja a lapozást.

  • Az oldalfejek és élőlábak nem jelennek meg.

  • A rejtett elemek, amelyeket nem lehet láthatóvá tenni az összesítéssel, nem jelennek meg. A program megjeleníti az eredetileg látható elemeket és a váltógombbal láthatóvá tehető rejtett elemeket.

  • A rendszer figyelmen kívül hagyja a képeket, sorokat és egyéni jelentéselemeket .

Adattípusok

A szövegdoboz eleméhez vagy attribútumához XSD-adattípus van rendelve a szövegdoboz által megjelenített értékek alapján.

Ha az összes szövegmező értéke A hozzárendelt adattípus a következő:
Int16, Int32, Int64, UInt16, UInt32, UInt64, Byte, SByte xsd:egész szám
Decimális (vagy decimális és bármely egész szám vagy bájt adattípus) xsd:decimális
Lebegtetés (vagy Decimális és bármely egész szám vagy bájt adattípus) xsd:float
Dupla (vagy Decimális és bármely egész szám vagy bájt adattípus) xsd:double
DateTime vagy DateTime eltolás xsd:dateTime
Idő xsd:sztring
Logikai xsd:boolean
Sztring, Karakter xsd:sztring
Egyéb xsd:sztring

XML-specifikus renderelési szabályok

A következő szakaszok bemutatják, hogyan értelmezik az XML-renderelő bővítmények a jelentésben lévő elemeket.

Jelentés törzse

A jelentés az XML-dokumentum gyökérelemeként jelenik meg. Az elem neve a Tulajdonságok panelEn beállított DataElementName tulajdonságból származik.

Az XML-névtérdefiníciók és a sémahivatkozási attribútumok is szerepelnek a jelentéselemben. A változók félkövér arctípusban jelennek meg:

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

A változók értékei a következők:

Név szerint Érték
Jelentés Report.DataElementName
ReportURL UrlEncoded absolute URL to the report on the server.
Séma neve Report.SchemaName. Ha null, akkor Report.Name. Ha Report.Name használ, először XmlConvert.EncodeLocalName kódolja.
ReportName A jelentés neve.

Szövegdobozok

A szövegdobozok a DataElementStyle RDL tulajdonság alapján elemekként vagy attribútumként jelennek meg. Az elem vagy attribútum neve a TextBox.DataElementName RDL tulajdonságból származik.

Diagramok, adatsávok és értékgörbék

A diagramok, adatsávok és értékgörbék XML-formátumban jelennek meg. Az adatok strukturáltak.

Mérőműszerek és kijelzők

A mérőműszerek és a jelzők XML-ben jelennek meg. Az adatok strukturáltak.

Segédjelentések

A segédjelentés elemként jelenik meg. Az elem neve a DataElementName RDL tulajdonságból származik. A jelentés TextBoxesAsElements tulajdonságbeállítása felülírja a segédjelentését. A névtér és az XSLT attribútumok nem lesznek hozzáadva a segédjelentési elemhez.

Téglalapok

A téglalap elemként jelenik meg. Az elem neve a DataElementName RDL tulajdonságból származik.

Egyéni jelentéselemek

A CustomReportItems (CRI) nem látható a renderelő bővítményben. Ha egy egyéni jelentéselem létezik a jelentésben, a renderelési bővítmény hagyományos jelentéselemként jeleníti meg.

Képek

A rendszer nem jeleníti meg a képeket.

Sorok

A vonalak nem jelennek meg.

Táblák, mátrixok és listák

A táblák, mátrixok és listák elemként jelennek meg. Az elem neve a Tablix DataElementName RDL tulajdonságból származik.

Sorok és oszlopok

Az oszlopok sorokban jelennek meg.

Tablix sarok

A sarok nem jelenik meg. Csak a sarok tartalma jelenik meg.

Tablix cellák

A Tablix-cellák elemként jelennek meg. Az elem neve a cella DataElementName RDL tulajdonságából származik.

Automatikus részösszegek

A Tablix automatikus részösszegei nem jelennek meg.

Csoporttal nem ismétlődő sor- és oszlopelemek

A csoporttal nem ismétlődő elemek, például címkék, részösszegek és összegek elemként jelennek meg. Az elem neve a TablixMember.DataElementName RDL tulajdonságból származik.

A TablixMember.DataElementOutput RDL tulajdonság szabályozza, hogy egy nem ismétlődő elem jelenik-e meg.

Ha a Tablix-tag DataElementName tulajdonsága nincs megadva, a nem ismétlődő elem neve dinamikusan jön létre ebben az űrlapban:

SorX a nem ismétlődő sorokhoz, ahol az X egy nulla alapú sorindex az aktuális szülőn belül.

Oszlop nem ismétlődő oszlopokhoz, ahol az Y ix egy nulla alapú oszlopindexet az aktuális szülőben.

A nem ismétlődő fejlécek a csoporttal nem ismétlődő sor vagy oszlop gyermekeként jelennek meg.

Ha egy nem ismétlődő tagnak nincsenek megfelelő Tablix-cellái, az nem jelenik meg. Ez akkor fordulhat elő, ha egy Tablix-cella több oszlopra is kiterjed.

Csoporttal ismétlődő sorok és oszlopok

A csoporton belül ismétlődő sorok és oszlopok a Tablix.DataElementOutput szabályok szerint jelennek meg. Az elem neve a DataElementName tulajdonságból származik.

A csoport minden egyedi értéke a csoport gyermekelemeként jelenik meg. Az elem neve a Group.DataElementName tulajdonságból származik.

Ha a DataElementOutput tulajdonság értéke a Kimenet értékkel egyenlő, az ismétlődő elem fejléce a részletelem gyermekeként jelenik meg.

Egyéni formátumok és XSL-átalakítások

Az XML-renderelő bővítmény által létrehozott XML-fájlok szinte bármilyen formátummá alakíthatók az XSL-átalakítások (XSLT) használatával. Ezzel a funkcióval olyan formátumban hozhat létre adatokat, amelyeket a meglévő renderelő bővítmények még nem támogatnak. Fontolja meg az XML-renderelési bővítmény és az XSLT használatát, mielőtt megpróbálná létrehozni a saját renderelő bővítményét.

Ismétlődő nevek

Ha ugyanazon a hatókörön belül ismétlődő adatelem-nevek találhatók, a renderelő hibaüzenetet jelenít meg.

XSLT-átalakítások

Az XML-megjelenítő kiszolgálóoldali XSLT-átalakítást alkalmazhat az eredeti XML-adatokra. XSLT alkalmazásakor a renderelő az átalakított tartalmat adja ki az eredeti XML-adatok helyett. Az átalakítás a kiszolgálón történik, nem az ügyfélen.

A kimenetre alkalmazandó XSLT a jelentésdefiníciós fájlban, a jelentés DataTransform tulajdonságával vagy az XSLT DeviceInfo paraméterrel van definiálva. Ha valamelyik érték be van állítva, az átalakítás minden alkalommal megtörténik, amikor az XML-megjelenítőt használja. Előfizetések használatakor az XSLT-t az RDL DataTransform tulajdonságban kell definiálni.

Ha XSLT-fájl van megadva, a DataTransform definíciós tulajdonsága és az eszközinformációs beállítás egyaránt a DataTransformban megadott XSLT-t követi először, majd az eszközinformációs beállítások által beállított XSLT-t.

Eszközinformációs beállítások

A renderelő néhány alapértelmezett beállítását módosíthatja az eszközinformációs beállítások módosításával, beleértve az alábbiakat:

  • Az XML-hez alkalmazandó átalakítás (XSLT).

  • Az XML-dokumentum MIME-típusa.

  • Formázási sztringek alkalmazása az adatokra.

  • Az XML-kimenet behúzása.

  • Adja meg az XML-séma nevét.

  • Az XML-dokumentum kódolása.

  • Az XML-dokumentum fájlkiterjesztése.

További információ: XML-eszközinformációs beállítások.