Comportamenti di rendering in un report impaginato (Report Builder)

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

A seconda del renderer selezionato, vengono applicate regole specifiche al corpo del report impaginato e al relativo contenuto durante il rendering di un report. La disposizione degli elementi del report in una pagina dipende dalla combinazione dei seguenti fattori:

• Regole di rendering.

• Larghezza e altezza degli elementi del report.

• Dimensioni del corpo del report.

• Larghezza e altezza della pagina.

• Supporto specifico del renderer per la paginazione.

In questo argomento vengono illustrate le regole generali applicate da Reporting Services. Per ulteriori informazioni, vedere Rendering degli elementi del report (Report Builder e SSRS), Rendering delle aree dati (Report Builder e SSRS) e Rendering dei dati (Report Builder e SSRS).

Comportamenti generali per HTML, MHTML, Word e Excel (renderer di interruzioni di pagina automatiche)

I report esportati utilizzando i formati HTML e MHTML sono ottimizzati per la visualizzazione sullo schermo di un computer di pagine di lunghezze diverse. Le interruzioni di pagina vengono inserite verticalmente solo in punti approssimativi all'interno del corpo del report. Tali punti approssimativi dipendono dall'impostazione relativa all'altezza interattiva nel riquadro Proprietà. Si supponga ad esempio che l'altezza interattiva sia impostata su 12 centimetri. Quando viene eseguito il rendering del report, l'altezza della pagina è di circa 5 pollici. In Word ed Excel l'impaginazione è basata su interruzioni di pagina logiche, pertanto l'impostazione relativa all'altezza interattiva viene ignorata.

In caso di esportazione di un report in HTML, MHTML, Word o Excel, vengono adottate le seguenti regole generali:

• Agli elementi del report vengono applicate interruzioni di pagina logiche, ovvero interruzioni di pagina inserite in modo esplicito. Se ad esempio si inserisce un'interruzione di pagina tra ogni gruppo, le interruzioni verranno applicate durante il rendering del report.

• Viene creato un layout approssimativo utilizzando l'altezza della pagina e il numero di occorrenze dell'elemento nel report. Se ad esempio una casella di testo è alta 1,2 centimetri e si ripete cinque volte nel report, verranno riservati 6,3 centimetri.

• Vengono inserite più interruzioni di pagina non permanenti in base all'impostazione dell'altezza interattiva. Per eliminarle nel formato HTML e nei controlli ReportViewer e controllare la paginazione solo con interruzioni di pagina esplicite, impostare il valore altezza interattiva su 0 o su un valore estremamente elevato.

  Nota

  L'impostazione relativa alla larghezza interattiva non viene utilizzata nei renderer con interruzioni di pagina automatiche.

• Le pagine del report possono espandersi per contenere vedove, orfane ed elementi del report che devono essere mantenuti insieme. Il report può pertanto estendersi oltre la larghezza dello schermo ed essere visualizzato utilizzando barre di scorrimento.

• La paginazione viene applicata solo verticalmente ai report.

• I margini di pagina non vengono applicati.

Comportamenti generali per PDF, immagini e stampa (renderer con interruzioni di pagina rigide)

I report esportati utilizzando i formati PDF e immagine sono ottimizzati per la stampa o la visualizzazione di documenti formattati come libri in cui le dimensioni delle pagine sono uniformi. Le interruzioni di pagina vengono inserite verticalmente e orizzontalmente in punti specifici all'interno del corpo del report. Tali punti specifici dipendono dalle impostazioni relative alla larghezza e all'altezza della pagina.

• Le pagine sono numerate in sequenza da sinistra verso destra e quindi dall'alto verso il basso.

• Agli elementi del report vengono applicate interruzioni di pagina logiche, ovvero interruzioni di pagina inserite in modo esplicito. Queste interruzioni di pagina possono far sì che alcuni elementi del report spingano altri elementi alla pagina successiva.

• Se si verifica un'interruzione di pagina fisica in elementi del report che devono essere mantenuti uniti, tutti gli elementi da mantenere uniti vengono spostati nella pagina successiva.

• A causa di vincoli relativi alle dimensioni della pagina, potrebbe non essere possibile mantenere uniti tutti gli elementi o ripetere elementi. In tale circostanza, il renderer potrebbe ignorare determinate regole per la ripetizione con un altro elemento allo scopo di consentire l'inserimento dell'elemento del report nella pagina.

• Se un elemento non può essere mantenuto unito, ad esempio una casella di testo che diventa troppo grande per essere inserita nell'area utilizzabile della pagina verticale, l'elemento verrà tagliato in corrispondenza del limite della pagina fisica e continuerà nella pagina successiva.

• La paginazione viene applicata verticalmente e orizzontalmente ai report.

  Nota

  L'impostazione della larghezza interattiva non viene utilizzata nei renderer con interruzione di pagina fisica.

Spaziatura minima tra gli elementi del report

Gli elementi del report si espandono all'interno del corpo del report per consentire l'inserimento del relativo contenuto. Durante il rendering del report un'area dati della matrice, ad esempio, si espande in genere in larghezza e in lunghezza nella pagina e l'altezza di una casella di testo viene regolata in base ai dati restituiti da un'espressione.

I renderer mantengono lo spazio minimo tra gli elementi del report definiti nel layout del report. Quando si posiziona un elemento del report accanto a un altro nel layout del report, la distanza tra gli elementi diventa la distanza minima da mantenere quando le dimensioni del report aumentano in orizzontale o in verticale. Se ad esempio si aggiunge un'area dati della matrice a un report e quindi si aggiunge un rettangolo da 0,06 centimetri a destra della matrice, tale spazio verrà mantenuto anche in caso di aumento delle dimensioni della matrice. Ogni elemento si sposta verso destra in modo da mantenere la distanza minima dagli elementi che terminano alla sua sinistra.

Intestazioni di pagina e piè di pagina

Le intestazioni e i piè di pagina appaiono nella parte superiore e inferiore di ogni pagina di cui viene eseguito il rendering. È possibile formattare l'intestazione e il piè di pagina in modo da includere un colore, uno stile e una larghezza per il bordo. È inoltre possibile aggiungere un colore o un'immagine di sfondo. A seconda del formato scelto, viene eseguito il rendering di tutte queste opzioni di formattazione.

Le seguenti regole si applicano alle intestazioni e ai piè di pagina quando vengono resi nel formato di rendering HTML o MHTML:

• Se presenti, l'intestazione e il piè di pagina vengono visualizzati nella parte superiore e inferiore di ogni pagina, nell'area utilizzabile della pagina.

• Nelle pagine in cui l'intestazione o il piè di pagina è nascosto, l'altezza dell'intestazione o del piè di pagina rimane riservata all'interno dell'area utilizzabile della pagina anche se il rendering dell'intestazione o del piè di pagina non viene eseguito.

• Se il contenuto dell'intestazione o del piè di pagina si estende oltre i limiti dell'intestazione o del piè di pagina, le dimensioni dell'intestazione o del piè di pagina vengono aumentate per consentire l'inserimento del contenuto.

Le seguenti regole si applicano alle intestazioni e ai piè di pagina durante il rendering nei formati PDF o immagine:

• L'intestazione o il piè di pagina viene visualizzato in alto e in basso di ogni pagina nell'area utilizzabile della pagina.

• Nelle pagine in cui l'intestazione o il piè di pagina è nascosto, l'altezza dell'intestazione o del piè di pagina rimane riservata all'interno dell'area utilizzabile della pagina anche se il rendering dell'intestazione o del piè di pagina non viene eseguito.

• L'intestazione e il piè di pagina non vengono espansi o ridotti di dimensione, Vengono visualizzati su ogni pagina all'altezza specificata al momento della creazione dell'intestazione o del piè di pagina.

• A prescindere dal numero di colonne nel report, sono presenti una sola intestazione e un solo piè di pagina per pagina.

• Se il contenuto dell'intestazione o il piè di pagina si estende oltre i limiti dell'intestazione o del piè di pagina, il contenuto viene tagliato.

• Le intestazioni e i piè di pagina definiti nel file RDL originale non vengono visualizzati quando il report viene visualizzato come sottoreport.

Interruzioni di pagina logiche

Le interruzioni di pagina logiche sono interruzioni di pagina inserite prima o dopo elementi del report o gruppi. Le interruzioni di pagina contribuiscono a determinare come il contenuto viene adattato a una pagina del report per una visualizzazione ottimale durante il rendering o l'esportazione del report.

Per il rendering delle interruzioni di pagina logiche si applicano le seguenti regole:

• Le interruzioni di pagina logiche vengono ignorate per gli elementi del report che rimangono sempre nascosti e per gli elementi del report la cui visibilità viene controllata facendo clic su un altro elemento del report.

• Le interruzioni di pagina logiche vengono applicate agli elementi visibili in modo condizionale se sono effettivamente visibili nel momento in cui viene eseguito il rendering del report.

• Lo spazio viene mantenuto tra l'elemento del report con l'interruzione di pagina logica e gli elementi del report di pari livello corrispondenti.

• Le interruzioni di pagina logiche inserite prima di un elemento del report comportano lo spostamento verso il basso dell'elemento del report nella pagina successiva. L'elemento del report viene visualizzato nella parte superiore della pagina successiva.

• Le interruzioni di pagina logiche definite su elementi contenuti in celle di tabella o matrice non vengono mantenute. Questo non si applica agli elementi degli elenchi.

Contenuto correlato

• Funzionalità interattive: estensioni per il rendering di report diverse
• Render in HTML (Report Builder)
• Layout di pagina e rendering nei report impaginati (Report Builder)