Sdílet prostřednictvím

RDL (Report Definition Language)

  • Článek

PLATÍ PRO: Power BI Tvůrce sestav Power BI Desktopu

Jazyk RDL (Report Definition Language) je reprezentace definice stránkované sestavy ve formátu XML. Definice sestavy obsahuje informace o načtení 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

Pokud chcete stáhnout specifikace pro konkrétní verze schématu, přečtěte si téma 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 System.Xml rozhraní Microsoft .NET Framework oboru názvů a System.Linq oboru názvů. Jedna třída zejména XmlTextWriter třídy 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 sestavy s vlastními vlastnostmi. Další informace o XmlTextWriter třídy a System.Xml oboru názvů naleznete v Microsoft .NET Framework Developer's Guide. Další informace o jazykově integrovaném dotazu (LINQ) vyhledejte na webu MSDN "LINQ to XML".

Standardní přípona souboru pro definiční soubory sestavy 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.
Logická hodnota 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 zadanou v ISO8601 formátu data: RRRR-MM-DD[THH:MM[:SS[. S]]].
Výčtu Vlastnost s řetězcovou textovou hodnotou, která musí být jedním ze seznamu určených hodnot.
Float 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 jazykové verze, například "en-us" pro angličtinu v USA. 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í zadaný, obor názvů položky je nejvíce vnitřní obsahující objekt, který má 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 tématu Hodnoty CSS a odkazy jednotek.

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 DateTime
Int16, Int32, UInt16, Bajt, SByte Celé číslo
Single, Double Float
String, Char, GUID, Timespan String

Související obsah