Progettare report impaginati di Reporting Services con Report Designer (SSRS)

  • Articolo

Usare Progettazione report per creare report e soluzioni di creazione di report impaginati completi di Reporting Services. Report Designer fornisce un'interfaccia grafica in cui è possibile definire le origini dati. Offre anche set di dati, query, posizioni di layout del report per aree dati e campi, nonché caratteristiche interattive, quali l'interazione tra parametri e set di report.

Progettazione report è una funzionalità di SQL Server Data Tools (SSDT), un ambiente Microsoft Visual Studio per la creazione di soluzioni di Business Intelligence. SQL Server Data Tools (SSDT) non è incluso in SQL Server. Scaricare SQL Server Data Tools.

Vantaggi dei progetti report

I progetti report costituiscono il contenitore per le definizioni e le risorse del report. Utilizzare i progetti per:

  • Organizzare i report e gli elementi correlati in un contenitore.

  • Testare le soluzioni di report che includono report ed elementi correlati a livello locale.

  • Distribuire insieme gli elementi correlati. Utilizzare le proprietà del progetto e la gestione della configurazione per la distribuzione in più ambienti.

  • Mantenere un set di copie primarie per i report e gli elementi correlati. Dopo la distribuzione, i report pubblicati potrebbero venire accidentalmente modificati.

Usare le informazioni contenute in questo articolo per progettare report impaginati ed elementi correlati per un unico progetto di report in una soluzione di SQL Server Data Tools (SSDT). Per altre informazioni sulle soluzioni e più progetti in SQL Server Data Tools, vedere Reporting Services in SQL Server Data Tools.

Origini dati condivise

Usare SQL Server Data Tools per definire e distribuire origini dati condivise per una soluzione di report. Le origini dati condivise possono essere distribuite indipendentemente dagli altri elementi di un progetto tramite le proprietà OverwriteDataSources e TargetDataSourceFolder . Per altre informazioni, vedere Impostare le proprietà di distribuzione (Reporting Services).

In Progettazione report per definire le origini dati utilizzate in un report è possibile utilizzare sia il riquadro dei dati del report che Esplora soluzioni. Per altre informazioni, vedere Report Data Pane. Non è possibile usare SQL Server Data Tools per aprire origini dati pubblicate in un server di report o in un sito di SharePoint, ma non incluse nella soluzione SQL Server Data Tools. Per tale caratteristica, usare Ambiente di creazione di Generatore report (SSRS).

SQL Server Data Tools è uno strumento client. È possibile testare la soluzione di report localmente nel computer, distribuirla in un ambiente di testing per il test della soluzione server, quindi distribuirla in un ambiente di produzione. Dopo la distribuzione, verificare che le estensioni per l'elaborazione dell'origine dati e le credenziali dell'origine dati siano configurate per l'ambiente del server di report. È possibile utilizzare Gestione configurazione per gestire le proprietà per distribuzioni diverse. Per altre informazioni, vedere Reporting Services in SQL Server Data Tools (SSDT).

Per altre informazioni, vedere Creare stringhe di connessione dati - Generatore report e SSRS.

Set di dati condivisi

Usare SQL Server Data Tools per definire e distribuire set di dati condivisi per una soluzione di report. I set di dati condivisi possono essere distribuiti indipendentemente dagli altri elementi di un progetto tramite le proprietà OverwriteDatasets e TargetDatasetFolder . Per altre informazioni, vedere Impostare le proprietà di distribuzione (Reporting Services).

In Progettazione report per definire i set di dati condivisi utilizzati in un report è possibile utilizzare sia il riquadro dei dati del report che Esplora soluzioni. Per altre informazioni, vedere Report Data Pane. Non è possibile usare SQL Server Data Tools per aprire i set di dati pubblicati direttamente da un server di report o da un sito di SharePoint. Per tale caratteristica, usare Ambiente di creazione di Generatore report (SSRS) in modalità Set di dati condiviso.

SQL Server Data Tools è uno strumento client. È possibile utilizzare le finestre Progettazione query per creare e testare i risultati delle query localmente in Anteprima. Dopo la distribuzione è possibile gestire i set di dati condivisi indipendentemente dalle origini dati condivise e dai report dai quali dipendono. Per altre informazioni, vedere Set di dati condivisi e incorporati del report (Generatore report e SSRS), Strumenti di progettazione query (SSRS) e Gestire set di dati condivisi.

Report impaginati

I report impaginati sono file archiviati in un progetto report. I report possono essere utilizzati come report autonomi, sottoreport o destinazioni per azioni drill-through dai report principali. I report possono essere distribuiti indipendentemente da altri elementi di un progetto tramite TargetReportFolder e altre proprietà. Per altre informazioni, vedere Impostare le proprietà di distribuzione (Reporting Services).

Nota

In caso di pubblicazione in un server di report in modalità SharePoint, non è possibile testare alcune caratteristiche della soluzione di report nel progetto di Progettazione report. I riferimenti a report, sottoreport e report drill-through devono utilizzare URL completi che possono essere testati solo dopo la distribuzione del progetto report. Per altre informazioni, vedere Esempi di URL per elementi di report pubblicati in un server di report in modalità SharePoint (SSRS).

È possibile aggiungere report a un progetto come indicato di seguito:

  • Aggiungere un nuovo progetto report. Per impostazione predefinita, un report vuoto viene aperto in Progettazione report. Per altre informazioni, vedere Aggiungere un report nuovo o esistente a un progetto report (SSRS).

  • Aggiungere un progetto Creazione guidata report. Il report viene creato mediante una serie di passaggi dettagliati. La Creazione guidata report consente di semplificare la procedura di definizione dei dati e di progettazione dei report mediante una serie di passaggi che consentono di creare un report completo. È possibile aggiungere stili per personalizzare la procedura guidata in base alla propria organizzazione. Per altre informazioni, vedere Aggiungere un report nuovo o esistente a un progetto report (SSRS).

  • Aggiungere un nuovo elemento di tipo Report. In Progettazione report verrà aperto un report vuoto.

  • Aggiungere un elemento esistente. In Progettazione report verrà visualizzata una definizione di report esistente (con estensione rdl). L'apertura di un report o di un progetto da una versione precedente di Reporting Services potrebbe determinare l'aggiornamento automatico del progetto alla versione corrente e del report allo schema corrente. Per altre informazioni, vedere Upgrade Reports.

  • Importare un report di Microsoft Access. Importare tutti i report da un file di database di Access (con estensione mdb, accdb) o da un file di progetto (con estensione adp). In Progettazione report ogni report nel file di database o di progetto viene convertito in formato RDL e salvato nel progetto report. Non tutte le funzionalità di un report di Access vengono trasferite in un file di definizione di report (con estensione rdl). Per altre informazioni, vedere Importazione report da Microsoft Access (Reporting Services) e Caratteristiche supportate dei report di Access (SSRS).

    Nota

    Per utilizzare la caratteristica di importazione è necessario che Access 2002 o versione successiva sia installato nello stesso computer di Progettazione report. Per l'importazione dei report è necessario che sia disponibile l'origine dati dei report di Access.

  • Utilizzare direttamente RDL. Al momento della scrittura in Progettazione report, il report viene salvato in formato XML come file RDL (Report Definition Language). È possibile modificare questo file in Progettazione report, in un editor di testo o con qualsiasi strumento che supporti la modifica di codice XML.

    Quando si modifica l'origine della definizione di report in Progettazione report, si utilizza lo schema RDL corrente della versione di SQL Server in cui sono stati installati gli strumenti di sviluppo. Durante la compilazione di un progetto, la versione dello schema potrebbe variare a seconda delle proprietà della distribuzione. Per altre informazioni, vedere Distribuzione e supporto delle versioni in SQL Server Data Tools (SSRS).

    La modifica diretta del file RDL può determinare la mancata pubblicazione nel server di report o la mancata esecuzione del report. Come per qualsiasi file XML, assicurarsi che i caratteri specifici del linguaggio XML utilizzati negli elementi siano correttamente codificati. Quando il report viene pubblicato, il server di report utilizza lo schema per convalidare il codice XML incluso nel file RDL.

    Per includere elementi che non fanno parte dello schema RDL, inserire tali elementi nell'elemento Custom. Le estensioni per il rendering personalizzate possono leggere l'elemento Custom. Tuttavia, le estensioni per il rendering fornite da Reporting Services ignorano l'elemento. Ad esempio, è possibile utilizzare l'elemento Custom per archiviare commenti nel report.

    Per altre informazioni, vedere Report Definition Language (SSRS).

Parti del report

Nota

Le parti del report sono deprecate per tutte le versioni di SQL Server Reporting Services a partire da SQL Server Reporting Services 2019 e tutte le versioni di Server di report di Power BI a partire da Server di report di Power BI, settembre 2022.

In Report Designer è possibile creare tabelle, grafici e altri elementi del report impaginati in un progetto. Dopo la creazione, è possibile pubblicarli su un server di report o su un sito di SharePoint integrato con un server di report come parti del report; Questa azione consente a utenti e altri di riutilizzarli in altri report. Per altre informazioni, vedere Parti del report in Progettazione report (SSRS).

Le parti del report possono essere distribuite indipendentemente da altri elementi di un progetto tramite TargetReportPartFolder e altre proprietà. Per altre informazioni, vedere Impostare le proprietà di distribuzione (Reporting Services).

Risorse

È possibile aggiungere al progetto file correlati al report, ma non elaborati dal server di report. È ad esempio possibile aggiungere immagini per le immagini o file di forma ESRI per i dati spaziali. Per altre informazioni, vedere Risorse.

Layout del report impaginato

Per creare il layout del report, trascinare gli elementi e le aree dati del report dalla casella degli strumenti nell'area di progettazione e disporli. Trascinare i campi del set di dati sugli elementi dell'area di progettazione per aggiungere dati al report. Per organizzare i dati in gruppi in un'area dati Tablix, trascinare i campi del set di dati nel riquadro di raggruppamento. Poiché gli strumenti per la creazione di report costituiscono essenzialmente un modo per creare definizioni di report, l'approccio alla progettazione di report di Generatore report e Progettazione report è simile.

Visualizzare in anteprima un report impaginato

Utilizzare Anteprima per verificare i dati del report e la progettazione del layout. Quando un report viene visualizzato in anteprima, il componente Elaborazione report convalida lo schema di definizione del report e la sintassi dell'espressione ed elenca i problemi nella finestra Output .

Nota

Quando un report viene visualizzato in anteprima, i dati per il report vengono memorizzati nella cache in un file nel computer locale. Quando lo stesso report viene visualizzato di nuovo in anteprima utilizzando la stessa query, gli stessi parametri e le stesse credenziali, in Progettazione report viene recuperata la copia memorizzata nella cache anziché rieseguire la query. Il file dei dati viene salvato come <reportname>.rdl.data nella stessa directory del file di definizione del report. e non viene eliminato alla chiusura di Progettazione report.

È possibile visualizzare l'anteprima di un report nei modi seguenti:

  • Vista Anteprima. Selezionare la scheda Anteprima. Il report viene eseguito localmente utilizzando le stesse funzionalità di elaborazione e rendering dei report offerte dal server di report. Il report visualizzato è un'immagine interattiva. È quindi possibile selezionare parametri, selezionare i collegamenti, visualizzare la mappa documento ed espandere e comprimere le aree nascoste del report. È inoltre possibile esportare il report in uno dei formati di rendering installati.

  • Anteprima autonoma. Consente di eseguire il report locale in un browser. Tramite una configurazione per il debug, è inoltre possibile utilizzare questa modalità per eseguire il debug degli assembly personalizzati scritti. Per eseguire un progetto in modalità debug è possibile procedere in tre modi diversi:

    • Scegliere Avvia debug dal menu Debug.

    • Nella barra degli strumenti standard di Visual Studio, selezionare il pulsante Avvia.

    • Premere F5.

    Se si utilizza una configurazione del progetto che compila il report senza distribuirlo, il report specificato nella proprietà StartItem della configurazione corrente viene aperto in una finestra di anteprima separata.

    Nota

    Per utilizzare la modalità debug, è necessario impostare un elemento iniziale. In Esplora soluzioni fare clic con il pulsante destro del mouse sul progetto report, scegliere Proprietà, quindi selezionare il nome del report da visualizzare nella proprietà StartItem.

    Se si desidera visualizzare in anteprima un report che non è l'elemento iniziale del progetto, selezionare una configurazione che compili il report senza distribuirlo, ad esempio la configurazione DebugLocal. Fare clic con il pulsante destro del mouse sul report e quindi scegliere Esegui. È necessario scegliere una configurazione che non distribuisca il report. In caso contrario, il report non viene pubblicato nel server di report anziché visualizzato localmente in una finestra di anteprima.

  • Anteprima di stampa.

    La prima volta che viene visualizzato in modalità di anteprima o nella finestra di anteprima, il report è simile a quello generato dall'estensione per il rendering HTML. L'anteprima non è in formato HTML, ma il layout e la paginazione del report sono simili a quelli dell'output HTML.

    Se si passa alla modalità anteprima di stampa, è possibile visualizzare la rappresentazione del report stampato. Selezionare il pulsante Anteprima di stampa sulla barra degli strumenti di anteprima. Il report viene visualizzato come in una pagina fisica. Questa visualizzazione assomiglia all'output generato dalle estensioni per il rendering delle immagini e PDF. L'anteprima di stampa non è un'immagine né un file PDF, ma la paginazione e il layout del report sono simili a quelli dell'output in questi formati. È possibile scegliere le dimensioni dell'immagine del report, ad esempio, la larghezza della pagina.

    L'anteprima di stampa consente di identificare molti problemi di rendering che si potrebbero verificare in caso di stampa del report. I comuni problemi di rendering includono:

    • Pagine vuote aggiuntive perché il report è troppo grande per adattarsi al formato della carta specificato per il report.

    • Pagine vuote aggiuntive perché il report contiene una matrice che si espande dinamicamente in modo da superare la larghezza della carta specificata.

    • Le interruzioni di pagina tra i gruppi non funzionano nel modo desiderato.

    • Le intestazioni e i piè di pagina non vengono visualizzati come previsto.

    • Layout del report che deve essere modificato per essere più leggibile nel formato di stampa.

Salvare e distribuire report impaginati

In Progettazione report è possibile salvare report e altri file di progetto in locale oppure distribuirli in un server di report o in un sito di SharePoint. È possibile distribuire origini dati condivise, set di dati condivisi, report, risorse del report e parti del report singolarmente o insieme a seconda delle proprietà di distribuzione del progetto configurate. Per altre informazioni, vedere Proprietà di configurazione e distribuzione.

In Report Designer è importante tenere presente che si progetta un report usando lo schema di definizione del report supportato dalla versione corrente di Reporting Services in SQL Server Data Tools (SSDT). È possibile impostare le proprietà di distribuzione del progetto per un server di report o un sito di SharePoint specifico. Quando si salva il report, in Progettazione report la definizione del report viene salvata nella directory di compilazione nello schema che corrisponde alla versione sul server di report di destinazione. Per creare report pubblicabili su un server di report di livello inferiore, in Progettazione report gli elementi del report non esistenti nello schema di destinazione vengono rimossi. L’azione avviene automaticamente, senza richiesta di conferma. Quando l’azione si verifica, la definizione di report originale viene mantenuta nella cartella del progetto. La definizione di report modificata che viene distribuita si trova nella cartella di compilazione.

Nota

Per le espressioni di debug e gli errori di distribuzione, è necessario visualizzare la definizione di report nella cartella di compilazione. Non utilizzare Visualizza origine. Visualizza origine consente di visualizzare l'origine della definizione del report dalla cartella del progetto.

Per altre informazioni, vedere Distribuzione e supporto delle versioni in SQL Server Data Tools (SSRS).

Salvare un report in locale

Quando si utilizza un report o altri elementi di progetto in Progettazione report, i file vengono salvati nel computer locale o in una condivisione di un altro computer a cui si ha accesso.

Se si utilizza il software di controllo del codice sorgente, potrebbe essere necessario controllare i report nel server di controllo del codice sorgente al salvataggio del report. Per altre informazioni, vedere Controllo del codice sorgente.

Distribuire o pubblicare report impaginati

In SQL Server Data Tools è possibile distribuire report o altri elementi di progetto in più versioni di server di report di Reporting Services. Utilizzare le configurazioni di progetto per controllare l'aggiornamento delle definizioni di report alle versioni dello schema compatibili con i server di report di destinazione. Le proprietà controllate dalle configurazioni di progetto includono il server di report di destinazione, la cartella in cui il processo di compilazione consente di archiviare temporaneamente le definizioni di report per l'anteprima e la distribuzione, nonché i livelli di errore. Per altre informazioni, vedere Proprietà di configurazione e distribuzione e Impostare le proprietà di distribuzione (Reporting Services).

Esportare un report impaginato in un formato di file diverso

I report possono essere esportati in diversi formati, dai quali dipende il funzionamento di alcune funzionalità relative all'interattività e al layout del report. Per altre informazioni sulle considerazioni relative alla progettazione per i diversi formati di output, vedere Esportare report (Generatore report e SSRS).

Convalida del report e livelli di errore

I report vengono convalidati prima dell'anteprima e durante la distribuzione. Durante la compilazione dei report si possono verificare diversi problemi. I report potrebbero ad esempio contenere stringhe quali espressioni o query incompatibili con la versione di Reporting Services specificata nella configurazione del progetto.

Usare la proprietà ErrorLevel per gestire avvisi ed errori relativi alla compilazione. La proprietà ErrorLevel può contenere un valore da 0 a 4 incluso. Il valore determina quali problemi di compilazione vengono segnalati come errori e quali come avvisi. Il valore predefinito è 2. Gli avvisi e gli errori vengono scritti nella finestra Output di SQL Server Data Tools (SSDT).

I problemi con livelli di gravità minori o uguali al valore di ErrorLevel vengono segnalati come errori; in caso contrario, vengono segnalati come avvisi.

Nella seguente tabella vengono elencati i livelli di errore.

Livello di errore Descrizione
0 Problemi di compilazione più gravi e inevitabili che impediscono la visualizzazione in anteprima e la distribuzione di report.
1 Problemi di compilazione gravi che modificano drasticamente il layout del report.
2 Problemi di compilazione meno gravi che modificano sensibilmente il layout del report.
3 Problemi di compilazione minori che modificano il layout del report in maniera meno significativa e quasi impercettibile.
4 Utilizzato solamente per pubblicare avvisi.

Quando si tenta di visualizzare in anteprima o di distribuire un report contenente elementi di report nuovi in SQL Server Reporting Services (SSRS) 2016 (13.x) o versioni successive, tali elementi possono essere rimossi dal report. Per impostazione predefinita, la proprietà ErrorLevel della configurazione è impostata su 2. Pertanto la compilazione del report potrebbe non essere eseguita correttamente in caso di rimozione della mappa. Se tuttavia si imposta il valore della proprietà ErrorLevel su 0 o 1, la mappa viene rimossa, viene visualizzato un avviso e il processo di compilazione continua.

Contenuto correlato

Scaricare SQL Server Data Tools
Reporting Services in SQL Server Data Tools
Strumenti di progettazione query
Distribuzione e supporto della versione in SQL Server Data Tools

Altre domande? Visitare il forum su Reporting Services