Reporting Services in SQL Server Data Tools (SSDT)

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

SQL Server Data Tools (SSDT) è un ambiente di Microsoft Visual Studio per la creazione di soluzioni di Business Intelligence. SSDT include l'ambiente di creazione Report Designer. È possibile usare Report Designer per aprire, modificare, visualizzare in anteprima, salvare e distribuire definizioni di report impaginati, origini dati condivise, set di dati condivisi e parti di report di SQL Server Reporting Services (SSRS).

Questo articolo descrive soluzioni, progetti, modelli di progetto e configurazioni SSDT usati per SSRS. Descrive anche le visualizzazioni, i menu, le barre degli strumenti e i tasti di scelta rapida che è possibile usare in Report Designer.

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.

Per un'introduzione alla progettazione di report, vedere Progettazione dei report impaginati Reporting Services con Report Designer (SSRS).

Soluzioni e progetti

Un progetto report costituisce il contenitore per le definizioni e le risorse del report. Tutti i file inclusi nel progetto report vengono pubblicati nel server di report al momento della distribuzione del progetto. Quando si crea un progetto per la prima volta, viene creata anche una soluzione come contenitore per il progetto. A una singola soluzione è possibile aggiungere più progetti.

Configurazioni

Per creare più set di proprietà di progetto per distribuzioni diversificate, ad esempio server di report aziendali di test e produzione, utilizzare Configuration Manager in Visual Studio. Per altre informazioni, vedere Distribuzione e supporto delle versioni in SQL Server Data Tools (SSRS).

Progetti server di report

Quando si installa l'estensione SSRS per Visual Studio, come descritto in precedenza nella installazione di SSDT, i modelli di progetto seguenti vengono resi disponibili in SSDT:

• Progetto server di report. Quando si seleziona un modello di progetto server di report, si apre Report Designer. È possibile trovare questo modello di progetto di Business Intelligence nella finestra di dialogo Creazione di un nuovo progetto. Per altre informazioni, vedere Creazione di un progetto server di report.

  Le proprietà del progetto server di report si applicano a tutti i report e a tutte le origini dati condivise in un progetto SSDT. Queste proprietà includono l'URL del server di report e i nomi di cartella per i report e le origini dati condivise. Usare la finestra di dialogo delle pagine delle proprietà del progetto per visualizzare i valori correnti delle proprietà. Per aprire questa finestra di dialogo, selezionare Proprietà dal menu Progetto.

• Creazione guidata progetto server di report. Quando si seleziona un modello di progetto Creazione guidata server di report, verrà creato automaticamente un progetto server di report e verrà aperta la Creazione guidata report. Nella procedura guidata è possibile creare un report seguendo le istruzioni in ogni pagina. Le istruzioni descrivono come:

  • Creare una stringa di connessione in un'origine dati.
  • Impostare le credenziali dell'origine dati.
  • Progettare una query.
  • Aggiungere una tabella o un’area dati della matrice.
  • Specificare i dati e i gruppi del report.
  • Selezionare uno stile di carattere e di colore.
  • Pubblicare il report in un server di report.
  • Visualizzare in anteprima il report in locale.

  Dopo aver creato un report con la procedura guidata, è possibile modificarne i dati e la finestra di progettazione tramite Report Designer nel progetto server di report.

Finestre e riquadri di Report Designer

Report Designer offre più finestre e riquadri che consentono di progettare report e visualizzare i report visualizzabili.

Riquadro dei dati del report

Nel riquadro dei dati del report vengono visualizzati gli oggetti dei dati che è possibile usare in un report.

Per aprire il riquadro dei dati del report, spostare lo stato attivo sull'area di progettazione. Quindi, dal menu Visualizza, scegliere Dati del report.

Nel riquadro dei dati del report sono disponibili i tipi di oggetti seguenti:

• Campi predefiniti. Tali campi contengono informazioni predefinite sul report, ad esempio il nome o l'ora in cui è stato elaborato.
• Origini dati. Un'origine dati rappresenta il nome e le informazioni di collegamento di un'origine dati.
• Set di dati. Ogni set di dati include una query che consente di specificare i dati da riprendere dall'origine dati. È possibile espandere il set di dati per visualizzare la raccolta di campi specificati dalla query del set di dati. In alcune finestre Progettazione query per i set di dati multidimensionali, è possibile specificare i filtri nel riquadro Filtri e indicare se creare i parametri del report. Se si specifica l'opzione relativa ai parametri del report, viene automaticamente creato un set di dati speciale per popolare l'elenco dei valori validi del parametro. Per impostazione predefinita, questo set di dati non viene visualizzato nel riquadro dei dati del report. Per altre informazioni, vedere Mostra set di dati nascosti per i valori dei parametri di dati multidimensionali.
• Parametri del report. Se una query del set di dati include parametri di query, è possibile creare i parametri manualmente o automaticamente.
• Immagini. Le immagini di questo elenco sono disponibili per l’inclusione come elementi del report Immagine in un report.

Le origini dati e i set di dati nel riquadro dei dati del report rappresentano gli elementi inclusi nella definizione del report. Il riquadro dei dati del report è una caratteristica supportata da più ambienti di creazione di report.

• In Report Builder, è l'unico riquadro disponibile per la gestione delle origini dati e dei set di dati.
• In Progettazione report il riquadro dei dati del report funziona con Esplora soluzioni in cui le origini dati condivise e i set di dati condivisi vengono elencati come file. Le origini dati condivise e i set di dati condivisi nel riquadro dei dati del report devono puntare alle origini dati condivise e ai set di dati condivisi corrispondenti di Esplora soluzioni. Gli elementi del riquadro dei dati del report contengono un riferimento ai file di dati di Esplora soluzioni. Le proprietà del progetto determinano se le origini dati condivise e i set di dati condivisi vengono distribuiti nel server di report o nel sito di SharePoint. Per altre informazioni, vedere Convertire le origini dati (Report Builder e SSRS).

Se il riquadro dei dati del report è mobile, è possibile ancorarlo. Per altre informazioni, vedere Ancorare il riquadro dei dati del report in Progettazione report (SSRS).

Riquadro di raggruppamento

Usare il riquadro di raggruppamento per definire i gruppi per un'area dati Tablix. È possibile definire gruppi di righe e gruppi di dettagli per le tabelle, nonché gruppi di righe e colonne per le matrici. Non è possibile usare il riquadro di raggruppamento per definire gruppi per grafici o altre aree dati. Per altre informazioni, vedere Gruppi in un report impaginato di Report Builder.

Il riquadro di raggruppamento presenta due modalità:

• Valore predefinito. Usare la modalità predefinita per visualizzare tutti i gruppi di righe e di colonne in un formato gerarchico che consente di visualizzare le relazioni esistenti tra gruppi padre, gruppi figlio, gruppi adiacenti e gruppi di dettagli. Un gruppo figlio viene visualizzato al di sotto e al livello di rientro successivo rispetto al relativo gruppo padre. Un gruppo adiacente viene visualizzato allo stesso livello di rientro dei gruppi di pari livello.

  Usare la modalità predefinita per aggiungere, modificare o eliminare gruppi. Per i gruppi basati su un singolo campo del set di dati, trascinare il campo nel riquadro Gruppi di righe o Gruppi di colonne. È possibile inserire il gruppo vicino a un gruppo esistente. Per aggiungere un gruppo adiacente, usare il menu di scelta rapida del gruppo di pari livello. Per visualizzare le celle della Tablix appartenenti a un gruppo, selezionare il gruppo nel riquadro di raggruppamento.

• Avanzate. Usare la modalità Avanzata per visualizzare membri di gruppi di righe e di colonne statici e dinamici dell'area dati Tablix selezionata. In modalità Avanzata, è possibile anche impostare le proprietà che consentono di controllare la visibilità delle righe e delle colonne associate a un gruppo o a un membro di un gruppo. Tali proprietà determinano le regole usate dai renderer per tentare di tenere insieme i gruppi in una pagina. I membri dei gruppi vengono visualizzati nell'area di progettazione come celle nelle aree dei gruppi di righe e di colonne.

Per altre informazioni, vedere Riquadro di raggruppamento.

Riquadro Casella degli strumenti

La casella degli strumenti contiene elementi del report che è possibile trascinare nell'area di progettazione.

• Le aree dati sono elementi del report che è possibile utilizzare per organizzare i dati nel report. Esempi di aree dati sono tabelle, matrici, elenchi, grafici, manometri, barre dei dati, grafici sparkline e indicatori.
• Altri elementi del report sono mappe, caselle di testo, rettangoli, linee, immagini e sottoreport.
• In questo elenco possono anche essere inclusi elementi del report personalizzati, se sono stati installati e registrati dall'amministratore di sistema.

Riquadro Proprietà

Il riquadro Proprietà è una finestra standard di Visual Studio in cui vengono visualizzati i nomi e i valori delle proprietà relative all'elemento del report attualmente selezionato nell'area di progettazione.

Per visualizzare il riquadro Proprietà, selezionare Finestra Proprietà dal menu Visualizza. È possibile annullare l'ancoraggio a questo riquadro e spostarlo in un'altra area della finestra SSDT oppure aprirlo come visualizzazione TAB nell'area di progettazione.

Nella maggior parte dei casi, i nomi delle proprietà corrispondono agli elementi e agli attributi contenuti nel file Report Definition Language (RDL). Le proprietà utilizzate più di frequente possono essere impostate usando la finestra di dialogo Proprietà relativa all'elemento selezionato. Per aprire la finestra di dialogo Proprietà di un elemento, selezionare l’articolo e poi il pulsante Pagine delle proprietà dalla barra degli strumenti relativa alle Proprietà. Gli utenti Advanced possono impostare i valori delle proprietà direttamente nel riquadro Proprietà.

È possibile usare il riquadro Proprietà per i seguenti task:

• Impostare le proprietà per l'elemento attualmente selezionato nell'area di progettazione. Per alcune proprietà è disponibile un elenco a discesa di valori. È inoltre possibile immettere il valore direttamente nella cella. Alcune proprietà contengono una raccolta di valori, indicata dal valore (Raccolta). La maggior parte delle proprietà può accettare un'espressione. Le espressioni complesse sono indicate dalla <expressione del valore>. Per aprire la finestra di dialogo Expressione, selezionare il pulsante Espressione (fx). Per altre informazioni, vedere Finestra di dialogo Espressione.
• Usare i pulsanti della barra degli strumenti del riquadro Proprietà per modificare la modalità di visualizzazione della griglia passando dalla visualizzazione per categorie alla visualizzazione in ordine alfabetico. In Visualizzazione categorie, potrebbe essere necessario espandere una categoria per visualizzare tutte le proprietà sottostanti. Per aprire la finestra di dialogo Proprietà di un elemento, selezionare il pulsante Pagine delle proprietà sulla barra degli strumenti. Oppure, fare clic con il pulsante destro del mouse sull’elemento e selezionare Proprietà.
• Impostare le proprietà per il membro del gruppo attualmente selezionato nel riquadro di raggruppamento. Le proprietà dei membri del gruppo consentono di controllare in che modo le righe dell'intestazione e del piè di pagina di un gruppo statico si ripetono per ogni istanza di un gruppo. Per altre informazioni, vedere Visualizzazione di intestazioni e piè di pagina con un gruppo in un report impaginato (Report Builder).

Esplora soluzioni

Esplora soluzioni è un componente standard di Visual Studio in cui vengono visualizzati tutti gli elementi del progetto. Per un progetto server di report, questo elenco di elementi include cartelle per organizzare origini dati condivise, set di dati condivisi, report e risorse. Gli elementi della cartella vengono automaticamente disposti in ordine alfabetico quando si apre il file di soluzione. Per visualizzare le proprietà dell'elemento nel riquadro Proprietà, selezionare questo elemento.

Finestra Output

Nella finestra Output vengono visualizzati gli errori di elaborazione che si verificano quando si visualizza l'anteprima di un report. Questa finestra visualizza anche gli errori di pubblicazione che si verificano quando si distribuisce un report o un'origine dati condivisa.

Usare la finestre di output per eseguire il debug degli errori contenuti nelle espressioni.

Riquadro struttura documento

Nella finestra Struttura documento viene visualizzato un elenco gerarchico di tutti gli elementi del report inclusi nella definizione del report. Per aprire il riquadro Struttura documento, è possibile selezionare Visualizza>altra struttura documento>di Windows.

Usare il riquadro Struttura documento per identificare le caselle di testo e altri elementi del report in base al nome. Quando si seleziona un elemento nel riquadro Struttura documento, l’elemento viene anche selezionato nell'area di progettazione.

È inoltre possibile usare il riquadro Struttura documento per eseguire il debug degli errori contenuti nelle espressioni.

Finestra Elenco attività

Nella finestra Elenco attività vengono visualizzati gli errori di compilazione che si verificano quando si importa un report da un'altra applicazione. Ad esempio, se si importa un report da Microsoft Access e il report contiene una caratteristica non supportata da SSRS, viene segnalato un errore nella finestra Elenco attività.

Visualizzazioni Report Designer

Report Designer supporta due visualizzazioni:

• Progettazione, per definire i dati e il layout di un report
• Anteprima, per visualizzare il report per cui è stato eseguito il rendering.

Visualizzazione Progettazione

Per impostazione predefinita, quando si crea un progetto server di report, Report Designer viene aperto in visualizzazione Progettazione e consente di visualizzare l'area di progettazione. Per impostazione predefinita, nell'area di progettazione vengono visualizzati il corpo e lo sfondo del report.

Lo sfondo dell'area di progettazione include un menu di scelta rapida. Questo menu offre opzioni per l'aggiunta di un'intestazione pagina e un piè di pagina. Contiene anche un menu Visualizza che è possibile usare per visualizzare il righello, il riquadro di raggruppamento e il riquadro Parametri.

Usare il controllo Zoom per aumentare o diminuire l'ingrandimento del report.

Per progettare un report, trascinare gli elementi del report dal riquadro Casella degli strumenti all'area di progettazione. Configurare quindi le relative proprietà e modificarne la disposizione nel report.

Visualizzazione Anteprima

Usare Anteprima per eseguire il report e aprire il report visualizzabile nel Report Viewer. È anche possibile impostare le proprietà di configurazione in modo da eseguire il report in modalità di debug, tramite un browser.

Quando si visualizza l'anteprima di un report, Report Designer:

• Si connette alle origini dati del report.
• Esegue query del set di dati.
• Memorizza nella cache i dati nel computer locale.
• Elabora il report per combinare dati e layout.
• Consente di eseguire il rendering del report.

Quando si usa la visualizzazione Anteprima, tenere presente alcuni aspetti:

• Report con parametri. Quando si visualizza l'anteprima di un report, quest'ultimo viene automaticamente elaborato se tutti i relativi parametri includono valori predefiniti validi. Se uno o più parametri del report non includono un valore predefinito valido, è necessario scegliere un valore per ogni parametro non assegnato. Sulla barra degli strumenti del report è quindi necessario selezionare Visualizzazione report.
• Cache dati locali. Quando si visualizza l'anteprima di un report, l'elaboratore di report esegue tutte le query per i set di dati nel report usando le impostazioni predefinite dei parametri correnti. Salva i risultati come file della cache dei dati locale (con estensione rdl.data). È possibile continuare a progettare il report senza incorrere nell'overhead associato a un nuovo recupero dei dati, se non vengono apportate modifiche alle query del set di dati o ai parametri del report.
• Configuration Manager e debug. In SSDT, le proprietà del progetto consentono di definire come distribuire i report ed eseguirne il debug. Queste proprietà si applicano a tutti i report e a tutte le origini dati condivise del progetto. Per impostare le proprietà del progetto, scegliere Proprietà dal menu Progetto. Nella finestra di dialogo Pagine delle proprietà, selezionare dunque Configuration Manager. Usare queste impostazioni per testare i report e pubblicarli nel server di report.
• Il riquadro di output. Quando si visualizza l'anteprima di un report e viene rilevato un problema, il componente Elaborazione report scrive i messaggi di errore nel riquadro di output.

Menu di Report Designer

Quando in è attivo un progetto di Report Designer in SSDT, al menu principale vengono aggiunti i seguenti menu.

Menu Formato

Quando si seleziona un elemento nell'area di progettazione, il menu Formato contiene le opzioni seguenti:

Menu report e menu di scelta rapida dell'area di progettazione

È possibile usare le opzioni seguenti per configurare le impostazioni applicabili a un intero report. La disponibilità e la posizione di queste opzioni dipendono dalla versione di Visual Studio usata:

• Nelle versioni precedenti è possibile trovare queste opzioni nel menu Report.
• Nelle versioni successive, la maggior parte delle opzioni è disponibile nel menu di scelta rapida dello sfondo dell'area di progettazione.

Menu Visualizza

È possibile usare le opzioni di menu Visualizza seguenti to show per visualizzare o nascondere varie finestre e barre degli strumenti:

Menu Progetto

Usare le opzioni del menu Progetto per gestire origini dati condivise e report in un progetto. Quando si aggiungono o rimuovono elementi dal progetto, la vista gerarchica degli elementi del progetto in Esplora soluzioni viene automaticamente aggiornata.

Barre degli strumenti di Report Designer

In Report Designer, sono disponibili le seguenti barre degli strumenti speciali da utilizzare per la progettazione di report:

È possibile usare il menu Visualizza per visualizzare o nascondere queste barre degli strumenti. È possibile che altre barre degli strumenti di Visual Studio siano disabilitate se le relative funzionalità non sono applicabili alle funzionalità di Report Designer.

Controllo del codice sorgente

SSDT può essere integrato con i plug-in di origine. È possibile usare le pagine Controlli del codice sorgente nella finestra di dialogo Opzioni per specificare un plug-in e configurare le proprietà.

Modelli di report personalizzati

Per utilizzare report personalizzati come modelli per nuovi report, è sufficiente copiarli nella cartella ReportProject nel computer in cui è installato SSDT.

La posizione predefinita di questa cartella dipende dalla versione e dall'edizione di Visual Studio in uso. Per Visual Studio 2022, 2019 e 2017, questa cartella si trova nella posizione seguente:

%ProgramFiles%\Microsoft Visual Studio\<release-year>\<edition>\Common7\IDE\CommonExtensions\Microsoft\SSRS\ProjectItems\ReportProject

Per Visual Studio 2015, la posizione predefinita è la cartella seguente:

%ProgramFiles%\Microsoft Visual Studio 14.0\Common7\IDE\Private Assemblies\ProjectItems\ReportProject

Quando si aggiunge un nuovo elemento al progetto report, il report personalizzato viene visualizzato nel riquadro dei Modelli. È inoltre possibile aggiungere stili personalizzati alla procedura guidata del report.

Supporto per la riga di comando di SSDT

SSDT si basa si Visual Studio e sull'applicazione devenv.exe sottostante. Questa applicazione offre diverse opzioni della riga di comando utili per lavorare sui report.

Prima di poter usare le opzioni della riga di comando descritte in questa sezione, è necessario impostare valori validi per i due elementi seguenti:

• Proprietà di progetto per OverwriteDataSources, TargetDataSourceFolder, TargetReportFolder e TargetServerURL.
• Almeno un set di proprietà di configurazione, ad esempio Debug o Release.

Per altre informazioni, vedere Pubblicazione di origini dati e report.

Per un progetto server di report, è possibile specificare le opzioni seguenti dalla riga di comando:

• /deploy: Distribuisce i report tramite le proprietà del progetto specificate in un file di configurazione. Ad esempio, il comando seguente distribuisce i report specificati dal file della soluzione Reports.sln. Usa le impostazioni di configurazione release specificate nelle proprietà del progetto:

  devenv.exe "C:\Users\<user-name>\source\repos\Reports\Reports.sln" /deploy "Release"
  

• /build: Compila il file di soluzione, ma non lo distribuisce. Ad esempio, il comando seguente compila i report specificati dal file della soluzione Reports.sln. Usa le impostazioni di configurazione di debug specificate nelle proprietà del progetto:

  devenv.exe "C:\Users\<user-name>\source\repos\Reports\Reports.sln" /build "Debug"
  

• /out: Reindirizza l'output generato dalla compilazione di una soluzione nel file specificato. Ad esempio, il comando seguente consente di reindirizzare l'output dalla compilazione dell'esempio precedente in un file denominato mybuildlog.txt.

  devenv.exe "C:\Users\<user-name>\source\repos\Reports\Reports.sln" /build "Debug" /out mybuildlog.txt
  

Abbreviazioni da tastiera in SSDT

È possibile usare le abbreviazioni da tastiera per:

• Controllare le finestre e le modalità di SSDT:

  Descrizione	Combinazione di tasti
  Consente di compilare il progetto selezionato	CTRL+Shift+B
  Consente di visualizzare la finestra Proprietà	F4
  Consente di visualizzare il riquadro dei dati del report	CTRL+ALT+D
  Consente di iniziare il debug	F5
  Consente di spostarsi da una finestra aperta a quella successiva	F6

• Consente di controllare gli elementi nell'area di progettazione del report

  Descrizione	Combinazione di tasti
  Consente di spostare lo stato attivo da un elemento del report all'elemento successivo	Tab
  Consente di spostare l'elemento del report selezionato	Tasti di direzione
  Consentono di spostare l'elemento del report selezionato	CTRL+Tasti di direzione
  Consente di aumentare o ridurre le dimensioni dell'elemento del report selezionato	CTRL+Shift+Tasti di direzione
  In una casella di testo, consente di spostare il cursore all'inizio del testo visualizzato	CTRL+Home
  In una casella di testo, consente di spostare il cursore alla fine del testo visualizzato	CTRL+Fine
  In una casella di testo, consente di selezionare il testo dalla posizione corrente del cursore all'inizio del testo visualizzato	MAIUSC+Home
  In una casella di testo, seleziona il testo dalla posizione corrente del cursore alla fine del testo visualizzato	MAIUSC+Fine
  In una casella di testo, seleziona il testo dalla posizione corrente del cursore all'inizio dell'espressione	CTRL+MAIUSC+INIZIO
  In una casella di testo, seleziona il testo dalla posizione corrente del cursore alla fine dell'espressione	CTRL+MAIUSC+FINE
  Consente di aprire il menu di scelta rapida dell'elemento del report selezionato	MAIUSC+F10

Contenuto correlato

• Esplora soluzioni
• Report Reporting Services (SSRS)
• Report Definition Language (SSRS)