Éléments et attributs RDL dans XML (Générateur de rapports version 1.0)
Lorsqu'un rapport est enregistré en tant que fichier XML, le Générateur de rapports doit traduire le langage RDL en XML. L'option d'exportation XML enregistre les éléments de rapport en tant qu'éléments ou en tant qu'attributs dans un document XML. Chaque élément peut avoir un ensemble d'attributs ou de sous-éléments qui lui est associé. Les attributs ou les éléments varient en fonction de l'élément de rapport. Cette rubrique explique comment le schéma RDL est modifié lorsqu'il est enregistré en XML.
Report
Report est le nœud racine XML. Ce nœud contient des attributs qui définissent les informations de schéma du document XML ainsi que le nom du rapport.
Le schéma XML (XSD) est spécifié dans le nœud racine XML de la façon suivante :
<Report xmlns="SchemaName" xmlns:sxi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="SchemaName ReportURL&rs:ImageID=SchemaName" Name="ReportName">
Le tableau suivant explique comment les attributs et les éléments de l'élément RDL Report sont enregistrés par l'option d'exportation XML.
Attribut RDL |
Enregistré sous |
|---|---|
Name |
L'attribut Name de l'élément racine. |
Zones de texte
Le tableau suivant décrit comment les zones de texte sont enregistrées par l'option d'exportation XML. Le nom et la valeur de la zone de texte sont enregistrés sous la forme d'un élément ou d'un attribut en fonction de la valeur de l'élément RDL DataElementStyle pour la zone de texte.
Élément RDL |
Enregistré sous |
|---|---|
DataElementName |
Le nom de l'élément ou de l'attribut de zone de texte. Si DataElementName n'est pas spécifié, le nom par défaut est le nom de la zone de texte dans l'élément RDL. |
Value |
La valeur des données dans la zone de texte. |
Table
Le tableau suivant décrit comment les tables sont enregistrées par l'option d'exportation XML. La table est enregistrée sous la forme d'un élément.
Élément RDL |
Enregistré sous |
|---|---|
DataElementName |
Le nom de l'élément de table. Si DataElementName n'est pas spécifié, le nom de l'élément est le nom de la table dans l'élément RDL. |
TableGroup |
Le premier élément TableGroup est enregistré sous la forme d'un sous-élément de l'élément de table. Chaque élément TableGroup suivant est enregistré sous la forme d'un sous-élément de l'instance de groupe de l'élément TableGroup précédent. Il en résulte des groupes de données imbriqués. |
Details |
Un sous-élément de chaque instance de groupe du dernier élément TableGroup. En l'absence de groupes de tables, Details est enregistré sous la forme d'un sous-élément de l'élément de table. |
TableGroup
Le tableau suivant décrit comment les groupes de tables sont enregistrés par l'option d'exportation XML. Les groupes de tables sont enregistrés sous la forme d'éléments.
Élément RDL |
Enregistré sous |
|---|---|
DataCollectionName (Grouping) |
Le nom de l'élément de groupe de tables. Si DataCollectionName n'est pas spécifié, le nom de l'élément est le nom spécifié dans l'élément DataElementName plus la chaîne "_Collection". |
DataElementName (Grouping) |
Le nom de l'élément d'instance de groupe. Les éléments d'instance de groupe sont des sous-éléments de l'élément de groupe de table. Si DataElementName n'est pas spécifié, le nom de l'élément est le nom du regroupement dans l'élément RDL. |
Header |
Tous les éléments de l'en-tête sont enregistrés sous la forme de sous-éléments ou d'attributs de l'élément d'instance de groupe. |
Details
Le tableau suivant décrit comment les attributs et les éléments de l'élément RDL Details sont enregistrés par l'option d'exportation XML. Details est enregistré sous la forme d'élément.
Élément RDL |
Enregistré sous |
|---|---|
DataCollectionName (Grouping) |
Le nom de l'élément de détails. Si DataCollectionName n'est pas spécifié, le nom de l'élément est le nom spécifié dans l'élément DataElementName plus la chaîne "_Collection". Si Details n'a pas de regroupement, le nom de l'élément est Detail_Collection. |
DataElementName (Grouping) |
Le nom de l'élément d'instance de groupe. Les éléments d'instance de groupe sont des sous-éléments de l'élément de détails. Si DataElementName n'est pas spécifié, le nom de l'élément est le nom du regroupement dans l'élément RDL. Si Details n'a pas de regroupement, le nom de l'élément est Detail. |
DetailsRows |
Tous les éléments des lignes de détails sont enregistrés sous la forme de sous-éléments ou d'attributs de l'élément d'instance de groupe. |
Matrix
Le tableau suivant décrit comment les matrices sont enregistrées par l'option d'exportation XML. La matrice est enregistrée sous la forme d'un élément.
Élément RDL |
Enregistré sous |
|---|---|
DataElementName |
Le nom de l'élément de matrice. Si DataElementName n'est pas spécifié, le nom de l'élément est le nom de la matrice dans l'élément RDL. |
Corner |
Tous les éléments dans l'angle sont enregistrés sous la forme de sous-éléments ou d'attributs de l'élément de matrice. |
RowGrouping |
Le premier élément RowGrouping est enregistré sous la forme d'un sous-élément de l'élément de matrice. Chaque élément RowGrouping suivant est enregistré sous la forme d'un sous-élément de l'instance de groupe de l'élément RowGrouping précédent. Il en résulte des groupes de données imbriqués. |
ColumnGrouping |
Le premier élément ColumnGrouping est enregistré sous la forme d'un sous-élément de chaque instance de groupe du dernier élément RowGrouping. Chaque élément ColumnGrouping suivant est enregistré sous la forme d'un sous-élément de l'instance de groupe de l'élément ColumnGrouping précédent. |
MatrixCell |
Le sous-élément Cell de chaque instance de groupe du dernier élément ColumnGrouping. Tous les éléments dans la cellule de matrice sont enregistrés sous la forme de sous-éléments ou d'attributs de l'élément Cell. |
RowGrouping
Le tableau suivant décrit comment les regroupements de lignes sont enregistrés par l'option d'exportation XML. Un regroupement de lignes est enregistré sous la forme d'un élément.
Élément RDL |
Enregistré sous |
|---|---|
DataCollectionName (Grouping) |
Le nom de l'élément de regroupement de lignes. Si DataCollectionName n'est pas spécifié, le nom de l'élément est le nom spécifié dans l'élément DataElementName plus la chaîne "_Collection". Ceci n'est pas utilisé pour les regroupements de lignes statiques. |
DataElementName (Grouping) |
Le nom de l'élément d'instance de groupe. Les éléments d'instance de groupe sont des sous-éléments de l'élément de regroupement de lignes. Si DataElementName n'est pas spécifié, le nom de l'élément est le nom du regroupement dans l'élément RDL. Pour les regroupements de lignes statiques, le nom de l'élément est la valeur de DataElementName de la zone de texte dans l'en-tête de groupe. S'il n'y a pas de zone de texte pour un en-tête de ligne statique, le nom de l'élément est RowN, où N est un nombre affecté au regroupement de lignes. |
ReportItems |
Tous les éléments dans le regroupement de lignes sont enregistrés sous la forme de sous-éléments ou d'attributs du parent de l'élément de regroupement de lignes. |
Subtotal |
Un élément frère de l'élément de regroupement de lignes. Cet élément contient une cellule de matrice. Le nom de cet élément est le nom spécifié dans l'élément DataElementName du sous-total. Si aucun nom n'est spécifié, le nom de l'élément est Total. |
[!REMARQUE]
Les sous-totaux ne sont pas enregistrés par défaut. L'option d'exportation XML n'enregistre des sous-totaux que si la valeur de l'élément RDL DataElementOutput du sous-total est Output.
ColumnGrouping
Le tableau suivant décrit comment les regroupements de colonnes sont enregistrés par l'option d'exportation XML. Un regroupement de colonnes est enregistré sous la forme d'un élément.
Élément RDL |
Enregistré sous |
|---|---|
DataCollectionName (Grouping) |
Le nom de l'élément de regroupement de colonnes. Si DataCollectionName n'est pas spécifié, le nom de l'élément est le nom spécifié dans l'élément DataElementName plus la chaîne "_Collection". Ceci n'est pas utilisé pour les regroupements de colonnes statiques. |
DataElementName (Grouping) |
Le nom de l'élément d'instance de groupe. Les éléments d'instance de groupe sont des sous-éléments de l'élément de regroupement de colonnes. Si DataElementName n'est pas spécifié, le nom de l'élément est le nom du regroupement dans l'élément RDL. Pour les regroupements de colonnes statiques, le nom de l'élément est la valeur de DataElementName de la zone de texte dans l'en-tête de groupe. S'il n'y a pas de zone de texte pour un en-tête de colonne statique, le nom de l'élément est ColumnN, où N est un nombre affecté au regroupement de colonnes. |
ReportItems |
Tous les éléments dans le regroupement de colonnes sont enregistrés sous la forme de sous-éléments ou d'attributs du parent de l'élément de regroupement de colonnes. |
Subtotal |
Un élément frère de l'élément de regroupement de colonnes. Cet élément contient une cellule de matrice. Le nom de cet élément est le nom spécifié dans l'élément DataElementName du sous-total. Si aucun nom n'est spécifié, le nom de l'élément est Total. |
[!REMARQUE]
Les sous-totaux ne sont pas enregistrés par défaut. L'option d'exportation XML n'enregistre des sous-totaux que si la valeur de l'élément RDL DataElementOutput du sous-total est Output.
Pour mieux comprendre comment l'option d'exportation XML enregistre les éléments RDL (Report Definition Language) d'un rapport sous forme de fichier XML, vous souhaitez peut-être en savoir plus sur ces éléments. Pour plus d'informations sur les éléments RDL, consultez la rubrique Report Definition Language dans la documentation en ligne de SQL Server.
Voir aussi