Sdílet prostřednictvím

Export stránkované sestavy Power BI do XML (Tvůrce sestav Power BI)

  • Článek

PLATÍ PRO: Power BI Tvůrce sestav Power BI Desktopu

Rozšíření vykreslování XML vrátí stránkovanou sestavu Power BI ve formátu XML. Schéma xml sestavy je specifické pro sestavu a obsahuje pouze data. Informace o rozložení se nevykreslují a rozšíření vykreslování XML neudržuje stránkování. Xml vygenerovaný tímto rozšířením lze importovat do databáze, použít jako datovou zprávu XML nebo odeslat do vlastní aplikace.

Poznámka:

Soubory definice stránkované sestavy (.rdl) můžete vytvářet a upravovat v Tvůrce sestav Power BI.

Položky sestavy

Následující tabulka popisuje, jak se vykreslují položky sestavy.

Položka Chování vykreslování
Sestava Zobrazí se jako prvek nejvyšší úrovně dokumentu XML.
Oblasti dat Vykreslí se jako prvek v rámci elementu pro jeho kontejner. Oblasti dat zahrnují tabulku, matici a seznam, které zobrazují data jako text a graf, datové pruhy, minigrafy, měřidla a indikátory, které vizualizují data.
Oddíly seskupení a podrobností Každá instance se vykreslí jako prvek v rámci elementu pro svůj kontejner.
Text box Vykreslí se jako atribut nebo prvek v rámci kontejneru.
Obdélník Vykreslí se jako prvek v rámci svého kontejneru.
Skupiny sloupců matice Vykreslí se jako prvky ve skupinách řádků.
Mapovat Vykreslí se jako prvek v rámci elementu pro jeho kontejner. Vrstvy mapování jsou podřízené prvky mapy a každá vrstva mapy obsahuje prvky pro členy mapy a atributy členů mapování.
Graf Vykreslí se jako prvek v rámci elementu pro jeho kontejner. Řady jsou podřízené prvky grafu a kategorie jsou podřízený prvek řady. Vykreslí všechny popisky grafu pro každou hodnotu grafu. Popisky a hodnoty jsou zahrnuty jako atributy.
Datový pruh Vykreslí se jako prvek v rámci elementu pro jeho kontejner, podobně jako graf. Datový pruh obvykle neobsahuje hierarchie ani popisky, pouze hodnoty.
Minigraf Vykreslí se jako prvek v rámci elementu pro jeho kontejner, podobně jako graf. Minigraf obvykle neobsahuje hierarchie ani popisky, pouze hodnoty.
Měřidlo Vykreslí se jako prvek v rámci elementu pro jeho kontejner. Zobrazí se jako jeden prvek s minimálními a maximálními hodnotami měřítka, počátečními a koncovými hodnotami rozsahu a hodnotou ukazatele jako atributy.
Indikátor Vykreslí se jako prvek v rámci elementu pro jeho kontejner, podobně jako měřidlo. Vykreslí se jako jeden prvek s názvem aktivního stavu, dostupnými stavy a datovou hodnotou jako atributy.

Sestavy, které se vykreslují pomocí rozšíření vykreslování XML, se řídí také těmito pravidly:

  • Elementy a atributy XML se vykreslují v pořadí, v jakém se zobrazují v definici sestavy.

  • Stránkování se ignoruje.

  • Záhlaví a zápatí stránky se nevykreslují.

  • Skryté položky, které nelze zobrazit přepnutím, se nevykreslí. Zpočátku viditelné položky a skryté položky, které lze zobrazit pomocí přepínače, se vykreslují.

  • Obrázky, řádky a vlastní položky sestavy se ignorují.

Datové typy

Prvek textového pole nebo atribut je přiřazen datový typ XSD na základě hodnot zobrazených v textovém poli.

Pokud jsou všechny hodnoty textového pole Přiřazený datový typ je
Int16, Int32, Int64, UInt16, UInt32, UInt64, Byte, SByte xsd:integer
Desetinné číslo (nebo desetinné číslo nebo datový typ bajtu) xsd:decimal
Float (nebo Decimal and any integer or byte data type) xsd:float
Double (nebo Decimal and any integer or byte data type) xsd:double
DateTime nebo DateTime Offset xsd:dateTime
Time xsd:string
Logická hodnota xsd:boolean
Řetězec, znak xsd:string
Jiný důvod xsd:string

Pravidla vykreslování specifická pro XML

Následující části popisují, jak rozšíření vykreslování XML interpretují položky v sestavě.

Text sestavy

Sestava se vykreslí jako kořenový prvek dokumentu XML. Název elementu pochází z DataElementName vlastnost nastavena v podokně Properties.

Definice oboru názvů XML a referenční atributy schématu jsou také zahrnuty do elementu sestavy. Proměnné jsou zaznamenány tučným typem tváře:

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

Hodnoty proměnných jsou následující:

Jméno Hodnota
Sestava Report.DataElementName
ReportURL Adresa URLEnkódovaná absolutní adresa URL pro sestavu na serveru.
Název schématu Report.SchemaName. Pokud má hodnotu null, Report.Name. Pokud se používá Report.Name, je nejprve kódován xmlConvert.EncodeLocalName.
ReportName Název sestavy

Textová

Textová pole jsou vykreslena jako elementy nebo atributy podle DataElementStyle RDL vlastnost. Název elementu nebo atributu pochází z TextBox.DataElementName RDL vlastnost.

Grafy, datové pruhy a minigrafy

Grafy, datové pruhy a minigrafy se vykreslují ve formátu XML. Data jsou strukturovaná.

Měřidla a indikátory

Měřidla a indikátory se vykreslují ve formátu XML. Data jsou strukturovaná.

Podsestavy

Podsestava se vykreslí jako prvek. Název elementu je převzat z DataElementName RDL vlastnost. Nastavení vlastnosti TextBoxesAsElements sestavy přepíše hodnotu podsestavy. Do elementu podsestavy nejsou přidány atributy oboru názvů a XSLT.

Obdélníky

Obdélník se vykreslí jako prvek. Název elementu je převzat z DataElementName RDL vlastnost.

Vlastní položky sestavy

CustomReportItems (CRI) nejsou viditelné pro rozšíření vykreslování. Pokud v sestavě existuje vlastní položka sestavy, vykresluje ji rozšíření vykreslování jako konvenční položku sestavy.

Obrázky

Obrázky se nevykreslují.

Řádky

Řádky se nevykreslují.

Tabulky, matice a seznamy

Tabulky, matice a seznamy se vykreslují jako prvek. Název elementu pochází z Tablix DataElementName RDL vlastnost.

Řádky a sloupce

Sloupce se vykreslují v řádcích.

Roh tablixu

Roh se nevykreslí. Vykreslí se jenom obsah rohu.

Tablix cells

Buňky Tablix se vykreslují jako prvky. Název elementu je převzat z vlastnosti DataElementName RDL buňky.

Automatické mezisoučty

Automatické mezisoučty tablixu se nevykreslí.

Položky řádků a sloupců, které se neopakují se skupinou

Položky, které se neopakují se skupinou, jako jsou popisky, mezisoučty a součty, se vykreslují jako prvky. Název elementu pochází z TablixMember.DataElementName RDL vlastnost.

TablixMember.DataElementOutput RDL vlastnost určuje, zda se neopakující položka vykresluje.

Pokud není k dispozici vlastnost DataElementName členu Tablix, název neopakující se položky se dynamicky vygeneruje v tomto formuláři:

RowX Pro neopakující se řádky, kde X je index řádku založený na nule v rámci aktuální nadřazené položky.

SloupecY Pro neopakující se sloupce, kde Y ix nulový index sloupce v rámci aktuální nadřazené položky.

Neopakující se záhlaví se vykreslí jako podřízená položka řádku nebo sloupce, která se neopakuje se skupinou.

Pokud neopakující člen nemá žádné odpovídající buňky Tablix, nevykreslí se. K tomu může dojít v případě buňky Tablix, ve které je více než jeden sloupec.

Řádky a sloupce, které se opakují se skupinou

Řádky a sloupce, které se opakují ve skupině, se vykreslují podle pravidel Tablix.DataElementOutput. Název elementu je převzat z DataElementName vlastnost.

Každá jedinečná hodnota v rámci skupiny se vykreslí jako podřízený prvek skupiny. Název elementu je převzat z Group.DataElementName vlastnost.

Pokud Hodnota Vlastnosti DataElementOutput se rovná Výstup, záhlaví opakující se položky je vykresleno jako podřízený prvek podrobností.

Vlastní formáty a transformace XSL

Soubory XML vytvořené rozšířením vykreslování XML lze transformovat do téměř libovolného formátu pomocí transformací XSL (XSLT). Tuto funkci lze použít k vytváření dat ve formátech, které už existující rozšíření vykreslování nepodporují. Než se pokusíte vytvořit vlastní rozšíření vykreslování, zvažte použití rozšíření vykreslování XML a rozšíření XSLT.

Duplicitní názvy

Pokud existují duplicitní názvy datových prvků ve stejném oboru, renderer zobrazí chybovou zprávu.

Transformace XSLT

Renderer XML může použít transformaci XSLT na straně serveru na původní data XML. Při použití XSLT vykreslovací modul vypíše transformovaný obsah místo původních dat XML. Transformace probíhá na serveru, ne na klientovi.

XSLT, který se má použít pro výstup, je definován buď v definičním souboru sestavy s vlastností DataTransform sestavy nebo s parametrem XSLT DeviceInfo . Pokud je nastavena jedna z těchto hodnot, dojde k transformaci při každém použití vykreslovacího modulu XML. Při použití předplatných musí být XSLT definován v RDL DataTransform vlastnost.

Pokud je zadán soubor XSLT, jak vlastnost definice DataTransform, tak nastavení informací o zařízení, XSLT zadaný v DataTransform nejprve, následovaný XSLT nastavením informací o zařízení.

Soubor XSLT by měl být dostupný přes internet přes https bez nutnosti ověřování.

Nastavení informací o zařízení

Některá výchozí nastavení tohoto rendereru můžete změnit tak, že změníte nastavení informací o zařízení, včetně následujících:

  • Transformace (XSLT), která se použije u XML.

  • Typ MIME dokumentu XML.

  • Zda použít formátovací řetězce na data.

  • Zda se má odsadit výstup XML.

  • Zda se má zahrnout název schématu XML.

  • Kódování dokumentu XML.

  • Přípona souboru dokumentu XML.

Další informace najdete v tématu Nastavení informací o zařízení XML.

Související obsah