Creazione dei parametri del report e impostazione delle relative proprietà
Data creazione: 17 luglio 2006
I parametri del report sono definiti a livello globale per il report. Vengono creati automaticamente se la query di report include parametri, oppure possono essere creati manualmente. Dopo aver creato un parametro del report, è necessario impostare le proprietà che lo identificano e che controllano il modo in cui viene utilizzato nel report.
Per utilizzare i parametri prima della pubblicazione di un report, utilizzare la finestra di dialogo Parametri report di Progettazione report. Per ulteriori informazioni, vedere Procedura: Aggiunta, modifica o eliminazione di un parametro di report (Progettazione report).
Dopo aver pubblicato il report, è possibile modificare molte delle proprietà dei parametri in Gestione report o SQL Server Management Studio. Per ulteriori informazioni sulla modifica delle proprietà dei parametri e per le considerazioni sulla protezione, vedere Impostazione delle proprietà dei parametri per un report pubblicato.
Parametri del report
Sebbene vengano creati automaticamente per i parametri di query, i parametri del report non vengono mai eliminati automaticamente quando si elimina un parametro di query.
Per aprire la finestra di dialogo Proprietà report, passare alla visualizzazione Dati o Layout in Progettazione report e quindi scegliere Proprietà report dal menu Report. L'elenco dei parametri del report verrà visualizzato nel riquadro sinistro. Selezionare il parametro che si desidera modificare.
Nome e tipo di dati
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 di report si basa su un parametro di query, verificare che il tipo di dati del parametro di report corrisponda al tipo di dati del parametro di query. In Reporting Services non vengono rilevati i tipi di dati del parametro di query, pertanto la modifica del tipo di dati deve essere eseguita dall'utente.
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, cercare "Common Language Specification" nel sito Web MSDN all'indirizzo https://msdn.microsoft.com.
Messaggio di richiesta
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, contrassegnare il parametro come nascosto o interno.
Parametri nascosti e interni
È possibile impostare opzioni che controllano la visibilità del parametro nel report pubblicato. Le opzioni Nascondi 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 come solo interno verrà esposto esclusivamente nella definizione del report.
Parametri a valore singolo e multivalore
È 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 di stringhe o utilizzare una query per recuperare i valori disponibili da un'origine dei 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.
[!NOTA] Se si sta utilizzando un'origine dei dati di Analysis Services, non scegliere l'opzione Seleziona tutto in SQL Server 2005. Questa opzione può comportare un peggioramento delle prestazioni durante l'elaborazione di una query MDX. Se si desidera selezionare tutti i valori, scegliere l'elenco membri Totale.
Consenti nessun 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.
Consenti valori Null
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, molti linguaggi di query non restituiscono valori Null in un set di risultati.
Valori disponibili
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.
Valore predefinito
È 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.
[!NOTA] Se si utilizza un parametro multivalore e la query restituisce più di una riga, tutte le righe vengono utilizzate per l'impostazione predefinita.
Vedere anche
Altre risorse
Esercitazione: Aggiunta di parametri a un report tabella semplice
Esercitazione: Funzionalità avanzate per l'utilizzo dei parametri
Utilizzo di parametri in Reporting Services
Parametri report (Progettazione report)