Exportieren als CSV-Datei

Artikel
10/14/2010

Die durch Trennzeichen getrennte 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:

Seitenkopf
Seitenfuß
Benutzerdefinierte Berichtselemente
Linie
Bild
Rechteck
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 Textfelds 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.
Unterbericht	Das übergeordnete Element wird für jede Instanz des Inhalts wiederholt.
Diagramm	Wird gerendert, indem eine Zeile für jeden Diagrammwert und jede Elementbezeichnung erstellt wird. Bezeichnungen aus Reihen und Kategorien in Form von Hierarchien werden vereinfacht und in die Zeile für einen Diagrammwert eingeschlossen.
Datenbalken	Rendert wie ein Diagramm. Ein Datenbalken enthält normalerweise keine Hierarchien oder Bezeichnungen.
Sparkline	Rendert wie ein Diagramm. Eine Sparkline enthält normalerweise keine Hierarchien oder Bezeichnungen.
Messgerät	Es wird als einzelner Datensatz mit dem Minimal- und Maximalwert der linearen Skala, dem Start- und Endwert des Bereichs und dem Wert des Zeigers gerendert.
Indikator	Es wird als einzelnes Element mit dem Namen des aktiven Zustands, den verfügbaren Zuständen und dem Datenwert als Attribute gerendert.
Karte	Rendert eine Zeile mit den Bezeichnungen und Werten der einzelnen Kartenelemente einer Kartenebene. Wenn die Karte über mehrere Ebenen verfügt, variieren die Werte in den Zeilen abhängig davon, ob die Kartenebenen die gleichen oder unterschiedliche Kartendatenbereiche verwenden. Wenn mehrere Kartenebenen den gleichen Datenbereich verwenden, enthalten die Zeilen Daten aus allen Ebenen.

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