Esecuzione di un report con parametri
Un report con parametri è un report che utilizza valori di input per l'elaborazione. Sono esempi tipici i report che filtrano i dati in base a un codice di area geografica, a una categoria di prodotti o a un identificatore. I parametri vengono in genere utilizzati per eseguire una query di selezione dei dati per il report. Per la gestione o l'esecuzione di un report con parametri è necessario conoscere gli effetti delle selezioni dei parametri sui report.
Nota
I parametri utilizzati in un report vengono definiti dall'autore. Dopo la pubblicazione del report è possibile modificare alcune proprietà dei parametri per cambiare i valori utilizzati e il modo in cui si ottengono tali valori. Per ulteriori informazioni sulla creazione dei parametri, vedere Parametri (Generatore report 3.0 e SSRS). Per ulteriori informazioni sulla gestione dei parametri, vedere Impostazione delle proprietà dei parametri per un report pubblicato.
Archiviazione e richiesta dei valori dei parametri
Per recuperare il valore di un parametro in fase di esecuzione, è possibile archiviare un valore predefinito nel report o richiedere all'utente di digitare o selezionare un valore. L'archiviazione del valore di un parametro in un report è utile se si desidera che il report venga sempre elaborato con un valore specifico. Se ad esempio una filiale regionale dispone di un sito Web dedicato, è possibile pubblicare in tale sito un report sulle vendite regionali che utilizza sempre il codice di area specifico.
È inoltre possibile richiedere agli utenti di digitare o selezionare il valore da utilizzare quando aprono il report. Se si configura un report per la richiesta dei valori dei parametri, nel report vengono inclusi campi di input per consentire agli utenti di digitare valori specifici. Dopo l'immissione dei valori, gli utenti possono fare clic su Visualizza report per eseguire il report. Se i valori sono validi, il report viene visualizzato. In caso contrario verrà visualizzato un messaggio di errore o un report vuoto. Quando si utilizzano valori dei parametri archiviati, nel report aperto non vengono visualizzati campi di input o il pulsante Visualizza report. In questo caso tutti gli utenti che eseguono il report utilizzano lo stesso valore dei parametri.
Nel caso di report che includono parametri basati su query e con un'origine dei dati che richiede una procedura di accesso per ogni utente, le credenziali verranno richieste prima della visualizzazione dei campi di input dei parametri nella pagina. In questa situazione è necessario specificare le credenziali prima che vengano recuperati i valori dei parametri.
Per eseguire un report con parametri è in genere necessario conoscere i valori da digitare. È possibile che il report includa elenchi a discesa di valori validi selezionabili.
Per impostare le proprietà dei parametri, inclusi i valori predefiniti, in un report pubblicato, utilizzare Gestione report. Per ulteriori informazioni, vedere Parametri (Generatore report 3.0 e SSRS) e Impostazione dei parametri in una sottoscrizione.
Impostazione dei parametri nell'URL di un report
È possibile eseguire un report con parametri anche tramite un URL. In questo caso si possono specificare uno o più parametri in coppie nome-valore codificate utilizzando il carattere e commerciale (&) come separatore.
Per i parametri Null è necessario utilizzare una sintassi speciale, ovvero specificare isnull. Se si specifica un valore Null per un parametro, tutti gli altri valori specificati per lo stesso parametro vengono ignorati. Nell'esempio seguente vengono illustrati più parametri per valori Null e costanti:
http://exampleWebServerName/reportserver?/foldercontainingreports/orders&division=mailorder®ion=west&sales:isnull=true
Per specificare parametri con più valori, ripetere il nome del parametro. Ad esempio:
http://exampleWebServerName/reportserver?/foldercontainingreports/orders®ion=east®ion=west
Per i parametri di tipo Boolean è necessario specificare il valore 0 o 1.
Per i parametri di tipo Float è necessario utilizzare il separatore decimale corrispondente alle impostazioni locali del server.
I parametri di tipo DateTime devono essere specificati nel formato AAAA-MM-GGThh:mm:ss in base allo standard ISO (International Organization for Standardization) 8601. Per ulteriori informazioni sull'impostazione di parametri in un URL, vedere Utilizzo dei parametri di accesso tramite URL.
Vedere anche