Progettazione per l'output CSV
L'estensione per il rendering CSV consente di eseguire il rendering dei report in file di testo normale delimitati da virgola, senza alcuna formattazione. Per la separazione dei campi e delle righe 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, come Microsoft Excel, o utilizzato come formato di importazione per altri programmi. Il report esportato viene salvato come file con estensione csv e restituisce il tipo MIME text/plain. I file sono in formato MIME versione 1.0.
Rendering CSV
Se il rendering viene eseguito utilizzando le impostazioni predefinite, il report CSV avrà le caratteristiche seguenti:
- Il primo record include le intestazioni per tutte le colonne del report.
- Tutte le righe hanno lo stesso numero di colonne.
- Il delimitatore di campo predefinito è la virgola (,).
- Il delimitatore di record è la sequenza ritorno a capo e avanzamento riga (<cr><lf>).
- Il carattere qualificatore di testo è la virgoletta doppia (").
- 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.
Per eseguire il rendering di un report, l'estensione per il rendering CSV esegue un'iterazione del modello di oggetti Report prodotto dal componente Elaborazione report. Durante l'elaborazione vengono ignorati gli elementi seguenti:
- PageHeader
- PageFooter
- Custom
- Line
- Image
- ActiveXControl
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 tabella seguente viene descritto il funzionamento del rendering CSV relativamente ai singoli elementi.
| Elemento | Tipo di rendering |
|---|---|
Casella di testo |
Viene eseguito il rendering del contenuto della casella di testo. I dati vengono formattati in base alla proprietà Format dell'elemento. |
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 |
Viene eseguito il rendering del contenuto come elementi nidificati. L'elemento padre viene ripetuto per ogni istanza del contenuto. |
Sottoreport |
Viene eseguito il rendering del contenuto come elementi nidificati. L'elemento padre viene ripetuto per ogni istanza del contenuto. |
Grafico |
Viene eseguito il rendering di una riga per un set di valori di dati e di colonne per l'altro set di valori di dati. |
L'estensione per il rendering CSV utilizza i valori predefiniti per varie impostazioni relative alle informazioni sui dispositivi configurabili, ad esempio quale carattere utilizzare come delimitatore di campo, delimitatore di record e qualificatore. È possibile accedere e modificare tali impostazioni mediante un'applicazione personalizzata per controllare il rendering dei dati, i delimitatori predefiniti e le interruzioni di pagina. È possibile modificare il delimitatore di campo, il delimitatore di record e il qualificatore di testo utilizzando le impostazioni delle informazioni sui dispositivi FieldDelimiter, RecordDelimiter e Qualifier.
Per controllare le interruzioni di pagina, è possibile impostare il valore booleano SuppressLineBreaks, che consente di stabilire se rimuovere le interruzioni di pagina durante il rendering dei dati. Se si imposta SuppressLineBreaks su true, le interruzioni di riga e i ritorni a capo vengono sostituiti da un singolo spazio. L'impostazione Extension consente di specificare l'estensione di file utilizzata per il file di testo, mentre l'impostazione Encoding consente di modificare la codifica, passando dalla codifica Unicode predefinita ad ASCII, UTF-7 o UTF-8. L'impostazione NoHeader indica infine se ignorare o meno la riga di intestazione durante il rendering. Per ulteriori informazioni sulle impostazioni relative alle informazioni sui dispositivi, vedere Reporting Services Device Information Settings
[!NOTA] La struttura dell'area dati matrice in formato CSV potrebbe venire modificata nelle prossime versioni di Reporting Services.
Vedere anche
Concetti
Considerazioni sulla progettazione del rendering dei report
Altre risorse
Reporting Services Programming