Esportazione in un file CSV (Generatore report e SSRS)Exporting to a CSV File (Report Builder and SSRS)

L'estensione per il rendering CSV (Comma-Separated Value) consente di eseguire il rendering di report impaginati come rappresentazione bidimensionale dei dati di un report in un formato di testo normale standardizzato, facilmente leggibile e interscambiabile con numerose applicazioni.The Comma-Separated Value (CSV) rendering extension renders paginated reports as a flattened representation of data from a report in a standardized, plain-text format that is easily readable and exchangeable with many applications.

Per la separazione dei campi e delle righe con l'estensione per il rendering CSV viene usato un delimitatore di stringhe di caratteri che è possibile configurare per impostare un carattere diverso dalla virgola.The CSV rendering extension uses a string character delimiter to separate fields and rows, with the string character delimiter configurable to be a character other than a comma. Il file risultante può essere aperto in un foglio di calcolo, ad esempio Microsoft ExcelMicrosoft Excel , oppure usato come formato di importazione per altri programmi.The resulting file can be opened in a spreadsheet program like Microsoft ExcelMicrosoft Excel or used as an import format for other programs. Il report esportato viene salvato come file con estensione csv e restituisce il tipo MIME text/csv.The exported report becomes a .csv file, and returns a MIME type of text/csv.

Se si desidera usare dati correlati a grafici, barre dei dati, grafici sparkline, misuratori e indicatori in Microsoft ExcelMicrosoft Excel, esportare il report in un file CSV, quindi aprire il file in MicrosoftMicrosoft Excel.If you want to work with data related to charts, data bars, sparklines, gauges, and indicators in Microsoft ExcelMicrosoft Excel, export the report to a CSV file, and then open the file in MicrosoftMicrosoft Excel.

Per informazioni dettagliate su come esportare in formato CSV, vedere Esportazione di report (Generatore report e SSRS).See Export Reports (Report Builder and SSRS) for details on how to export to CSV format.

Nota

È possibile creare e modificare file di definizioni report impaginati (con estensione rdl) in Generatore report e in Progettazione report di 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. Ogni ambiente di creazione offre modalità differenti per creare, aprire e salvare report ed elementi correlati.Each authoring environment provides different ways to create, open, and save reports and related items.

Rendering CSVCSV Rendering

Se il rendering viene eseguito usando le impostazioni predefinite, il report CSV avrà le caratteristiche seguenti:When rendered using the default settings, a CSV report has the following characteristics:

  • Il delimitatore di campo predefinito è la virgola (,).The default field delimiter string is a comma (,).

    Nota

    È possibile impostare il delimitatore del campo su qualsiasi carattere desiderato, incluso TAB, modificando le impostazioni relative alle informazioni sui dispositivi.You can change the field delimiter to any character that you want, including TAB, by changing the device information settings. Per altre informazioni, vedere CSV Device Information Settings.For more information, see CSV Device Information Settings.

  • La stringa di delimitazione dei record è una sequenza di ritorno a capo e avanzamento riga (<cr><lf>).The record delimiter string is the carriage return and line feed (<cr><lf>).

  • Il carattere qualificatore di testo è la virgoletta doppia (").The text qualifier string is a quotation mark (").

    Il renderer CSV non racchiude le stringhe di testo tra qualificatori.The CSV renderer does not add qualifiers around all text strings. I qualificatori di testo vengono aggiunti solo quando il valore contiene il carattere del delimitatore o include un'interruzione di riga.Text qualifiers are added only when the value contains the delimiter character or when the value has a line break.

  • Se il testo contiene uno dei delimitatori o qualificatori, il qualificatore di testo viene posizionato attorno al testo e i caratteri qualificatori all'interno del testo vengono raddoppiati.If the text contains an embedded delimiter string or qualifier string, the text qualifier is placed around the text, and the embedded qualifier strings are doubled.

  • La formattazione e il layout vengono ignorati.Formatting and layout are ignored.

    Durante il rendering i seguenti elementi vengono ignorati:The following items are ignored during rendering:

  • Intestazione di paginaPage header

  • Piè di paginaPage footer

  • Elementi personalizzati del reportCustom report items

  • LineaLine

  • ImmagineImage

  • RettangoloRectangle

  • Subtotali automaticiAutomatic subtotals

    Gli elementi rimanenti del report vengono ordinati dall'alto verso il basso, quindi da sinistra a destra.The remaining report items are sorted, from top to bottom, then left to right. Viene quindi eseguito il rendering di ogni elemento in una colonna.Each item is then rendered to a column. Se il report include elementi di dati nidificati, ad esempio elenchi o tabelle, gli elementi padre vengono ripetuti in ogni record.If the report has nested data items like lists or tables, the parent items are repeated in each record.

    Nella seguente tabella è indicato l'aspetto degli elementi del report di cui è stato eseguito il rendering:The following table indicates the appearance of report items when rendered:

ElementoItem Tipo di renderingRendering behavior
Casella di testoText box Viene eseguito il rendering del contenuto della casella di testo.Renders the contents of the text box. Nella modalità predefinita gli elementi vengono formattati in base alle proprietà di formattazione dell'elemento.In default mode, items are formatted based on the item's formatting properties. Nella modalità conforme la formattazione può essere modificata dalle impostazioni relative alle informazioni sui dispositivi.In compliant mode, formatting can be changed by device information settings. Per altre informazioni sulle modalità di rendering CSV, vedere di seguito.For more information about CSV rendering modes, see below.
TabellaTable Il rendering viene eseguito mediante l'espansione della tabella e la creazione di una riga e una colonna per ogni riga e colonna al livello di dettaglio inferiore.Renders by expanding the table and creating a row and column for each row and column at the lowest level of detail. Per le righe e le colonne di subtotali non sono disponibili intestazioni.Subtotal rows and columns do not have column or row headings. I report drill-through non sono supportati.Drillthrough reports are not supported.
MatriceMatrix Il rendering viene eseguito mediante l'espansione della matrice e la creazione di una riga e una colonna per ogni riga e colonna al livello di dettaglio inferiore.Renders by expanding the matrix and creating a row and column for each row and column at the lowest level of detail. Per le righe e le colonne di subtotali non sono disponibili intestazioni.Subtotal rows and columns do not have column or row headings.
ElencoList Viene eseguito il rendering di un record per ogni riga di dettagli o istanza nell'elenco.Renders a record for each detail row or instance in the list.
SottoreportSubreport L'elemento padre viene ripetuto per ogni istanza del contenuto.The parent item is repeated for each instance of the contents.
GraficoChart Il rendering viene eseguito mediante la creazione di una riga per ogni valore del grafico ed etichetta del membro.Renders by creating a row for each chart value and member labels. Le etichette delle serie e delle categorie nelle gerarchie sono rese bidimensionali e incluse nella riga per un valore del grafico.Labels from series and categories in hierarchies are flattened and included in the row for a chart value.
Barra dei datiData bar Viene eseguito il rendering come grafico.Renders like a chart. In genere, in una barra dei dati non sono incluse gerarchie o etichette.Typically, a data bar does not include hierarchies or labels.
Grafico sparklineSparkline Viene eseguito il rendering come grafico.Renders like a chart. In genere, in un grafico sparkline non sono incluse gerarchie o etichette.Typically, a sparkline does not do not include hierarchies or labels.
MisuratoreGauge Viene eseguito il rendering come un record singolo con i valori minimo e massimo della scala lineare, i valori iniziale e finale dell'intervallo e il valore dell'indicatore di misura.Renders as a single record with the minimum and maximum values of the linear scale, start and end values of the range, and the value of the pointer.
IndicatoreIndicator Viene eseguito il rendering come un singolo record con il nome di stato attivo, gli stati disponibili e il valore dei dati.Renders as a single record with the active state name, available states, and the data value.
MappaMap Viene eseguito il rendering di una riga con le etichette e i valori per ogni membro della mappa di un livello mappa.Renders a row with the labels and values for each map member of a map layer.

Se la mappa ha più livelli, i valori nelle righe variano a seconda se i livelli mappa usano le stesse aree dati della mappa o aree diverse.If the map has multiple layers the values in the rows varies depending on whether the map layers use the same or different map data regions. Se più livelli mappa usano la stessa area dati, le righe contengono i dati di tutti i livelli.If multiple map layers use the same data region, the rows contain data from all layers.

Dati gerarchici e raggruppatiHierarchical and Grouped Data

Per poter essere rappresentati nel formato CSV, i dati gerarchici e raggruppati devono essere bidimensionali.Hierarchical and grouped data must be flattened in order to be represented in the CSV format.

L'estensione per il rendering rende bidimensionale il report in una struttura ad albero che rappresenta i gruppi nidificati all'interno dell'area dati.The rendering extension flattens the report into a tree structure that represents the nested groups within the data region. Per rendere bidimensionale il report:To flatten the report:

  • Una gerarchia di righe viene resa bidimensionale prima di una gerarchia di colonne.A row hierarchy is flattened before a column hierarchy.

  • Le colonne vengono ordinate nel modo seguente: caselle di testo presenti nel corpo da sinistra verso destra e quindi dall'alto verso il basso seguite dalle aree dati da sinistra verso destra e quindi dall'alto verso il basso.Columns are ordered as follows: text boxes in body order left-to-right, top-to-bottom followed by data regions ordered left-to-right, top-to-bottom.

  • All'interno di un'area dati le colonne vengono ordinate nel modo seguente: membri di angolo, membri della gerarchia delle righe, membri della gerarchia delle colonne e quindi le celle.Within a data region, the columns are ordered as follows: corner members, row hierarchy members, column hierarchy members, and then cells.

  • Le aree dati di pari livello sono aree dati o gruppi dinamici che condividono un'area dati o un predecessore dinamico comune.Peer data regions are data regions or dynamic groups that share a common data region or dynamic ancestor. I dati di pari livello sono identificabili dalle diramazioni dell'albero bidimensionale.Peer data is identified by branching of the flattened tree.

    Per altre informazioni, vedere Tabelle, matrici ed elenchi (Generatore report e SSRS).For more information, see Tables, Matrices, and Lists (Report Builder and SSRS).

Modalità del rendererRenderer Modes

L'estensione per il rendering CSV può operare in due modalità: una è ottimizzata per Excel, mentre l'altra è ottimizzata per applicazioni di terze parti che richiedono una rigida conformità alla specifica CSV del documento RFC 4180.The CSV rendering extension can operate in two modes: one is optimized for Excel and the other is optimized for third-party applications that require strict CSV compliance to the CSV specification in RFC 4180. Le aree dati di pari livello vengono gestite in modo diverso a seconda della modalità usata.Depending on which mode you use, peer data regions are handled differently.

Modalità predefinitaDefault Mode

La modalità predefinita è ottimizzata per Excel.The default mode is optimized for Excel. Nella modalità predefinita il rendering del report viene eseguito come file CSV contenente più sezioni di dati di cui è stato eseguito il rendering in formato CSV.When rendered in default mode, the report is rendered as a CSV file with multiple sections of CSV-rendered data. Ogni area dati peer è delimitata da una riga vuota.Each peer data region is delimited by an empty line. Il rendering di aree dati di pari livello all'interno del corpo del report viene eseguito come blocchi distinti di dati all'interno del file CSV.Peer data regions within the report body are rendered as separate blocks of data within the CSV file. Il risultato è un file CSV in cui:The result is a CSV file in which:

  • Il rendering delle singole caselle di testo all'interno del corpo del report viene eseguito una sola volta come primo blocco di dati all'interno del file CSV.Individual text boxes within the report body are rendered once as the first block of data within the CSV file.

  • Il rendering di ciascuna area dati di pari livello di livello superiore nel corpo del report viene eseguito nel relativo blocco di dati.Each top-level peer data region in the report body is rendered in its own data block.

  • Il rendering delle aree dati nidificate viene eseguito in senso diagonale nello stesso blocco di dati.Nested data regions are rendered diagonally into the same data block.

FormattazioneFormatting

Il rendering dei valori numerici viene eseguito nel relativo stato formattato.Numeric values are rendered in their formatted state. Excel è in grado di riconoscere valori numerici formattati, ad esempio valuta, percentuale e data, nonché di formattare le celle in modo appropriato durante l'importazione del file CSV.Excel can recognize formatted numeric values, such as currency, percentage and date, and format the cells appropriately when importing the CSV file.

Modalità conformeCompliant Mode

La modalità conforme è ottimizzata per applicazioni di terze parti.Compliant mode is optimized for third-party applications.

Aree datiData Regions

Solo la prima riga del file contiene le intestazioni di colonna e ogni riga dispone dello stesso numero di colonne.Only the first row of the file contains the column headers and each row has the same number of columns.

FormattazioneFormatting

I valori non vengono formattati.Values are unformatted.

InterattivitàInteractivity

L'interattività non è supportata da nessuno dei formati CSV generati da questo renderer.Interactivity is not supported by either CSV formats generated by this renderer. Non viene eseguito il rendering dei seguenti elementi interattivi:The following interactive elements are not rendered:

  • Collegamenti ipertestualiHyperlinks

  • Elementi visualizzati o nascostiShow or Hide

  • Mappa documentoDocument Map

  • Collegamenti drill-through o click-throughDrillthrough or clickthrough links

  • Ordinamento dell'utente finaleEnd user sort

  • Intestazioni fisseFixes headers

  • SegnalibriBookmarks

Impostazioni relative alle informazioni sul dispositivoDevice Information Settings

È possibile cambiare alcune impostazioni predefinite per questo renderer, tra cui la modalità in cui eseguire il rendering, i caratteri da usare come delimitatori e i caratteri da usare come stringa predefinita del qualificatore di testo, modificando le impostazioni relative alle informazioni sui dispositivi.You can change some default settings for this renderer, including which mode to render in, which characters to use as delimiters and which characters to use as the text qualifier default string, by changing the device information settings. Per altre informazioni, vedere CSV Device Information Settings.For more information, see CSV Device Information Settings.

Vedere ancheSee Also

Paginazione in Reporting Services (Generatore report e SSRS) Pagination in Reporting Services (Report Builder and SSRS)
Tipi di rendering (Generatore report e SSRS) Rendering Behaviors (Report Builder and SSRS)
Funzionalità interattiva per estensioni per il rendering di report differenti (Generatore report e SSRS) Interactive Functionality for Different Report Rendering Extensions (Report Builder and SSRS)
Rendering degli elementi del report (Generatore report e SSRS) Rendering Report Items (Report Builder and SSRS)
Tabelle, matrici ed elenchi (Generatore report e SSRS)Tables, Matrices, and Lists (Report Builder and SSRS)