RDL (Report Definition Language)

PLATÍ PRO: Power BI Report Builder Power BI Desktop

Jazyk RDL (Report Definition Language) je reprezentace definice stránkované sestavy ve formátu XML. Definice sestavy obsahuje informace o získávání a rozložení dat pro sestavu. RDL se skládá z elementů XML, které odpovídají gramatikě XML vytvořené pro Power BI. Vlastní funkce pro řízení hodnot položek sestavy, stylů a formátování můžete přidat tak, že v souborech definic sestavy získáte přístup k blokům kódu.

RDL podporuje interoperabilitu komerčních produktů generování sestav definováním společného schématu, které umožňuje výměnu definic sestav. Jakýkoli protokol nebo programové rozhraní, které funguje s XML, lze použít s RDL. RDL je:

  • Schéma XML pro definice sestavy.
  • Formát výměny pro firmy a třetí strany.
  • Rozšiřitelné a otevřené schéma, které podporuje další obory názvů a vlastní prvky.

Specifikace RDL

Pro stažení specifikací pro konkrétní verze schématu viz Specifikace jazyka definice sestavy.

Definice schématu RDL XML

Soubor RDL (Report Definition Language) se ověřuje pomocí souboru XSD (XML Schema Definition). Schéma definuje pravidla, ve kterých se můžou v souboru .rdl vyskytovat elementy RDL. Prvek obsahuje datový typ a kardinalitu, tj. počet povolených výskytů. Prvek může být jednoduchý nebo složitý. Jednoduchý prvek nemá podřízené elementy ani atributy. Komplexní prvek obsahuje podřízené položky a volitelně atributy.

Schéma například obsahuje element RDL ReportParameters, což je komplexní typ ReportParametersType. Podle konvence je komplexní typ prvku název prvku, který následuje po slově Type. Element ReportParameters může obsahovat element Report (komplexní typ) a může obsahovat elementy ReportParameter . ReportParameterType je jednoduchý typ, který může být pouze jednou z následujících hodnot: Logická hodnota, DateTime, Integer, Float nebo String. Další informace o datových typech schématu XML naleznete v tématu Schémata XML část 2: Datové typy Druhé vydání.

Vytvoření RDL

Vzhledem k otevřené a rozšiřitelné povaze RDL je možné sestavit různé nástroje a aplikace, které generují RDL na základě schématu XML.

Power BI Tvůrce sestav je upřednostňovaným způsobem vytváření stránkovaných sestav založených na RDL.

Jedním z nejjednodušších způsobů generování RDL z aplikace je použití tříd oboru názvů System.Xml a oboru názvů System.Linq rozhraní Microsoft .NET Framework. Zejména jedna třída, třída XmlTextWriter, lze použít k zápisu RDL. Pomocí XmlTextWriter můžete vygenerovat úplnou definici sestavy od začátku do konce v libovolné aplikaci .NET Framework. Vývojáři mohou také rozšířit RDL přidáním vlastních položek zpráv s vlastními nastaveními. Další informace o třídě XmlTextWriter a oboru názvů System.Xml naleznete v průvodci vývojáře Microsoft .NET Framework. Další informace o jazykově integrovaném dotazu (LINQ) vyhledejte na webu MSDN "LINQ to XML".

Standardní přípona souboru pro definiční soubory sestav je .rdl. Typ MIME je text/xml.

Typy RDL

Následující tabulka uvádí typy používané v prvcích a atributech RDL.

Typ Popis
Binární Vlastnost s binární hodnotou s kódováním base-64.
Boolean Vlastnost s hodnotou true nebo false jako hodnotou objektu. Pokud není zadán jinak, hodnota vynechaného volitelného logického objektu je False.
Date Vlastnost s plně zadanou hodnotou data nebo data a času ve formátu ISO8601: RRRR-MM-DD[THH:MM[:SS[.S]]].
Výčet Vlastnost s řetězcovou textovou hodnotou, která musí být jedním ze seznamu určených hodnot.
Plout Vlastnost s plovoucí hodnotou. Tečka (.) se používá jako volitelný oddělovač desetinných míst.
Celé číslo Vlastnost s celočíselnou hodnotou (int32).
Jazyk Vlastnost s textovou hodnotou, která obsahuje kód jazyka a kulturní kód, například "en-us" pro americkou angličtinu. Hodnota musí být buď konkrétní jazyk, nebo neutrální jazyk, pro který je definován výchozí jazyk v rozhraní Microsoft .NET Framework.
Název Vlastnost s řetězcovou textovou hodnotou. Názvy musí být jedinečné v rámci oboru názvů položky. Pokud není specifikován, oborem názvů položky je nejvnitřnější objekt, který obsahuje název.
NormalizedString Vlastnost s textovou hodnotou řetězce, která byla normalizována.
Velikost Prvek velikosti musí obsahovat číslo (s znakem tečky, který se používá jako volitelný oddělovač desetinných míst). Za číslem musí následovat designátor pro jednotku délky CSS, například cm, mm, in, pt nebo pc. Mezera mezi číslem a designátorem je volitelná. Další informace o designátorech velikostí naleznete v konceptu Referenční příručka pro hodnoty a jednotky CSS.

V RDL je maximální hodnota pro velikost 160 in. Minimální velikost je 0 in.
Řetězec Vlastnost s řetězcovou textovou hodnotou.
UnsignedInt Vlastnost s celočíselnou hodnotou bez znaménka (uint32).
Varianta Vlastnost s libovolným jednoduchým typem XML.

Datové typy RDL

Výčet DataType definuje datový typ atributu, výrazu nebo parametru v RDL. Následující tabulka ukazuje, jak datové typy CLR (Common Language Runtime) odpovídají datovým typům RDL.

Typy CLR Odpovídající datový typ
logický logický
DateTime, DateTimeOffset DatumČas
Int16, Int32, UInt16, Byte, SByte Celé číslo
Jednolůžkový, Dvoulůžkový Float
String, Char, GUID, Timespan String

Související obsah

  • Last updated on