Jelentésdefiníció nyelve (RDL)
A következőkre vonatkozik: 
Power BI Jelentéskészítő 
Power BI Desktop
A jelentésdefiníciós nyelv (RDL) egy többoldalas jelentésdefiníció XML-reprezentációja. A jelentésdefiníciók adatlekérési és elrendezési információkat tartalmaznak egy jelentéshez. Az RDL olyan XML-elemekből áll, amelyek megfelelnek a Power BI-hoz létrehozott XML-nyelvtannak. A jelentéselemek értékeinek, stílusainak és formázásának szabályozásához saját egyéni függvényeket adhat hozzá a jelentésdefiníciós fájlokban lévő kódblokkokhoz való hozzáféréssel.
Az RDL elősegíti a kereskedelmi jelentéskészítési termékek együttműködését egy közös séma meghatározásával, amely lehetővé teszi a jelentésdefiníciók közötti váltást. Az XML-lel működő protokollok és programozott felületek rdL-vel is használhatók. Az RDL a következő:
- Xml-séma jelentésdefiníciókhoz.
- A vállalatok és harmadik felek közötti felcserélés formátuma.
- Bővíthető és nyitott séma, amely további névtereket és egyéni elemeket támogat.
Az egyes sémaverziók specifikációinak letöltéséhez tekintse meg a jelentésdefiníció nyelvi specifikációját.
A jelentésdefiníciós nyelv (RDL) fájl egy XML-sémadefiníciós (XSD) fájl használatával van érvényesítve. A séma meghatározza azokat a szabályokat, amelyekben az RDL-elemek előfordulhatnak egy .rdl-fájlban. Az elemek tartalmazzák az adattípust és a számosságot, vagyis az engedélyezett előfordulások számát. Az elemek lehetnek egyszerűek vagy összetettek. Az egyszerű elemek nem rendelkeznek gyermekelemekkel vagy attribútumokkal. Egy összetett elem rendelkezik gyermekekkel és opcionálisan attribútumokkal.
A séma például tartalmazza a ReportParameters RDL-elemet, amely a ReportParametersType komplex típus. Konvenció szerint egy elem összetett típusa az elem neve, amelyet a Type (Típus) szó követ. A Jelentésparaméterek elemet a Jelentés elem (összetett típus) tartalmazhatja, és jelentésparaméter-elemeket is tartalmazhat. A ReportParameterType egy egyszerű típus, amely csak az alábbi értékek egyike lehet: Logikai, DateTime, Egész szám, Lebegőpontos vagy Sztring. További információ az XML-séma adattípusairól: XML-séma 2. rész: Datatypes Second Edition.
Az RDL nyitott és bővíthető jellege miatt számos olyan eszköz és alkalmazás hozható létre, amely az XML-sémája alapján hoz létre RDL-t.
Az RDL-alapú lapszámozott jelentések készítésének előnyben részesített módja a Power BI Jelentéskészítő.
Az RDL alkalmazásból való létrehozásának egyik legegyszerűbb módja a Névtér és System.Linq névtér Microsoft .NET-keretrendszer osztályainak System.Xml használata. Az RDL írásához különösen egy osztály, az XmlTextWriter osztály használható. Az XmlTextWriter használatával létrehozhat egy teljes jelentésdefiníciót az elejétől a végéig bármely .NET-keretrendszer alkalmazásban. A fejlesztők egyéni jelentéselemek egyéni tulajdonságokkal való hozzáadásával is bővíthetik az RDL-t. Az XmlTextWriter osztályról és a System.Xml névtérről további információt a Microsoft .NET-keretrendszer fejlesztői útmutatójában talál. A nyelvvel integrált lekérdezéssel (LINQ) kapcsolatos további információkért keresse meg a "LINQ to XML" kifejezést az MSDN-en.
A jelentésdefiníciós fájlok szabványos fájlkiterjesztése az .rdl. A MIME típusa szöveg/xml.
Az alábbi táblázat az RDL-elemekben és -attribútumokban használt típusokat sorolja fel.
| Típus | Leírás |
|---|---|
| Bináris | Egy base-64 kódolású bináris értékkel rendelkező tulajdonság. |
| Logikai | Az objektum értékeként igaz vagy hamis tulajdonság. Ha másként nincs megadva, a kihagyott logikai objektum értéke Hamis. |
| Dátum | Az ISO8601 dátumformátumban megadott teljes dátum- vagy dátum/idő értékkel rendelkező tulajdonság: YYYYY-MM-DD[THH:MM[:SS[. S]]]. |
| Enumerálás | Karakterlánc szöveges értékkel rendelkező tulajdonság, amelynek a kijelölt értékek listájának egyikének kell lennie. |
| Lebeg | Lebegőpontos tulajdonság. A rendszer a pont (.) függvényt használja a választható tizedeselválasztóként. |
| Egész szám | Egész számmal (int32) rendelkező tulajdonság. |
| Nyelv | Olyan szöveges értékkel rendelkező tulajdonság, amely tartalmaz egy nyelv- és kulturális kódot, például "en-us" az amerikai angol nyelvhez. Az értéknek egy adott nyelvnek vagy egy semleges nyelvnek kell lennie, amelyhez a Microsoft .NET-keretrendszer alapértelmezett nyelv van definiálva. |
| Név | Karakterlánc szöveges értékkel rendelkező tulajdonság. A neveknek egyedinek kell lenniük az elem névterében. Ha nincs megadva, az elem névtere a névvel rendelkező objektumot tartalmazó legbelső. |
| NormalizedString | Normalizált sztringszöveg-értékkel rendelkező tulajdonság. |
| Méret | A méretelemnek tartalmaznia kell egy számot (egy pont karakterrel, amelyet nem kötelező tizedeselválasztóként használni). A számot egy CSS-hosszúsági egység (például cm, mm, in, pt vagy pc) tervezőjének kell követnie. A szám és a tervező közötti térköz megadása nem kötelező. A mérettervezőkkel kapcsolatos további információkért lásd a CSS értékeit és az egységekre vonatkozó referenciát. RDL-ben a méret maximális értéke 160. A minimális méret 0. |
| Sztring | Karakterlánc szöveges értékkel rendelkező tulajdonság. |
| UnsignedInt | Egy nem aláírt egész (uint32) értékkel rendelkező tulajdonság. |
| Változat | Bármilyen egyszerű XML-típussal rendelkező tulajdonság. |
A DataType Enumerálás egy attribútum, kifejezés vagy paraméter adattípusát határozza meg az RDL-ben. Az alábbi táblázat bemutatja, hogy a gyakori nyelvi futtatókörnyezeti (CLR) adattípusok hogyan felelnek meg az RDL-adattípusoknak.
| CLR-típus(ok) | Megfelelő adattípus |
|---|---|
| Logikai | Logikai |
| DateTime, DateTimeOffset | Dátum/idő |
| Int16, Int32, UInt16, Byte, SByte | Egész |
| Egy- és kétszemélyes | Lebegőpontos értékek |
| Sztring, Karakter, GUID, Időbélyeg | Sztring |