Exportation vers XML (Générateur de rapports et SSRS)Exporting to XML (Report Builder and SSRS)

L’extension de rendu XML retourne un rapport paginé au format XML.The XML rendering extension returns a paginated report in XML format. Le schéma du rapport XML est spécifique du rapport et contient uniquement des données.The schema for the report XML is specific to the report, and contains data only. Les informations de mise en page ne sont pas rendues et la pagination n'est pas conservée par l'extension de rendu XML.Layout information is not rendered and pagination is not maintained by the XML rendering extension. 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.The XML generated by this extension can be imported into a database, used as an XML data message, or sent to a custom application.

Note

Vous pouvez créer et modifier des fichiers de définition de rapport (.rdl) paginés dans le Générateur de rapports et dans le Concepteur de rapports dans SQL Server Data Tools.You can create and modify paginated report definition (.rdl) files in Report Builder and in Report Designer in SQL Server Data Tools. Chaque environnement de création offre différentes possibilités pour créer, ouvrir et enregistrer des rapports et des éléments connexes.Each authoring environment provides different ways to create, open, and save reports and related items.

Éléments de rapport Report Items

Le tableau suivant décrit la façon dont les éléments de rapport sont rendus.The following table describes how report items are rendered.

ÉlémentItem Comportement de renduRendering behavior
RapportReport Rendu sous la forme d'un élément de premier niveau du document XML.Renders as the top-level element of the XML document.
Régions de donnéesData regions Rendu sous la forme d'un élément à l'intérieur de l'élément de son conteneur.Renders as an element within the element for its container. 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.Data regions include table, matrix, and list that display data as text and chart, data bars, sparklines, gauges, and indicators that visualize data.
Sections de groupe et de détailsGroup and detail sections Chaque instance est rendue sous la forme d'un élément à l'intérieur de l'élément de son conteneur.Each instance renders as an element within the element for its container.
Zone de texteText box Rendu sous la forme d'un attribut ou d'un élément à l'intérieur de son conteneur.Renders as an attribute or element within its container.
RectangleRectangle Rendu sous la forme d'un élément à l'intérieur de son conteneur.Renders as an element within its container.
Groupes de colonnes de matricesMatrix column groups Rendu sous la forme d'éléments à l'intérieur de groupes de lignes.Renders as elements within row groups.
MappageMap Rendu sous la forme d'un élément à l'intérieur de l'élément de son conteneur.Renders as an element within the element for its container. 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.Map layers are child elements of the map and each map layer includes elements for their map members and map member attributes.
GraphiqueChart Rendu sous la forme d'un élément à l'intérieur de l'élément de son conteneur.Renders as an element within the element for its container. Les séries sont des éléments enfants du graphique, et les catégories sont des éléments enfants d'une série.Series are child elements of the chart, and categories are child element of a series. Effectue le rendu de toutes les étiquettes de graphiques pour chaque valeur de graphique.Renders all chart labels for each chart value. Les étiquettes et les valeurs sont incluses en tant qu'attributs.Labels and values are included as attributes.
Barre de donnéesData bar Rendu sous la forme d'un élément à l'intérieur de l'élément de son conteneur, comme un graphique.Renders as an element within the element for its container, similar to a chart. En règle générale, une barre de données n'inclut pas de hiérarchies ou d'étiquettes, seulement des valeurs.Typically, a data bar does not include hierarchies or labels, only values.
Graphique sparklineSparkline Rendu sous la forme d'un élément à l'intérieur de l'élément de son conteneur, comme un graphique.Renders as an element within the element for its container, similar to a chart. En règle générale, un graphique sparkline n'inclut pas de hiérarchies ou d'étiquettes, seulement des valeurs.Typically, a sparkline does not include hierarchies or labels, only values.
JaugeGauge Rendu sous la forme d'un élément à l'intérieur de l'élément de son conteneur.Renders as an element within the element for its container. 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.Renders as a single element with the minimum and maximum values of the scale, start and end values of the range, and the value of the pointer as attributes.
IndicateurIndicator Rendu sous la forme d'un élément à l'intérieur de l'élément de son conteneur, comme une jauge.Renders as an element within the element for its container, similar to a gauge. 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.Renders as a single element with the active state name, available states, and the data value as attributes.

Les rapports qui sont rendus à l'aide de l'extension de rendu XML sont également soumis aux règles suivantes :Reports that are rendered using the XML rendering extension also follow these rules:

  • Les éléments et les attributs XML sont rendus dans leur ordre d'apparition dans la définition de rapport.XML elements and attributes are rendered in the order that they appear in the report definition.

  • La pagination est ignorée.Pagination is ignored.

  • Les en-têtes et les pieds de page ne sont pas rendus.Page headers and footers are not rendered.

  • Les éléments masqués qui ne peuvent pas être rendus visibles par le biais d'une bascule ne sont pas rendus.Hidden items that cannot be made visible by toggling are not rendered. Les éléments initialement visibles et les éléments masqués qui peuvent être rendus visibles par le biais d'une bascule sont rendus.Initially visible items and hidden items that can be made visible through a toggle are rendered.

  • Images, lines, and custom report items sont ignorés.Images, lines, and custom report items are ignored.

Types de données Data Types

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.The text box element or attribute is assigned an XSD data type based on the values that the text box displays.

Si toutes les valeurs de zone de texte sontIf all text box values are Le type de données affecté estAssigned data type is
Int16, Int32, Int64, UInt16, UInt32, UInt64, Byte, SByteInt16, Int32, Int64, UInt16, UInt32, UInt64, Byte, SByte xsd:integerxsd:integer
Decimal (ou Decimal et tout type de données entier ou octet)Decimal (or Decimal and any integer or byte data type) xsd:decimalxsd:decimal
Float (ou Decimal et tout type de données entier ou octet)Float (or Decimal and any integer or byte data type) xsd:floatxsd:float
Double (ou Decimal et tout type de données entier ou octet)Double (or Decimal and any integer or byte data type) xsd:doublexsd:double
DateTime ou DateTime OffsetDateTime or DateTime Offset xsd:dateTimexsd:dateTime
TimeTime xsd:stringxsd:string
BooléenBoolean xsd:booleanxsd:boolean
String, CharString, Char xsd:stringxsd:string
AutresOther xsd:stringxsd:string

Règles de rendu spécifiques à XML XML-Specific Rendering Rules

Les sections suivantes décrivent comment les extensions de rendu XML interprètent les éléments dans le rapport.The following sections describe how the XML rendering extensions interprets the items within the report.

Corps du rapportReport Body

Un rapport est rendu sous la forme de l'élément racine du document XML.A report is rendered as the root element of the XML document. Le nom de l’élément provient de la propriété DataElementName définie dans le volet Propriétés.The name of the element comes from the DataElementName property set in the Properties pane.

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.XML namespace definitions and schema reference attributes are also included in the report element. Les variables sont notées en gras :Variables are noted in bold face type:

<Rapport xmlns = »SchemaName» xmlns : xsi = « http://www.w3.org/2001/XMLSchema-instance » xsi :schemaLocation= «SchemaNameReportURL&rc % 3aSchema = true » nom = « ReportName » ><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 :The values for the variables are as follows:

NomName ValueValue
RapportReport Report.DataElementNameReport.DataElementName
ReportURLReportURL URL absolue URLEncoded d'accès au rapport sur le serveur.URLEncoded absolute URL to the report on the server.
SchemaNameSchemaName Report.SchemaName.Report.SchemaName. Si Null, alors Report.Name.If null, then Report.Name. Si Report.Name est utilisé, il est d'abord encodé avec XmlConvert.EncodeLocalName.If Report.Name is used, it is first encoded with XmlConvert.EncodeLocalName.
ReportNameReportName Nom du rapport.The name of the report.

Zones de texteText boxes

Les zones de texte sont rendues sous la forme d’éléments ou d’attributs en fonction de la propriété RDL DataElementStyle.Text boxes are rendered as elements or attributes according to the DataElementStyle RDL property. Le nom de l’élément ou de l’attribut provient de la propriété RDL TextBox.DataElementName.The name of the element or attribute comes from the TextBox.DataElementName RDL property.

Graphiques, barres de données et graphiques sparklineCharts, Data Bars, and Sparklines

Les graphiques, les barres de données et les graphiques sparkline sont rendus au format XML.Charts ,data bars, and sparklines are rendered in XML. Les données sont structurées.The data is structured.

Jauges et indicateursGauges and Indicators

Les jauges et les indicateurs sont rendus au format XML.Gauges and indicators are rendered in XML. Les données sont structurées.The data is structured.

Sous-rapportsSubreports

Un sous-rapport est rendu sous la forme d'un élément.A subreport is rendered as an element. Le nom de l’élément provient de la propriété RDL DataElementName.The name of the element is taken from the DataElementName RDL property. Le paramètre de propriété TextBoxesAsElements du rapport remplace celui du sous-rapport.The TextBoxesAsElements property setting of the report overrides that of the subreport. Les attributs d'espace de noms et XSLT ne sont pas ajoutés à l'élément de sous-rapport.Namespace and XSLT attributes are not added to the subreport element.

RectanglesRectangles

Un rectangle est rendu sous la forme d'un élément.A rectangle is rendered as an element. Le nom de l’élément provient de la propriété RDL DataElementName.The name of the element is taken from the DataElementName RDL property.

Éléments de rapport personnalisésCustom Report Items

Les éléments de rapport personnalisés, CustomReportItems (CRI), ne sont pas visibles à l’extension de rendu.CustomReportItems (CRI) are not visible to the rendering extension. 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.If a custom report item exists in the report, the rendering extension renders it as a conventional report item.

ImagesImages

Les images ne sont pas rendues.Images are not rendered.

LignesLines

Les lignes ne sont pas rendues.Lines are not rendered.

Tables, matrices et listesTables, Matrices, and Lists

Les tables, matrices et listes sont rendues sous la forme d'un élément.Tables, matrices, and lists, are rendered as an element. Le nom de l’élément provient de la propriété RDL DataElementName de tableau matriciel.The name of the element comes from the Tablix DataElementName RDL property.

Lignes et colonnesRows and Columns

Les colonnes sont rendues dans des lignes.Columns are rendered within rows.

Angle de tableau matricielTablix Corner

L'angle n'est pas rendu.The corner is not rendered. Seul le contenu de l'angle est rendu.Only the contents of the corner are rendered.

Cellules de tableau matricielTablix Cells

Les cellules de tableau matriciel sont rendues sous la forme d'éléments.Tablix cells are rendered as elements. Le nom de l’élément provient de la propriété RDL DataElementName de la cellule.The name of the element is taken from the cell’s DataElementName RDL property.

Sous-totaux automatiquesAutomatic Subtotals

Les sous-totaux automatiques de tableau matriciel ne sont pas rendus.Tablix automatic subtotals are not rendered.

Éléments de ligne et de colonne qui ne se répètent pas avec un groupeRow and Column Items that Do Not Repeat with a Group

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.Items that do not repeat with a group, such as labels, subtotals and totals, are rendered as elements. Le nom de l’élément provient de la propriété RDL TablixMember.DataElementName.The name of the element comes from the TablixMember.DataElementName RDL property.

La propriété TablixMember.DataElementOutput contrôle si un élément non répétitif est rendu.The TablixMember.DataElementOutput RDL property controls whether a non-repeating item is rendered.

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 :If the DataElementName property of the Tablix member is not provided, a name for the non-repeating item is dynamically generated in this form:

RowX Pour les lignes non répétitives, X étant un index de ligne de base zéro dans le parent actuel.RowX For non-repeating rows, where X is a zero-based row index within the current parent.

ColumnY Pour les colonnes non répétitives, Y étant un index de colonne de base zéro dans le parent actuel.ColumnY For non-repeating columns, where Y ix a zero-based column index within the current parent.

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.A non-repeating header is rendered as a child of the row or column that does not repeat with a group.

Si un membre non répétitif n'a aucune cellule de tableau matriciel correspondante, il n'est pas rendu.If a non-repeating member has no corresponding Tablix cells, it is not rendered. Cela peut se produire dans le cas d'une cellule de tableau matriciel où il s'étend sur plusieurs colonnes.This may occur in the case of a Tablix cell where it spans more than one column.

Lignes et colonnes qui se répètent avec un groupeRows and Columns that Repeat with a Group

Les lignes et colonnes qui se répètent dans un groupe sont rendues en fonctions des règles Tablix.DataElementOutput.Rows and columns that repeat within a group are rendered according to Tablix.DataElementOutput rules. Le nom de l’élément provient de la propriété DataElementName.The name for the element is taken from the DataElementName property.

Chaque valeur unique dans un groupe est rendue sous la forme d'un élément enfant du groupe.Each unique value within a group is rendered as a child element of the group. Le nom de l’élément provient de la propriété Group.DataElementName.The name for the element is taken from the Group.DataElementName property.

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.If the DataElementOutput property value equals Output, a repeating item's header is rendered as a child of the detail element.

Formats personnalisés et XSLT Custom Formats and XSL Transformations

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).XML files produced by the XML rendering extension can be transformed into almost any format using 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.This functionality can be used to produce data in formats not already supported by existing rendering extensions. Pensez à utiliser l'extension de rendu XML et XSLT avant de tenter de créer votre propre extension de rendu.Consider using the XML rendering extension and XSLT before attempting to create your own rendering extension.

Noms en double Duplicate Names

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.If there are duplicate data element names within the same scope, the renderer displays an error message.

Transformations XSLT XSLT Transformations

Le convertisseur XML peut appliquer une transformation XSLT côté serveur aux données XML d'origine.The XML renderer can apply a server-side XSLT transformation to the original XML data. 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.When an XSLT is applied, the renderer outputs the transformed content instead of the original XML data. La transformation a lieu sur le serveur, et non sur le client.The transformation occurs on the server, not on the 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 .The XSLT to apply to the output is defined either in the report definition file with the DataTransform property of the report or with the XSLT DeviceInfo parameter. Si l'une de ces valeurs est définie, la transformation se produit chaque fois que le convertisseur XML est utilisé.If either of these values are set, the transform occurs each time the XML renderer is used. Lors de l’utilisation d’abonnements, la transformation XSLT doit être définie dans la propriété RDL DataTransform.When using subscriptions, the XSLT must be defined in the RDL DataTransform property.

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.If an XSLT file is specified, by both the DataTransform definition property and the device information setting, the XSLT specified in DataTransform occurs first, followed by the XSLT set by the device information settings.

Paramètres d'informations de périphérique Device Information Settings

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 :You can change some default settings for this renderer by changing the device information settings, including the following:

  • une transformation (XSLT) à appliquer à la sortie XML ;A transformation (XSLT) to apply to the XML.

  • le type MIME du document XML ;The MIME type of the XML document.

  • s'il faut appliquer des chaînes de format aux données ;Whether to apply format strings to data.

  • s'il faut appliquer un retrait à la sortie XML ;Whether to indent the XML output.

  • s'il faut inclure le nom de schéma XML ;Whether to include the XML schema name.

  • l'encodage du document XML ;The encoding for the XML document.

  • l'extension de fichier du document XML.The file extension of the XML document.

    Pour plus d'informations, consultez XML Device Information Settings.For more information, see XML Device Information Settings.

Voir aussiSee Also

Pagination dans Reporting Services ( Le Générateur de rapports et SSRS ) Pagination in Reporting Services (Report Builder and SSRS)
Comportements de rendu ( Le Générateur de rapports et SSRS ) Rendering Behaviors (Report Builder and SSRS)
Fonctionnalité interactive des différentes Extensions ( de rendu de rapport Le Générateur de rapports et SSRS ) Interactive Functionality for Different Report Rendering Extensions (Report Builder and SSRS)
Rendu des éléments de rapport ( Le Générateur de rapports et SSRS ) Rendering Report Items (Report Builder and SSRS)
Tables, Matrices et listes ( Le Générateur de rapports et SSRS )Tables, Matrices, and Lists (Report Builder and SSRS)