Sottoreport nei report impaginati (Generatore di report)

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

Un sottoreport è un elemento del report in cui viene visualizzato un altro report impaginato all'interno del corpo del report principale. A livello concettuale, un sottoreport in un report è simile a un frame in una pagina Web. Viene utilizzato per incorporare un report all'interno di un report. Qualsiasi report può essere utilizzato come sottoreport. Il report visualizzato come sottoreport è archiviato in un server di report, solitamente nella stessa cartella del report padre. È possibile progettare il report principale in modo che passi parametri al sottoreport. Un sottoreport può essere ripetuto all'interno di aree dati, utilizzando un parametro per filtrare i dati in ogni istanza del sottoreport.

Nota

Se si usa un sottoreport in un'area dati Tablix, il sottoreport e i suoi parametri verranno elaborati per ogni riga. Se le righe sono numerose, è consigliabile valutare l'opportunità di utilizzare un report drill-through.

rs_Subreport

In questa illustrazione, le informazioni di contatto visualizzate nel report Sales Order principale provengono da un sottoreport Contacts.

Nota

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

Confronto tra subreport e aree dati nidificate

Se i sottoreport vengono utilizzati per visualizzare gruppi separati di dati, è consigliabile prendere in considerazione l'utilizzo delle aree dati, ovvero tabelle, matrici o grafici. È possibile che le prestazioni dei report che utilizzano solo le aree dati risultino migliori di quelle dei report che includono sottoreport.

Utilizzare le aree dati per annidare gruppi di dati provenienti dalla stessa origine dati all'interno della stessa area dati. I sottoreport sono utili per annidare gruppi di dati da diverse origini dati all'interno di un'unica area dati, riutilizzare un sottoreport in più report padre o visualizzare un report autonomo all'interno di un altro report. È possibile, ad esempio, creare un "briefing book" inserendo più sottoreport nel corpo di un altro report.

Le aree dati offrono invece un livello di funzionalità e flessibilità analogo a quello dei sottoreport, ma con prestazioni migliori. Poiché il server di report elabora ogni istanza di un sottoreport come un report separato, le prestazioni possono essere influenzate. Per altre informazioni, vedere Aree dati annidate (Generatore report e SSRS).

Utilizzo di parametri nei sottoreport

Per passare parametri dal report padre al sottoreport, definire un parametro di report nel report utilizzato come sottoreport. Quando si inserisce il sottoreport nel report padre, è possibile selezionare il parametro di report e un valore da passare dal report padre al parametro di report nel sottoreport.

Nota

Il parametro selezionato nel sottoreport è un parametro di report e non un parametro di query.

È possibile inserire un sottoreport nel corpo principale del report o in un'area dati. Se si inserisce un sottoreport in un'area dati, il sottoreport verrà ripetuto per ogni istanza del gruppo o riga dell'area dati. Per passare un valore dal gruppo o dalla riga al sottoreport, nella proprietà del valore del sottoreport utilizzare un'espressione di campo per il campo contenente il valore che si desidera passare al parametro del sottoreport.

Per altre informazioni per l'uso dei sottoreport, vedere Aggiungere un sottoreport e i parametri (Report Builder e SSRS).

Specifica di nomi e percorsi dei sottoreport

È possibile progettare un report principale per specificare un sottoreport in una cartella diversa nello stesso server di report.

La sintassi utilizzata per specificare il sottoreport dipende dalla modalità del server di report, ovvero nativa o integrata SharePoint. Per ulteriori informazioni, vedere Specificare i percorsi per elementi esterni (Generatore report e SSRS).

In Generatore report, per visualizzare in anteprima un sottoreport in un report principale, entrambi i report devono trovarsi nello stesso server di report oppure è necessario specificare il percorso completo del sottoreport.