Impostazione delle proprietà dei parametri per un report pubblicato
Un report con parametri è un report che accetta valori di input utilizzati per l'elaborazione del report. I parametri vengono definiti in Progettazione report durante la creazione del report. Per ulteriori informazioni sulla definizione dei parametri, vedere Parametri (Generatore report 3.0 e SSRS).
Dopo che un report è stato pubblicato, è possibile modificare le proprietà dei parametri tramite Gestione report per effettuare le operazioni seguenti:
Esecuzione di un report con valori di parametro preimpostati che non vengono visualizzati dagli utenti.
Esecuzione di un report con un valore di parametro predefinito o un valore valido selezionato dall'utente.
Esecuzione di un report per il quale non è specificato alcun valore di parametro. È possibile specificare un valore Null per restituire un set di risultati non filtrato.
Esecuzione di un report personalizzato che recupera informazioni specifiche per un utente in base a un valore fornito dall'utente stesso, ad esempio un numero di identificazione personale per ottenere un estratto conto o visualizzare il cedolino dello stipendio.
Le proprietà dei parametri impostate dall'utente in Gestione report per un report pubblicato vengono in genere mantenute se si pubblica nuovamente la definizione del report da Progettazione report. Se la definizione del report viene ripubblicata senza modifiche e i nomi dei parametri e i tipi di dati rimangono invariati, le impostazioni delle proprietà verranno mantenute. Se si aggiungono o eliminano parametri nella definizione del report oppure si modifica il tipo di dati o il nome di un parametro esistente, potrebbe essere necessario modificare le proprietà dei parametri nel report pubblicato.
Non è sempre possibile modificare tutti i parametri. Se un parametro del report ottiene un valore predefinito da una query, non sarà possibile modificare tale valore in Gestione report. I valori predefiniti dei parametri "basati su query" sono definiti nella definizione del report e non possono essere modificati in Gestione report. Un valore di parametro basato su query non è un valore costante. Il valore utilizzato in fase di esecuzione viene determinato al momento dell'esecuzione della query oppure, nel caso di parametri basati su espressioni, al momento della valutazione dell'espressione.
Le opzioni di esecuzione del report possono influire sulle modalità di elaborazione dei parametri. Per un report che viene eseguito come snapshot non è possibile utilizzare parametri derivati da una query, a meno che la query non includa valori predefiniti per i parametri. Per ulteriori informazioni sui parametri di query, vedere Procedura: Associazione di un parametro di query a un parametro di report (Generatore report 3.0 e SSRS).
Problemi di sicurezza per i report con parametri
Quando si distribuiscono report con parametri che contengono informazioni riservate è necessario fare attenzione. Un utente può facilmente sostituire un parametro di report con un valore diverso, con la conseguente divulgazione di informazioni potenzialmente riservate.
Un'alternativa più sicura all'utilizzo di parametri per i dati personali o relativi ai dipendenti consiste nel selezionare i dati basati su espressioni che includono il campo UserID dalla raccolta Users. La raccolta Users consente di ottenere l'identità dell'utente che esegue il report e di utilizzarla per recuperare i dati specifici per l'utente. Per ulteriori informazioni, vedere Utilizzo di riferimenti a elementi globali e utenti predefiniti (Generatore report 3.0 e SSRS).
.gif "Nota sulla sicurezza") Nota sulla sicurezza |
|---|
In qualsiasi report che includa un parametro di tipo String, accertarsi di utilizzare un elenco di valori disponibili, anche detto elenco di valori validi, e assicurarsi che ogni utente che esegue il report disponga solo delle autorizzazioni necessarie per visualizzare i dati del report. Quando si definisce un parametro di tipo String, viene visualizzata una casella di testo che può accettare qualsiasi valore. Un elenco di valori disponibili consente di limitare i valori che è possibile immettere. Se un parametro di report è correlato a un parametro di query e non si utilizza un elenco di valori disponibili, un utente potrebbe digitare nella casella di testo sintassi SQL, esponendo il report e il server a un potenziale attacco intrusivo nel codice SQL. Se l'utente dispone di autorizzazioni sufficienti per eseguire la nuova istruzione SQL, è possibile che nel server si verifichino risultati non desiderati. Se un parametro di report non è correlato a un parametro di query e i valori del parametro sono inclusi nel report, un utente potrebbe digitare nel valore del parametro un URL o la sintassi di un'espressione ed eseguire il rendering del report in formato Excel o HTML. Se il report viene quindi visualizzato da un altro utente che fa clic sul contenuto dei parametri di cui è stato eseguito il rendering, potrebbe venire inavvertitamente eseguito il collegamento o lo script dannoso. Per ridurre il rischio di esecuzione involontaria di script dannosi, aprire soltanto report visualizzabili provenienti da fonti attendibili. Per ulteriori informazioni sulla sicurezza dei report, vedere sicurezza di report e risorse. |
Impostazione delle proprietà dei parametri
Le proprietà dei parametri che è possibile modificare in un report pubblicato dipendono dal parametro specificato nella definizione di report originale. È sempre possibile modificare il testo visualizzato e la proprietà Hide, che determina se il parametro può essere visualizzato dagli utenti, tuttavia non è sempre possibile modificare il valore predefinito se questo è derivato da una query. In questo caso, accanto al parametro viene visualizzata la stringa di testo "QueryBased".
Per modificare le proprietà dei parametri, aprire la pagina delle proprietà Parametri del report. È possibile modificare le proprietà seguenti:
La proprietà Con valore predefinito determina se il report può essere elaborato senza input da parte dell'utente. Se per un parametro non è specificato un valore predefinito, l'utente deve specificarne uno prima che il report possa essere elaborato.
La proprietà Valore predefinito può essere una costante o Null se il parametro accetta valori Null, ma non può essere un'espressione.
La proprietà Nascondi determina se i campi di visualizzazione e di input sono visibili agli utenti. Selezionare questa casella di controllo per nascondere il parametro.
La proprietà Richiesta all'utente determina se l'utente può digitare o selezionare un valore valido diverso per il parametro. Questa proprietà è attivata quando la casella Nascondi è disattivata.
La proprietà Testo da visualizzare specifica il testo visualizzato accanto al parametro. Il testo può essere un'etichetta o una stringa di testo più lunga con istruzioni relative all'utilizzo. Questa proprietà è attivata quando si seleziona Richiesta all'utente.
Non è possibile eliminare, rinominare, reimpostare o modificare il tipo di dati dei parametri in un report pubblicato. Non è inoltre possibile modificare il nome del parametro. Per modificare queste proprietà, è necessario modificare definizione del report.
Possibilità di nascondere i parametri
È possibile nascondere le etichette e i campi dei parametri utilizzati in un report. Quando tutti i parametri sono nascosti, l'area dei parametri di un report su richiesta risulta nascosta. Se si nasconde un parametro, è necessario specificare un valore predefinito nella definizione del report o nella pagina Proprietà parametro. In base al report, è possibile specificare un valore Null se sono consentiti valori Null.
Un parametro nascosto non è sempre invisibile. I parametri che vengono nascosti nella barra degli strumenti Report possono comunque essere impostati nelle sottoscrizioni e tramite URL. Per nascondere un parametro in qualsiasi parte del report ad eccezione della definizione, selezionare Interno nella finestra di dialogo Parametri report.
Per nascondere un parametro:
Selezionare Con valore predefinito.
Specificare Valore predefinito.
Selezionare Nascondi.
Convalida dei valori dei parametri
Dopo aver specificato un valore, è possibile verificarne la validità eseguendo il report. Gli errori correlati all'elaborazione dei parametri vengono visualizzati nella pagina Errore di Gestione report. Per analizzare il problema in modo più dettagliato, è possibile visualizzare i file di log. Per ulteriori informazioni, vedere File di log di Reporting Services.
Impostazione dei parametri nelle sottoscrizioni
Oltre a utilizzare la pagina delle proprietà Parametri, è possibile impostare i valori dei parametri durante la creazione di una sottoscrizione. Ogni utente che sottoscrive un report può specificare i valori dei parametri archiviati e utilizzati dalla sottoscrizione. Per ulteriori informazioni, vedere Impostazione dei parametri in una sottoscrizione.
Vedere anche