Esportare un report impaginato in un file CSV (Generatore report)

  • Articolo

Si applica a: Generatore di report Microsoft (SSRS) Power BI Report Builder Progettazione report in SQL Server Data Tools

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.

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. Il file risultante può essere aperto in un foglio di calcolo, ad esempio Microsoft Excel, oppure usato come formato di importazione per altri programmi. Il report esportato viene salvato come file con estensione csv e restituisce il tipo MIME text/csv.

Se si desidera usare dati correlati a grafici, barre dei dati, grafici sparkline, misuratori e indicatori in Microsoft Excel, esportare il report in un file CSV, quindi aprire il file in Microsoft Excel.

Per informazioni dettagliate su come esportare in formato CSV, vedere Esportazione di report (Generatore report e SSRS).

Nota

È possibile creare e modificare file di definizioni di report impaginati (con estensione rdl) in Generatore report di Microsoft, Power BI Report Builder e Progettazione report di SQL Server Data Tools.

Rendering CSV

Se il rendering viene eseguito usando le impostazioni predefinite, il report CSV avrà le caratteristiche seguenti:

  • Il delimitatore di campo predefinito è la virgola (,).

    Nota

    È possibile impostare il delimitatore del campo su qualsiasi carattere desiderato, incluso TAB, modificando le impostazioni relative alle informazioni sui dispositivi. Per altre informazioni, vedere CSV Device Information Settings.

  • La stringa di delimitazione dei record è una sequenza di ritorno a capo e avanzamento riga (<cr><lf>).

  • Il carattere qualificatore di testo è la virgoletta doppia (").

    Il renderer CSV non racchiude le stringhe di testo tra qualificatori. I qualificatori di testo vengono aggiunti solo quando il valore contiene il carattere del delimitatore o include un'interruzione di riga.

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

  • La formattazione e il layout vengono ignorati.

Durante il rendering i seguenti elementi vengono ignorati:

  • Intestazione di pagina

  • Piè di pagina

  • Elementi dei report personalizzati

  • A linee

  • Immagine

  • Rettangolo

  • Subtotali automatici

Gli elementi rimanenti del report vengono ordinati dall'alto verso il basso, quindi da sinistra a destra. Viene quindi eseguito il rendering di ogni elemento in una colonna. Se il report include elementi di dati nidificati, ad esempio elenchi o tabelle, gli elementi padre vengono ripetuti in ogni record.

Nella seguente tabella è indicato l'aspetto degli elementi del report di cui è stato eseguito il rendering:

Articolo Tipo di rendering
Casella di testo Viene eseguito il rendering del contenuto della casella di testo. Nella modalità predefinita gli elementi vengono formattati in base alle proprietà di formattazione dell'elemento. Nella modalità conforme la formattazione può essere modificata dalle impostazioni relative alle informazioni sui dispositivi. Per altre informazioni sulle modalità di rendering CSV, vedere più avanti in questo articolo.
Tabella 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. Per le righe e le colonne di subtotali non sono disponibili intestazioni. I report drill-through non sono supportati.
Con matrice 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. Per le righe e le colonne di subtotali non sono disponibili intestazioni.
List Viene eseguito il rendering di un record per ogni riga di dettagli o istanza nell'elenco.
Sottoreport L'elemento padre viene ripetuto per ogni istanza del contenuto.
Grafico Il rendering viene eseguito mediante la creazione di una riga per ogni valore del grafico ed etichetta del membro. Le etichette delle serie e delle categorie nelle gerarchie sono rese bidimensionali e incluse nella riga per un valore del grafico.
Barra dei dati Viene eseguito il rendering come grafico. In genere, in una barra dei dati non sono incluse gerarchie o etichette.
Grafico sparkline Viene eseguito il rendering come grafico. In genere, in un grafico sparkline non sono incluse gerarchie o etichette.
Misuratore 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.
Indicatore Viene eseguito il rendering come un singolo record con il nome di stato attivo, gli stati disponibili e il valore dei dati.
Mapping Viene eseguito il rendering di una riga con le etichette e i valori per ogni membro della mappa di un livello mappa.

Quando 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. Se più livelli mappa usano la stessa area dati, le righe contengono i dati di tutti i livelli.

Dati gerarchici e raggruppati

Per poter essere rappresentati nel formato CSV, i dati gerarchici e raggruppati devono essere bidimensionali.

L'estensione per il rendering rende bidimensionale il report in una struttura ad albero che rappresenta i gruppi nidificati all'interno dell'area dati. Per rendere bidimensionale il report:

  • Una gerarchia di righe viene resa bidimensionale prima di una gerarchia di colonne.

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

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

  • Le aree dati di pari livello sono aree dati o gruppi dinamici che condividono un'area dati o un predecessore dinamico comune. I dati di pari livello sono identificabili dalle diramazioni dell'albero bidimensionale.

Per altre informazioni, vedere Tabelle, matrici ed elenchi (Generatore di report e SSRS).

Modalità del renderer

L'estensione per il rendering CSV può operare in due modalità: una è ottimizzata per Excel, mentre l'altra è ottimizzata per applicazioni non Microsoft che richiedono una rigida conformità alla specifica CSV del documento RFC 4180. Le aree dati di pari livello vengono gestite in modo diverso a seconda della modalità usata.

Modalità predefinita

La modalità predefinita è ottimizzata per 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. Ogni area dati peer è delimitata da una riga vuota. 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. Il risultato è un file CSV in cui:

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

  • Il rendering di ciascuna area dati di pari livello di livello superiore nel corpo del report viene eseguito nel relativo blocco di dati.

  • Il rendering delle aree dati nidificate viene eseguito in senso diagonale nello stesso blocco di dati.

Formato

Il rendering dei valori numerici viene eseguito nel relativo stato formattato. 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.

Modalità conforme

La modalità conforme è ottimizzata per applicazioni non Microsoft.

Aree dati

Solo la prima riga del file contiene le intestazioni di colonna e ogni riga dispone dello stesso numero di colonne.

Formato

I valori non vengono formattati.

Interattività

Questo renderer non supporta l'interattività nei formati CSV generati. Non viene eseguito il rendering dei seguenti elementi interattivi:

  • Collegamenti ipertestuali

  • Elementi visualizzati o nascosti

  • Mappa documento

  • Collegamenti drill-through o click-through

  • Ordinamento dell'utente finale

  • Intestazioni fisse

  • Bookmarks

Impostazioni relative alle informazioni sul dispositivo

È possibile modificare alcune impostazioni predefinite per questo renderer. Queste impostazioni includono la modalità con cui eseguire il rendering, i caratteri da usare come delimitatori e i caratteri da usare come stringa predefinita del qualificatore di testo. È possibile modificare queste impostazioni modificando le impostazioni delle informazioni sul dispositivo. Per altre informazioni, vedere CSV Device Information Settings.

Vedi anche