Artikel
09/24/2010

Exportieren als CSV-Datei

Die CSV (Comma-Separated Value)-Renderingerweiterung rendert Berichte als vereinfachte Darstellung der Daten eines Berichts in einem standardisierten Nur-Text-Format, das leicht lesbar und mit anderen Anwendungen austauschbar ist.

Dabei werden Felder und Zeilen durch ein Trennzeichen getrennt, für das auch ein anderes Zeichen als ein Komma gewählt werden kann. Die erstellte Datei kann in einem Tabellenkalkulationsprogramm wie Microsoft Excel geöffnet oder als Importformat für andere Programme verwendet werden. Der exportierte Bericht wird zu einer CSV-Datei und gibt den MIME-Typ text/csv zurück.

CSV-Rendering

Ein CSV-Bericht, der mit den Standardeinstellungen gerendert wurde, hat folgende Merkmale:

Das standardmäßige Feldtrennzeichen ist ein Komma (,).

Hinweis
Sie können das Feldtrennzeichen in ein beliebiges Zeichen ändern, einschließlich TAB, indem Sie die Geräteinformationseinstellungen ändern. Weitere Informationen finden Sie unter Geräteinformationseinstellungen in Reporting Services.

Die Trennzeichenfolge für Datensätze ist ein Wagenrücklauf, gefolgt von einem Zeilenvorschub (<cr><lf>).
Als Textqualifizierer-Zeichenfolge dient das Anführungszeichen (").

Der CSV-Renderer fügt keine Qualifizierer um alle Textzeichenfolgen hinzu. Textqualifizierer werden nur hinzugefügt, wenn der Wert das Trennzeichen oder einen Zeilenumbruch enthält.
Falls der Text eine eingebettete Trennzeichenfolge oder Qualifiziererzeichenfolge enthält, wird der Text in den Textqualifizierer eingeschlossen, und die eingebetteten Qualifiziererzeichenfolgen werden verdoppelt.
Formatierung und Layout werden ignoriert.

Die folgenden Elemente werden beim Rendern ignoriert:

Diagramm
Messgerät
Seitenkopf
Seitenfuß
Benutzerdefinierte Elemente
Liniendiagramm
Image
Automatische Teilergebnisse

Die verbleibenden Berichtselemente werden von oben nach unten und dann von links nach rechts sortiert. Anschließend wird jedes Element in eine Spalte gerendert. Enthält der Bericht geschachtelte Datenelemente, wie Listen oder Tabellen, werden die übergeordneten Elemente in jedem Datensatz wiederholt.

In der folgenden Tabelle wird die Darstellung von Berichtselementen beim Rendern angegeben:

Element	Renderingverhalten
Textfeld	Der Inhalt des Textfeldes wird gerendert. Im Standardmodus werden Elemente auf Grundlage der Formatierungseigenschaften des Elements formatiert. Im kompatiblen Modus kann die Formatierung durch die Geräteinformationseinstellungen geändert werden. Weitere Informationen zu den CSV-Renderingmodi finden Sie weiter unten.
Tabelle	Das Rendering erfolgt durch Erweitern der Tabelle und Erstellen einer Zeile und Spalte für jede Zeile und Spalte auf der untersten Detailebene. Teilergebniszeilen und -spalten weisen keine Zeilen- und Spaltenüberschriften auf. Drillthroughberichte werden nicht unterstützt.
Matrix	Das Rendering erfolgt durch Erweitern der Matrix und Erstellen einer Zeile und Spalte für jede Zeile und Spalte auf der untersten Detailebene. Teilergebniszeilen und -spalten weisen keine Zeilen- und Spaltenüberschriften auf.
Liste	Für jede Detailzeile oder Instanz in der Liste wird ein Datensatz gerendert.
Rechteck	Das übergeordnete Element wird für jede Instanz des Inhalts wiederholt.
Eingebetteter Bericht	Das übergeordnete Element wird für jede Instanz des Inhalts wiederholt.

Hierarchische und gruppierte Daten

Hierarchische und gruppierte Daten müssen vereinfacht werden, um im CSV-Format dargestellt zu werden.

Die Renderingerweiterung vereinfacht den Bericht zu einer Baumstruktur, die die geschachtelten Gruppen innerhalb des Datenbereichs darstellt. So vereinfachen Sie den Bericht:

Eine Zeilenhierarchie wird vor einer Spaltenhierarchie vereinfacht.
Elemente der Zeilenhierarchie werden vor Elementen der Spaltenhierarchie zur CSV-Datei gerendert.
Spalten werden wie folgt sortiert: Textfelder im Hauptteil von links nach rechts und von oben nach unten, gefolgt von Datenbereichen von links nach rechts und von oben nach unten
Innerhalb eines Datenbereichs werden die Spalten wie folgt sortiert: Eckelemente, Zeilenhierarchieelemente, Spaltenhierarchieelemente und Zellen
Peerdatenbereiche sind Datenbereiche oder dynamische Gruppen, die einen allgemeinen Datenbereich oder einen dynamischen Vorgänger gemeinsam nutzen. Peerdaten werden durch die Verzweigung der vereinfachten Struktur identifiziert.

Weitere Informationen finden Sie unter Arbeiten mit Tablix-Datenbereichen.

Renderermodi

Für die CSV-Renderingerweiterung stehen zwei Modi zur Verfügung. Ein Modus ist für Excel optimiert, der andere ist für Anwendungen von Drittanbietern optimiert, die eine strikte Kompatibilität mit der CSV-Spezifikation in RFC 4180 erfordern. Abhängig vom verwendeten Modus werden Peerdatenbereiche unterschiedlich behandelt.

Standardmodus

Der Standardmodus ist für Excel optimiert. Im Standardmodus wird der Bericht als CSV-Datei mit mehreren Abschnitten gerenderter CSV-Daten gerendert. Jeder Peerdatenbereich wird durch eine leere Zeile begrenzt. Peerdatenbereiche innerhalb des Berichthauptteils werden als separate Datenblocks innerhalb der CSV-Datei gerendert. Das Ergebnis ist eine CSV-Datei mit folgenden Merkmalen:

Einzelne Textfelder innerhalb des Berichthauptteils werden einmal als erster Datenblock innerhalb der CSV-Datei gerendert.
Jeder Peerdatenbereich der obersten Ebene im Hauptteil des Berichts wird in einem eigenen Datenblock gerendert.
Geschachtelte Datenbereiche werden diagonal in den gleichen Datenblock gerendert.

Formatierung

Numerische Werte werden in ihrem formatierten Status gerendert. Excel kann formatierte numerische Werte, wie Währungen, Prozentwerte und Datumsangaben, erkennen und die Zellen beim Importieren einer CSV-Datei entsprechend formatieren.

Kompatibler Modus

Der kompatible Modus ist für Anwendungen von Drittanbietern optimiert.

Datenbereiche

Nur die erste Textzeile in der Datei enthält die Spaltenkopfzeilen, und jede Zeile verfügt über dieselbe Spaltenanzahl.

Formatierung

Die Werte sind unformatiert.

Interaktivität

Interaktivität wird von keinem der durch diesen Renderer generierten CSV-Formate unterstützt. Die folgenden interaktiven Elemente werden nicht gerendert:

Hyperlinks
Anzeigen oder ausblenden
Dokumentstruktur
Drillthrough oder Links mit Durchklicken
Endbenutzersortierung
Feste Berichtsköpfe
Lesezeichen

Geräteinformationseinstellungen

Sie können einige Standardeinstellungen für diesen Renderer ändern, beispielsweise den Modus für das Rendern, die Zeichen, die als Trennzeichen verwendet werden können, und die Zeichen, die als Textqualifizierer für die Standardzeichenfolge verwendet werden können. Ändern Sie dazu die Geräteinformationseinstellungen. Weitere Informationen finden Sie unter Geräteinformationseinstellungen in Reporting Services.