Utilizzo dei parametri per controllare i dati del report

I parametri del report vengono creati automaticamente quando si definiscono i parametri della query. In Generatore report i parametri del report vengono creati automaticamente quando si imposta un messaggio di richiesta in una clausola di filtro.

Quando si definisce un set di dati, si specifica un determinato tipo di origine dati, ad esempio MicrosoftSQL Server. In Progettazione report viene aperta una finestra Progettazione query progettata per gestire tale tipo di origine dati. Quando si definisce la query per ogni set di dati, la finestra Progettazione query identifica le variabili nel testo del comando della query e crea un parametro della query per ogni variabile. Le query con variabili non sono supportate da tutte le combinazioni di origine dati e provider di dati. Per ulteriori informazioni sulla sintassi della query prevista nell'origine dati, vedere Utilizzo di parametri di query con origini dati specifiche (Reporting Services).

Per un'origine dati di SQL Server, le variabili di una query sono in genere incluse nella clausola WHERE di un'istruzione Transact-SQL per limitare l'ambito dei dati restituiti durante l'esecuzione della query. Analogamente, una query sull'origine dati di Analysis Services solitamente include le variabili MDX utilizzate in una clausola FILTER. Le query possono inoltre includere variabili passate come input a stored procedure o a funzioni definite dall'utente.

Ogni volta che si modifica la query di un set di dati, la query viene rielaborata. Se si modifica una query rimuovendo o rinominando una variabile, i parametri di query verranno aggiornati in base a tali modifiche.

È possibile creare parametri aggiuntivi del set di dati nella pagina Parametri della finestra di dialogo Proprietà set di dati. I parametri creati non vengono modificati quando la query cambia.

Il valore predefinito di ogni parametro della query viene impostato su un'espressione che restituisce il parametro del report corrispondente. Per modificare i valori predefiniti, utilizzare la pagina Parametri della finestra di dialogo Proprietà set di dati. Ad esempio, per un'origine dati di SQL Server, se il parametro della query è @MyParameter, il parametro del report sarà MyParameter e il valore di @MyParameter sarà impostato sull'espressione [@MyParameter]. Per ulteriori informazioni, vedere Finestra di dialogo Proprietà set di dati, Parametri. Sarà quindi possibile modificare manualmente i parametri di query e impostarne i valori predefiniti. Per ulteriori informazioni, vedere Procedura: Associazione di un parametro di query a un parametro di report.

Per i parametri del report creati automaticamente vengono utilizzati i valori predefiniti seguenti:

• Valore singolo

• Tipo di dati Text.

• Prompt impostato sul nome del parametro.

• Nessun valore predefinito

• Nessun valore disponibile

Può essere necessario modificare queste proprietà in base al tipo di dati rappresentato dal parametro della query. Per ulteriori informazioni, vedere Creazione dei parametri del report e impostazione delle relative proprietà.

Quando si crea una query che utilizza più parametri, è possibile creare un set di parametri di propagazione. I parametri di propagazione consentono di filtrare un numero molto elevato di valori di parametri fino a un numero gestibile di valori. Si supponga ad esempio che una query includa i parametri @Category, @Subcategory e @Product, in cui l'elenco di sottocategorie dipende da @Category e l'elenco di prodotti dipende da @Subcategory. Quando un utente sceglie un valore per il parametro del report Category, i valori per Subcategory sono limitati ai valori validi per la categoria scelta. Dopo la selezione di un valore per Subcategory da parte dell'utente, le opzioni per Product sono già state filtrate dalla scelta di Category e Subcategory. Con questa tecnica, è possibile ridurre le opzioni valide per un parametro fino a un numero ragionevole di valori.

Per progettare parametri di propagazione, è necessario includere gli elementi seguenti nel report:

• Query del set di dati principale, che include diversi parametri della query correlati.

• Elenco ordinato di parametri del report, ognuno associato a un parametro della query. Solitamente, questi parametri vengono creati automaticamente dalla query principale. Ogni parametro dipendente deve seguire il parametro da cui dipende. L'ordine dei parametri può essere modificato nel riquadro Dati report, in cui è possibile spostare i parametri verso l'alto e verso il basso nella raccolta. Per ulteriori informazioni, vedere Procedura: Modifica dell'ordine di un parametro del report (Reporting Services).

• Set di dati distinto per ogni parametro del report che fornisce i relativi valori disponibili. È importante utilizzare la stessa sequenza di caratteri con distinzione tra maiuscole e minuscole per ogni parametro della query, in modo da collegare correttamente i parametri della query e i parametri del report. La query per ogni set di valori disponibili per ogni parametro del report deve fornire solo valori significativi nel contesto della query principale.

Nell'esempio il parametro del report Product dipende da Subcategory, che a sua volta dipende da Category. È necessario che Category preceda Subcategory, seguito da Product. La query per il set di dati che fornisce i valori disponibili per Category deve mostrare tutte categorie valide per la query principale. La query che fornisce i valori disponibili per Subcategory dopo che è stata scelta una categoria deve fornire valori validi per la categoria specificata, oltre a eventuali vincoli esistenti nella query principali.

Per ulteriori informazioni, vedere Procedura: Aggiunta di parametri di propagazione a un report (Reporting Services).