Creazione dei parametri del report e impostazione delle relative proprietà

I nomi di parametro sono obbligatori ed è necessario che siano univoci nel report. Per impostazione predefinita, un tipo di dati del parametro è impostato su String. È possibile selezionare un tipo di dati diverso nell'elenco a discesa. Se il parametro del report è basato su un parametro della query, verificare che il tipo di dati del parametro del report corrisponda al tipo di dati del parametro della query. Poiché Reporting Services non rileva i tipi di dati del parametro della query, è necessario modificare manualmente il tipo di dati.

I nomi devono essere conformi ai caratteri e agli standard di utilizzo di maiuscole e minuscole della specifica CLS (Common Language Specification). Per ulteriori informazioni, vedere Specifiche CLS (Common Language Specification) nel sito Web MSDN all'indirizzo https://msdn.microsoft.com.

In un report pubblicato i parametri sono in genere visualizzati come caselle di testo in un'area di input di parametri nella parte superiore del report. La stringa del messaggio di richiesta definisce l'etichetta che identifica il parametro nell'area di input. Può essere costituita dal nome del parametro o da istruzioni per l'utente, ad esempio "Anno" o "Selezionare un anno". Se viene lasciata vuota e viene specificato un valore predefinito, verrà utilizzato tale valore e la casella di input per il parametro non verrà visualizzata durante l'esecuzione del report. Se viene lasciata vuota e non viene specificato alcun parametro predefinito, non sarà possibile eseguire il report. Se non si desidera visualizzare la stringa del messaggio di richiesta dei valori di un parametro, selezionare Nascosto o Interno.

È possibile impostare opzioni che controllano la visibilità del parametro nel report pubblicato. Le opzioni Nascosto e Interno consentono di ottenere livelli diversi di visibilità. È possibile nascondere il parametro nell'area di input dei parametri del report pubblicato, impostando tuttavia i valori per il parametro nell'URL di un report o nella definizione di una sottoscrizione. Un parametro impostato su Interno verrà esposto esclusivamente nella definizione del report. Un parametro interno deve avere un valore predefinito, che può essere Null se è stata selezionata l'opzione Consenti valore Null.

È possibile definire un parametro multivalore selezionando l'opzione Multivalore nella finestra di dialogo Parametri report. Se questa casella di controllo non è selezionata, il parametro è a valore singolo. Se si specifica l'opzione Multivalore, verranno aggiunte caselle di controllo ai valori disponibili nell'elenco a discesa dei parametri nel report pubblicato. Gli utenti possono selezionare i valori desiderati. Nel report Sales Reason Comparisons è ad esempio possibile selezionare più prodotti per visualizzare i relativi dati di vendita combinati.

Quando si specificano i valori disponibili, è possibile fornire un elenco statico o utilizzare una query per recuperare i valori disponibili da un'origine dati. Un parametro multivalore deve includere almeno un valore. I valori Null non sono consentiti. L'opzione Seleziona tutto viene creata automaticamente e visualizzata solo se è disponibile più di un valore.

Quando si crea un elenco di valori disponibili, è necessario includere il valore <Vuoto> nell'elenco dei valori validi se si desidera che venga considerato valido.

L'opzione Consenti valori Null può essere utilizzata per i parametri a valore singolo. Non è possibile selezionare questo valore per un parametro multivalore. Quando si seleziona Consenti valori Null, si consente che per il parametro venga specificato un valore Null. Per impostazione predefinita, in genere i linguaggi di query non restituiscono valori Null in un set di risultati.

Quando si definisce un parametro di report, è necessario definire i valori che è possibile utilizzare con il report. Tali valori vengono denominati valori disponibili o valori validi. Un elenco di valori disponibili include un set di coppie valore/etichetta. Durante l'esecuzione del report l'etichetta viene visualizzata all'utente. Quando l'utente seleziona un'etichetta, il valore corrispondente viene utilizzato come valore del parametro. I valori disponibili possono essere predefiniti come elenco statico o espressione oppure possono essere recuperati da un set di dati:

• Un elenco non da query è un elenco statico di coppie valore/etichetta. L'intero elenco è contenuto nella definizione del parametro di report. I singoli valori e le singole etichette possono essere valori statici o essere generati da un'espressione.

• Se si specifica un elenco di valori disponibili da query, il server di report recupererà un set di valori ed etichette da un set di dati durante l'esecuzione del report. Quando si specifica un elenco di questo tipo, si seleziona il set di dati e i campi da utilizzare per il valore e per l'etichetta.

Quando si specifica un elenco di valori disponibili da query è consigliabile creare un set di dati semplificato, utilizzato in modo specifico dal parametro, anziché utilizzare un set di dati più complesso, utilizzato anche da aree dati nel report. L'utilizzo dello stesso set di dati per l'elenco di valori validi e per le aree dati del report potrebbe provocare risultati imprevisti nell'elenco di valori validi.

È possibile impostare un valore predefinito per il parametro. Se tutti i parametri nel report hanno valori predefiniti, il report verrà elaborato immediatamente quando viene aperto dall'utente o visualizzato in anteprima in Progettazione report. Se non si assegna un valore predefinito ad almeno un parametro, i dati verranno visualizzati nel report solo dopo l'immissione di tutti i valori di parametro e l'esecuzione del report.

È possibile utilizzare un valore non da query o da query come impostazione predefinita. Un valore predefinito non da query è un valore statico o un'espressione. Un valore predefinito da query è un'espressione che punta a un campo in un set di dati. Se la query restituisce più righe, verrà utilizzato il valore della prima riga del set di dati restituito.

È inoltre possibile decidere di non specificare alcun valore predefinito. In questo caso sarà necessario impostare un messaggio di richiesta.