Język definicji raportu (RDL)
DOTYCZY: 
Power BI Report Builder 
Power BI Desktop
Język RDL (Report Definition Language) to reprezentacja XML definicji raportu podzielonego na strony. Definicja raportu zawiera informacje o pobieraniu danych i układzie raportu. Język RDL składa się z elementów XML, które pasują do gramatyki XML utworzonej dla usługi Power BI. Możesz dodać własne funkcje niestandardowe do kontrolowania wartości elementów raportu, stylów i formatowania, korzystając z bloków kodu w plikach definicji raportu.
Język RDL promuje współdziałanie komercyjnych produktów raportowania, definiując wspólny schemat, który umożliwia wymianę definicji raportów. Dowolny protokół lub interfejs programowy, który współpracuje z językiem XML, może być używany z językiem RDL. Język RDL to:
- Schemat XML definicji raportu.
- Format wymiany dla firm i firm trzecich.
- Rozszerzalny i otwarty schemat, który obsługuje dodatkowe przestrzenie nazw i elementy niestandardowe.
Specyfikacje języka RDL
Aby pobrać specyfikacje dla określonych wersji schematu, zobacz Specyfikacja języka definicji raportu.
Definicja schematu XML języka RDL
Plik języka RDL (Report Definition Language) jest weryfikowany przy użyciu pliku definicji schematu XML (XSD). Schemat definiuje reguły, dla których elementy języka RDL mogą występować w pliku rdl. Element zawiera jego typ danych i kardynalność, czyli liczbę dozwolonych wystąpień. Element może być prosty lub złożony. Prosty element nie ma elementów podrzędnych ani atrybutów. Element złożony ma elementy podrzędne i opcjonalnie atrybuty.
Na przykład schemat zawiera element RDL ReportParameters, który jest typem złożonym ReportParametersType. Zgodnie z konwencją typ złożony elementu to nazwa elementu, po którym następuje słowo Typ. Element ReportParameters może być zawarty przez element Report (typ złożony) i może zawierać elementy ReportParameter. Parametr ReportParameterType to prosty typ, który może być tylko jedną z następujących wartości: wartość logiczna, data/godzina, liczba całkowita, zmiennoprzecinkowa lub ciąg. Aby uzyskać więcej informacji na temat typów danych schematu XML, zobacz Schemat XML — część 2: Datatypes Second Edition.
Tworzenie języka RDL
Ze względu na otwarty i rozszerzalny charakter języka RDL można utworzyć różne narzędzia i aplikacje, które generują język RDL na podstawie schematu XML.
Program Power BI Report Builder jest preferowanym sposobem tworzenia raportów podzielonych na strony opartych na języku RDL.
Jednym z najprostszych sposobów generowania języka RDL z aplikacji jest użycie klas System.Xml programu Microsoft .NET Framework przestrzeni nazw i System.Linq przestrzeni nazw. Jedna klasa w szczególności, klasa XmlTextWriter , może służyć do pisania języka RDL. Za pomocą narzędzia XmlTextWriter można wygenerować pełną definicję raportu od początku do końca w dowolnej aplikacji .NET Framework. Deweloperzy mogą również rozszerzyć język RDL, dodając niestandardowe elementy raportu z właściwościami niestandardowymi. Aby uzyskać więcej informacji na temat klasy XmlTextWriter i System.Xml przestrzeni nazw, zobacz Przewodnik dewelopera programu Microsoft .NET Framework. Aby uzyskać więcej informacji na temat zapytania zintegrowanego z językiem (LINQ), wyszukaj frazę "LINQ to XML" w witrynie MSDN.
Standardowe rozszerzenie pliku dla plików definicji raportu to .rdl. Typ MIME to tekst/xml.
Typy języka RDL
W poniższej tabeli wymieniono typy używane w elementach i atrybutach języka RDL.
| Type | Opis |
|---|---|
| Dwójkowy | Właściwość z zakodowaną wartością binarną base-64. |
| Wartość logiczna | Właściwość z wartością true lub false jako wartością obiektu. Jeśli nie określono inaczej, wartość pominiętego opcjonalnego obiektu logicznego ma wartość False. |
| Data | Właściwość z w pełni określoną wartością daty lub daty/godziny określoną w formacie daty ISO8601: RRRR-MM-DD[THH:MM[:SS[. S]]]. |
| Wyliczenie | Właściwość z wartością tekstową ciągu, która musi być jedną z listy wyznaczonych wartości. |
| Spławik | Właściwość z wartością zmiennoprzecinkową. Kropka (.) jest używana jako opcjonalny separator dziesiętny. |
| Wartość całkowita | Właściwość o wartości całkowitej (int32). |
| Język | Właściwość z wartością tekstową zawierającą kod języka i kultury, taki jak "en-us" dla języka angielskiego w Stanach Zjednoczonych. Wartość musi być określonym językiem lub neutralnym językiem, dla którego język domyślny jest zdefiniowany w programie Microsoft .NET Framework. |
| Nazwa/nazwisko | Właściwość z wartością tekstową ciągu. Nazwy muszą być unikatowe w przestrzeni nazw elementu. Jeśli nie zostanie określona, przestrzeń nazw elementu jest najbardziej wewnętrznym obiektem zawierającym nazwę. |
| NormalizedString | Właściwość z wartością tekstową ciągu, która została znormalizowana. |
| Rozmiar | Element rozmiaru musi zawierać liczbę (z znakiem kropki używanym jako opcjonalny separator dziesiętny). Po numerze musi znajdować się projektant dla jednostki długości CSS, takiej jak cm, mm, in, pt lub pc. Odstęp między liczbą a projektantem jest opcjonalny. Aby uzyskać więcej informacji na temat projektowania rozmiarów, zobacz Wartości CSS i dokumentacja jednostek. W języku RDL maksymalna wartość rozmiaru to 160 cali. Minimalny rozmiar to 0 cala. |
| ciąg | Właściwość z wartością tekstową ciągu. |
| NiepodpisaneInt | Właściwość z niepodpisaną liczbą całkowitą (uint32). |
| Wariant | Właściwość z dowolnym prostym typem XML. |
Typy danych języka RDL
Wyliczenie DataType definiuje typ danych atrybutu, wyrażenia lub parametru w języku RDL. W poniższej tabeli przedstawiono, jak typy danych środowiska uruchomieniowego języka wspólnego (CLR) odpowiadają typom danych języka RDL.
| Typy CLR | Odpowiedni typ danych |
|---|---|
| Wartość logiczna | Wartość logiczna |
| DateTime, DateTimeOffset | DateTime |
| Int16, Int32, UInt16, Byte, SByte | Integer |
| Pojedynczy, podwójny | Liczba zmiennoprzecinkowa |
| String, Char, GUID, Timespan | String |