Share via

Exportovanie stránkovanej zostavy služby Power BI do formátu XML (Power BI Zostavovač zostáv)

  • Článok

VZŤAHUJE SA NA: Power BI Zostavovač zostáv Power BI Desktop

Vykresľovacie rozšírenie XML vráti stránkovanú zostavu v službe Power BI vo formáte XML. Schéma pre XML zostavu je špecifická pre zostavu a obsahuje iba údaje. Informácie o rozložení sa nevykreslia a stránkovanie nie je udržiavané vykresľovacím rozšírením XML. XML vygenerovaný týmto rozšírením sa dá importovať do databázy, používať ako správa o údajoch XML alebo odoslať do vlastnej aplikácie.

Poznámka

Súbory s definíciou stránkovanej zostavy (.rdl) môžete vytvárať a upravovať v aplikácii Power BI Zostavovač zostáv.

Položky zostavy

Nasledujúca tabuľka popisuje spôsob vykreslenia položiek zostavy.

Položka Správanie vykresľovania
Report Vykreslí sa ako prvok najvyššej úrovne dokumentu XML.
Oblasti údajov Vykreslí sa ako prvok v rámci prvku pre jeho kontajner. Oblasti údajov zahŕňajú tabuľku, maticu a zoznam, ktoré zobrazujú údaje ako text a graf, údajové pruhy, krivky, mierky a indikátory na vizualizáciu údajov.
Sekcie skupín a podrobností Každá inštancia sa vykreslí ako prvok v rámci prvku pre jeho kontajner.
Textové pole Vykreslí sa ako atribút alebo prvok v rámci svojho kontajnera.
Obdĺžnik Vykreslí sa ako prvok v kontajneri.
Skupiny stĺpcov matice Vykreslí sa ako prvky v skupinách riadkov.
Mapa Vykreslí sa ako prvok v rámci prvku pre jeho kontajner. Vrstvy mapy sú podriadené prvky mapy a každá vrstva mapy obsahuje prvky pre ich členov mapy a atribúty členov mapy.
Graf Vykreslí sa ako prvok v rámci prvku pre jeho kontajner. Rad je podradené prvky grafu a kategórie sú podriadeným prvkom radu. Vykreslí všetky označenia grafov pre každú hodnotu grafu. Označenia a hodnoty sú zahrnuté ako atribúty.
Údajový panel Vykreslí sa ako prvok v rámci prvku pre jeho kontajner, podobne ako graf. Údajový panel zvyčajne nezahŕňa hierarchie ani označenia, len hodnoty.
Krivka Vykreslí sa ako prvok v rámci prvku pre jeho kontajner, podobne ako graf. Krivka zvyčajne nezahŕňa hierarchie ani označenia, len hodnoty.
Mierka Vykreslí sa ako prvok v rámci prvku pre jeho kontajner. Vykreslí sa ako jeden prvok s minimálnymi a maximálnymi hodnotami mierky, začiatkom a koncom hodnôt rozsahu a hodnotou ukazovateľa ako atribútov.
Indikátor Vykreslí sa ako prvok v rámci prvku pre jeho kontajner, podobne ako mierka. Vykreslí sa ako jeden prvok s názvom aktívneho stavu, dostupnými stavmi a hodnotou údajov ako atribútmi.

Zostavy vykreslené pomocou vykresľovacieho rozšírenia XML tiež dodržiavajú tieto pravidlá:

  • Prvky a atribúty XML sa vykreslia v poradí, v akom sa zobrazujú v definícii zostavy.

  • Stránkovanie sa ignoruje.

  • Hlavičky a päty strán sa nevykreslia.

  • Skryté položky, ktoré nie je možné zobraziť pomocou prepínania, sa nevykreslia. Najprv sa vykreslia viditeľné položky a skryté položky, ktoré je možné zviditeľniť pomocou prepínača.

  • Obrázky, riadky a vlastné položky zostavy sa ignorujú.

Typy údajov

Prvok textového poľa alebo atribút je priradený k typu údajov XSD na základe hodnôt, ktoré sa zobrazujú v textovom poli.

Ak sú všetky hodnoty textového poľa Priradený typ údajov je
Int16, Int32, Int64, UInt16, UInt32, UInt64, Byte, SByte xsd:celé číslo
Desatinné číslo (alebo desatinné číslo a akékoľvek celé číslo alebo typ údajov bajtu) xsd:desatinné číslo
Float (alebo desatinné číslo a akékoľvek celé číslo alebo typ údajov bajtu) xsd:float
Double (alebo Desatinné číslo a akékoľvek celé číslo alebo typ údajov bajtu) xsd:double
Posun dátumu a času alebo dátumu a času xsd:dateTime
Čas xsd:string
Boolean xsd:booleovská hodnota
Reťazec, Char xsd:string
Ostatné xsd:string

Pravidlá vykresľovania špecifické pre XML

Nasledujúce časti popisujú, ako vykresľovacie rozšírenia XML interpretujú položky v zostave.

Telo zostavy

Zostava sa vykreslí ako koreňový prvok dokumentu XML. Názov prvku pochádza z vlastnosti DataElementName nastavenej na table Vlastnosti.

Definície priestoru názvov XML a referenčné atribúty schémy sú tiež zahrnuté v prvku zostavy. Premenné sú zaznamenávané tučným písmom typu tváre:

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

Hodnoty premenných sú nasledovné:

Názov Hodnota
Report Report.DataElementName
URL adresa zostavy URL adresa Zakódovaná absolútna URL adresa zostavy na serveri.
Názov schémy Report.SchemaName. Ak má hodnotu null, potom Report.Name. Ak sa použije Report.Name, najprv sa zakóduje pomocou xmlConvert.EncodeLocalName.
Názov zostavy Názov zostavy.

Textové polia

Textové polia sa podľa vlastnosti DataElementStyle RDL vykresľujú ako prvky alebo atribúty. Názov prvku alebo atribútu pochádza z vlastnosti TextBox.DataElementName RDL.

Grafy, údajové pruhy a krivky

Grafy, údajové pruhy a krivky sa vykresľujú vo formáte XML. Údaje sú štruktúrované.

Mierky a ukazovatele

Mierky a indikátory sa vykresľujú vo formáte XML. Údaje sú štruktúrované.

Čiastkové zostavy

Čiastková zostava sa vykreslí ako prvok. Názov prvku je prevzatý z vlastnosti DataElementName RDL. Nastavenie vlastnosti TextBoxAsElements (Textové poliaAsElements) zostavy prepíše vlastnosť čiastkovej zostavy. Atribúty Priestor názvov a XSLT sa do prvku čiastkovej zostavy nepridajú.

Obdĺžniky

Obdĺžnik sa vykreslí ako prvok. Názov prvku je prevzatý z vlastnosti DataElementName RDL.

Vlastné položky zostavy

Možnosti CustomReportItems (CRI) nie sú pre vykresľovacie rozšírenie viditeľné. Ak v zostave existuje vlastná položka zostavy, vykresľovacie rozšírenie ju vykreslí ako bežnú položku zostavy.

Obrázky

Obrázky sa nevykreslia.

Riadky

Čiary sa nevykreslia.

Tabuľky, matice a zoznamy

Tabuľky, matice a zoznamy sa vykreslia ako prvok. Názov prvku pochádza z vlastnosti RDL Tablix DataElementName.

Riadky a stĺpce

Stĺpce sa vykreslia v rámci riadkov.

Roh tablixu

Roh sa nevykreslí. Vykreslí sa len obsah rohu.

Bunky položky Tablix

Bunky Tablix sa vykreslia ako prvky. Názov prvku sa prevezme z vlastnosti RDL DataElementName v bunke.

Automatické medzisúčty

Automatické medzisúčty Tablix sa nevykreslia.

Položky riadkov a stĺpcov, ktoré sa neopakujú so skupinou

Položky, ktoré sa neopakujú v skupine, ako sú napríklad označenia, medzisúčty a súčty, sa vykreslia ako prvky. Názov prvku pochádza z vlastnosti TablixMember.DataElementName RDL.

Vlastnosť TablixMember.DataElementOutput RDL určuje, či sa vykreslí neopakujúca položka.

Ak nie je zadaná vlastnosť DataElementName člena Tablix, názov neopakujúcej položky sa dynamicky vygeneruje v tomto formulári:

RowX Pre neopakujúce sa riadky, kde X je index riadkov založený na nule v rámci aktuálneho nadradeného prvku.

ColumnY Pre neopakujúce sa stĺpce, kde Y ix index stĺpca s nulovým základom v rámci aktuálneho nadradeného prvku.

Neopakujúca hlavička sa vykreslí ako podradená hlavička riadka alebo stĺpca, ktorá sa neopakuje so skupinou.

Ak neopakujúci člen nemá žiadne zodpovedajúce bunky Tablix, nevykreslí sa. Táto situácia môže nastať v prípade bunky Tablix, ktorá zahŕňa viac ako jeden stĺpec.

Riadky a stĺpce, ktoré sa opakujú so skupinou

Riadky a stĺpce, ktoré sa opakujú v rámci skupiny, sa vykreslia podľa pravidiel Tablix.DataElementOutput. Názov prvku sa prevezme z vlastnosti DataElementName.

Každá jedinečná hodnota v rámci skupiny sa vykreslí ako podradený prvok skupiny. Názov prvku sa prevezme z vlastnosti Group.DataElementName.

Ak sa hodnota vlastnosti DataElementOutput rovná hodnote Output (Výstup), hlavička opakujúcej sa položky sa vykreslí ako podradená prvku podrobností.

Vlastné formáty a transformácie XSL

Súbory XML vytvorené vykresľovacím rozšírením XML sa môžu transformovať do takmer akéhokoľvek formátu pomocou transformácií XSL (XSLT). Túto funkciu možno použiť na vytvorenie údajov vo formátoch, ktoré ešte nie sú podporované existujúcimi vykresľovacími rozšíreniami. Pred pokusom o vytvorenie vlastného vykresľovacieho rozšírenia zvážte použitie vykresľovacieho rozšírenia XML a XSLT.

Duplicitné názvy

Ak sa v tom istom rozsahu nachádzajú duplicitné názvy prvkov údajov, vykresľovač zobrazí chybové hlásenie.

Transformácie XSLT

Vykresľovač XML môže použiť transformáciu XSLT na strane servera na pôvodné údaje XML. Po použití XSLT vytvorí vykresľovač výstup transformovaného obsahu namiesto pôvodných údajov XML. Transformácia sa vyskytuje na serveri, nie v klientovi.

XSLT, ktorá sa má použiť na výstup, je definovaná buď v súbore definície zostavy s vlastnosťou DataTransform zostavy alebo s parametrom XSLT DeviceInfo . Ak je niektorá z týchto hodnôt nastavená, transformácia sa vykoná pri každom použití vykresľovača XML. Pri používaní predplatných musí byť XSLT definovaná vo vlastnosti RDL DataTransform.

Ak je zadaný súbor XSLT, pri nastavení definície DataTransform aj nastavení informácií zariadenia sa najskôr vyskytne XSLT zadaný v DataTransforme, za ktorým nasleduje XSLT nastavená nastaveniami informácií o zariadení.

Nastavenia informácií o zariadení

Zmenou nastavenia informácií o zariadení môžete zmeniť niektoré predvolené nastavenia pre tento vykresľovač vrátane týchto:

  • Transformácia (XSLT) na použitie vo formáte XML.

  • Typ MIME dokumentu XML.

  • Určuje, či sa majú na údaje použiť reťazce formátu.

  • Určuje, či sa má odsadiť výstup XML.

  • Určuje, či sa má zahrnúť názov schémy XML.

  • Kódovanie dokumentu XML.

  • Prípona súborov v dokumente XML.

Ďalšie informácie nájdete v téme Nastavenia informácií o zariadení XML.

Súvisiaci obsah