Report Definition Language (SSRS)

Report Definition Language (RDL) is een XML-representatie van een SQL Server Reporting Services (SSRS) rapportdefinitie. Een rapportdefinitie bevat informatie over het ophalen en indelen van gegevens voor een rapport. RDL bestaat uit XML-elementen die overeenkomen met een XML-grammatica die is gemaakt voor Reporting Services. Je kunt functies aanpassen voor het beheren van rapportitems, stijlen en opmaak door code assemblies binnen rapportdefinitiebestanden te benaderen.

RDL bevordert de interoperabiliteit van commerciële rapportageproducten door een gemeenschappelijk schema te definiëren dat de uitwisseling van rapportdefinities mogelijk maakt. RDL is:

  • Een XML-schema voor rapportdefinities.
  • Een uitwisselingsformaat voor bedrijven en derden.
  • Een uitbreidbaar en open schema dat meer namespaces en aangepaste elementen ondersteunt.

Prerequisites

Elke protocol- of programmatische interface die met XML werkt, kan worden gebruikt met RDL.

RDL-specificaties

Als u specificaties voor specifieke schemaversies wilt downloaden, raadpleegt u De specificatie van de rapportdefinitietaal.

RDL XML Schema Definitie

Een SSRS RDL-bestand wordt gevalideerd met behulp van een XML Schema Definition (XSD)-bestand. Het schema definieert de regels voor waar RDL-elementen kunnen optreden in een RDL-bestand. Een element bevat zijn datatype en kardinaliteit, wat het aantal toegestane voorkomsen is. Een element kan eenvoudig of complex zijn. Een eenvoudig element heeft geen kind-elementen of attributen. Een complex element heeft kindelementen en kan attributen hebben.

Het schema bevat bijvoorbeeld het RDL-element ReportParameters, het complexe type ReportParametersType.

  • Volgens conventie is een complex type voor een element de naam van het element gevolgd door het woord Type.
  • Een ReportParameters-element kan worden opgenomen door het element Rapport (een complex type) en kan ReportParameter-elementen bevatten.
  • Een ReportParameterType is een eenvoudig type dat slechts een van de volgende waarden kan zijn: Booleaanse waarde, DateTime, Integer, Float of String.

Zie XML-schema deel 2: Datatypes Second Edition voor meer informatie over XML-schemagegevenstypen.

De RDL XSD is beschikbaar in het ReportDefinition.xsd-bestand, dat zich bevindt in de Extras-map op de product-cd-rom. Het is ook beschikbaar op de rapportserver via de volgende URL: https://servername/reportserver/reportdefinition.xsd.

Maak RDL aan

Bouw tools en applicaties die RDL genereren op basis van hun XML-schema vanwege de open en uitbreidbare aard van RDL.

Reporting Services biedt meerdere tools om RDL-bestanden op te bouwen. Zie Reporting Services Tools voor meer informatie.

  • Genereer RDL vanuit een applicatie door gebruik te maken van de Microsoft .NET Framework-klassen van de System.Xml en System.Linq namespaces.
  • Gebruik de XmlTextWriter om RDL te schrijven. Met XmlTextWriter kunt u een volledige rapportdefinitie genereren van begin tot eind in elke .NET Framework-toepassing. Voor meer informatie over de XmlTextWriter-klasse en de System.Xml naamruimte, zie de Microsoft .NET Framework Developer's Guide.

Ontwikkelaars kunnen RDL uitbreiden door aangepaste rapportitems met aangepaste eigenschappen toe te voegen. Voor meer informatie over Language-Integrated Query (LINQ), zoek op "LINQ to XML" op Microsoft Developer Network.

De standaard bestandsextensie voor een rapportdefinitiebestand is .rdl. Je kunt client report definition-bestanden ontwikkelen, die de extensies .rdlc hebben. Het MIME-type voor beide extensies is text/xml. Voor meer informatie, zie Reporting Services Reports (SSRS).

RDL-typen

De volgende tabel bevat typen die worden gebruikt in RDL-elementen en -kenmerken.

Type Description
Binaire Een eigenschap met een met base 64 gecodeerde binaire waarde.
Boolean Een eigenschap met waar of onwaar als de waarde van het object. Tenzij anders opgegeven, is de waarde van een weggelaten optioneel Booleaanse object Onwaar.
Date Een eigenschap met een volledig opgegeven datum- of datum/tijdwaarde die is opgegeven in ISO8601 datumnotatie: JJJJ-MM-DD[THH:MM[:SS[. S]]].
Enum Een eigenschap met een tekenreekstekstwaarde die een van een lijst met aangewezen waarden moet zijn.
Drijven Een eigenschap met een float-waarde. Een punt (.) wordt gebruikt als het optionele decimaalteken.
geheel getal Een eigenschap met een geheel getalwaarde (int32).
Language Een eigenschap met een tekstwaarde die een taal- en cultuurcode bevat, zoals 'en-us' voor Amerikaans Engels. De waarde moet een specifieke taal of een neutrale taal zijn waarvoor een standaardtaal is gedefinieerd in Microsoft .NET Framework.
Naam Een eigenschap met een tekenreekstekstwaarde. Namen moeten uniek zijn binnen de naamruimte van het item. Als dit niet is opgegeven, is de naamruimte voor een item het binnenste object met een naam.
NormalizedString Een eigenschap met een genormaliseerde tekststringwaarde.
grootte Een maatelement moet een getal bevatten waarbij een punt als optioneel decimaal scheidingsteken wordt gebruikt. Een aanduiding voor een CSS-lengte-eenheid zoals cm, mm, in, pt of pc moet het nummer volgen. Een spatie tussen het getal en de aanduiding is optioneel. Voor meer informatie, zie CSS Values and Units Reference.

In RDL is de maximumwaarde voor Grootte 160 in. De minimale grootte is 0 in.
String Een eigenschap met een tekenreekstekstwaarde.
UnsignedInt Een eigenschap met een uint32-waarde zonder teken.
Variant Een eigenschap met elk eenvoudig XML-type.

RDL-gegevenstypen

De DataType Enumeration definieert het datatype van een attribuut, expressie of parameter in RDL. In de volgende tabel ziet u hoe clr-gegevenstypen (Common Language Runtime) overeenkomen met RDL-gegevenstypen.

CLR-type(en) Bijbehorend gegevenstype
Boolean Boolean
DatumTijd, DatumTijdVerplaatsing DateTime
Int16, Int32, UInt16, Byte, SByte Integer
Enkel, Dubbel zweven
String, Char, GUID, tijdsduur String

Verwante onderwerpen

  • Last updated on