Jaa

Power BI:n sivutetun raportin vieminen XML:ään (Power BI:n raportin muodostin)

  • Artikkeli

KOSKEE: Power BI Report Builder Power BI Desktop

XML-hahmontamislaajennus palauttaa Power BI:n sivutetun raportin XML-muodossa. Raportin XML-tiedoston rakenne koskee vain raporttia ja sisältää vain tietoja. Asettelutietoja ei hahmonneta, eikä sivutusta ylläpidetä XML-hahmontamislaajennuksella. Tämän laajennuksen luoma XML voidaan tuoda tietokantaan, käyttää XML-tietoviestinä tai lähettää mukautettuun sovellukseen.

Muistiinpano

Voit luoda ja muokata sivutettuja raporttimääritysten (.rdl) tiedostoja Power BI:n raportin muodostimessa.

Raporttikohteet

Seuraavassa taulukossa kuvataan, miten raporttikohteet hahmonnetaan.

Nimike Hahmontamistoiminta
Raportti Hahmontaa XML-tiedoston ylimmän tason elementtinä.
Tietoalueet Hahmonnetaan elementtinä elementissä sen säilössä. Tietoalueet sisältävät taulukon, matriisin ja luettelon, jotka näyttävät tiedot tekstinä ja kaaviona, tietopalkit, sparkline-kaaviot, mittarit ja ilmaisimet, jotka visualisoivat tietoja.
Ryhmittely- ja tietoosiot Jokainen esiintymä hahmonnetaan elementtinä elementissä sen säilössä.
Tekstiruutu Hahmontuu määritteeksi tai elementiksi sen säilössä.
Suorakulmio Hahmontuu elementtinä sen säilössä.
Matriisisarakeryhmät Hahmontaa elementtinä riviryhmien sisällä.
Map Hahmonnetaan elementtinä elementissä sen säilössä. Karttatasot ovat kartan alielementtejä, ja kukin karttataso sisältää elementtejä kartan jäsenille ja kartan jäsenen määritteille.
Kaavio Hahmonnetaan elementtinä elementissä sen säilössä. Sarjat ovat kaavion alielementtejä ja luokat ovat sarjan alielementtejä. Hahmontaa kaikki kaavion otsikot kullekin kaavion arvolle. Otsikot ja arvot sisällytetään määritteinä.
Tietopalkki Hahmonnetaan elementtinä elementissä sen säilössä, kuten kaaviossa. Yleensä tietopalkki ei sisällä hierarkioita tai otsikoita, vain arvoja.
Sparkline Hahmonnetaan elementtinä elementissä sen säilössä, kuten kaaviossa. Sparkline-kaavio ei yleensä sisällä hierarkioita tai otsikoita, vain arvoja.
Mittari Hahmonnetaan elementtinä elementissä sen säilössä. Hahmontaa yksittäisenä elementtinä, joka sisältää asteikon sekä alueen aloitus- ja loppuarvojen vähimmäis- ja enimmäisarvot ja osoittimen arvon määritteinä.
Ilmaisin Hahmonnetaan elementtinä elementissä sen säilössä, kuten mittarissa. Hahmontuu yksittäisenä elementtinä, jolla on aktiivisen tilan nimi, käytettävissä olevat tilat ja tietoarvo määritteinä.

Raportit, jotka hahmonnetaan XML-hahmontamislaajennuksen avulla, noudattavat myös seuraavia sääntöjä:

  • XML-elementit ja määritteet hahmonnetaan siinä järjestyksessä, jossa ne näkyvät raportin määrityksessä.

  • Sivutus ohitetaan.

  • Sivun ylä- ja alatunnisteita ei hahmonneta.

  • Piilotettuja kohteita, joita ei voi tehdä näkyviin vaihtokytkinnällä, ei hahmonneta. Aluksi näytetään kohteet ja piilotetut kohteet, jotka voidaan hahmontaa vaihtopainikkeella.

  • Kuvat, viivat ja mukautetut raporttikohteet ohitetaan.

Tietotyypit

Tekstiruutu-elementille tai -määritteelle määritetään XSD-tietotyyppi tekstiruudun näyttämien arvojen perusteella.

Jos kaikki tekstiruudun arvot ovat Määritetty tietotyyppi on
Int16, Int32, Int64, UInt16, UInt32, UInt64, Byte, SByte xsd:integer
Desimaali (tai desimaali ja mikä tahansa kokonaisluku- tai tavutietotyyppi) xsd:decimal
Liukuluku (tai desimaali ja mikä tahansa kokonaisluku- tai tavutietotyyppi) xsd:float
Double (tai desimaali ja mikä tahansa kokonaisluku- tai tavutietotyyppi) xsd:double
DateTime tai DateTime Offset xsd:dateTime
Time xsd:string
Totuusarvo xsd:boolean
Merkkijono, char xsd:string
Muu xsd:string

XML-erityiset hahmontamissäännöt

Seuraavissa osissa kuvataan, miten XML-hahmontamislaajennukset tulkitsevat raportin sisältämia kohteita.

Raportin leipäteksti

Raportti hahmonnetaan XML-tiedoston pääelementtinä. Elementin nimi tulee Ominaisuudet-ruudussa määritetystä DataElementName-ominaisuudesta.

Raporttielementtiin sisällytetään myös XML-nimitilan määritykset ja rakenteen viitemääritteet. Muuttujat on lihavoitu kasvotyyppi:

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

Muuttujien arvot ovat seuraavat:

Nimi Arvo
Raportti Report.DataElementName
RaportinURL URLEnkoodattu absoluuttinen URL-osoite raporttiin palvelimessa.
Rakenteen nimi Report.SchemaName. Jos arvo on tyhjä, Report.Name. Jos Report.Name käytetään, se koodataan ensin XmlConvert.EncodeLocalNamen avulla.
Raportin nimi Raportin nimi.

Tekstikehyksiä

Tekstiruudut hahmonnetaan elementteinä tai määritteinä DataElementStyle RDL -ominaisuuden mukaisesti. Elementin tai määritteen nimi tulee TextBox.DataElementName RDL -ominaisuudesta.

Kaaviot, tietopalkit ja sparkline-kaaviot

Kaaviot, tietopalkit ja sparkline-kaaviot hahmonnetaan XML:ssä. Tiedot on jäsennetty.

Mittarit ja ilmaisimet

Mittarit ja ilmaisimet hahmonnetaan XML:ssä. Tiedot on jäsennetty.

Aliraportit

Aliraportti hahmonnetaan elementtinä. Elementin nimi otetaan DataElementName RDL -ominaisuudesta. Raportin TextBoxesAsElements-ominaisuusasetus ohittaa aliraportin ominaisuuden. Nimitila- ja XSLT-määritteitä ei lisätä aliraporttielementtiin.

Suorakulmiot

Suorakulmio hahmonnetaan elementtinä. Elementin nimi otetaan DataElementName RDL -ominaisuudesta.

Mukautetut raporttikohteet

CustomReportItems (CRI) ei näy hahmontamislaajennuksessa. Jos raportissa on mukautettu raporttikohde, hahmontamislaajennus tekee siitä tavanomaisen raporttikohteen.

Kuvat

Kuvia ei hahmonneta.

Rivit

Viivoja ei hahmonneta.

Taulukot, matriisit ja luettelot

Taulukot, matriisit ja luettelot hahmonnetaan elementtinä. Elementin nimi tulee Tablix DataElementName RDL -ominaisuudesta.

Rivit ja sarakkeet

Sarakkeet hahmonnetaan riveillä.

Tablix-kulma

Kulmaa ei hahmonneta. Vain kulman sisältö hahmonnetaan.

Tablix-solut

Tablix-solut hahmonnetaan elementteinä. Elementin nimi otetaan solun DataElementName RDL -ominaisuudesta.

Automaattiset välisummat

Tablix-automaattisia välisummia ei hahmonneta.

Rivi- ja sarakekohteet, jotka eivät toistu ryhmän kanssa

Kohteet, jotka eivät toistu ryhmässä, kuten otsikot, välisummat ja summat, hahmonnetaan elementteinä. Elementin nimi tulee TablixMember.DataElementName RDL -ominaisuudesta.

TablixMember.DataElementOutput RDL -ominaisuus määrittää, hahmonnetaanko toistamaton kohde.

Jos Tablix-jäsenen DataElementName-ominaisuutta ei ole annettu, toistamattoman kohteen nimi luodaan dynaamisesti tässä lomakkeessa:

RowX Toistumattoville riveille, joissa X on nollapohjainen riviindeksi nykyisessä pääelementissä.

ColumnY (sarakeY) Sarakkeille, jotka eivät toistu, kun Y ix on nollapohjainen sarakeindeksi nykyisen ylätason sisällä.

Toistamaton otsikko hahmonnetaan rivin tai sarakkeen alikohteina, joka ei toistu ryhmälle.

Jos ei-toistuvilla jäsenillä ei ole vastaavia Tablix-soluja, sitä ei hahmonneta. Näin voi käydä, jos kyseessä on Tablix-solu, jossa se ulottuu useampaan kuin yhteen sarakkeeseen.

Rivit ja sarakkeet, jotka toistuvat ryhmän kanssa

Ryhmässä toistuvat rivit ja sarakkeet hahmonnetaan Tablix.DataElementOutput-sääntöjen mukaisesti. Elementin nimi otetaan DataElementName-ominaisuudesta.

Jokainen ryhmän yksilöllinen arvo hahmonnetaan ryhmän alielementtinä. Elementin nimi otetaan Group.DataElementName-ominaisuudesta.

Jos DataElementOutput-ominaisuuden arvo on tuloste, toistuvan kohteen otsikko hahmonnetaan tietoelementin alielementtinä.

Mukautetut muodot ja XSL-muunnokset

XML-hahmontamislaajennuksen tuottamat XML-tiedostot voidaan muuntaa lähes mihin tahansa muotoon XSL-muunnosten (XSLT) avulla. Tämän toiminnon avulla voidaan tuottaa tietoja muodoissa, joita olemassa olevat hahmontamislaajennukset eivät vielä tue. Harkitse XML-hahmontamislaajennuksen ja XSLT:n käyttöä, ennen kuin yrität luoda oman hahmontamislaajennuksen.

Nimien kaksoiskappaleet

Jos tietoelementtien nimet ovat saman alueen sisällä, hahmontaja näyttää virhesanoman.

XSLT-muunnokset

XML-hahmonnin voi käyttää palvelinpuolen XSLT-muunnoksen alkuperäisiin XML-tietoihin. Kun XSLT-tiedostoa käytetään, hahmontaja tulostaa muunnetun sisällön alkuperäisten XML-tietojen sijaan. Muunnos tapahtuu palvelimessa, ei asiakaskoneessa.

Tulokseen käytettävä XSLT määritetään joko raportin määritystiedostossa raportin DataTransform-ominaisuudella tai XSLT DeviceInfo-parametrilla . Jos jompikumpi näistä arvoista määritetään, muunnos tehdään aina, kun XML-hahmonninta käytetään. Jos käytät tilauksia, XSLT on määritettävä RDL DataTransform -ominaisuudessa.

Jos määritetään XSLT-tiedosto sekä DataTransform-määritysominaisuuden että laitetietojen asetuksen mukaisesti, DataTransform-kohdassa määritetty XSLT suoritetaan ensin, ja sen jälkeen laitetietojen asetukset määrittävät XSLT:n.

XSLT-tiedoston pitäisi olla saatavilla Internetissä https-yhteyden kautta ilman todentamista.

Laitteen tietoasetukset

Voit muuttaa joitakin tämän hahmontimen oletusasetuksia muuttamalla laitetietojen asetuksia, esimerkiksi seuraavat:

  • XML:ään käytettävä muunnos (XSLT).

  • XML-tiedoston MIME-tyyppi.

  • Määrittää, käytetäänkö muotoilumerkkijonoja tiedoissa.

  • Määrittää XML-tulosteen sisennyksen.

  • Määrittää, sisällytetäänkö XML-rakenteen nimi.

  • XML-tiedoston koodaus.

  • XML-tiedoston tiedostotunniste.

Lisätietoja on kohdassa XML-laitetietojen asetukset.

Liittyvä sisältö