Exportation au format XML
L'extension de rendu XML rend un rapport 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.
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. |
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. |
Carte |
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. |
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'une bascule ne sont pas rendus. 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 des données de type entier ou octet) |
xsd:decimal |
Float (ou Decimal et des données de type entier ou octet) |
xsd:float |
Double (ou Decimal et des données de type entier ou octet) |
xsd:double |
DateTime or DateTime Offset |
xsd:dateTime |
Time |
xsd:string |
Boolean |
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
Les graphiques sont rendus en XML. Les données de graphique 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, 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 rendues.
Lignes
Les lignes ne sont pas rendues.
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
L'angle n'est pas rendu. 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 rendus.
É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é RDL 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 cette forme :
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 rendu. 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 transformations XSL
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 portée, 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 Reporting Services Device Information Settings (en anglais).
Voir aussi
Concepts
Présentation de la pagination dans Reporting Services
Présentation des comportements de rendu
Comparaison des fonctionnalités interactives pour différentes extensions de rendu de rapport