Jaa

Report Definition Language (RDL)

  • Artikkeli

KOSKEE: Power BI Report Builder Power BI Desktop

Report Definition Language (RDL) on sivutetun raportin määrityksen XML-esitys. Raporttimääritelmä sisältää raportin tietojen noutamisen ja asettelun tiedot. RDL koostuu XML-elementeistä, jotka vastaavat Power BI:lle luotua XML-kielioppia. Voit lisätä omia mukautettuja funktioita raporttikohteiden arvojen, tyylien ja muotoilun hallintaan käyttämällä raportin määritystiedostojen koodilohkoja.

RDL edistää kaupallisten raportointituotteiden yhteentoimivuutta määrittämällä yhteisen rakenteen, joka mahdollistaa raporttimääritysten välillä vaihtamisen. Mitä tahansa XML:n kanssa toimivaa protokollaa tai ohjelmallista käyttöliittymää voi käyttää RDL:n kanssa. RDL on:

  • XML-rakenne raportin määrityksiä varten.
  • Liiketoiminnalle ja kolmansille osapuolille tarkoitettu vaihtomuoto.
  • Laajennettava ja avoin rakenne, joka tukee muita nimitiloja ja mukautettuja elementtejä.

RDL-määritykset

Jos haluat ladata tietyn rakenteen versiot, katso Raportin määrityskielen määritys.

RDL XML -rakenteen määritys

RDL (Report Definition Language) -tiedosto vahvistetaan KÄYTTÄMÄLLÄ XML-rakenteen määritelmä (XSD) -tiedostoa. Rakenne määrittää säännöt, joiden mukaan RDL-elementit voivat sijaita .rdl-tiedostossa. Elementti sisältää tietotyypin ja kardinaliteetin, eli sallittujen esiintymien määrän. Elementti voi olla yksinkertainen tai monimutkainen. Yksinkertaisessa elementissä ei ole alielementtejä tai määritteitä. Monimutkaisessa elementissä on alielementit ja valinnaisesti määritteitä.

Rakenne sisältää esimerkiksi RDL-elementin Raporttiparametrit, jonka monitasoinen tyyppi on ReportParametersType. Käytännön mukaan elementin monimutkainen tyyppi on elementin nimi, jota seuraa sana Tyyppi. Raporttiparametrit-elementti voi sisältyä raporttielementtiin (monimutkainen tyyppi), ja se voi sisältää Raporttiparametri-elementtejä. ReportParameterType on yksinkertainen tyyppi, joka voi olla vain yksi seuraavista arvoista: totuusarvo, päivämäärä/aika, kokonaisluku, liukuluku tai merkkijono. Lisätietoja XML-rakenteen tietotyypeistä on kohdassa XML-rakenteen osa 2: Tietotyypit toinen versio.

RDL:n luominen

RDL:n avoimen ja laajennettavan luonteen vuoksi voidaan luoda erilaisia työkaluja ja sovelluksia, jotka luovat RDL:n sen XML-rakenteen perusteella.

Power BI:n raportin muodostin on ensisijainen tapa luoda RDL-pohjaisia sivutettuja raportteja.

Yksi helpoimmista tavoista luoda RDL sovelluksesta on käyttää nimitilan ja System.Linq nimitilan Microsoft .NET Framework luokkiaSystem.Xml. Erityisesti yhtä luokkaa , XmlTextWriter-luokkaa , voidaan käyttää RDL:n kirjoittamiseen. XmlTextWriterin avulla voit luoda täydellisen raporttimäärityksen alusta loppuun missä tahansa .NET Framework sovelluksessa. Kehittäjät voivat myös laajentaa RDL:ää lisäämällä mukautettuja raporttikohteita mukautetuilla ominaisuuksilla. Lisätietoja XmlTextWriter-luokasta ja nimitilasta System.Xml on Microsoft .NET Framework Developer's Guidessa. Jos haluat lisätietoja LANGUAGE-Integrated Querystä (LINQ), etsi MSDN:ssä sana "LINQ to XML".

Raportin määritystiedostojen vakiotiedostotunniste on .rdl. MIME-tyyppi on text/xml.

RDL-tyypit

Seuraavassa taulukossa on luettelo tyypeistä, joita käytetään RDL-elementeissä ja -määritteissä.

Tyyppi Kuvaus
Binääri Ominaisuus, jolla on base-64-koodattu binaariarvo.
Totuusarvo Ominaisuus, jonka objektin arvona on tosi tai epätosi . Ellei toisin määritetä, valinnaisen totuusarvo-objektin arvo on False.
Päivämäärä Ominaisuus, jonka täysin määritetty päivämäärä- tai päivämäärä/aika-arvo on määritetty ISO8601 päivämäärämuodossa: VVVV-KK-PP[THH:MM[:SS[. S]]].
Luettelointi Ominaisuus, jolla on merkkijonotekstiarvo ja jonka on oltava yksi määritettyjen arvojen luettelosta.
Kellua Ominaisuus, jolla on liukulukuarvo. Piste (.) on valinnainen desimaalierottimena.
Kokonaisluku Ominaisuus, jolla on kokonaislukuarvo (int32).
Kieli Ominaisuus, jonka tekstiarvo sisältää kielen ja maa-asetuksen koodin, kuten "en-us" (Yhdysvaltain englanti). Arvon on oltava tietty kieli tai neutraali kieli, jolle Microsoft-.NET Framework määritetään oletuskieli.
Nimi Ominaisuus, jolla on merkkijonotekstiarvo. Nimien on oltava yksilöllisiä kohteen nimitilassa. Jos tätä ei määritetä, kohteen nimitila on sisin objekti, jolla on nimi.
NormalizedString Ominaisuus, jolla on normalisoitu merkkijonotekstiarvo.
Koko Kokoelementin on sisällettävä luku (pistemerkki valinnaisena desimaalierottimena). Luvun perässä on oltava CSS-pituusyksikön, kuten cm, mm, in, pt tai pc, suunnittelukone. Numeron ja suunnittelulaitteen välissä on valinnainen välilyönti. Lisätietoja koon suunnittelusta on kohdassa CSS-arvot ja yksiköiden viitetiedot.

RDL:ssä Koon enimmäisarvo on 160 in. Pienin koko on 0 in.
Merkkijono Ominaisuus, jolla on merkkijonotekstiarvo.
UnsignedInt Ominaisuus, jolla on etumerkkitön kokonaislukuarvo (uint32).
Muunnos Ominaisuus, joka sisältää minkä tahansa yksinkertaisen XML-tyypin.

RDL-tietotyypit

DataType-luettelointi määrittää RDL:ssä määritteen, lausekkeen tai parametrin tietotyypin. Seuraavassa taulukossa näytetään, miten yleisen kielen suorituspalvelun (CLR) tietotyypit vastaavat RDL-tietotyyppejä.

CLR-tyypit Vastaava tietotyyppi
Totuusarvo Totuusarvo
DateTime, DateTimeOffset DateTime
Int16, Int32, UInt16, Byte, SByte Integer
Yksittäinen, kaksinkertainen Kellua
String, Char, GUID, Timespan Merkkijono

Liittyvä sisältö