Esportare un report impaginato in Microsoft Word (Report Builder)

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

L'estensione per il rendering di Word consente di eseguire il rendering di report impaginati nel formato Microsoft Word (con estensione docx). Il formato è Office Open XML.

Il tipo di contenuto dei file generati da questo renderer è application/vnd.openxmlformats-officedocument.wordprocessingml.document e l’estensione dei file è .docx.

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

Dopo l'esportazione del report in un documento di Word, è possibile modificarne il contenuto e progettare report in formato documento, ad esempio etichette di indirizzi, ordini di acquisto o lettere tipo.

Elementi del rapporto in Word

I report esportati in Word vengono visualizzati sotto forma di una tabella nidificata che rappresenta il corpo del report. Il rendering di un'area dati Tablix viene eseguito come tabella nidificata che riflette la struttura dell'area dati nel report, Le caselle di testo e i rettangoli vengono ciascuno resi come celle all'interno della tabella. Il valore della casella di testo viene visualizzato all'interno della cella.

Il rendering di immagini, grafici, barre di dati, sparklines, mappe, indicatori e misuratori viene eseguito come immagini statiche all'interno delle celle della tabella. I collegamenti ipertestuali e i collegamenti drill-through presenti in questi elementi del report vengono sottoposti a rendering. Le mappe e le aree che è possibile selezionare all'interno di un grafico non sono supportate.

I report in stile newsletter a colonne non vengono resi in Word. La resa dei colori e delle immagini di sfondo del corpo del report e delle pagine non viene eseguita.

Impaginazione

Dopo l'apertura in Word, l'intero report viene rimpaginato in base alle dimensioni della pagina. La rimpaginazione potrebbe causare l'inserimento di interruzioni di pagina nei punti in cui non si intende aggiungerle. In alcuni casi, questo risultato potrebbe causare due interruzioni di pagina consecutive nel report esportato o aggiungere pagine vuote. È possibile tentare di modificare la paginazione di Word regolando i margini della pagina.

Questo renderer supporta solo interruzioni di pagina logiche.

Dimensioni della pagina

Quando viene eseguito il rendering del report, le seguenti proprietà RDL impostano l'altezza e la larghezza della pagina Word: l'altezza e la larghezza del formato carta, i margini sinistro e destro della pagina e i margini superiore e inferiore della pagina.

Larghezza della pagina

Word supporta una larghezza di pagina massima di 56 centimetri. Se il report è più ampio di 22 pollici il renderer esegue comunque il rendering del report. Tuttavia, Word non visualizza il contenuto del report nella visualizzazione layout di stampa o nella visualizzazione layout di lettura. Per visualizzare i dati, passare alla visualizzazione Normale o Layout Web. Poiché in queste visualizzazioni di Word la quantità di spazi vuoti viene ridotta, è possibile visualizzare un'area maggiore del contenuto del report.

Dopo il rendering, la larghezza del report aumenta se necessario fino a un massimo di 56 centimetri, per consentire la visualizzazione del contenuto. La larghezza minima del report è basata sulla proprietà RDL Width nel riquadro Proprietà.

Proprietà del documento

Il renderer di Word consente di scrivere i metadati seguenti nel file DOCX.

Intestazioni di pagina e piè di pagina

Per le intestazioni e i piè di pagina il rendering viene eseguito come aree di intestazione e piè di pagina in Word. Se nell'intestazione o nel piè di pagina è visualizzato un numero di pagina o un'espressione che indica il numero complessivo di pagine del report, il valore viene convertito in un campo di Word. Questa azione garantisce che il numero di pagina accurato venga visualizzato nel report sottoposto a rendering. L'eventuale impostazione nel report dell'altezza dell'intestazione o del piè di pagina non è supportata in Word. In alcune circostanze, la proprietà PrintOnFirstPage può specificare se il testo di un'intestazione e di un piè di pagina viene stampato nella prima pagina di un report. Se il report sottoposto a rendering include più pagine e ogni pagina contiene solo una singola sezione, è possibile impostare PrintOnFirstPage su False. Il testo viene eliminato nella prima pagina. In caso contrario, il testo viene stampato indipendentemente dal valore della proprietà PrintOnFirstPage.

Il renderer di Word tenta di analizzare tutte le espressioni presenti nelle intestazioni e nei piè di pagina quando i report vengono esportati in Word. Molte forme di espressioni vengono analizzate correttamente e i valori previsti vengono visualizzati nei piè di pagina e nelle intestazioni di tutte le pagine dei report.

Tuttavia, in un'intestazione o piè di pagina può essere presente un'espressione complessa mediante la quale vengono restituiti valori diversi in pagine differenti di un report. In tal caso, lo stesso valore potrebbe essere visualizzato in tutte le pagine del report. I numeri di pagina nelle due espressioni seguenti non vengono incrementati nel report esportato. Il numero di pagina si traduce nello stesso valore in tutte le pagine del report.

• ="Page: " + Globals!PageNumber.ToString + " of " + Globals!TotalPages.ToString

• =Avg(Fields!YTDPurchase.Value, "Sales") & " Page Number " & Globals!PageNumber

Questo risultato si verifica in quanto tramite il renderer di Word nel report viene eseguita l'analisi dei campi correlati alla paginazione, ad esempio PageNumber e TotalPages , e viene gestito solo un riferimento semplice, non le chiamate a una funzione. In questo caso, tramite l'espressione viene chiamata la funzione ToString . Le due espressioni seguenti sono equivalenti ed entrambe consentono di eseguire correttamente il rendering quando il report viene visualizzato in anteprima in Generatore report o Progettazione report o viene eseguito il rendering del report pubblicato in un portale Web di Reporting Services o in una raccolta di SharePoint. Tuttavia, il renderer di Word consente di analizzare correttamente solo la seconda espressione ed eseguire il rendering dei numeri di pagina corretti.

• Espressione complessa: l'espressione è ="Average Sales " & Avg(Fields!YTDPurchase.Value, "Sales") & " Page Number " & Globals!PageNumber

• Espressione con sequenze di testo: testo, Average Sales, espressione, =Avg(Fields!YTDPurchase.Value, "Sales), testo, Page Number, ed espressione =Globals!PageNumber

Per evitare questo problema, usare sequenze di testo invece di una sola espressione complessa quando si usano espressioni nei piè di pagina e nelle intestazioni. Le due espressioni seguenti sono equivalenti. La prima è un'espressione complessa, mentre nella seconda vengono utilizzate sequenze di testo. Il renderer di Word consente di analizzare correttamente solo la seconda espressione.

Mappa documento

Se nel report esistono etichette della mappa del documento, possono essere utilizzate come etichette del Sommario di Word nei rispettivi elementi e gruppi del report. L'etichetta della mappa documento viene utilizzata come testo delle etichette di sommario. Il collegamento di destinazione viene posizionato accanto all'elemento su cui è impostata l'etichetta. Anche se nel documento di Word non viene automaticamente creato un sommario al momento dell'esportazione, è possibile compilarne uno utilizzando le etichette della mappa documento visualizzate nel report seguendo i passaggi riportati di seguito.

1. Nel documento di Word selezionare la posizione in cui deve essere collocato il sommario.
2. Nella barra multifunzione selezionare Inserisci.
3. Selezionare il menu Parti rapide.
4. Selezionare Campo dal menu.
5. In Nomi dei campi selezionare TOC e selezionare il pulsante Table of Contents nel riquadro Proprietà campo.
6. Nella finestra popup selezionare il pulsante Opzioni e verificare che la casella Campi voce tabella sia selezionata.
7. Selezionare OK in entrambe le finestre popup per completare il processo e generare il sommario.

Per altre informazioni, vedere Creare una mappa del documento o un sommario (Generatore report).

Interattività

Alcuni elementi interattivi sono supportati in Word. La sezione seguente è una descrizione di comportamenti specifici.

Elementi visualizzati e nascosti

Il renderer di Word esegue il rendering degli elementi del report in base al loro stato al momento del rendering. Se un elemento del report ha lo stato impostato come nascosto, tale elemento non verrà sottoposto a rendering nel documento di Word. Un elemento del report il cui stato è impostato come visualizzato verrà sottoposto a rendering nel documento di Word. La funzionalità di attivazione e disattivazione della visualizzazione non è supportata in Word.

Collegamenti ipertestuali e collegamenti di approfondimento

I collegamenti ipertestuali e drill-through negli elementi del report di tipo casella di testo e immagine vengono resi come collegamenti ipertestuali nel documento di Word. Quando si seleziona il collegamento ipertestuale, il browser Web predefinito si apre e naviga all'URL. Quando si seleziona il collegamento ipertestuale drill-through, si accede al server di report di origine.

Ordinamento interattivo

I contenuti del report vengono visualizzati in base al modo in cui sono attualmente ordinati nell'area dati del report. L'ordinamento interattivo non è supportato in Word. Dopo il rendering del report, è possibile applicare l'ordinamento della tabella all'interno di Word.

Segnalibri

I segnalibri nel report vengono resi come segnalibri di Word. I collegamenti ai segnalibri vengono resi come collegamenti ipertestuali che collegano alle etichette dei segnalibri all'interno del documento. Le etichette di segnalibro devono contenere meno di 40 caratteri. L'unico carattere speciale che è possibile utilizzare in queste etichette è il carattere di sottolineatura (_). I caratteri speciali non supportati vengono rimossi dal nome dell'etichetta di segnalibro. Il nome viene inoltre troncato se costituito da più di 40 caratteri. Se il report contiene nomi di segnalibro duplicati, il rendering dei segnalibri non verrà eseguito in Word.

Eseguire il rendering degli stili di Word

Nella sezione seguente è riportata una breve descrizione della modalità di rendering degli stili in Word.

Tavolozza colori

I colori visualizzati nel report vengono sottoposti a rendering nel documento di Word.

Bordo

Per i bordi degli elementi del report, ad eccezione del bordo della pagina, viene eseguito il rendering come bordi di celle di tabella di Word.

Righe ondulate nei report esportati

Quando esportati e visualizzati in Word, i dati del report o le costanti potrebbero essere sottolineati con linee ondulate rosse o verdi. Con le righe ondulate rosse vengono identificati gli errori di ortografia, Le linee ondulate verdi identificano gli errori grammaticali. Questo risultato si verifica quando nel report sono incluse parole non conformi agli strumenti di correzione (controllo ortografia e grammatica) della lingua di modifica specificata in Word. Ad esempio, i titoli delle colonne del rapporto in inglese probabilmente sono sottolineati con linee ondulate rosse quando il rapporto viene visualizzato in una versione spagnola di Microsoft Word. Gli errori ortografici percepiti sono più comuni nei report rispetto a quelli grammaticali in quanto nei report sono inclusi in genere solo testi brevi, non paragrafi o frasi intere.

La presenza di righe ondulate nei report suggerisce che ci siano errori, cosa che probabilmente non è vera. È possibile rimuovere le righe ondulate cambiando la lingua di revisione del report. Per cambiare la lingua di correzione, selezionare il contenuto del report e specificare la lingua appropriata per tale contenuto. È possibile selezionare una parte o l'intero contenuto. In Word l'opzione Imposta lingua di modifica si trova nell'area Lingua della scheda Revisione. Dopo aver aggiornato il contenuto, è necessario salvare di nuovo il documento.

A seconda della lingua della versione di Office in uso, gli strumenti di correzione, ad esempio, il dizionario, della lingua scelta sono inclusi nel programma o forniti in un Language Pack di Microsoft Office acquistato.

Negli articoli seguenti vengono fornite ulteriori informazioni sull'impostazione delle opzioni di Word e di Office.

• Cambiare la lingua di modifica nella finestra di dialogo Preferenze di lingua di Microsoft Office o Opzioni di Word in Word. Per altre informazioni, vedere Aggiungere una lingua di modifica o di creazione o impostare le preferenze di lingua in Office.

• Aggiungere i Language Pack di Office e cambiare la lingua di modifica. Per altre informazioni, vedere Aggiungere una lingua di modifica o di creazione o impostare le preferenze di lingua nelleopzioni di Office e della lingua di Office.

Limitazioni di Word

Microsoft Word applica le seguenti limitazioni:

• Le tabelle di Word supportano un massimo di 63 colonne. Se il report contiene più di 63 colonne e si tenta di eseguirne il rendering, la tabella viene divisa in Word. Le altre colonne vengono posizionate accanto alle 63 colonne visualizzate nel corpo del report. Pertanto, è possibile che le colonne del report non siano allineate come previsto.

• Word supporta pagine di dimensioni massime pari a 56 centimetri di larghezza e 56 centimetri di altezza. Se la larghezza del contenuto è maggiore di 56 centimetri, è possibile che alcuni dati non vengano visualizzati in visualizzazione Layout di stampa.

• Le impostazioni relative all'altezza dell'intestazione e del piè di pagina vengono ignorate in Word.

• Dopo l'esportazione, il report viene rimpaginato in Word. Questo risultato può causare che altre interruzioni di pagina siano aggiunte al report visualizzato.

• In Word le righe di intestazione non vengono ripetute nella seconda pagina o nelle pagine successive, anche se si imposta la proprietà RepeatOnNewPage della riga di intestazione statica di una Tablix (tabella, matrice o elenco) su True. È possibile definire interruzioni di pagina esplicite nel report per forzare la visualizzazione delle righe di intestazione nelle nuove pagine. Poiché tuttavia al report visualizzabile esportato in Word viene applicata la paginazione specifica di Word, i risultati potrebbero variare e la riga di intestazione potrebbe non essere ripetuta in modo prevedibile. La riga di intestazione statica è la riga contenente le intestazioni di colonna.

• Le dimensioni delle caselle di testo aumentano quando contengono spazi non separabili.

• Quando il testo viene esportato in Word, il testo con decorazioni dei caratteri in alcuni tipi di carattere potrebbe generare glifi imprevisti o mancanti nel report reso.

Vantaggi dell'utilizzo del renderer di Word

Oltre a rendere disponibili per i report esportati le nuove funzionalità di Microsoft Word, i file con estensione *docx tendono anche a essere più piccoli. I report esportati tramite il renderer di Word sono in genere più piccoli rispetto agli stessi report esportati utilizzando il renderer di Word 2003.

Compatibilità con le versioni precedenti di report esportati

È possibile selezionare una modalità di compatibilità di Word e impostare opzioni di compatibilità. Il renderer di Word consente di creare documenti con la modalità di compatibilità abilitata. L'ulteriore salvataggio di documenti con tale modalità disabilitata potrebbe influire sul layout del documento.

Se si disabilita la modalità di compatibilità e si salva di nuovo un report, il relativo layout potrebbe cambiare in modo imprevisto.

Renderizzatore di Word 2003

Il renderer di Word è compatibile con Microsoft Word 2003 con il Microsoft Office Compatibility Pack installato per Word, Excel e PowerPoint. Per altre informazioni, vedere Microsoft Office Compatibility Pack per Word, Excel e PowerPoint.

La versione precedente dell'estensione per il rendering di Word, compatibile con Microsoft Word 2003, è stata rinominata Word 2003. Per impostazione predefinita, è disponibile solo l'estensione per il rendering di Word. È necessario aggiornare i file di configurazione di Reporting Services per rendere disponibile l'estensione per il rendering di Word 2003. Il tipo di contenuto dei file generati dal renderer di Word 2003 è application/vnd.ms-word e l'estensione dei file è doc.

In SQL Server Reporting Services il renderer di Word predefinito è la versione mediante la quale viene eseguito il rendering nel formato docx di Microsoft Word. Questo formato è l'opzione Word elencata nei menu Esporta in un portale Web di Reporting Services e in SharePoint. La versione precedente, compatibile solo con Microsoft Word 2003, è ora denominata Word 2003 ed è elencata nei menu con tale nome. L'opzione di menu Word 2003 non è visibile per impostazione predefinita, tuttavia un amministratore può renderla tale aggiornando il file di configurazione RSReportServer. Per esportare i report da SQL Server Data Tools (SSDT) usando il renderer di Word 2003, è possibile aggiornare il file di configurazione RSReportDesigner. Tuttavia, rendere visibile il renderer di Word 2003 non lo rende disponibile in tutti gli scenari. Poiché il file di configurazione RSReportServer si trova nel server di report, gli strumenti o prodotti da cui si esportano i report devono essere connessi a un server di report per la lettura del file di configurazione. Se si usano strumenti o prodotti in modalità senza connessione o locale, rendere visibile il renderer di Word 2003 non produce alcun effetto. L'opzione di menu Word 2003 rimane non disponibile. Se si rende visibile il renderer di Word 2003 nel file di configurazione RSReportDesigner, l'opzione di menu Word2003 è sempre disponibile nell'anteprima report di SQL Server Data Tools (SSDT).

L'opzione di menu Word 2003 non è mai visibile negli scenari seguenti:

• Report Builder in modalità senza connessione e visualizzazione di un'anteprima di un report in Report Builder.

• La Web Part di Visualizzazione Report in modalità locale e la farm di SharePoint non è integrata con un server di report di Reporting Services. Per altre informazioni, vedere Report in modalità locale e con connessione nel visualizzatore di report (Reporting Services in modalità SharePoint)

Se il renderer di Word 2003 è configurato per essere visibile, entrambe le opzioni di menu Word e Word 2003 sono disponibili negli scenari seguenti:

• Portale Web di Reporting Services se Reporting Services è installato in modalità nativa.

• Sito di SharePoint quando Reporting Services è installato in modalità integrata SharePoint.

• SQL Server Data Tools (SSDT) quando si visualizzano in anteprima i report.

• Generatore report connesso a un server di reportistica.

• La Web part di Visualizzatore report in modalità remota.

Nel codice XML seguente sono mostrati gli elementi delle due estensioni per il rendering di Word nei file di configurazione RSReportServer e RSReportDesigner:

<Extension Name="WORDOPENXML" Type="Microsoft.ReportingServices.Rendering.WordRenderer.WordOpenXmlRenderer.WordOpenXmlDocumentRenderer,Microsoft.ReportingServices.WordRendering"/>

<Extension Name="WORD" Type="Microsoft.ReportingServices.Rendering.WordRenderer.WordDocumentRenderer,Microsoft.ReportingServices.WordRendering" Visible="false"/>

L'estensione WORDOPENXML consente di definire il renderer di Word per i file con estensione docx di Microsoft Word. L'estensione WORD definisce la versione Microsoft Word 2003. Visible = "false" indica che il renderer di Word 2003 è nascosto. Per altre informazioni, vedere File di configurazione RsReportServer.config e File di configurazione RSReportDesigner.

Differenze tra i renderer di Word e Word 2003

I report, visualizzabili tramite i renderer di Word o Word 2003, tendono a essere non distinguibili da un punto di vista visivo. Tuttavia, è possibile riscontrare piccole differenze tra i due tipi di formati Word o Word 2003.

Impostazioni relative alle informazioni sul dispositivo

È possibile modificare alcune impostazioni predefinite per questo renderer modificando le impostazioni relative alle informazioni sul dispositivo. È possibile modificare alcune impostazioni predefinite, come omettere collegamenti ipertestuali e collegamenti drill-through o espandere tutti gli elementi che possono essere attivati o disattivati, indipendentemente dallo stato originale dell'elemento al momento del rendering. Per altre informazioni, vedere Word Device Information Settings.

Contenuto correlato

• Paginazione in Reporting Services
• Comportamenti del renderer
• Funzionalità interattiva per estensioni per il rendering di report differenti
• Eseguire il rendering degli elementi del report
• Tabelle, matrici ed elenchi
• Prova a chiedere nel forum di Reporting Services