Condividi tramite

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

  • Articolo

Si applica a: SQL Server 2016 (13.x) Reporting Services e versioni successive

È possibile utilizzare Report Designer per creare report impaginati completi e soluzioni per la creazione di report di SQL Reporting Services (SSRS). Report Designer fornisce:

  • Un modo per definire origini dati, set di dati e query.
  • Funzionalità per la progettazione e la personalizzazione del layout di aree dati e campi.
  • Caratteristiche interattive, ad esempio parametri e set di report che interagiscono.

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

Installazione SSDT

SSDT non è incluso in SQL Server. Non è necessario installarlo separatamente. Per istruzioni, vedere Installazione di Visual Studio.

Per usare i modelli di Report Designer, è necessario anche installare un'estensione SSRS per Visual Studio. Per istruzioni, vedere Installazione delle estensioni per Analysis Services, Integration Services e Reporting Services.

Vantaggi dei progetti report

In Report Designer, è possibile usare i progetti per organizzare i report. I progetti report costituiscono il contenitore per le definizioni e le risorse del report. È possibile usare i progetti per i seguenti task:

  • 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 degli elementi in più ambienti.
  • Conservare un set di copie primarie per i report e gli elementi correlati, perché dopo la distribuzione, i report pubblicati possono essere modificati accidentalmente.

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

Origini dati e set di dati condivisi

SSDT consente di definire e implementare origini dati condivise e set di dati condivisi per una soluzione di creazione di report.

  • Per distribuire un'origine dati condivisa indipendentemente da altri elementi di un progetto, è possibile usare le proprietà OverwriteDataSources e TargetDataSourceFolder.
  • Per distribuire un set di dati condiviso indipendentemente da altri elementi di un progetto, è possibile usare le proprietà OverwriteDatasets e TargetDatasetFolder.

Per altre informazioni, vedere Impostazione delle proprietà di distribuzione (Reporting Services).

In Report Designer, 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 Riquadro dei dati del report.

Se un’origine dati è pubblicata su un server di report o in un sito di SharePoint, ma non è inclusa nella soluzione SSDT, non è possibile usare SSDT per aprire tale origine dati. Analogamente, non è possibile usare SSDT per aprire i set di dati pubblicati direttamente da un server di report o da un sito di SharePoint. Per aprire un'origine dati o un set di dati in questi scenari, è possibile usare Report Builder. Per altre informazioni, vedere Ambiente di creazione Report Builder (SSRS). Per i set di dati, usare tale ambiente in modalità set di dati condivisi.

SSDT è uno strumento client. È possibile usarlo per:

  • Testare la soluzione di creazione report in locale nel proprio computer.
  • Testare la soluzione server implementando la soluzione di report in un ambiente di testing.
  • Implementare una soluzione in un ambiente di produzione.
  • Aiuto online per creare e testare i risultati delle query localmente usando le funzionalità di anteprima delle progettazioni query SSDT.

Dopo la distribuzione:

Per altre informazioni sull’inserimento dei dati nei report impaginati, vedere Creazione di stringhe di connessione dati in Report Builder.

Report impaginati

I report impaginati sono file archiviati in un progetto report. È possibile usare un file di report impaginato come report autonomo, sottoreport o come obiettivo per eseguire il drill-through dai report principali. Per implementare un report indipendentemente da altri elementi di un progetto, è possibile usare la TargetReportFolder proprietà e altre proprietà. Per altre informazioni, vedere Impostazione delle 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 Report Designer. I riferimenti a report, sottoreport e report drill-through devono usare URL completi che possano essere testati solo dopo aver implementato il progetto report. Per altre informazioni, vedere Esempi di URL per elementi di report pubblicati in un server di report in modalità SharePoint.

Se si installa l'estensione SSRS in Visual Studio, come illustrato in precedenza nella installazione di SSDT, è possibile usare il modello Progetto server di report per creare un nuovo progetto. È possibile aggiungere un report al proprio progetto come indicato di seguito:

  • Utilizzare la 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 creazione dei report in una serie di passaggi che permettono di creare un report completo. È possibile aggiungere stili per personalizzare la procedura guidata in base alla propria organizzazione. Per altre informazioni, vedere Aggiungere un nuovo report attraverso la procedura guidata.

  • Aggiungere un nuovo elemento di tipo report. In Progettazione report verrà aperto un report vuoto. Per altre informazioni, vedere Aggiungere un nuovo report vuoto.

  • Aggiungere un elemento esistente. In Report Designer, viene aperto un file di definizione del report esistente (con estensione rdl). L'apertura di un report o di un progetto da una versione precedente di SSRS potrebbe determinare l'aggiornamento automatico del progetto alla versione corrente e del report allo schema corrente. Per altre informazioni, vedere Aggiornamento dei report (SSRS).

  • Importare un report di Microsoft Access. Il processo di importazione importa tutti i report da un file di database di Access (con estensione mdb, accdb) o da un file di progetto (con estensione adp). Report Designer converte ogni report nel file di database o di progetto in Report Definition Language (formato RDL) e lo salve 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 dei report da Microsoft Access (Reporting Services).

    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.

  • Lavorare direttamente su un file RDL. Il report viene salvato in formato XML come file RDL. È possibile modificare questo file in Report Designer, con un editor di testo o con qualsiasi editor XML.

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

    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 di codificare correttamente i caratteri specifici di XML usati all'interno degli elementi. Quando il report viene pubblicato, il server di report usa lo schema per convalidare il codice XML del file RDL.

    Per includere elementi che non fanno parte dello schema RDL, inserirli in elemento Custom. Le estensioni per il rendering personalizzate possono leggere gli elementi Custom. Le estensioni per il rendering fornite da SSRS, invece, ignorano l'elemento. Ad esempio, è possibile usare 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).

È possibile distribuire parti del report in modo indipendente da altri elementi di un progetto usando la TargetReportPartFolder proprietà e altre proprietà. Per altre informazioni, vedere Impostazione delle 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 oppure aggiungere file di forma Environmental Systems Research Institute, Inc. (ESRI) per i dati spaziali. Per maggiori 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 all'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 creazione di report in Report Builder e in Report Designer è 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 delle espressioni. Vengono inoltre elencati i problemi nella finestra di 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 <report-name>.rdl.data nella stessa directory del file di definizione del report. e non viene eliminato alla chiusura di Report Designer.

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

  • Vista Anteprima. Se si seleziona la TAB Anteprima, il report viene eseguito in locale. Il report viene eseguito in locale 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 Start.
    • Selezionare F5.

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

    Nota

    Per utilizzare la modalità di debug, è necessario impostare un elemento iniziale. Per impostare un elemento iniziale, passare a Esplora soluzioni, fare clic con il pulsante destro del mouse sul progetto di report e selezionare Proprietà. Quindi, in StartItem, selezionare il nome del report da visualizzare.

    Se si vuole visualizzare in anteprima un report specifico che non è l'elemento iniziale del progetto, è possibile selezionare una configurazione che compila il report ma non la distribuisce. Ad esempio, è possibile usare la configurazione DebugLocal. Fare quindi clic con il pulsante destro del mouse sul report e selezionare Esegui. È necessario scegliere una configurazione che non distribuisca il report. In caso contrario, il report verrà pubblicato nel server di report anziché visualizzato in locale in una finestra di anteprima.

  • Anteprima di stampa. La prima volta che viene visualizzato in modalità anteprima o nella finestra di anteprima, il report sarà 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. Quando si seleziona Anteprima di stampa sulla barra degli strumenti Anteprima, il report viene visualizzato come se fosse in una pagina fisica. Questa visualizzazione assomiglia all'output generato dalle estensioni per il rendering di 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, e impostare 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 e supera 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 devono essere modificati per essere più leggibili 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 crea un report utilizzando lo schema di definizione del report supportato dalla versione corrente di SSRS in 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 che utilizza una versione precedente di SSRS, in Report Designer vengono rimossi gli elementi del report che non esistono nello schema di destinazione. 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 da Report Designer 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 usare Visualizzare codice nel menu di scelta rapida del file di report per visualizzare la definizione del report in questo caso. Quando si seleziona Visualizzare codice, si apre l'origine della definizione del report dalla cartella del progetto.

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

Salvare un report in locale

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

Se si utilizza un software di controllo del codice sorgente, l'atto di salvataggio di un report potrebbe verificarlo nel server di controllo del codice sorgente. Per altre informazioni, vedere Controllo del codice sorgente.

Distribuire o pubblicare report impaginati

Da SSDT, è possibile distribuire report o altri elementi di progetto in più versioni di server di report di SSRS. Usare 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. Da tali formati dipendono il funzionamento di alcune caratteristiche relative all'interattività e al layout del report. Per altre informazioni sulle considerazioni relative alla progettazione per i diversi formati di output, vedere Esportazione dei report impaginati (Report Builder).

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 SSRS specificata nella configurazione del progetto.

Usare la proprietà ErrorLevel per gestire avvisi ed errori relativi alla compilazione. È possibile assegnare alla ErrorLevel proprietà un valore compreso tra 0 e 4. 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 SSDT.

I problemi con i livelli di gravità minori o uguali al valore ErrorLevel vengono segnalati come errori. Altri problemi 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 Avvisi relativi ai problemi di pubblicazione

È possibile tentare di visualizzare in anteprima o distribuire un report che contiene elementi del report non supportati nella versione di SSRS. Tuttavia, tali elementi del report vengono talvolta rimossi dal report e viene generato un errore di livello 2. Se la proprietà ErrorLevel è impostata sul valore predefinito 2, la compilazione ha esito negativo in questo caso.

È possibile risolvere questo problema modificando il valore ErrorLevel in 0 o 1. Quindi, quando l'elemento viene eliminato, viene generato un avviso e il processo di compilazione continua.

Contenuto correlato