Esportazione in un file CSV (Generatore report 2.0)
L'estensione per il rendering CSV (Comma-Separated Value) consente di eseguire il rendering di report come una 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 utilizzato 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 utilizzato come formato di importazione per altri programmi. Il report esportato viene salvato come file con estensione csv e restituisce il tipo MIME text/csv.
Rendering CSV
Se il rendering viene eseguito utilizzando 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 ulteriori informazioni, vedere Reporting Services 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:
Grafico
Contatore
Intestazione di pagina
Piè di pagina
Elementi personalizzati
Line
Image
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:
Elemento |
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à compatibile la formattazione può essere modificata dalle impostazioni relative alle informazioni sui dispositivi. Per ulteriori informazioni sulle modalità di rendering CSV, vedere di seguito. |
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. |
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. |
Elenco |
Viene eseguito il rendering di un record per ogni riga di dettagli o istanza nell'elenco. |
Rettangolo |
L'elemento padre viene ripetuto per ogni istanza del contenuto. |
Sottoreport |
L'elemento padre viene ripetuto per ogni istanza del contenuto. |
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.
Il rendering dei membri della gerarchia di righe nel file CSV viene eseguito prima di quello dei membri della 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 della struttura ad albero bidimensionale.
Per ulteriori informazioni, vedere Utilizzo delle aree dati Tablix (Generatore report 2.0).
Modalità del renderer
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. Le aree dati di pari livello vengono gestite in modo diverso a seconda della modalità utilizzata.
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.
Formattazione
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à compatibile
La modalità compatibile è ottimizzata per applicazioni di terze parti.
Aree dati
Solo la prima riga del file contiene le intestazioni di colonna e ogni riga dispone dello stesso numero di colonne.
Formattazione
I valori non vengono formattati.
Interattività
L'interattività non è supportata da nessuno dei formati CSV generati da questo renderer. 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
Segnalibri
Impostazioni relative alle informazioni sul dispositivo
È possibile cambiare alcune impostazioni predefinite per questo renderer, tra cui la modalità in cui eseguire il rendering, i caratteri da utilizzare come delimitatori e i caratteri da utilizzare come stringa predefinita del qualificatore di testo, modificando le impostazioni relative alle informazioni sui dispositivi. Per ulteriori informazioni, vedere Reporting Services Device Information Settings.
Vedere anche