RDL-Elemente und -Attribute in XML (Berichts-Generator 1.0)

Wenn ein Bericht als XML-Datei gespeichert wird, muss der Berichts-Generator die Berichtsdefinitionssprache (RDL, Report Definition Language) in XML übersetzen. Die XML-Exportoption speichert Berichtselemente als Elemente oder Attribute in einem XML-Dokument. Jedem Element können eine Reihe von Attributen oder untergeordneten Elementen zugeordnet sein. Die Attribute oder Elemente hängen vom Berichtselement ab. In diesem Thema wird erläutert, wie das RDL-Schema geändert wird, wenn es im XML-Format gespeichert wird.

Report

Report ist der XML-Stammknoten. Er enthält Attribute, die Schemainformationen für das XML-Dokument und den Berichtsnamen angeben.

Das XML-Schema (XSD) wird im XML-Stammknoten wie folgt angegeben:

<Report xmlns="SchemaName" xmlns:sxi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="SchemaName ReportURL&rs:ImageID=SchemaName" Name="ReportName">

In der folgenden Tabelle wird beschrieben, wie die Attribute und Elemente im Report-RDL-Element von der XML-Exportoption gespeichert werden.

RDL-Attribut	Gespeichert als
Name	Das Name-Attribut des Stammelements.

Textfelder

In der folgenden Tabelle wird beschrieben, wie Textfelder von der XML-Exportoption gespeichert werden. Der Name und der Wert des Textfeldes werden als Element oder Attribut in Abhängigkeit des DataElementStyle-RDL-Elementwerts für das Textfeld gespeichert.

RDL-Element	Gespeichert als
DataElementName	Der Name des Textfeldelements oder -attributs. Wenn DataElementName nicht angegeben ist, wird als Standardname der Name des Textfeldes in RDL verwendet.
Value	Der Wert der Daten im Textfeld.

Tabelle

In der folgenden Tabelle wird beschrieben, wie Tabellen von der XML-Exportoption gespeichert werden. Die Tabelle wird als ein Element gespeichert.

RDL-Element	Gespeichert als
DataElementName	Der Name des Tabellenelements. Wenn DataElementName nicht angegeben ist, wird der Name der Tabelle in RDL verwendet.
TableGroup	Das erste TableGroup-Element wird als untergeordnetes Element des Tabellenelements gespeichert. Jedes nachfolgende TableGroup-Element wird als untergeordnetes Element der Gruppeninstanz für das vorherige TableGroup-Element gespeichert. Dies ergibt geschachtelte Datengruppen.
Details	Ein untergeordnetes Element jeder Gruppeninstanz für das letzte TableGroup-Element. Wenn keine Tabellengruppen vorhanden sind, wird Details als untergeordnetes Element des Tabellenelements gespeichert.

TableGroup

In der folgenden Tabelle wird beschrieben, wie Tabellengruppen von der XML-Exportoption gespeichert werden. Die Tabellengruppen werden als Elemente gespeichert.

RDL-Element	Gespeichert als
DataCollectionName (Grouping)	Der Name des Tabellengruppenelements. Falls DataCollectionName nicht angegeben ist, wird der im DataElementName-Element angegebene Name zusammen mit der Zeichenfolge "_Collection" verwendet.
DataElementName (Grouping)	Der Name des Gruppeninstanzelements. Gruppeninstanzelemente sind untergeordnete Elemente des Tabellengruppenelements. Wenn DataElementName nicht angegeben ist, wird der Name der Gruppierung in RDL verwendet.
Header	Alle Elemente in der Kopfzeile werden als untergeordnete Elemente oder Attribute des Gruppeninstanzelements gespeichert.

Details

In der folgenden Tabelle wird beschrieben, wie die Attribute und Elemente im Details-RDL-Element von der XML-Exportoption gespeichert werden. Details wird als Element gespeichert.

RDL-Element	Gespeichert als
DataCollectionName (Grouping)	Der Name des Detailelements. Falls DataCollectionName nicht angegeben ist, wird der im DataElementName-Element angegebene Name zusammen mit der Zeichenfolge "_Collection" verwendet. Falls Details keine Gruppierung aufweist, lautet der Name des Elements Detail_Collection.
DataElementName (Grouping)	Der Name des Gruppeninstanzelements. Gruppeninstanzelemente sind untergeordnete Elemente des Detailelements. Wenn DataElementName nicht angegeben ist, wird der Name der Gruppierung in RDL verwendet. Falls Details keine Gruppierung aufweist, lautet der Name des Elements Detail.
DetailsRows	Alle Elemente in der Detailzeile werden als untergeordnete Elemente oder Attribute des Gruppeninstanzelements gespeichert.

Matrix

In der folgenden Tabelle wird beschrieben, wie Matrizen von der XML-Exportoption gespeichert werden. Die Matrix wird als ein Element gespeichert.

RDL-Element	Gespeichert als
DataElementName	Der Name des Matrixelements. Wenn DataElementName nicht angegeben ist, wird der Name der Matrix in RDL verwendet.
Corner	Alle Elemente in der Ecke werden als untergeordnete Elemente oder Attribute des Matrixelements gespeichert.
RowGrouping	Das erste RowGrouping-Element wird als untergeordnetes Element des Matrixelements gespeichert. Jedes nachfolgende RowGrouping-Element wird als untergeordnetes Element der Gruppeninstanz für das vorherige RowGrouping-Element gespeichert. Dies ergibt geschachtelte Datengruppen.
ColumnGrouping	Das erste ColumnGrouping-Element wird als untergeordnetes Element jeder einzelnen Gruppeninstanz für das letzte RowGrouping-Element gespeichert. Jedes nachfolgende ColumnGrouping-Element wird als untergeordnetes Element der Gruppeninstanz für das vorherige ColumnGrouping-Element gespeichert.
MatrixCell	Das untergeordnete Cell-Element innerhalb jeder Gruppeninstanz für das letzte ColumnGrouping-Element. Alle Elemente in der Matrixzelle werden als untergeordnete Elemente oder Attribute des Cell-Elements gespeichert.

RowGrouping

In der folgenden Tabelle wird beschrieben, wie Zeilengruppierungen von der XML-Exportoption gespeichert werden. Eine Zeilengruppierung wird als ein Element gespeichert.

RDL-Element	Gespeichert als
DataCollectionName (Grouping)	Der Name des Zeilengruppierungselements. Falls DataCollectionName nicht angegeben ist, wird der im DataElementName-Element angegebene Name zusammen mit der Zeichenfolge "_Collection" verwendet. Für statische Zeilengruppierungen wird dies nicht verwendet.
DataElementName (Grouping)	Der Name des Gruppeninstanzelements. Gruppeninstanzelemente sind untergeordnete Elemente des Tabellengruppenelements. Wenn DataElementName nicht angegeben ist, wird der Name der Gruppierung in RDL verwendet. Für statische Zeilengruppierungen wird als Name für das Element der Wert von DataElementName für das Textfeld in der Gruppenkopfzeile verwendet. Wenn kein Textfeld für eine statische Zeilenkopfzeile vorhanden ist, wird der Name RowN verwendet, wobei N eine Zahl darstellt, die der Zeilengruppierung zugewiesen ist.
ReportItems	Alle Elemente in der Zeilengruppierung werden als untergeordnete Elemente oder Attribute des übergeordneten Elements des Zeilengruppierungselements gespeichert.
Subtotal	Ein gleichgeordnetes Element des Zeilengruppierungselements. Dieses Element enthält eine Matrixzelle. Der Name dieses Elements ist der für das DataElementName-Element angegebene Name für das Teilergebnis. Falls kein Name angegeben ist, lautet der Name des Elements Total.

Hinweis
Teilergebnisse werden standardmäßig nicht gespeichert. Die XML-Exportoption speichert Teilergebnisse nur, wenn der Wert des DataElementOutput-RDL-Elements für das Teilergebnis Output lautet.

ColumnGrouping

In der folgenden Tabelle wird beschrieben, wie Spaltengruppierungen von der XML-Exportoption gespeichert werden. Eine Spaltengruppierung wird als ein Element gespeichert.

RDL-Element	Gespeichert als
DataCollectionName (Grouping)	Der Name des Spaltengruppierungselements. Falls DataCollectionName nicht angegeben ist, wird der im DataElementName-Element angegebene Name zusammen mit der Zeichenfolge "_Collection" verwendet. Für statische Spaltengruppierungen wird dies nicht verwendet.
DataElementName (Grouping)	Der Name des Gruppeninstanzelements. Gruppeninstanzelemente sind untergeordnete Elemente des Spaltengruppenelements. Wenn DataElementName nicht angegeben ist, wird der Name der Gruppierung in RDL verwendet. Für statische Spaltengruppierungen wird als Name für das Element der Wert von DataElementName für das Textfeld in der Gruppenkopfzeile verwendet. Wenn kein Textfeld für eine statische Spaltenkopfzeile vorhanden ist, wird der Name ColumnN verwendet, wobei N eine Zahl darstellt, die der Spaltengruppierung zugewiesen ist.
ReportItems	Alle Elemente in der Spaltengruppierung werden als untergeordnete Elemente oder Attribute des übergeordneten Elements des Spaltengruppierungselements gespeichert.
Subtotal	Ein gleichgeordnetes Element des Spaltengruppierungselements. Dieses Element enthält eine Matrixzelle. Der Name dieses Elements ist der für das DataElementName-Element angegebene Name für das Teilergebnis. Falls kein Name angegeben ist, lautet der Name des Elements Total.

Hinweis
Teilergebnisse werden standardmäßig nicht gespeichert. Die XML-Exportoption speichert Teilergebnisse nur, wenn der Wert des DataElementOutput-RDL-Elements für das Teilergebnis Output lautet.

Um besser zu verstehen, wie die XML-Exportoption die RDL-Elemente (Report Definition Language, Berichtsdefinitionssprache) in einem Bericht als XML-Datei speichert, möchten Sie möglicherweise mehr über Elemente erfahren. Weitere Informationen zu RDL-Elementen finden Sie im Thema zur Report Definition Language in der SQL Server-Onlinedokumentation.