Eksportowanie raportu podzielonego na strony usługi Power BI do formatu XML (Power BI Report Builder)

  • Artykuł

DOTYCZY: Power BI Report Builder Power BI Desktop

Rozszerzenie renderowania XML zwraca raport podzielony na strony usługi Power BI w formacie XML. Schemat pliku XML raportu jest specyficzny dla raportu i zawiera tylko dane. Informacje o układzie nie są renderowane, a stronicowanie nie jest obsługiwane przez rozszerzenie renderowania XML. Kod XML wygenerowany przez to rozszerzenie można zaimportować do bazy danych, użyć jako komunikatu danych XML lub wysłać do aplikacji niestandardowej.

Uwaga

Pliki definicji raportu podzielonego na strony (rdl) można tworzyć i modyfikować w programie Power BI Report Builder.

Elementy raportu

W poniższej tabeli opisano sposób renderowania elementów raportu.

Produkt Zachowanie renderowania
Report Renderuje jako element najwyższego poziomu dokumentu XML.
Regiony danych Renderuje jako element w elemecie dla kontenera. Regiony danych obejmują tabelę, macierz i listę, które wyświetlają dane jako tekst i wykres, słupki danych, wykresy przebiegu w czasie, mierniki i wskaźniki, które wizualizują dane.
Sekcje grupowania i szczegółów Każde wystąpienie jest renderowane jako element w elemecie dla kontenera.
Pole tekstowe Renderuje jako atrybut lub element w kontenerze.
Prostokąt Renderuje jako element w kontenerze.
Grupy kolumn macierzy Renderuje jako elementy w grupach wierszy.
Mapowanie Renderuje jako element w elemecie dla kontenera. Warstwy mapy są elementami podrzędnymi mapy, a każda warstwa mapy zawiera elementy dla ich elementów członkowskich mapy i atrybutów składowych mapy.
Wykres Renderuje jako element w elemecie dla kontenera. Serie to elementy podrzędne wykresu, a kategorie są elementem podrzędnym serii. Renderuje wszystkie etykiety wykresu dla każdej wartości wykresu. Etykiety i wartości są dołączane jako atrybuty.
Pasek danych Renderuje jako element w elemecie dla kontenera, podobnie jak na wykresie. Zazwyczaj pasek danych nie zawiera hierarchii ani etykiet, tylko wartości.
Wykres przebiegu w czasie Renderuje jako element w elemecie dla kontenera, podobnie jak na wykresie. Zazwyczaj linia przebiegu wykrętowego nie zawiera hierarchii ani etykiet, tylko wartości.
Miernik Renderuje jako element w elemecie dla kontenera. Renderuje jako pojedynczy element z minimalnymi i maksymalnymi wartościami skali, początkowymi i końcowymi zakresu oraz wartością wskaźnika jako atrybutami.
Wskaźnik Renderuje jako element w elemecie dla kontenera, podobnie jak miernik. Renderuje jako pojedynczy element z aktywną nazwą stanu, dostępnymi stanami i wartością danych jako atrybutami.

Raporty renderowane przy użyciu rozszerzenia renderowania XML są również zgodne z następującymi regułami:

  • Elementy i atrybuty XML są renderowane w kolejności, w której są wyświetlane w definicji raportu.

  • Stronicowanie jest ignorowane.

  • Nagłówki i stopki stron nie są renderowane.

  • Ukryte elementy, których nie można uwidocznić przez przełączanie, nie są renderowane. Początkowo widoczne elementy i ukryte elementy, które można uwidocznić za pomocą przełącznika, są renderowane.

  • Obrazy, linie i niestandardowe elementy raportu są ignorowane.

Typy danych

Element lub atrybut pola tekstowego jest przypisany typ danych XSD na podstawie wartości wyświetlanych w polu tekstowym.

Jeśli wszystkie wartości pól tekstowych to Przypisany typ danych to
Int16, Int32, Int64, UInt16, UInt32, UInt64, Byte, SByte xsd:integer
Liczba dziesiętna (lub liczba dziesiętna i dowolna liczba całkowita lub bajtowy typ danych) xsd:decimal
Liczba zmiennoprzecinkowa (lub liczba dziesiętna i dowolna liczba całkowita lub bajt typu danych) xsd:float
Podwójna (lub dziesiętna i dowolna liczba całkowita lub bajtowy typ danych) xsd:double
Przesunięcie daty/godziny lub daty/godziny xsd:dateTime
Czas xsd:string
Wartość logiczna xsd:boolean
Ciąg, Znak xsd:string
Inne xsd:string

Reguły renderowania specyficzne dla kodu XML

W poniższych sekcjach opisano, jak rozszerzenia renderowania XML interpretują elementy w raporcie.

Treść raportu

Raport jest renderowany jako element główny dokumentu XML. Nazwa elementu pochodzi z właściwości DataElementName ustawionej w okienku Właściwości.

Definicje przestrzeni nazw XML i atrybuty odwołania do schematu są również zawarte w elemencie raportu. Zmienne są zanotowane w typie pogrubionej twarzy:

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

Wartości zmiennych są następujące:

Nazwa/nazwisko Wartość
Report Report.DataElementName
Reporturl Adres URL Zakodowany bezwzględny adres URL raportu na serwerze.
Nazwa schematu Report.SchemaName. Jeśli wartość null, Report.Name. Jeśli Report.Name jest używany, jest on najpierw zakodowany w pliku XmlConvert.EncodeLocalName.
Reportname Nazwa raportu.

Pola tekstowe

Pola tekstowe są renderowane jako elementy lub atrybuty zgodnie z właściwością DataElementStyle RDL. Nazwa elementu lub atrybutu pochodzi z właściwości TextBox.DataElementName RDL.

Wykresy, słupki danych i wykresy przebiegu w czasie

Wykresy, paski danych i wykresy przebiegu w czasie są renderowane w formacie XML. Dane są ustrukturyzowane.

Mierniki i wskaźniki

Mierniki i wskaźniki są renderowane w formacie XML. Dane są ustrukturyzowane.

Podraporty

Podraport jest renderowany jako element. Nazwa elementu jest pobierana z właściwości RDL Elementu DataElementName. Ustawienie właściwości TextBoxesAsElements raportu zastępuje wartość podraportu. Przestrzeń nazw i atrybuty XSLT nie są dodawane do elementu podraportu.

Prostokąty

Prostokąt jest renderowany jako element. Nazwa elementu jest pobierana z właściwości RDL Elementu DataElementName.

Niestandardowe elementy raportu

Atrybuty CustomReportItems (CRI) nie są widoczne dla rozszerzenia renderowania. Jeśli w raporcie istnieje niestandardowy element raportu, rozszerzenie renderowania renderuje go jako konwencjonalny element raportu.

Obrazy

Obrazy nie są renderowane.

Wiersze

Wiersze nie są renderowane.

Tabele, macierze i listy

Tabele, macierze i listy są renderowane jako element. Nazwa elementu pochodzi z właściwości Tablix DataElementName RDL.

Wiersze i kolumny

Kolumny są renderowane w wierszach.

Róg elementu Tablix

Róg nie jest renderowany. Renderowana jest tylko zawartość rogu.

Komórki elementu Tablix

Komórki elementu Tablix są renderowane jako elementy. Nazwa elementu jest pobierana z właściwości RDL elementu DataElementName komórki.

Automatyczne sumy częściowe

Automatyczne sumy częściowe elementu Tablix nie są renderowane.

Elementy wierszy i kolumn, które nie są powtarzane w grupie

Elementy, które nie są powtarzane w grupie, takie jak etykiety, sumy częściowe i sumy, są renderowane jako elementy. Nazwa elementu pochodzi z właściwości TablixMember.DataElementName RDL.

Właściwość TablixMember.DataElementOutput RDL określa, czy element nie powtarzający się jest renderowany.

Jeśli właściwość DataElementName elementu członkowskiego elementu Tablix nie jest podana, nazwa elementu nie powtarzającego się jest generowana dynamicznie w tej formie:

RowX w przypadku wierszy, które nie powtarzają się, gdzie X jest indeksem wierszy opartym na zera w bieżącym elemencie nadrzędnym.

ColumnY Dla kolumn nie powtarzających się, gdzie Y ix indeks kolumny zero w bieżącym elemencie nadrzędnym.

Nagłówek nie powtarzający jest renderowany jako element podrzędny wiersza lub kolumny, który nie powtarza się z grupą.

Jeśli nie powtarzający się element członkowski nie ma odpowiednich komórek elementu Tablix, nie jest renderowany. Może się to zdarzyć w przypadku komórki elementu Tablix, w której obejmuje więcej niż jedną kolumnę.

Wiersze i kolumny powtarzające się z grupą

Wiersze i kolumny powtarzane w grupie są renderowane zgodnie z regułami Tablix.DataElementOutput. Nazwa elementu jest pobierana z właściwości DataElementName.

Każda unikatowa wartość w grupie jest renderowana jako element podrzędny grupy. Nazwa elementu jest pobierana z właściwości Group.DataElementName.

Jeśli wartość właściwości DataElementOutput jest równa Output, nagłówek powtarzającego się elementu jest renderowany jako element podrzędny elementu szczegółów.

Formaty niestandardowe i przekształcenia XSL

Pliki XML utworzone przez rozszerzenie renderowania XML można przekształcić w niemal dowolny format przy użyciu przekształceń XSL (XSLT). Ta funkcja może służyć do tworzenia danych w formatach, które nie są jeszcze obsługiwane przez istniejące rozszerzenia renderowania. Przed podjęciem próby utworzenia własnego rozszerzenia renderowania rozważ użycie rozszerzenia renderowania XML i XSLT.

Zduplikowane nazwy

Jeśli w tym samym zakresie istnieją zduplikowane nazwy elementów danych, renderer wyświetla komunikat o błędzie.

Przekształcenia XSLT

Program renderacyjny XML może zastosować przekształcenie XSLT po stronie serwera do oryginalnych danych XML. Po zastosowaniu kodu XSLT renderator generuje przekształconą zawartość zamiast oryginalnych danych XML. Przekształcenie odbywa się na serwerze, a nie na kliencie.

Kod XSLT do zastosowania do danych wyjściowych jest zdefiniowany w pliku definicji raportu z właściwością DataTransform raportu lub z parametrem XSLT DeviceInfo . Jeśli którakolwiek z tych wartości jest ustawiona, transformacja jest wykonywana za każdym razem, gdy jest używany moduł renderowania XML. W przypadku korzystania z subskrypcji kod XSLT musi być zdefiniowany we właściwości RDL DataTransform.

Jeśli zostanie określony plik XSLT, zarówno przez właściwość definicji DataTransform, jak i ustawienie informacji o urządzeniu, XSLT określone w DataTransform następuje najpierw, a następnie XSLT ustawione przez ustawienia informacji o urządzeniu.

Ustawienia informacji o urządzeniu

Niektóre ustawienia domyślne tego modułu renderowania można zmienić, zmieniając ustawienia informacji o urządzeniu, w tym następujące:

  • Przekształcenie (XSLT) do zastosowania do kodu XML.

  • Typ MIME dokumentu XML.

  • Określa, czy mają być stosowane ciągi formatu do danych.

  • Określa, czy należy wciąć dane wyjściowe XML.

  • Określa, czy należy uwzględnić nazwę schematu XML.

  • Kodowanie dokumentu XML.

  • Rozszerzenie pliku dokumentu XML.

Aby uzyskać więcej informacji, zobacz Ustawienia informacji o urządzeniu XML.

Powiązana zawartość