• Articolo

Aggiunta di parametri al report

In Reporting Services i parametri vengono utilizzati per specificare i dati da utilizzare in un report, collegare report correlati e modificare la presentazione di report. Per progettare un report che utilizza i parametri in modo efficace, è necessario comprendere l'interazione tra parametri e query del set di dati, l'interazione tra parametri ed espressioni, la modalità di gestione dei parametri nel server di report per un report pubblicato e le domande cui un report è progettato per rispondere. I valori che si sceglie di parametrizzare possono influire sulla progettazione e sul layout del report.

I parametri di query vengono aggiunti a una query del set di dati mediante gli strumenti di progettazione query disponibili nella finestra di dialogo Proprietà set di dati. Dopo la creazione di una query con parametri, Reporting Services collega automaticamente i parametri di query ai parametri di report con lo stesso nome. I nuovi parametri di report vengono aggiunti e modificati mediante il riquadro Dati report.

Utilizzo di parametri in Reporting Services

I parametri vengono in genere utilizzati per modificare i dati del report recuperati dalle query del set di dati. In questo scenario, agli utenti che eseguono il report viene chiesto di specificare uno o più valori, quindi la query del set di dati restituisce solo i dati richiesti. La query del set di dati include parametri di query e Reporting Services crea automaticamente i parametri di report corrispondenti che sono indirettamente collegati ai parametri di query. È possibile modificare le proprietà dei parametri di report con gli strumenti di progettazione dei report per includere un elenco di valori validi e un prompt utente visualizzati in fase di esecuzione.

È inoltre possibile creare parametri di propagazione che recuperano dati gerarchici da un'origine dati. Ad esempio, il primo parametro può applicare un filtro in base alla categoria di prodotto e il secondo in base al prodotto. I parametri di propagazione vengono utilizzati per organizzare e limitare il numero di valori disponibili per l'utente.

Non tutte le origini dati supportano i parametri di query. Nei casi in cui non è possibile filtrare i dati all'origine, è possibile utilizzare i parametri di report per offrire agli utenti la possibilità di filtrare i dati dopo che sono stati recuperati per il report. Anche se tutti i parametri di query prevedono parametri di report corrispondenti, è possibile definire parametri di report in modo indipendente con gli strumenti di progettazione dei report. I parametri di report possono anche essere utilizzati per modificare l'aspetto o l'organizzazione di un report dopo il recupero dei dati.

I parametri vengono utilizzati per connettere i report a sottoreport e a report drill-through. Questi parametri di report possono essere nascosti, utilizzando i valori nel report principale per selezionare i dati corretti per il report connesso, o possono essere visibili all'utente in fase di esecuzione.

Dopo la creazione di un parametro di report, è possibile modificare i valori predefiniti e altre proprietà dei parametri, ad esempio la visibilità. Ad esempio, i parametri di report possono utilizzare variabili predefinite come UserID, per cui è possibile creare un report con un parametro nascosto che seleziona i dati specifici per l'utente che esegue il report. I parametri possono contenere uno o più valori, utilizzare un elenco di valori validi statici o basati su query e accettare valori Null o vuoti. I parametri multivalore consentono agli utenti di selezionare più di un valore in fase di esecuzione.

Dopo la pubblicazione di un report, i parametri possono essere gestiti in modo indipendente rispetto alla definizione del report. La possibilità per gli amministratori dei server di report di modificare molte proprietà dei parametri nel report pubblicato dipende dal modo in cui è stato configurato il parametro nel report in fase di progettazione. Possono anche creare set di parametri collegati alla stessa definizione del report che personalizzano il report per più tipologie di pubblico. Per ulteriori informazioni, vedere Impostazione delle proprietà dei parametri per un report pubblicato.

È anche possibile eseguire report e specificare i valori dei parametri utilizzando l'accesso tramite URL. Per ulteriori informazioni, vedere Utilizzo dei parametri di accesso tramite URL.

Nota sulla protezioneNota sulla protezione

In qualsiasi report che includa un parametro di tipo String, accertarsi di utilizzare un elenco di valori disponibili, anche detto elenco di valori validi, e assicurarsi che ogni utente che esegue il report disponga solo delle autorizzazioni necessarie per visualizzare i dati del report. Quando si definisce un parametro di tipo String, viene visualizzata una casella di testo che può accettare qualsiasi valore. Un elenco di valori disponibili consente di limitare i valori che è possibile immettere. Se un parametro di report è correlato a un parametro di query e non si utilizza un elenco di valori disponibili, un utente potrebbe digitare nella casella di testo sintassi SQL, esponendo il report e il server a un potenziale attacco intrusivo nel codice SQL. Se l'utente dispone di autorizzazioni sufficienti per eseguire la nuova istruzione SQL, è possibile che nel server si verifichino risultati non desiderati.

Se un parametro di report non è correlato a un parametro di query e i valori del parametro sono inclusi nel report, un utente potrebbe digitare nel valore del parametro un URL o la sintassi di un'espressione ed eseguire il rendering del report in formato Excel o HTML. Se il report viene quindi visualizzato da un altro utente che fa clic sul contenuto dei parametri di cui è stato eseguito il rendering, potrebbe venire inavvertitamente eseguito il collegamento o lo script dannoso.

Per ridurre il rischio di eseguire inavvertitamente script dannosi, aprire soltanto report visualizzabili provenienti da fonti attendibili. Per ulteriori informazioni sulla protezione dei report, vedere Protezione di report e risorse.

Contenuto della sezione