Exporter un rapport paginé au format XML (Générateur de rapports)

Article
06/19/2023

S’applique à : Générateur de rapports Microsoft (SSRS) Power BI Report Builder Concepteur de rapports dans SQL Server Data Tools

L’extension de rendu XML retourne un rapport paginé au format XML. Le schéma du rapport XML est spécifique du rapport et contient uniquement des données. Les informations de mise en page ne sont pas rendues et la pagination n’est pas conservée par l’extension de rendu XML. La sortie XML générée par cette extension peut être importée dans une base de données, utilisée en tant que message de données XML ou envoyée à une application personnalisée.

Notes

Il est possible de créer et de modifier des fichiers de définition de rapports (.rdl) paginés dans le Générateur de rapports Microsoft, dans Power BI Report Builder et dans le Concepteur de rapports de SQL Server Data Tools.

Éléments de rapport

Le tableau suivant décrit la façon dont les éléments de rapport sont rendus.

Élément	Comportement de rendu
Rapport	Rendu sous la forme d'un élément de premier niveau du document XML.
Régions de données	Rendu sous la forme d'un élément à l'intérieur de l'élément de son conteneur. Les régions de données incluent les tables, matrices et listes qui affichent les données sous forme de texte, ainsi que les graphiques, barres de données, graphiques sparkline, jauges et indicateurs qui visualisent les données.
Sections de groupe et de détails	Chaque instance est rendue sous la forme d'un élément à l'intérieur de l'élément de son conteneur.
Zone de texte	Rendu sous la forme d'un attribut ou d'un élément à l'intérieur de son conteneur.
Rectangle	Rendu sous la forme d'un élément à l'intérieur de son conteneur.
Groupes de colonnes de matrices	Rendu sous la forme d'éléments à l'intérieur de groupes de lignes.
Mappage	Rendu sous la forme d'un élément à l'intérieur de l'élément de son conteneur. Les couches sont des éléments enfants de la carte et chaque couche comporte des éléments pour ses membres cartographiques et attributs de membre cartographique.
Graphique	Rendu sous la forme d'un élément à l'intérieur de l'élément de son conteneur. Les séries sont des éléments enfants du graphique, et les catégories sont des éléments enfants d'une série. Effectue le rendu de toutes les étiquettes de graphiques pour chaque valeur de graphique. Les étiquettes et les valeurs sont incluses en tant qu'attributs.
Barre de données	Rendu sous la forme d'un élément à l'intérieur de l'élément de son conteneur, comme un graphique. En règle générale, une barre de données n’inclut pas de hiérarchies ou d’étiquettes, seulement des valeurs.
Graphique sparkline	Rendu sous la forme d'un élément à l'intérieur de l'élément de son conteneur, comme un graphique. En règle générale, un graphique sparkline n’inclut pas de hiérarchies ou d’étiquettes, seulement des valeurs.
Jauge	Rendu sous la forme d'un élément à l'intérieur de l'élément de son conteneur. Effectue le rendu en tant qu'élément unique avec les valeurs maximale et minimale de l'échelle, les valeurs de début et de fin de la plage et la valeur du pointeur en tant qu'attributs.
Indicateur	Rendu sous la forme d'un élément à l'intérieur de l'élément de son conteneur, comme une jauge. Effectue le rendu en tant qu'élément unique avec le nom de l'état actif, les états disponibles et la valeur de données en tant qu'attributs.

Les rapports qui sont rendus à l'aide de l'extension de rendu XML sont également soumis aux règles suivantes :

Les éléments et les attributs XML sont rendus dans leur ordre d'apparition dans la définition de rapport.
La pagination est ignorée.
Les en-têtes et les pieds de page ne sont pas rendus.
Les éléments masqués qui ne peuvent pas être rendus visibles par le biais d’un bouton bascule ne sont pas affichés. Les éléments initialement visibles et les éléments masqués qui peuvent être rendus visibles par le biais d'une bascule sont rendus.
Images, lines, and custom report items sont ignorés.

Types de données

L'élément zone de texte ou attribut se voit affecter un type de données XSD sur la base des valeurs affichées par la zone de texte.

Si toutes les valeurs de zone de texte sont	Le type de données affecté est
Int16, Int32, Int64, UInt16, UInt32, UInt64, Byte, SByte	xsd:integer
Decimal (ou Decimal et tout type de données entier ou octet)	xsd:decimal
Float (ou Decimal et tout type de données entier ou octet)	xsd:float
Double (ou Decimal et tout type de données entier ou octet)	xsd:double
DateTime ou DateTime Offset	xsd:dateTime
Time	xsd:string
Booléen	xsd:boolean
String, Char	xsd:string
Autre	xsd:string

Règles de rendu spécifiques à XML

Les sections suivantes décrivent comment les extensions de rendu XML interprètent les éléments dans le rapport.

Corps du rapport

Un rapport est rendu sous la forme de l'élément racine du document XML. Le nom de l’élément provient de la propriété DataElementName définie dans le volet Propriétés.

Les définitions d'espaces de noms XML et les attributs de référence de schéma sont également inclus dans l'élément de rapport. Les variables sont notées en gras :

<Report xmlns="SchemaName" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="SchemaNameReportURL&rc%3aSchema=true" Name="ReportName">

Les valeurs des variables sont les suivantes :

Nom	Valeur
Rapport	Report.DataElementName
ReportURL	URL absolue URLEncoded d'accès au rapport sur le serveur.
SchemaName	Report.SchemaName. Si Null, alors Report.Name. Si Report.Name est utilisé, il est d'abord encodé avec XmlConvert.EncodeLocalName.
ReportName	Nom du rapport.

Zones de texte

Les zones de texte sont rendues sous la forme d’éléments ou d’attributs en fonction de la propriété RDL DataElementStyle. Le nom de l’élément ou de l’attribut provient de la propriété RDL TextBox.DataElementName.

Graphiques, barres de données et graphiques sparkline

Les graphiques, barres de données et graphiques sparkline sont affichés au format XML. Les données sont structurées.

Jauges et indicateurs

Les jauges et les indicateurs sont rendus au format XML. Les données sont structurées.

Sous-rapports

Un sous-rapport est rendu sous la forme d'un élément. Le nom de l’élément provient de la propriété RDL DataElementName. Le paramètre de propriété TextBoxesAsElements du rapport remplace celui du sous-rapport. Les attributs d’espace de noms et XSLT ne sont pas ajoutés à l’élément de sous-rapport.

Rectangles

Un rectangle est rendu sous la forme d'un élément. Le nom de l’élément provient de la propriété RDL DataElementName.

Éléments de rapport personnalisés

Les éléments de rapport personnalisés, CustomReportItems (CRI), ne sont pas visibles à l’extension de rendu. Si le rapport contient un élément de rapport personnalisé, l'extension de rendu le rend sous la forme d'un élément de rapport classique.

Images

Les images ne sont pas affichées.

Lignes

Les lignes ne sont pas affichées.

Tables, matrices et listes

Les tables, matrices et listes sont rendues sous la forme d'un élément. Le nom de l’élément provient de la propriété RDL DataElementName de tableau matriciel.

Lignes et colonnes

Les colonnes sont rendues dans des lignes.

Angle de tableau matriciel

Le coin n’est pas affiché. Seul le contenu de l'angle est rendu.

Cellules de tableau matriciel

Les cellules de tableau matriciel sont rendues sous la forme d'éléments. Le nom de l’élément provient de la propriété RDL DataElementName de la cellule.

Sous-totaux automatiques

Les sous-totaux automatiques de tableau matriciel ne sont pas affichés.

Éléments de ligne et de colonne qui ne se répètent pas avec un groupe

Les éléments qui ne se répètent pas avec un groupe, comme les étiquettes, les sous-totaux et les totaux sont rendus sous la forme d’éléments. Le nom de l’élément provient de la propriété RDL TablixMember.DataElementName.

La propriété TablixMember.DataElementOutput contrôle si un élément non répétitif est rendu.

Si la propriété DataElementName du membre de tableau matriciel n’est pas fournie, un nom est généré de façon dynamique pour l’élément non répétitif, sous la forme suivante :

RowX Pour les lignes non répétitives, X étant un index de ligne de base zéro dans le parent actuel.

ColumnY Pour les colonnes non répétitives, Y étant un index de colonne de base zéro dans le parent actuel.

Un en-tête non répétitif est rendu sous la forme d’un enfant de la ligne ou la colonne qui ne se répète pas avec un groupe.

Si un membre non répétitif n’a aucune cellule de tableau matriciel correspondante, il n’est pas affiché. Cela peut se produire dans le cas d'une cellule de tableau matriciel où il s'étend sur plusieurs colonnes.

Lignes et colonnes qui se répètent avec un groupe

Les lignes et colonnes qui se répètent dans un groupe sont rendues en fonctions des règles Tablix.DataElementOutput. Le nom de l’élément provient de la propriété DataElementName.

Chaque valeur unique dans un groupe est rendue sous la forme d'un élément enfant du groupe. Le nom de l’élément provient de la propriété Group.DataElementName.

Si la valeur de la propriété DataElementOutput est égale à Output, l’en-tête d’un élément répétitif est rendu sous la forme d’un enfant de l’élément de détail.

Formats personnalisés et XSLT

Les fichiers XML générés par l'extension de rendu XML peuvent être convertis dans n'importe quel format à l'aide de XSL Transformations (XSLT). Cette fonctionnalité permet de générer des données dans des formats qui ne sont pas déjà pris en charge par des extensions de rendu existantes. Pensez à utiliser l'extension de rendu XML et XSLT avant de tenter de créer votre propre extension de rendu.

Noms en double

S'il existe des noms d'élément de données en double dans la même étendue, le convertisseur affiche un message d'erreur.

Transformations XSLT

Le convertisseur XML peut appliquer une transformation XSLT côté serveur aux données XML d'origine. Lorsqu'une transformation XSLT est appliquée, le convertisseur génère en sortie le contenu transformé au lieu des données XML d'origine. La transformation a lieu sur le serveur, et non sur le client.

La transformation XSLT à appliquer à la sortie est définie dans le fichier de définition de rapport avec la propriété DataTransform du rapport ou avec le paramètre XSLT DeviceInfo . Si l'une de ces valeurs est définie, la transformation se produit chaque fois que le convertisseur XML est utilisé. Lors de l’utilisation d’abonnements, la transformation XSLT doit être définie dans la propriété RDL DataTransform.

Si un fichier XSLT est spécifié, à la fois par la propriété de définition DataTransform et par le paramètre d’informations de périphérique, la transformation XSLT spécifiée dans DataTransform a lieu en premier, suivie de celle définie par les paramètres d’informations de périphérique.

Paramètres d'informations de périphérique

Vous pouvez modifier certains paramètres par défaut de ce convertisseur en modifiant les paramètres d'informations de périphérique, y compris ceux ci-dessous :

une transformation (XSLT) à appliquer à la sortie XML ;
le type MIME du document XML ;
s'il faut appliquer des chaînes de format aux données ;
s'il faut appliquer un retrait à la sortie XML ;
s'il faut inclure le nom de schéma XML ;
l'encodage du document XML ;
l'extension de fichier du document XML.

Pour plus d'informations, consultez XML Device Information Settings.