Articolo
03/31/2012

Parametri (Generatore report 3.0 e SSRS)

I parametri del report consentono di controllare i dati del report, connettere report correlati e variare la presentazione del report. Per progettare un report in cui vengono utilizzati efficacemente i parametri, è necessario comprendere come correlare i parametri e le query del set di dati, come includere i parametri nelle espressioni e come gestire i parametri indipendentemente dalla definizione del report nel server di report o in un sito di SharePoint.

I parametri del report possono essere creati nei modi seguenti:

Creare e aggiungere un set di dati, incorporato o condiviso, che disponga di una query in cui siano contenute variabili di query.
Creare un parametro manualmente dal riquadro Dati report.
Aggiungere una parte del report in cui siano contenuti riferimenti a un parametro o a un set di dati condiviso contenente variabili.

Dopo la pubblicazione di un report, i parametri possono essere gestiti in modo indipendente rispetto alla definizione del report. È possibile anche creare più set di parametri per lo stesso report. Per ulteriori informazioni, vedere Impostazione delle proprietà dei parametri per un report pubblicato e Aggiunta, modifica ed eliminazione di report collegati.

Ogni parametro viene visualizzato nella barra degli strumenti del visualizzatore di report in modo che gli utenti possano specificarne in modo interattivo i valori. Nell'illustrazione seguente viene mostrata l'area dei parametri di un report con i parametri @StartDate, @EndDate, @Subcategory e @ShowAllRows.

Parametri sulla barra degli strumenti del visualizzatore di report

Riquadro Parametri Nella barra degli strumenti del visualizzatore di report vengono visualizzati un messaggio di richiesta e un valore predefinito per ogni parametro. Il layout del parametro viene formattato nella barra degli strumenti automaticamente. L'ordine in cui i parametri vengono visualizzati è determinato dall'ordine dei parametri nel riquadro Dati report.
**Parametri @StartDate e @EndDate** Il parametro @StartDate corrisponde al tipo di dati DateTime. Il messaggio di richiesta Data inizio viene visualizzato accanto alla casella di testo. Per modificare la data, digitare una nuova data nella casella di testo o utilizzare il controllo calendario.

Il parametro @EndDate viene visualizzato accanto a @StartDate.
**Parametro @Subcategory** Il parametro @Subcategory corrisponde al tipo di dati Text. Poiché @Subcategory dispone di un elenco di valori, i valori validi vengono visualizzati in un elenco a discesa. È necessario scegliere i valori da questo elenco. Essendo @Subcategory un parametro multivalore, viene visualizzata l'opzione Seleziona tutto che consente di cancellare tutto e selezionare tutti i valori nell'elenco.
**Parametro @ShowAllRows** Il parametro @ShowAllRows corrisponde al tipo di dati Boolean. Utilizzare i pulsanti di opzione per specificare True o False.
Handle Mostra o nasconde l'area dei parametri Nella barra degli strumenti del visualizzatore di report fare clic su questa freccia per mostrare o nascondere il riquadro dei parametri.
Pulsante Parametri Nell'anteprima di Generatore report fare clic sul pulsante Parametri della barra multifunzione per visualizzare o nascondere il riquadro dei parametri.
Pulsante Visualizza report Nella barra degli strumenti del visualizzatore di report fare clic su Visualizza report per eseguire il report dopo avere immesso il valore dei parametri. Se tutti i parametri hanno valori predefiniti, il report viene eseguito automaticamente a prima vista.

Per ulteriori informazioni sull'utilizzo di parametri, vedere Esercitazione: Aggiunta di un parametro al report (Generatore report 3.0), Esercitazione: Aggiunta di parametri a un report (SSRS) o la pagina relativa ai report di esempio (Report Builder 3.0 e SSRS)

Nota

I parametri possono essere pubblicati come parte del report separata per aree dati che dispongono di set di dati dipendenti con parametri. Sebbene i parametri siano elencati come parte del report, non è possibile aggiungere un parametro della parte del report direttamente a un report. Aggiungere invece la parte del report affinché tutti i parametri del report necessari vengano generati automaticamente dalle query del set di dati contenute o cui fa riferimento la parte del report. Per ulteriori informazioni sulle parti del report, vedere Parti di report (Generatore report 3.0) e Parti di report in Progettazione report (SSRS).

Nota

È possibile creare e modificare definizioni del report (con estensione rdl) in Generatore report 3.0 e in Progettazione report di Business Intelligence Development Studio. Ogni ambiente di creazione offre modalità differenti per creare, aprire e salvare report ed elementi correlati. Per ulteriori informazioni, vedere Progettazione di report tramite Progettazione report e Generatore report 3.0 (SSRS) nel Web all'indirizzo microsoft.com.

Contenuto dell'articolo

Utilizzi comuni per i parametri

Tipi di parametri

Utilizzo dei parametri di report

Utilizzo dei parametri di set di dati

Parametri di propagazione

Passaggio di parametri a report drill-through o sottoreport

Gestione di parametri in un server di report o in un sito di SharePoint

Contenuto della sezione

Argomenti correlati

Utilizzi comuni per i parametri

Di seguito sono elencate alcune delle modalità più comuni di utilizzo dei parametri:

Consentire agli utenti di specificare valori per personalizzare i dati di un report. È ad esempio possibile fornire due parametri per la data di inizio e la data di fine dei dati di vendita.
Consentire agli utenti di specificare valori per personalizzare l'aspetto di un report. È ad esempio possibile fornire un parametro booleano per indicare se espandere o comprimere tutti i gruppi di righe nidificati in una tabella.
Creare un elenco a discesa di valori tra cui scegliere in modo che un utente possa selezionare solo un valore valido.
Creare un valore predefinito per ogni parametro in modo che il report venga eseguito automaticamente a prima vista.
Creare valori di propagazione in modo che l'elenco a discesa per un parametro corrisponda al set di valori validi basato sulla selezione di un parametro precedente. Ciò consente di filtrare successivamente i valori del parametro da migliaia a un numero gestibile.
Personalizzare set di parametri per più utenti. Creare due report collegati basati su un report relativo alle vendite sul server di report. In un report collegato vengono utilizzati i valori di parametro predefiniti per i venditori mentre nel secondo report collegato vengono utilizzati i valori di parametro predefiniti per i responsabili delle vendite. In entrambi i report viene utilizzata la stessa definizione report.
Consentire agli utenti di filtrare i dati in un set di dati condiviso. Quando si aggiunge un set di dati condiviso a un report, non è possibile modificare la query. Nel report è possibile aggiungere un filtro del set di dati che include un riferimento a un parametro di report creato.

Icona freccia utilizzata con il collegamento Torna all'inizio Torna all'inizio

Tipi di parametri

I report includono due tipi di parametri: parametri dei set di dati e parametri del report.

Parametro di set di dati Per ogni variabile di query contenuta nel comando della query del set di dati viene creato automaticamente un parametro del set di dati relativo a un set di dati incorporato o condiviso. Alcuni strumenti di progettazione query forniscono un'area per l'aggiunta di filtri applicati basati sui nomi dei campi e un'opzione per aggiungere un parametro del set di dati basato sul nome del campo.

I parametri del set di dati vengono configurati dopo avere definito la query del set di dati. È possibile specificare valori predefiniti in modo indipendente per ogni parametro del set di dati. Quando si aggiunge un set di dati condiviso a un report, non è possibile eseguire l'override dei parametri del set di dati contrassegnati come interni nel report. È possibile eseguire l'override dei parametri del set di dati che non sono contrassegnati come interni. È inoltre possibile creare parametri aggiuntivi. Per ulteriori informazioni, vedere Utilizzo dei parametri di set di dati di seguito in questo argomento.
Parametro di report Per ogni parametro del set di dati viene creato automaticamente un parametro del report. È anche possibile creare i parametri del report manualmente. È possibile configurare i parametri del report in modo che un utente possa immettere in modo interattivo i valori per personalizzare il contenuto o l'aspetto di un report. È inoltre possibile configurare i parametri del report in modo che un utente non possa modificare i valori preconfigurati. I parametri di report vengono gestiti in modo indipendente da un report pubblicato sul server di report. Per ulteriori informazioni, vedere Utilizzo dei parametri di report di seguito in questo argomento.

È inoltre possibile salvare un parametro di report separatamente dal report come parte di report. Le parti di report vengono archiviate sul server di report e possono quindi essere utilizzate da altri utenti nei propri report. Le parti di report corrispondenti a parametri non possono essere gestite dal server di report. È possibile cercare i parametri in Raccolta parti del report e configurarli nel report dopo averli aggiunti. Per ulteriori informazioni, vedere Parti di report (Generatore report 3.0).

Nella maggior parte dei casi verranno utilizzati i parametri del report.

Icona freccia utilizzata con il collegamento Torna all'inizio Torna all'inizio

Utilizzo dei parametri di report

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 i parametri della query e l'elaboratore di report crea automaticamente i parametri del report indirettamente collegati ai parametri della query.

Per impostazione predefinita, per i parametri creati automaticamente vengono utilizzati un nome generato automaticamente, un messaggio di richiesta e un tipo di dati. È possibile modificare le proprietà dei parametri del report utilizzando la finestra di dialogo Proprietà report nel riquadro Dati report. Nella tabella riportata di seguito vengono riepilogate le proprietà che è possibile impostare per ogni parametro.

Proprietà	Descrizione
Nome	Digitare un nome con distinzione tra maiuscole e minuscole per il parametro. Il nome deve iniziare con una lettera e contenere lettere, numeri, un carattere di sottolineatura (_) e nessuno spazio. Per i parametri generati automaticamente, il nome corrisponde al parametro della query nella query del set di dati. Per impostazione predefinita, i parametri creati manualmente sono simili a ParametroReport1.
Messaggio di richiesta	Il testo che viene visualizzato accanto al parametro nella barra degli strumenti del visualizzatore di report.
Tipo di dati	Un parametro di report deve corrispondere a uno dei seguenti tipi di dati: Text, Integer, Float, DateTime, Boolean. Il tipo di dati determina il modo in cui il parametro del report viene presentato sulla barra degli strumenti del visualizzatore di report. Il tipo di dati può rivelarsi importante anche quando si scrivono espressioni che includono un riferimento al parametro.
Consenti nessun valore	Selezionare questa opzione se il valore del parametro può corrispondere a una stringa vuota o a un valore vuoto. Se si specificano valori validi per un parametro e si desidera che uno di essi sia un valore vuoto, è necessario includere tale valore come uno dei valori specificati. La selezione di questa opzione non include automaticamente un valore vuoto tra i valori disponibili.
Consenti valore Null	Selezionare questa opzione se il valore del parametro può essere un valore Null. Se si specificano valori validi per un parametro e si desidera che uno dei valori sia Null, è necessario includere tale valore come uno dei valori specificati. La selezione di questa opzione non include automaticamente un valore Null tra i valori disponibili.
Consenti più valori	Fornire i valori disponibili per creare un elenco a discesa dal quale gli utenti possono scegliere. Si tratta di un metodo efficace per assicurarsi che nella query del set di dati vengano inviati solo valori validi. Selezionare questa opzione se il valore per il parametro può essere costituito da più valori visualizzati in un elenco a discesa. I valori Null non sono consentiti. Se questa opzione è selezionata, verranno aggiunte caselle di controllo all'elenco di valori disponibili nell'elenco a discesa dei parametri. Nella parte superiore dell'elenco è inclusa una casella di controllo Seleziona tutto. Gli utenti possono selezionare i valori desiderati. Se i dati che forniscono i valori cambiano rapidamente, l'utente potrebbe non visualizzare l'elenco più recente.
Visibile	Selezionare questa opzione per visualizzare il parametro nella parte superiore del report durante l'esecuzione. Questa opzione consente agli utenti di selezionare i valori del parametro in fase di esecuzione.
Nascosto	Selezionare questa opzione per nascondere il parametro nel report. I valori dei parametri del report possono essere impostati su un URL del report, nella definizione di una sottoscrizione oppure nel server di report utilizzando Gestione report.
Interno	Selezionare questa opzione per nascondere il parametro del report. Il parametro del report può essere visualizzato solo nella relativa definizione.
Valori disponibili	Se sono stati specificati valori disponibili per un parametro, tali valori vengono sempre visualizzati sotto forma di elenco a discesa. Se ad esempio si forniscono i valori disponibili per un parametro DateTime, nel riquadro del parametro viene visualizzato un elenco a discesa per le date anziché un controllo calendario. Per assicurarsi che un elenco di valori sia coerente fra report e sottoreport, è possibile impostare un'opzione sull'origine dati per utilizzare una sola transazione per tutte le query nei set di dati associati a un'origine dati. Nota sulla sicurezza In qualsiasi report che includa un parametro del tipo di dati Text, verificare di utilizzare un elenco di valori disponibili, noto anche come elenco di valori validi, e assicurarsi che ogni utente che esegue il report disponga solo delle autorizzazioni necessarie per visualizzare i dati del report. Per ulteriori informazioni, vedere Sicurezza (Generatore report 3.0).
Valori predefiniti	Impostare i valori predefiniti da una query o da un elenco statico. Il report viene eseguito automaticamente a prima vista quando ogni parametro ha un valore predefinito.
Avanzate	Impostare un valore che indica se questo parametro influisce direttamente o indirettamente sui dati inclusi in un report. Questo valore viene utilizzato nel server di report per determinare le opzioni della cache per i report e i dati del report. Per ulteriori informazioni, vedere Finestra di dialogo Proprietà Parametri report, Avanzate (Generatore report 3.0).

Icona freccia utilizzata con il collegamento Torna all'inizio Torna all'inizio

Utilizzo dei parametri di set di dati

Quando si compila una query in Progettazione query vengono definiti i parametri della query. Alcune estensioni per i dati consentono di selezionare i campi da includere come parametri. Altre estensioni per i dati identificano le variabili della query nel comando di query. Per ogni variabile della query viene generato automaticamente un parametro di query.

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. I parametri di report possono anche essere utilizzati per modificare l'aspetto o l'organizzazione di un report dopo il recupero dei dati.

Per filtrare i dati nella query del set di dati è possibile includere una clausola di restrizione che limita i dati recuperati specificando i valori da includere o escludere dal set dei risultati.

Utilizzare Progettazione query associata a un'origine dati per compilare una query con parametri.

Per query Transact-SQL, origini dati diverse supportano una sintassi diversa per i parametri. Supportare gli intervalli dei parametri identificati nella query in base alla posizione o al nome. Per ulteriori informazioni, vedere gli argomenti su tipi specifici di origini dati esterne in Aggiunta di dati a un report (Generatore report 3.0 e SSRS). Nella finestra Progettazione query relazionale, è necessario selezionare l'opzione del parametro di filtro per creare una query con parametri. Per ulteriori informazioni, vedere Interfaccia utente di Progettazione query relazionale (Generatore report 3.0).
Per query basate su un'origine di dati multidimensionale quale Microsoft SQL Server Analysis Services, SAP NetWeaver BI o Hyperion Essbase, è possibile specificare se creare un parametro basato su un filtro specificato in Progettazione query. Per ulteriori informazioni, vedere l'argomento relativo alla progettazione di query corrispondente all'estensione per i dati in Finestre Progettazione query (Generatore report 3.0).

Icona freccia utilizzata con il collegamento Torna all'inizio Torna all'inizio

Parametri di propagazione

È possibile creare parametri di propagazione, in cui l'utente sceglie il valore per ogni parametro in un ordine specifico e ciascuna scelta limita i valori per il parametro successivo. I parametri di propagazione possono ridurre migliaia di scelte possibili a un numero gestibile. Un utente sceglie ad esempio una categoria di prodotti, quindi sceglie il prodotto dall'elenco dei prodotti disponibili nella categoria specificata, quindi sceglie la dimensione e il colore.

Per ulteriori informazioni, vedere Procedura: Aggiunta di parametri di propagazione a un report (Generatore report 3.0 e SSRS).

Icona freccia utilizzata con il collegamento Torna all'inizio Torna all'inizio

Passaggio di parametri a report drill-through e sottoreport

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.

Per ulteriori informazioni, vedere Utilizzo di parametri per la connessione ad altri report (Generatore report 3.0 e SSRS).

Gestione di parametri in un server di report o un sito di SharePoint

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 per un report o un set di dati condiviso dipende dal modo in cui è stato configurato il parametro nel report in fase di progettazione. Se si progetta un report di cui si intende pianificare la memorizzazione nella cache o sottoscrizioni, è possibile che ai parametri vengano applicati requisiti aggiuntivi. Per ulteriori informazioni, vedere gli argomenti seguenti nella documentazione di Reporting Services inclusa nella documentazione online di SQL Server.

**Report memorizzati nella cache. **Per creare un piano della cache per un report, ogni parametro deve avere un valore predefinito. Per ulteriori informazioni, vedere memorizzazione nella cache dei report in Reporting Services.
**Set di dati condivisi memorizzati nella cache. **Per creare un piano della cache per un set di dati condiviso, ogni parametro deve avere un valore predefinito. Per ulteriori informazioni, vedere memorizzazione nella cache dei report in Reporting Services.
Report collegati. È possibile creare report collegati con valori di parametro preimpostati per filtrare i dati per diverse tipologie di pubblico. Per ulteriori informazioni, vedere Aggiunta, modifica ed eliminazione di report collegati.
Sottoscrizioni di report. È possibile specificare valori di parametro per filtrare i dati e recapitare report tramite sottoscrizioni. Per ulteriori informazioni, vedere Impostazione dei parametri in una sottoscrizione e Sottoscrizioni e recapito (Reporting Services).
Accesso tramite URL. È possibile specificare valori di parametro nell'URL di un report. È anche possibile eseguire report e specificare valori di parametro utilizzando l'accesso tramite URL. Per ulteriori informazioni, vedere Accesso con URL.