Partager via


Exportation au format XML (Générateur de rapports version 3.0 et SSRS)

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.

Notes

Vous pouvez créer et modifier des définitions de rapports (.rdl) dans le Générateur de rapports version 3.0 et dans le Concepteur de rapports, dans Business Intelligence Development Studio. Chaque environnement de création offre différentes possibilités pour créer, ouvrir et enregistrer des rapports et des éléments connexes. Pour plus d'informations, consultez Conception de rapports dans le Concepteur de rapports et le Générateur de rapports version 3.0 (SSRS) sur le site Web Microsoft.

Dans cet article

Éléments de rapport

Types de données

Règles de rendu spécifiques à XML

Formats personnalisés et XSLT

Noms en double

Transformations XSLT

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

Éléments de rapport

La table suivante 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.

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.

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'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.

Icône de flèche utilisée avec le lien Retour au débutRetour au début

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

Icône de flèche utilisée avec le lien Retour au débutRetour au début

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&amp;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, les barres de données et les graphiques sparkline sont rendus 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, 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.

Icône de flèche utilisée avec le lien Retour au débutRetour au début

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.

Icône de flèche utilisée avec le lien Retour au débutRetour au début

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.

Icône de flèche utilisée avec le lien Retour au débutRetour au début

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.

Icône de flèche utilisée avec le lien Retour au débutRetour au début

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.

Icône de flèche utilisée avec le lien Retour au débutRetour au début

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 Paramètres d'informations de périphérique XML.

Icône de flèche utilisée avec le lien Retour au débutRetour au début