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 Progettazione report. È possibile usare Progettazione report 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 Progettazione report.

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.

Per iniziare a progettare report, vedi Progettare report impaginati di Reporting Services con Progettazione report (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 Gestione configurazione in Visual Studio. Per altre informazioni, vedere Distribuzione e supporto delle versioni in SQL Server Data Tools (SSRS).

Progetti di report server

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 del server di report. Quando si seleziona un modello di progetto server di report, si apre Progettazione report. È 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 del progetto server di report. Quando si utilizza il modello di progetto Creazione guidata Report Server, viene creato automaticamente un progetto Report Server e si apre 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 a un'origine dati.
  • Impostare le credenziali dell'origine dati.
  • Progetta 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 Progettazione report nel progetto server di report.

Finestre e riquadri di Progettazione report

Progettazione report 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 sulla connessione di una fonte di 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 alcuni strumenti di progettazione query per i set di dati multidimensionali, è possibile specificare i filtri nel riquadro Filtri e indicare se creare parametri di 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 in questo elenco sono disponibili per essere incluse come elementi immagine del report 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 Dati report devono fare riferimento alle corrispondenti origini dati condivise e ai corrispondenti set di dati condivisi in 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 appare allo stesso livello di rientro dei propri gruppi di pari livello o fratelli.

  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, utilizzare il menu contestuale del gruppo fratello. 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 della 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.
• Gli elementi di report personalizzati potrebbero anche essere visualizzati nel riquadro Casella degli strumenti se l'amministratore di sistema li installa e li registra.

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 dal valore <espressione>. 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 Visualizzare 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 di 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.

È possibile usare la finestra Output per facilitare il debug degli errori 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>Altre finestre>Struttura documento.

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à.

Viste di Progettazione report

Progettazione report 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, Progettazione report 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 fornisce opzioni per aggiungere un'intestazione di 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, si trascinano gli elementi del report dal riquadro Strumenti all'area di progettazione. Configurare quindi le relative proprietà e modificarne la disposizione nel report.

Visualizzazione di anteprima

Nella visualizzazione Anteprima, è possibile eseguire il report e visualizzare il report renderizzato nel visualizzatore report. È 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, Progettazione report:

• Si connette alle fonti dati del report.
• Esegue query sui 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.
• La cache locale dei dati. 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.
• Gestione configurazione 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 Gestione configurazione. 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 Progettazione report

Quando in è attivo un progetto di Progettazione report 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 del 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 seguenti opzioni del menu Visualizza per visualizzare o nascondere le varie finestre e barre degli strumenti di Progettazione report:

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 Progettazione report

In Progettazione report, 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 Progettazione report.

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 della riga di comando per 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
  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
  Avvia il debug	F5
  Passa da una finestra aperta alla successiva	F6

• Elementi di controllo nell'area di progettazione del report:

  Descrizione	Combinazione di tasti
  Sposta il focus da un elemento del report all'elemento del report successivo	Tab
  Sposta l'elemento del report selezionato	Tasti freccia
  Sposta leggermente l'elemento del report selezionato	Ctrl+tasti freccia
  Consente di aumentare o ridurre le dimensioni dell'elemento del report selezionato	Ctrl+Shift+tasti freccia
  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
• Reporting Services Reports (SSRS)
• Linguaggio di definizione dei rapporti (SSRS)