Creazione di origini dei dati per un report

Articolo
08/22/2008

La modalità di elaborazione di un controllo ReportViewer determina il tipo di dati utilizzabili per un report.

Nella modalità di elaborazione remota in cui i report sono elaborati su un server di report SQL Server 2005, le estensioni per l'elaborazione dati sul server del report determinano i tipi di origine dati che è possibile utilizzare. Estensioni per l'elaborazione dati predefinite sono disponibili per SQL Server, Analysis Services, SQL Server Integration Services, Oracle, SAP NetWeaver® Business Intelligence, XML, ODBC e OLE DB. Le connessioni alle origini dati e alle query per il recupero di dati del report sono specificate in una definizione report in fase di progettazione durante la creazione del report in Business Intelligence Development Studio (lo strumento di progettazione report incluso in SQL Server 2005). I campi restituiti dalla query possono essere utilizzati nel layout del report tramite trascinamento sulla superficie di progettazione del report. Per ulteriori informazioni sull'utilizzo dei dati in un report del server, vedere Connessione a un'origine dati (Reporting Services) nella documentazione in linea di SQL Server.

Nella modalità di elaborazione locale in cui i report sono elaborati dal controllo all'interno dell'applicazione, è possibile specificare le origini dei dati Visual Studio e i campi di definizione dati del report. Le connessioni all'origine dati e le query per il recupero dei dati del report sono definite in fase di progettazione nel progetto di applicazione. In un report client è possibile utilizzare dati di qualsiasi origine, purché possano essere forniti come oggetto DataTable di ADO.NET oppure come un insieme enumerabile di oggetti business. La tabella di dati o l'oggetto business restituisce un elenco di campi utilizzabili dal report. I campi contengono un collegamento a un campo del database e una proprietà del nome. È possibile trascinare i campi dalla finestra Origine dei dati sul layout del report.

Associazione dei dati in un report

Le definizioni del report utilizzano le aree dati per associare dati al report. È possibile scegliere tra numerose aree dati per supportare strutture di dati diverse nel report. Gli esempi di aree dati utilizzabili in una definizione di report includono Tabella, Matrice, Grafico ed Elenco. Per associare i dati in un report è necessario eseguire le operazioni seguenti:

Definire le origini dati e i set di dati da utilizzare nel report; per informazioni sull'operazione, è possibile utilizzare le informazioni e i collegamenti riportati in questo argomento. Nella finestra Origine dei dati vengono visualizzati le origini di dati e i campi che è possibile utilizzare.
Trascinare le aree dati che si desidera utilizzare dalla casella degli strumenti del report nell'area di progettazione.
Trascinare singoli campi dalla finestra Origine dei dati nell'area dati.

Ogni area dati può utilizzare i campi di un unico set di dati. Né il controllo di ReportViewer né il server di report possono eseguire join tra diversi set di dati. Ad esempio, se si utilizzano oggetti business, è necessario eseguire il join all'interno dell'oggetto business. Per ulteriori informazioni sulle aree dati, vedere Aggiunta di aree dati a un report (Progettazione report di Visual Studio).

Come aggiungere origini dei dati per report di ReportViewer

Di seguito sono riportati gli approcci consigliati per configurare un'origine dei dati per l'utilizzo in una definizione del report del client.

Aggiungere un'origine dei dati al progetto di applicazione e configurare la connessione ai dati sottostanti. Nel caso di un archivio dati sottostante, selezionare i dati specifici che si desidera utilizzare. I dati da utilizzare nel report devono essere disponibili nella finestra Origini dei dati. Nel caso di una tabella di dati, l'origine dei dati riporta i nomi di colonna restituiti da una query. Nel caso, infine, di un insieme enumerabile di oggetti business, l'origine dei dati visualizza un elenco di proprietà pubbliche di tipi di dati semplici esposti dall'oggetto classe.
Per creare una tabella di dati, aggiungere un set di dati al progetto e utilizzare la Configurazione guidata TableAdapter per configurare la tabella. La Configurazione guidata TableAdapter include un generatore delle query e una funzionalità di anteprima dei dati per la conferma immediata dei risultati delle query.
Per creare oggetti business, scegliere Aggiungi nuovo elemento dal menu Progetto e selezionare l'oggetto Classe. Fornire implementazioni che espongono proprietà di tipi di dati semplici da utilizzare in fase di progettazione. Fornire inoltre metodi per la restituzione di insiemi enumerabili delle proprietà da utilizzare in fase di esecuzione.

Dopo aver configurato un'origine dei dati, nella finestra Origine dei dati viene visualizzata una gerarchia dei dati associabili. Per associare dati a un report, trascinare i nodi della gerarchia espansa in caselle di testo o aree dati in un layout di report. Se i set di dati vengono modificati dopo la definizione del report, sarà necessario aggiornare le associazioni di dati nel report e nel controllo. Per ulteriori informazioni, vedere Aggiornamento e riassociazione di riferimenti all'origine dei dati (Progettazione report di Visual Studio).

Nel progetto è possibile includere il numero desiderato di origini dei dati. Per visualizzare l'elenco delle origini dei dati effettivamente utilizzate in un report, scegliere Origini dei dati dal menu Report. Per visualizzare l'anteprima del report e dei relativi dati nell'applicazione, è necessario generare o distribuire l'applicazione al fine di verificare che il report contenga i dati previsti. Per ulteriori informazioni sulla configurazione del controllo e sulla definizione del layout del report, vedere Configurazione di ReportViewer per l'elaborazione locale e Creazione di file di definizione del report client (con estensione rdlc).

Per iniziare subito, utilizzare gli scenari seguenti in cui vengono aggiunti i singoli tipi di origini dei dati a un progetto:

Utilizzo di oggetti business

Un oggetto business è un qualsiasi oggetto applicazione che espone proprietà pubbliche di tipi di dati semplici. Esempi di oggetti business possono includere un insieme di oggetti Cliente di un archivio dati sottostante, una matrice di oggetti Titolo libro creati dall'applicazione oppure un elenco di oggetti Canale creati da un'origine XML RSS.

Per essere accessibile come origine dei dati, l'insieme deve supportare l'insieme IEnumerable. I dati associabili sono visualizzati in una gerarchia nella finestra Origine dei dati. Per gli oggetti business l'origine dei dati visualizza un elenco di proprietà pubbliche di tipi di dati semplici esposti dall'oggetto classe. È quindi possibile associarli alle aree dati e alle caselle di testo in una definizione del report.

Per fornire un insieme di oggetti business, è possibile aggiungere una classe oppure un riferimento a una classe nel progetto.

Utilizzo di tabelle di dati

È possibile aggiungere facilmente un oggetto DataTable, incluso in un oggetto DataSet di ADO.NET, scegliendo Aggiungi nuovo elemento dal menu Progetto. Per configurare la connessione dati, avviare la Configurazione guidata TableAdapter. Scegliere Aggiungi dal menu Dati e quindi TableAdapter. È inoltre possibile definire una query per limitare il set di risultati. Al termine della procedura guidata, le colonne di DataTable risulteranno accessibili nella finestra Origini dei dati e potranno essere associate ad aree dati e caselle di testo in una definizione del report del client.

Definizione delle origini dei dati per controlli del server Web ReportViewer

I controlli dell'origine dei dati supportano l'astrazione del livello di accesso ai dati consentendo l'associazione tra i controlli presenti in una pagina Web e un'origine dei dati, che a sua volta viene associata ai dati effettivi. In questo modo è possibile cambiare l'origine dati senza dover riassociare i singoli controlli ai singoli dati.

Durante la progettazione di una pagina Web, nella sezione relativa ai dati della casella degli strumenti ****sono elencati numerosi controlli dell'origine dei dati, tra cui SqlDataSource e XmlDataSource. Alcuni controlli dell'origine dei dati forniscono il supporto per la memoria a pagine nelle pagine Web, mentre altri utilizzano dati condivisi. Nei report non viene utilizzata la memoria a pagine, pertanto per un controllo del server Web ReportViewer è preferibile utilizzare il controllo ObjectDataSource. Tale controllo offre un collegamento tra gli oggetti della cache in memoria (DataTable o insiemi di oggetti business) e le aree dati del report. Quando si aggiunge un controllo ReportViewer a una pagina Web, viene automaticamente aggiunto e configurato un controllo ObjectDataSource.

Per ridurre al minimo la necessità di nuovo codice aggiuntivo, il supporto ASP.NET per le pagine Web include ulteriori operazioni di elaborazione automatiche per la rilevazione degli insiemi che forniscono oggetti business associabili. Quando si aggiunge una classe al progetto che restituisce un insieme di oggetti identificabili come oggetti business, l'insieme verrà automaticamente aggiunto alla finestra Origini dei dati del sito Web.

Vedere anche

Condividi tramite

Creazione di origini dei dati per un report

Associazione dei dati in un report

Come aggiungere origini dei dati per report di ReportViewer

Utilizzo di oggetti business

Utilizzo di tabelle di dati

Definizione delle origini dei dati per controlli del server Web ReportViewer

Vedere anche

Riferimento

Concetti

Altre risorse

Risorse aggiuntive