Progettare report con Progettazione report (SSRS)

Progettazione report consente di creare report e soluzioni di report Reporting Services completi. Tale strumento offre un'interfaccia grafica in cui è possibile definire origini dati, 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.

Vantaggi per i progetti

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 master per i report e gli elementi correlati. Dopo la distribuzione, i report pubblicati potrebbero venire accidentalmente modificati.

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

Contenuto dell'articolo

Origini dati condivise

Set di dati condivisi

Report

Parti del report

Risorse

Layout del report

Anteprima

Salvare e distribuire

Convalida del report e livelli di errore

Origini dati condivise

Utilizzare 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 ulteriori 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 ulteriori informazioni, vedere Riquadro dei dati del report. Non è possibile utilizzare 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, utilizzare 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 ulteriori informazioni, vedere Reporting Services in SQL Server Data Tools (SSRS).

Per ulteriori informazioni, vedere Connessioni dati, origini dati e stringhe di connessione (SSRS).

Torna all'inizio

Set di dati condivisi

Utilizzare 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 ulteriori 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 ulteriori informazioni, vedere Riquadro dei dati del report. Non è possibile utilizzare 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, utilizzare 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 ulteriori informazioni, vedere Set di dati condivisi e incorporati del report (Generatore report e SSRS), Strumenti per la progettazione di query in Progettazione report in SQL Server Data Tools (SSRS) e Gestire set di dati condivisi.

Torna all'inizio

Report

I report 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 ulteriori 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 ulteriori 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 ulteriori 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 ulteriori 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 ulteriori informazioni, vedere Aggiornare i report.

• 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 ulteriori 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 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 ulteriori informazioni, vedere Distribuzione e supporto della versione 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. L'elemento Custom può essere letto dalle estensioni per il rendering personalizzate, ma viene ignorato dalle estensioni per il rendering incluse in Reporting Services. Ad esempio, è possibile utilizzare l'elemento Custom per archiviare commenti nel report.

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

Torna all'inizio

Parti del report

In Progettazione report, dopo aver creato tabelle, grafici e altri elementi del report in un progetto, è possibile pubblicarli come parti di report in un server di report o in un sito di SharePoint integrato con un server di report in modo da permetterne il riutilizzo in altri report. Per ulteriori 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 ulteriori informazioni, vedere Impostare le proprietà di distribuzione (Reporting Services).

Torna all'inizio

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 ulteriori informazioni, vedere Risorse.

Torna all'inizio

Layout del report

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 è piuttosto simile.

Torna all'inizio

Anteprima

Utilizzare Anteprima per verificare i dati del report e la progettazione del layout. Quando un report viene visualizzato in anteprima, il componente Elaborazione report consente di convalidare lo schema di definizione del report e la sintassi dell'espressione e di elencare i problemi nella finestra ms173745(v=sql.110).md.

[!NOTA]

Quando un report viene visualizzato in anteprima, i dati del report vengono memorizzati nella cache di 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 di 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:

• Visualizzazione Anteprima. Fare clic sulla 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, fare clic sui 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 dal menu Debug.

  • Nella barra degli strumenti standard di Visual Studio, fare clic sul pulsante Avvia.

  • Premere F5.

  Se si utilizza una configurazione del progetto che prevede la compilazione del report, ma non la distribuzione, 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 preveda la compilazione del report, ma non la distribuzione, ad esempio la configurazione DebugLocal. Fare clic con il pulsante destro del mouse sul report, quindi su Esegui. È necessario scegliere una configurazione che non preveda la distribuzione del report. In caso contrario, il report, anziché venire visualizzato in locale in una finestra di anteprima, verrà pubblicato nel server di report.

• Anteprima di stampa.

  La prima volta che viene visualizzato in modalità 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. Fare clic sul pulsante Anteprima di stampa sulla barra degli strumenti di anteprima. Il report verrà 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.

  • Interruzioni di pagina tra i gruppi che non funzionano nel modo desiderato.

  • Intestazioni e piè di pagina non visualizzate come previsto.

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

Torna all'inizio

Salvare e distribuire

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 ulteriori informazioni, vedere Proprietà di configurazione e distribuzione.

In Progettazione report è importante tenere presente che si progetta un report utilizzando lo schema di definizione del report supportato dalla versione corrente di Reporting Services in SQL Server Data Tools (SSDT). Quando si impostano le proprietà di distribuzione del progetto per un server di report o un sito di SharePoint specifico e 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. Ciò si verifica automaticamente, senza richiesta di conferma. Quando ciò 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 ulteriori informazioni, vedere Distribuzione e supporto della versione 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 ulteriori informazioni, vedere Controllo del codice sorgente.

Distribuire o pubblicare

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

Esportare un report in un formato di file diverso

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

Torna all'inizio

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.

Utilizzare 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 SQL Server Data Tools (SSDT) Output.

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 2008 R2 quali mappe e barre dei dati, 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.

Torna all'inizio

Vedere anche

Concetti

Reporting Services in SQL Server Data Tools (SSRS)

Strumenti per la progettazione di query in Progettazione report in SQL Server Data Tools (SSRS)

Distribuzione e supporto della versione in SQL Server Data Tools (SSRS)