Una funzionalità che trovo molto utilie di Reporting Services sono gli Report Snapshots.
Cos'è un report snapshot?
Uno Report Snapshot non è altro che una copia del report, eseguito in un preciso istante. Questa copia conterrà tutte le informazioni necessarie per permettere di visualizzare il report in un secondo momento, e avere lo stato al momento della sua creazione.
Quando viene chiesto di salavare uno snapshots, Reporting Services esegue il report in questione e immagazzina tutte le informazioni che vanno a popolare i dataset utilizzati nel report stesso (e anche il layout del report). In questo modo, quando viene richiesta la visualizzazione di un preciso Snapshot, si hanno a disposizione i dati già elaborati, che erano presenti in quel preciso istante (data + ora).
Ecco cosa viene salvato nel server di Reporting Services:
- The result set (that is, the data in the report, retrieved through the credentials specified in the Data Sources properties page of the report).
- The underlying report definition, as it exists at the time the snapshot was created. If the report definition was subsequently modified after the snapshot was generated, those changes are not reflected in the snapshot.
- Parameter values that are used to obtain or filter the result set.
- Embedded resources, such as images. External resources that are linked to a report are not stored with the report snapshot.
Un enorme vantaggio, che porta all'uso dei Report Snapshots, è il fatto di poter essere schedulati, ed esistono molte impostazioni possibili a riguardo. (esecuzione a intervalli prestabiliti, in precisi giorni, una sola volta, ...)
I Report Snapshots hanno però anche delle limitazioni, una di queste, è dovuta al fatto che vengono salvanti anche i valori dei parametri, e questo comporta che se vogliamo Snapshot con parametri differenti, si dovranno creare differenti Report (o Linked Reports), ma questo è anche capibile.
In alcune condizioni però, è possibile utilizzare un parametro (visibile) all'interno del report per filtrare i dati. Infatti, il filtro dei dati all'interno del report è una prassi consentita, in quanto viene applicato ai dati che popolano i DataSet (e quindi immagazzinati nello snapshot)
Quando utilizzare i report snapshots?
Possono essere utilizzati prevalentemente per due motivazioni:
- Si vuole avere uno storico di un determinato report.
Schedulando la creazione di snapshot a determinati intervalli, permettono di avere esattamente la situazione (il risultato del report) in quel dato momento, e quindi poter eseguire a posteriore una visualizzazione di tali dati. - Esecuzione di report che richiedono molto tempo di elaborazione.
E' possibile schedulare l'esecuzione di snapshot per ovviare al problema dell'attesa per l'elaborazione di report che richiedono un lungo tempo di caricamento. In questo modo, l'utente può visualizzare l'ultimo snapshot eseguito, che verrà caricato velocemente in quanto i dataset sono già stati popolati durante la creazione dello snapshot, risparmiando così l'attesa all'utente.
Come visualizzare uno snapshot nel controllo ReportViewer
Per visualizzare uno snapshot di un preciso report nel controllo ReportViewer è sufficiente impostare la proprietà HistoryId del controllo, con l'ID dello snapshot che si vuole visualizzare.
reportViewer.ServerReport.HistoryId = historyID;
Utilizzando il web service esposto da Reporting Services (Consumare il web service di Reporting Services) è possibile recuperare la lista di Snapshots di un determinato report, e utilizzare i dati ricevuti per recuperare l'identificativo dell'ultimo Snapshot eseguito.
Ecco come poter recuperare la lista di tutti gli snapshot di un determinato report:
1: public ReportHistorySnapshot[] GetReportHistory(string reportFullPath)
2: {
3: using (ReportingService2005SoapClient rs = ReportingService2005SoapClient())
4: {
5: rs.ClientCredentials.Windows.AllowedImpersonationLevel = System.Security.Principal.TokenImpersonationLevel.Impersonation;
6: rs.ClientCredentials.Windows.ClientCredential.UserName = "username";
7: rs.ClientCredentials.Windows.ClientCredential.Password = "password";
8:
9: ReportHistorySnapshot[] snapshots = null;
10: rs.ListReportHistory(reportFullPath, out snapshots);
11:
12: return snapshots;
13: }
14: }
Link: