Progettare report impaginati di Reporting Services con il Progettazione report (SSRS)

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

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

• Un modo per definire fonti di 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. È necessario installare SSDT separatamente. Per istruzioni, vedere Installare SSDT con Visual Studio.

Per usare i modelli di Progettazione report, è 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 di report

In Progettazione report, è 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.
• Distribuzione congiunta degli 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 ulteriori informazioni, vedere Impostare le proprietà di distribuzione (Reporting Services).

In Progettazione report si lavora sia nel riquadro Dati report sia in Esplora soluzioni per definire le origini dati e i set di dati condivisi utilizzati in un report. 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.
• Distribuisci la tua soluzione di reporting in un ambiente di produzione.
• Consente di creare e testare localmente i risultati delle query usando le funzionalità di anteprima dei progettisti di query di SSDT.

Dopo la distribuzione:

• È necessario verificare che le estensioni di elaborazione delle origini dati e le credenziali delle origini dati siano configurate per l'ambiente del server di reportistica. È possibile utilizzare Gestione della configurazione del server di report per gestire le proprietà per più distribuzioni. Per altre informazioni, vedere Reporting Services in SQL Server Data Tools (SSDT).
• È possibile gestire i set di dati condivisi indipendentemente dalle origini dati condivise e dai report dai quali dipendono. Per ulteriori informazioni, consultare le seguenti risorse:
  • Set di dati del report incorporati e condivisi (Report Builder e SSRS)
  • Strumenti per la progettazione di query (SSRS)
  • Gestire set di dati condivisi

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

Report con impaginazione

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 ulteriori informazioni, vedere Impostare le proprietà di distribuzione (Reporting Services).

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 procedura guidata per i 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 Progettazione report, 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 ulteriori informazioni, vedere Report di aggiornamento (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). Progettazione report 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 funzionalità di importazione, è necessario che Access 2002 o una versione successiva sia installato nel computer in cui è installato Progettazione report. L'origine dati dei report di Access deve essere disponibile quando i report vengono importati.

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

  Quando si modifica l'origine della definizione del report in Progettazione report, 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 di rendering personalizzate possono leggere gli elementi personalizzati. 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).

Sezioni del report

In Progettazione report è 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 di 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 ulteriori 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 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. Trascinando i campi del set di dati sugli elementi dell'area di progettazione, è possibile 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 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 delle espressioni. Vengono inoltre elencati i problemi nella finestra di Output.

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

• Vista di anteprima. Se si seleziona la TAB Anteprima, il report viene eseguito in locale. Utilizza le stesse funzionalità di elaborazione e rendering dei report fornite 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 indipendente. 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.

  È possibile modificare la visualizzazione in modo che mostri il report come verrà stampato passando alla modalità anteprima di stampa. 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.

Salva e pubblica 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 Progettazione report è 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, Progettazione report salva la definizione del report nella directory di compilazione nello schema corrispondente alla versione presente nel server di report di destinazione. Per creare report pubblicabili su un server di report che utilizza una versione precedente di SSRS, in Progettazione report 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 Progettazione report si trova nella cartella di compilazione.

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

Salva un report localmente

Quando si lavora su un report o altri elementi di progetto in Progettazione report, 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.

È 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

• Reporting Services Reports (SSRS)
• Installare SQL Server Data Tools (SSDT) per Visual Studio
• Strumenti per la progettazione di query (SSRS)