Langage de définition de rapport (SSRS, Report Definition Language)

 

S'applique à: SQL Server 2016

Langage RDL (Report Definition) est une représentation XML d’un SQL Server Reporting Services définition de rapport. Une définition de rapport contient les informations d'extraction de données et de mise en page d'un rapport. La spécification RDL est composée d'éléments XML qui sont conformes à une grammaire XML créée pour Reporting Services. Vous pouvez ajouter vos propres fonctions personnalisées pour contrôler les valeurs, les styles et la mise en forme des éléments de rapport en accédant à des assemblys de code dans les fichiers de définition de rapport.

Le langage RDL favorise l'interopérabilité des produits commerciaux de création de rapports en définissant un schéma commun qui permet l'échange de définitions de rapport. Les protocoles ou les interfaces de programmation qui fonctionnent avec XML peuvent être utilisés avec le langage RDL. Les caractéristiques du langage RDL sont les suivantes :

  • Schéma XML pour les définitions de rapport

  • Format d'échange pour les entreprises et les fournisseurs tiers

  • Schéma extensible et ouvert qui prend en charge des éléments personnalisés et des espaces de noms supplémentaires.

Pour télécharger les caractéristiques des versions de schéma spécifique, voir spécification de langage de définition de rapport.

Un SQL Server Reporting Services fichier de langage de définition de rapport (RDL) est validé à l’aide d’un fichier de définition de schéma XML (XSD). Le schéma définit les règles où les éléments RDL peuvent se produire dans un fichier .rdl. Un élément inclut son type de données et de la cardinalité, autrement dit, le nombre d’occurrences autorisées. Un élément peut être simple ou complexe. Un élément simple n'a pas d'éléments enfants ni d'attributs. Un élément complexe a des enfants et éventuellement des attributs.

Par exemple, le schéma inclut l’élément RDL ReportParameters, qui est le type complex ReportParametersType. Par convention, un type complexe d’un élément est le nom de l’élément suivi par le mot Type. A ReportParameters élément peut être contenu par le rapport élément (type complexe) et peut contenir ReportParameter éléments. A ReportParameterType est un type simple qui ne peut avoir une des valeurs suivantes : booléenne, DateTime, entier, Float, ou chaîne. Pour plus d’informations sur les types de données de schéma XML, consultez XML Schema Part 2 : Datatypes Second Edition.

Le XSD RDL est disponible dans le fichier ReportDefinition.xsd, situé dans le dossier Extras sur le CD-ROM du produit. Il est également disponible sur le serveur de rapports à l'adresse URL suivante : http://servername/reportserver/reportdefinition.xsd.

Compte tenu du caractère ouvert et extensible du langage RDL, il est possible de créer divers outils et applications qui génèrent le langage RDL selon son schéma XML.

Reporting Services fournit plusieurs outils pour créer les fichiers RDL. Pour plus d’informations, consultez Outils des Services de création de rapports.

Une des méthodes plus simples à générer le langage RDL à partir d’une application consiste à utiliser le Microsoft .NET Framework classes de la System.Xml espace de noms et System.Linq espace de noms. Une classe en particulier, le XmlTextWriter de classe, peut être utilisé pour écrire le langage RDL. Avec XmlTextWriter, vous pouvez générer une définition de rapport complète de bout en bout dans les .NET Framework application. Les développeurs peuvent également étendre le langage RDL en ajoutant des éléments de rapport personnalisés avec des propriétés personnalisées. Pour plus d’informations sur la XmlTextWriter classe et System.Xml espace de noms, consultez le Microsoft .NET Framework Guide du développeur. Pour plus d'informations sur LINQ (Language-Integrated Query), recherchez les termes « LINQ to XML » sur MSDN.

L'extension de fichier standard pour les fichiers de définition de rapport est .rdl. Vous pouvez également développer des fichiers de définition de rapport client, lesquels portent l'extension .rdlc. Le type MIME pour les deux extensions est text/xml. Pour plus d’informations sur les rapports, consultez la page les rapports Reporting Services & #40 ; SSRS & #41 ;.

La table suivante répertorie les types utilisés dans des éléments et des attributs RDL.

TypeDescription
BinairePropriété dotée d'une valeur binaire encodée en base 64.
BooléenUne propriété avec true ou false comme valeur de l’objet. Sauf indication contraire, la valeur d’un objet Boolean omis facultatif est False.
DatePropriété dotée d'une valeur date ou date/heure entièrement spécifiée au format de date ISO8601 : AAAA-MM-JJ[THH:MM[:SS[.S]]]
EnumPropriété dont la valeur est le texte d'une chaîne, qui doit appartenir à une liste de valeurs désignées.
FloatPropriété dotée d'une valeur flottante (Float). Une virgule (,) est utilisée comme séparateur décimal facultatif.
EntierPropriété dotée d'une valeur entière (int32).
LangagePropriété dont la valeur est le texte d'une chaîne, qui contient un code de langue et de culture, tel que « en-us » pour l'anglais (États-Unis). La valeur doit être une langue spécifique ou une langue neutre pour lequel une langue par défaut est définie dans le Microsoft .NET Framework.
NomPropriété dont la valeur est le texte d'une chaîne. Les noms doivent être uniques dans l'espace de noms de l'élément. S'il n'est pas spécifié, l'espace de noms d'un élément est l'objet conteneur le plus profond doté d'un nom.
NormalizedStringPropriété dont la valeur est le texte d'une chaîne, qui a été normalisée.
TailleUn élément de taille doit contenir un nombre (avec une virgule comme séparateur décimal facultatif). Le nombre doit être suivi d'un indicateur pour une unité de longueur CSS ; par exemple, cm, mm, in, pt ou pc. Un espace entre le nombre et l'indicateur est facultatif. Pour plus d’informations sur les indicateurs de taille, consultez CSS Length Units Reference.

Dans RDL, la valeur maximale de taille est 160 po. La taille minimale est 0 po.
ChaînePropriété dont la valeur est le texte d'une chaîne.
UnsignedIntPropriété dotée d'une valeur entière non signée (uint32).
VariantUne propriété dotée d'un type XML simple.

L'énumération DataType définit le type de données d'un attribut, d'une expression ou d'un paramètre dans RDL. Le tableau suivant illustre les types de données CLR (common langage runtime (CLR)) correspondent aux types de données RDL.

Type CLRType de données correspondant
BooléenBooléen
DateTime, DateTimeOffsetDateTime
Int16, Int32, UInt16, Byte, SByteEntier
Single, DoubleFloat
String, Char, GUID, TimespanChaîne

Recherchez la Version de schéma de définition de rapport & #40 ; SSRS & #41 ;
Utilisation d'assemblys personnalisés avec des rapports
Éléments de rapport personnalisés

Ajouts de la communauté

AJOUTER
Afficher: