Set di dati incorporati nel report e set di dati condivisi (Generatore di report e SSRS)

Un set di dati consente di specificare i dati che si desidera utilizzare da una connessione dati. Un set di dati è basato su una connessione dati salvata nel report come origine dati incorporata o come riferimento a un'origine dati condivisa in un server di report. Nel set di dati è inclusa una query che specifica un set di campi. Quando si trascinano questi campi nell'area di progettazione, è possibile creare espressioni che restituiscono i dati effettivi quando si esegue il report.

Esistono due tipi di set di dati:

• Set di dati condivisi. Un set di dati condiviso viene definito nel server di report. È possibile individuare il server per creare un set di dati condiviso o per selezionarne uno predefinito da aggiungere al report. Utilizzare un set di dati condiviso per fornire una query che può essere utilizzata da più report. I set di dati condivisi vengono archiviati nel server di report e possono essere gestiti separatamente dai report o dalle origini dati condivise. Ad esempio, un amministratore del server di report potrebbe aggiornare la query per sfruttare l'indicizzazione avanzata o un'altra ottimizzazione delle prestazioni di esecuzione delle query.

• Set di dati incorporato. Un set di dati incorporato viene definito e usato esclusivamente dal report in cui è incorporato. Utilizzare un set di dati incorporato quando si desidera ottenere dati da un'origine dati esterna da utilizzare solo in un unico report. I set di dati incorporati risultano utili quando si desidera creare una query senza altre dipendenze che non sia necessario utilizzare per più report.

Un set di dati include anche parametri, filtri e opzioni dei dati che specificano le proprietà di confronto dei caratteri, ad esempio differenza tra maiuscole e minuscole, tipo kana, larghezza, accenti e informazioni sulle regole di confronto.

1. Set di dati nel riquadro dei dati del report Un set di dati viene visualizzato nel riquadro dei dati del report in seguito alla creazione di un set di dati incorporato o l'aggiunta di un set di dati condiviso. Un set di dati è basato su un'origine dati.

2. Progettazione query Quando si progetta una query di database, viene visualizzata la finestra Progettazione query che è associata al tipo di origine dati.

3. Comando di query La finestra di progettazione delle query consente di creare un comando di query. La sintassi del comando è determinata dal provider di dati.

4. Estensione per i dati/Provider di dati La connessione ai dati può avvenire attraverso più livelli di accesso ai dati.

5. Origini dati esterne È possibile recuperare dati da database relazionali, database multidimensionali, elenchi SharePoint, servizi Web o modelli di report.

6. Risultati della query È possibile eseguire la query e vedere un set di risultati di esempio. Per eseguire una query, è necessario disporre di credenziali per la fase di progettazione.

7. Metadati dello schema Il provider di dati esegue un comando di query dello schema separato dalla query principale per recuperare i metadati per la raccolta di campi del set di dati. Ad esempio, un'istruzione Transact-SQL SELECT restituisce i nomi di colonna per una tabella di database. Usare il riquadro Dati report per espandere il set di dati e visualizzarne la raccolta di campi.

I dati inoltre possono essere inclusi in un report utilizzando set di dati condivisi predefiniti e parti del report. Tali elementi dispongono già delle informazioni necessarie sulla connessione dati. Per ulteriori informazioni, vedere Set di dati del report (SSRS) e Componenti del report (Generatore di report e SSRS).

Per ulteriori informazioni sui tipi di origine dati incorporati e sulle estensioni dati, vedere Aggiungere dati da origini dati esterne (SSRS).

Informazioni sui set di dati del report e sulle query

In un set di dati del report è contenuto un comando di query che viene eseguito sull'origine dati esterna e consente di specificare i dati da recuperare. Per creare il comando di query, utilizzare lo strumento di progettazione di query associato all'estensione dati per l'origine dati esterna. Nella progettazione query è possibile eseguire il comando della query e visualizzare un set di risultati. Il set di risultati è un set di righe rettangolare che dispone di nomi di colonna e di righe con lo stesso numero di valori in ogni riga. I dati gerarchici, noti anche come gerarchie incomplete, non sono supportati. I nomi di colonna vengono salvati nella definizione del report come elenco di campi del set di dati.

Dopo aver aggiunto i set di dati al report, trascinare i campi dalle relative raccolte nel riquadro Dati report a tabelle, grafici e altri elementi del report usati per progettare il layout del report. Per ulteriori informazioni sull'uso dei campi, vedere Raccolta di campi del set di dati (Generatore report e SSRS).

Comprendere i dati di un dataset del report

A seconda dell'estensione per i dati, un set di dati del report può essere costituito dai tipi di dati seguenti:

• Un set di risultati di un database relazionale restituito in seguito all'esecuzione di comandi di database, stored procedure o funzioni definite dall'utente. Se vengono recuperati più set di risultati tramite una singola query, solo il primo set di risultati viene elaborato e tutti gli altri vengono ignorati. Quando, ad esempio, si esegue la query riportata di seguito in Progettazione query basata su testo, nel riquadro dei risultati viene visualizzato solo il set di risultati per Production.Product :

  SELECT ProductID FROM Production.Product  
  GO  
  SELECT ContactID FROM Person.Contact  
  

• Un rowset appiattito da origini dati multidimensionali che utilizzano il protocollo XML for Analysis (XMLA). Alcuni provider di dati forniscono ulteriori proprietà di celle e dimensioni dall'origine dati, che non è possibile visualizzare nel set di risultati ma che sono disponibili nel report.

• Un set di risultati appiattito da origini dati XML che include elementi XML, i relativi attributi e i relativi elementi figlio.

• Un set di risultati restituito da qualsiasi provider di dati .NET Framework registrato e configurato.

• Dati da un modello di report progettato per una specifica origine dati, con entità, relazioni di entità e campi predefiniti. Per altre informazioni, vedere "Set di dati del report" nella documentazione di Reporting Services.

Quando il report viene elaborato in fase di esecuzione, il set di risultati effettivi restituito per una query può includere zero o più righe. È anche possibile che le colonne definite nella query non siano presenti nell'origine dati. I valori null provenienti dall'origine dati vengono mappati al valore .NET Framework System.DBNull.Value.

Per ulteriori informazioni sui campi del set di dati, vedere Raccolta dei campi del set di dati (Generatore report e SSRS).

Query del set di dati

Quando si esegue una query di un set di dati in una finestra di progettazione query, in fase di progettazione viene visualizzato un insieme di righe dall'origine dati che mostra dati di esempio. In fase di esecuzione, quando un utente visualizza il report, la query del set di dati potrebbe produrre valori differenti in quanto i dati dell'origine dati sono stati modificati. Ogni volta che il report viene elaborato, potrebbero essere visualizzati nuovi dati.

Quando si definisce ciascun set di dati, Generatore report apre la finestra di progettazione query appropriata per il tipo di origine dati, per facilitare la progettazione delle query. Per definire ad esempio una query per dati provenienti da un database relazionale di SQL Server, nelle procedure guidate relative a tabella, matrice, grafico e mappa viene visualizzata un'interfaccia grafica semplice che consente di compilare la query; infatti, si dovranno solo scegliere i campi desiderati nel set di dati.

In un progettista di query, è possibile eseguire le operazioni seguenti:

• Passare dalla visualizzazione della query in formato grafico a quella basata su testo. Utilizzare l'interfaccia grafica per esplorare schemi, tabelle, viste e procedure memorizzate nell'origine dati. Usare la visualizzazione testuale per digitare, incollare o visualizzare una query esistente, in genere per query complesse che non possono essere visualizzate in una finestra di progettazione grafica delle query. Ad esempio, è possibile importare una query da un file Transact-SQL (con estensione sql), un report diverso sul server di report o un file di definizione del report (con estensione rdl) da una condivisione di file.

• Eseguire la query per visualizzare i dati. La query restituisce un set di risultati. Le colonne del set di risultati diventano la raccolta dei campi per il set di dati. Le righe del risultato diventano i dati per il set di dati. È possibile utilizzare la query fino a ottenere le colonne desiderate.

• Aggiungere parametri di query per recuperare solo i dati desiderati per il report. I parametri di query automaticamente generano i parametri del report corrispondenti. Per un'origine dati di un modello di report, il filtro specificato genera automaticamente un parametro di report corrispondente. I parametri del report consentono agli utenti di specificare i dati del report da visualizzare quando si esegue il report. Ad esempio, l'utente seleziona le categorie di prodotto per le quali si desiderano i dati e, quando si esegue il report, vengono visualizzati i dati solo per quelle categorie di prodotto nel report.

• Importare una query esistente da un altro report.

Le utilità di progettazione delle query possono offrire una modalità grafica o una modalità testuale, a seconda del tipo di origine dati. Se si sceglie la modalità testo, è necessario utilizzare la sintassi di query adatta per l'origine dati.

Quando si definisce un set di dati del report, è possibile impostare le proprietà dei dati nella query oppure accettare quelle predefinite impostate dal provider di dati. È inoltre possibile modificare un tipo di dati mediante una delle strategie seguenti:

• Riscrivi la query del dataset per convertire specificamente un campo in un tipo di dati diverso.

• Modificando il campo nel set di dati e specificando un formato personalizzato.

• Creando un nuovo campo personalizzato basato su un campo del database e specificando un formato personalizzato.

Per altre informazioni, vedere Raccolta dei campi del set di dati (Generatore report e SSRS).

Importazione delle query esistenti per un set di dati

Quando si crea un set di dati, è possibile creare una nuova query o importarne una esistente da un file o da un altro report. Quando si importa una query da un altro report, è possibile scegliere la query da importare dall'elenco di set di dati nel report.

Sono supportati solo i tipi di file con estensione sql e rdl. Le query MDX (espressioni multidimensionali), le query DMX (Data Mining Prediction) e le query di modello (SMQL) possono essere generate solo dalla finestra di progettazione query associata.

Confronto e creazione di set di dati condivisi e set di dati incorporati

Un set di dati incorporato è definito in un report o in una parte di report pubblicata. Le modifiche apportate a un set di dati incorporato influiscono solo su quel report o su quella parte di report.

Un set di dati condiviso è definito su un server di report o un sito di SharePoint, è basato su un'origine dati condivisa e può essere utilizzato da più report e parti di report. Le modifiche apportate a una definizione del set di dati condiviso influiscono su tutti i report e su tutte le parti di report che la utilizzano.

Quando si aggiunge un set di dati condiviso a un report, la raccolta campi del set di dati viene aggiornata alla definizione corrente sul server di report. Non si ricevono notifiche di aggiornamento quando le modifiche vengono apportate sul server di report. Per sincronizzare una copia locale della raccolta campi con le modifiche apportate alla definizione del set di dati condiviso sul server di report, è necessario aggiornare la raccolta campi locale. Per altre informazioni, vedere Aggiungere, modificare e aggiornare campi nel riquadro dei dati del report (Generatore report e SSRS).

Negli elementi del report pubblicati sono contenuti i set di dati incorporati e condivisi dai quali dipendono. Per altre informazioni, vedere Parti del report e set di dati in Generatore report.

La differenza tra le origini dati incorporate e quelle condivise dipende dalle diverse modalità di creazione, archiviazione e gestione. Nella tabella seguente vengono riepilogate le differenze fra le origini dati incorporate e quelle condivise:

Descrizione	Integrato Fonte dati	Condiviso Fonte dati
La connessione dati è incorporata nella definizione del report.
Il puntatore alla connessione dati sul server di report è incorporato nella definizione del report.
Gestita nel server di report
Richiesta per i set di dati condivisi
Obbligatorio per i componenti

In Progettazione report è possibile creare set di dati condivisi come parte di un progetto report e controllare se distribuirli a un server di report. Non è possibile accedere a un server di report e selezionare un set di dati condiviso da aggiungere al report in uso.

In Generatore report è possibile eseguire le operazioni seguenti:

• Per creare un set di dati condiviso, utilizzare visualizzazione di progettazione del set di dati condiviso. È possibile salvarlo in un server di report o in un sito di SharePoint per condividere con altri report. È inoltre possibile accedere al server di report e modificare il set di dati condiviso esistente. In questa visualizzazione è possibile compilare una query e impostare tutte le opzioni del set di dati. Per ulteriori informazioni, vedere Visualizzazione struttura del dataset condiviso (Generatore report).

• Per aggiungere un set di dati condiviso al report, aprire Generatore report in visualizzazione di progettazione report. Da una procedura guidata o dal riquadro Dati report, passare al server di report e selezionare il set di dati condivisi da aggiungere al report. In questa visualizzazione non è possibile modificare la query eccetto per aggiungere campi. È possibile eseguire l'override di altre opzioni dei dati e aggiungere filtri. Non è possibile rimuovere filtri.

Nella tabella seguente vengono confrontate le proprietà configurabili per la definizione del set di dati condiviso nel server di report e quelle configurabili per l'istanza del set di dati condiviso nella definizione del report.

Per altre informazioni sulla creazione di set di dati, vedere Creazione di un set di dati condiviso o un set di dati incorporato (Generatore report e SSRS) e Strumenti di Reporting Services nella documentazione relativa a Reporting Services.

Filtro, ordinamento e raggruppamento di dati in un set di dati

I dati in un set di dati provengono dall'esecuzione di un comando di query su un'origine dati esterna. La sintassi del comando di query per un'estensione per i dati consente di determinare se i dati possono essere ordinati o raggruppati. L'ordinamento e il raggruppamento vengono eseguiti nella query prima del recupero dei dati per un report. L'operazione di filtro viene eseguita invece dopo il recupero dei dati per un report.

Per altre informazioni, vedere Filtro, raggruppamento e ordinamento di dati (Generatore report e SSRS).

Filtro dei dati in un set di dati

I filtri del set di dati fanno parte della definizione del set di dati in un report. Utilizzare i filtri del set di dati per specificare quali dati di un set di dati includere in un report. Quando si specificano i filtri su un set di dati, in tutte le aree dati basate sul set di dati vengono visualizzati solo i dati che passano i filtri del set di dati.

I filtri fanno parte della definizione di un set di dati condiviso. I filtri del set di dati condiviso influiscono su tutti i report che includono il set di dati condiviso. Dopo avere aggiunto un set di dati condiviso al report o dopo avere aggiunto un componente con un set di dati condiviso dipendente, è possibile creare filtri del set di dati aggiuntivi. I filtri creati vengono utilizzati solo nel report in uso, non sono parte della definizione del set di dati condiviso sul server di report.

È possibile impostare filtri aggiuntivi su un'area dati o un gruppo di aree dati. Inoltre è possibile utilizzare una combinazione di parametri e filtri per consentire agli utenti di scegliere i dati che desiderano visualizzare nel report. Per ulteriori informazioni, vedere Parametri del report (Generatore di report e Progettazione di report).

Ordinamento dei dati in un set di dati

In un set di dati, l'ordinamento dei dati rappresenta l'ordine in base al quale i dati vengono recuperati dall'origine dati esterna. È lo stesso ordine che si vede quando si esegue la query nella finestra di progettazione query. Se la sintassi del comando di query supporta l'ordinamento, è possibile modificare la query per ordinare i dati nell'origine, prima che venga restituita come dati del report. Per una query Transact-SQL, ad esempio, l'istruzione ORDER BY consente di controllare il tipo di ordinamento.

Per ordinare i dati dopo la restituzione al report, definire le espressioni di ordinamento su aree dati e gruppi di aree dati. Per altre informazioni, consultare l'argomento relativo al tipo specifico di area dati, ad esempio Tabelle, matrici ed elenchi (Generatore report e SSRS).

Inoltre è possibile utilizzare una combinazione di parametri ed espressioni di ordinamento per consentire agli utenti di scegliere il tipo di ordinamento dei dati in un report. Per ulteriori informazioni, vedere Parametri del report (Generatore di report e Progettazione di report).

Raggruppamento di dati in un set di dati

Non è possibile raggruppare dati in un set di dati. Per l'aggregazione di dati in un set di dati, è possibile modificare il comando di query per calcolare le aggregazioni prima del recupero dei dati per un report. Tali valori sono noti come aggregazioni server. Nelle espressioni, per identificare questi valori come aggregazioni precalcolate, utilizzare la funzione Aggregate. Per ulteriori informazioni, vedere Funzione di aggregazione (Generatore report e SSRS).

Utilizzo di parametri e di set di dati

Per una query di un set di dati incorporato che contiene variabili di query, vengono creati automaticamente i parametri di query e i corrispondenti parametri di report. Durante l'esecuzione del report, il valore del parametro del report è collegato al parametro di query del set di dati. In questo modo, il comando di query che viene eseguito sull'origine dati esterna consente di includere i valori specificati per i parametri del report. I parametri del report consentono a un utente di scegliere i dati da visualizzare nel report. È possibile visualizzare come i parametri di query e i parametri di report sono collegati nella pagina Parametri della finestra di dialogo Proprietà del set di dati.

Per un set di dati condiviso, i parametri di query sono parte della definizione del set di dati condiviso che può essere gestita sul server di report indipendentemente da un report. Nell'elenco seguente viene descritto il supporto per i valori dei parametri di query:

• Può essere basato su espressioni.

• Può includere valori predefiniti.

• Può essere impostato per la sola lettura. Non è possibile modificare i parametri di sola lettura in un'istanza del set di dati condiviso in un report.

• Non può includere riferimenti alla raccolta predefinita Parameters, che rappresenta i parametri del report.

Per configurare i valori dei parametri di query per un set di dati condiviso, in modalità di progettazione del set di dati individuare e aprire un set di dati condiviso dal server di reportistica e impostare le opzioni dalla pagina Parametri della finestra di dialogo Proprietà set di dati. Per altre informazioni, vedere Creare un set di dati condiviso o un set di dati incorporato (Generatore report e SSRS).

Per alcune origini dati multidimensionali, ad esempio Analysis Services, la finestra Progettazione query con interfaccia grafica consente di specificare filtri query e di selezionare un'opzione per creare un parametro query corrispondente. Quando selezioni l'opzione parametro, l'estensione dati crea automaticamente un dataset di report separato per fornire i valori disponibili per una lista a tendina per quel parametro. Per impostazione predefinita, questi set di dati nascosti non vengono visualizzati nel riquadro dei dati del report.

I parametri del report collegati ai parametri di query consentono di filtrare i dati prima che questi vengano restituiti dall'origine dati esterna. È inoltre possibile filtrare i dati nel report creando filtri che sono parte della definizione del report. Per altre informazioni, vedere Filtro, raggruppamento e ordinamento di dati (Generatore report e SSRS).

Visualizzazione dei set di dati nascosti

Quando si crea una query con parametri per alcune origini dati multidimensionali, i set di dati che forniscono valori validi per il parametro vengono creati automaticamente. In alcuni strumenti di progettazione di query, questa operazione si esegue specificando i filtri e selezionando l'opzione per creare dei parametri. Per impostazione predefinita, tali set di dati, pur essendo visualizzabili, non vengono mostrati nel riquadro dei dati del report. Per altre informazioni, vedere Visualizzare set di dati nascosti per i valori dei parametri di dati multidimensionali (Generatore report e SSRS).

Utilizzo di mappe e di set di dati

Se si include una mappa nel report in uso, è necessario fornire dati spaziali. I dati spaziali possono provenire da un set di dati di un report, da una mappa nella galleria delle mappe o da shapefile ESRI. I dati spaziali provenienti da un report o da un file di forma ESRI non sono visualizzati come set di dati nel riquadro dei dati del report. Per altre informazioni, vedere Mappe (Report Builder e SSRS).

Visualizzazione dei dati da più set di dati

Un report include in genere più set di dati. Nell'elenco seguente vengono descritte le diverse modalità di utilizzo dei set di dati presenti in un report:

• Per visualizzare i dati di ogni set di dati è necessario utilizzare un'area dati distinta. Per ulteriori informazioni, vedere Aree dati e mappe (Generatore report e SSRS).

• È possibile collegare più aree dati a un set di dati e fornire più viste degli stessi dati. Per altre informazioni, vedere Collegamento di più aree dati allo stesso set di dati (Generatore report e SSRS).

• Puoi usare i dataset per fornire un menu a tendina dei valori disponibili o dei valori predefiniti per un parametro del rapporto. Per ulteriori informazioni, vedere Parametri del report (Generatore di report e Progettazione di report).

• È possibile collegare dati correlati di più set di dati utilizzando parametri con report drill-through o sottoreport. Un report delle vendite può ad esempio mostrare dati riepilogativi per tutti i punti vendita e un collegamento drill-through può specificare l'identificatore del punto vendita come parametro di report con una query del set di dati che recupera le singole vendite per il punto vendita specificato. Per ulteriori informazioni, vedere Drillthrough, Drilldown, sottoreport e aree dati annidate (Report Builder e SSRS) e Sottoreport (Report Builder e SSRS).

• Non è possibile visualizzare dati dettaglio di più set di dati in una singola area dati. È tuttavia, possibile visualizzare valori di funzioni predefinite o di aggregazione per più set di dati all'interno di un'area dati. Per altre informazioni, vedere Riferimento a funzioni di aggregazione (Generatore report e SSRS). Se è necessario combinare dati dettaglio di più set di dati in un'area dati, è necessario riscrivere la query in modo da recuperare i dati come singolo set di dati.

Visualizzazione di un messaggio quando non sono disponibili righe di dati

Durante l'elaborazione del report, quando è in esecuzione la query di un set di dati, il set di risultati potrebbe non contenere righe. Nel report sottoposto a rendering un'area dati collegata a un set di dati vuoto viene visualizzata come area dati vuota. È possibile specificare il testo da visualizzare nel report sottoposto a rendering al posto dell’area dati vuota. È inoltre possibile specificare un messaggio per i sottoreport quando le query per tutti i set di dati non producono dati in fase di esecuzione. Per altre informazioni, vedere Impostazione di una proprietà NoDataMessage per un'area dati (Generatore report e SSRS).

Impostazione delle opzioni del set di dati

Per le origini dati che supportano dati internazionali, potrebbe essere necessario modificare le proprietà di un set di dati che incidono sul criterio di ordinamento, sulle proprietà dei caratteri internazionali e sulla distinzione tra maiuscole e minuscole. Tali proprietà includono la distinzione tra maiuscole e minuscole, il tipo kana, la larghezza, l'accento e le regole di confronto. Per ulteriori informazioni su come impostare queste proprietà, vedere la voce Finestra di dialogo Proprietà set di dati, Opzioni (Generatore report).

Contenuto correlato

• Raccolta di campi del set di dati (Generatore di report e SSRS)
• Creare stringhe di connessione dati in Report Builder
• Set di dati del report (SSRS)