Parametri report (Generatore report e SSRS)
I parametri del report consentono di controllare i dati del report, connettere report correlati e variare la presentazione del report. Per progettare un report in cui vengono utilizzati i parametri in modo efficace, è necessario comprendere come sono correlati i parametri e le query del set di dati, come includere i parametri nelle espressioni e come gestire i parametri indipendentemente dalla definizione del report nel server di report o in un sito di SharePoint. Dopo la pubblicazione di un report, i parametri possono essere gestiti in modo indipendente rispetto alla definizione del report. Creando report collegati, è anche possibile creare più set di parametri per lo stesso report.
Quando si visualizza un report, ogni parametro viene visualizzato nella barra degli strumenti del visualizzatore di report in modo che gli utenti possano specificarne i valori in modo interattivo. Nell'illustrazione seguente viene mostrata l'area dei parametri di un report con i parametri @StartDate, @EndDate, @Subcategory e @ShowAllRows.
.gif "rs_ParameterStory")
Riquadro Parametri Nella barra degli strumenti del visualizzatore di report vengono visualizzati un messaggio di richiesta e un valore predefinito per ogni parametro. Il layout del parametro viene formattato nella barra degli strumenti automaticamente. L'ordine in cui i parametri vengono visualizzati è determinato dall'ordine dei parametri nel riquadro dei dati del report.
**Parametri @StartDate e @EndDate** Il parametro @StartDate corrisponde al tipo di dati DateTime. Il messaggio di richiesta Data inizio viene visualizzato accanto alla casella di testo. Per modificare la data, digitare una nuova data nella casella di testo o utilizzare il controllo calendario.
Il parametro @EndDate viene visualizzato accanto a @StartDate.
**Parametro @Subcategory** Il parametro @Subcategory corrisponde al tipo di dati Text. Poiché @Subcategory dispone di un elenco di valori, i valori validi vengono visualizzati in un elenco a discesa. È necessario scegliere i valori da questo elenco. Essendo @Subcategory un parametro multivalore, viene visualizzata l'opzione Seleziona tutto che consente di cancellare tutto e selezionare tutti i valori nell'elenco.
**Parametro @ShowAllRows** Il parametro @ShowAllRows corrisponde al tipo di dati Boolean. Utilizzare i pulsanti di opzione per specificare True o False.
Handle Mostra o nasconde l'area dei parametri Nella barra degli strumenti del visualizzatore di report fare clic su questa freccia per mostrare o nascondere il riquadro dei parametri.
Pulsante Parametri Nell'anteprima di Generatore report fare clic sul pulsante Parametri della barra multifunzione per visualizzare o nascondere il riquadro dei parametri.
Pulsante Visualizza report Nella barra degli strumenti del visualizzatore di report fare clic su Visualizza report per eseguire il report dopo avere immesso il valore dei parametri. Se tutti i parametri hanno valori predefiniti, il report viene eseguito automaticamente a prima vista.
Per ulteriori informazioni sull'utilizzo di parametri, vedere Esercitazione: Aggiungere un parametro al report (Generatore report) o la pagina relativa ai report di esempio (Generatore report e SSRS)
[!NOTA]
È possibile creare e modificare definizioni del report (con estensione rdl) in Generatore report e in Progettazione report di SQL Server Data Tools. Ogni ambiente di creazione offre modalità differenti per creare, aprire e salvare report ed elementi correlati. Per ulteriori informazioni, vedere Progettazione di report tramite Progettazione report e Generatore report (SSRS) nel Web all'indirizzo microsoft.com.
Contenuto dell'articolo
Utilizzi comuni per i parametri
Tipi di parametri
Creazione di parametri
Parametri di report
Parametri dei set di dati
Parametri di propagazione
Visualizzazione di valori di parametro in un report
Impostazione di parametri in un report drill-through
Impostazione di parametri in un sottoreport
Gestione di parametri in un report pubblicato
Impostazione di parametri in un URL di report
Impostazione di parametri per una sottoscrizione
Impostazione di parametri per uno snapshot
Parametri e sicurezza dei dati
Procedure
Argomenti della sezione
Argomenti correlati
Utilizzi comuni per i parametri
Di seguito sono elencate alcune delle modalità più comuni di utilizzo dei parametri:
Filtrare i dati del report nell'origine dei dati scrivendo query del set di dati comprensive di variabili di query.
Filtrare i dati da un set di dati condiviso. Quando si aggiunge un set di dati condiviso a un report, non è possibile modificare la query. Nel report è possibile aggiungere un filtro del set di dati che include un riferimento a un parametro di report creato.
Consentire agli utenti di specificare valori per personalizzare i dati di un report. È ad esempio possibile fornire due parametri per la data di inizio e la data di fine dei dati di vendita.
Consentire agli utenti di specificare valori per personalizzare l'aspetto di un report. È ad esempio possibile fornire un parametro booleano per indicare se espandere o comprimere tutti i gruppi di righe nidificati in una tabella.
Creare un elenco a discesa di valori tra cui scegliere in modo che un utente possa selezionare solo un valore valido.
Creare un valore predefinito per ogni parametro in modo che il report venga eseguito automaticamente a prima vista.
Creare valori di propagazione in modo che l'elenco a discesa per un parametro corrisponda al set di valori validi basato sulla selezione di un parametro precedente. In questo modo, è possibile filtrare successivamente i valori del parametro da migliaia a un numero gestibile.
Utilizzare parametri per correlare report principali a report drill-through, sottoreport e report collegati. Durante la progettazione di un set di report, ogni report viene progettato in modo da rispondere a domande specifiche. In particolare, ogni report è in grado di offrire una vista diversa o un livello di dettaglio diverso per le informazioni correlate. Per ottenere un set di report correlati tra loro, creare i parametri per i dati correlati nei report di destinazione.
Personalizzare set di parametri per più utenti. Creare due report collegati basati su un report relativo alle vendite sul server di report. In un report collegato vengono utilizzati i valori di parametro predefiniti per i venditori mentre nel secondo report collegato vengono utilizzati i valori di parametro predefiniti per i responsabili vendite. In entrambi i report viene utilizzata la stessa definizione report.
Se si prevede di creare snapshot, cronologie o sottoscrizioni di report in un report pubblicato, è necessario capire come i parametri del report influiscono sui requisiti di progettazione per il report.
.gif "Icona freccia usata con il collegamento Torna all'inizio")
Torna all'inizio
Creazione di parametri
È possibile creare parametri di report nelle modalità seguenti:
Creare o aggiungere un set di dati, incorporato o condiviso, che disponga di una query in cui siano contenute variabili di query. Per ulteriori informazioni, vedere Informazioni sui set di dati del report e sulle query.
Creare manualmente un parametro dal riquadro dei dati del report. Per ulteriori informazioni, vedere Aggiungere, modificare o eliminare un parametro di report (Generatore report e SSRS).
Aggiungere una parte del report in cui siano inclusi riferimenti a un parametro o a un set di dati condiviso contenente variabili.
[!NOTA]
I parametri possono essere pubblicati come parte del report separata per aree dati che dispongono di set di dati dipendenti con parametri. Sebbene i parametri siano elencati come parte del report, non è possibile aggiungere un parametro della parte del report direttamente a un report. Aggiungere invece la parte del report e tutti i parametri del report necessari vengono generati automaticamente da query del set di dati contenute o a cui fa riferimento la parte del report. Per ulteriori informazioni sulle parti del report, vedere Parti del report (Generatore report e SSRS) e Parti del report in Progettazione report (SSRS).
Tipi di parametri
I report includono due tipi di parametri: parametri dei set di dati e parametri del report.
Parametro di set di dati Per ogni variabile di query contenuta nel comando della query del set di dati viene creato automaticamente un parametro del set di dati relativo a un set di dati incorporato o condiviso. Alcuni strumenti di progettazione query forniscono un'area per l'aggiunta di filtri applicati basati sui nomi dei campi e un'opzione per aggiungere un parametro del set di dati basato sul nome del campo.
I parametri del set di dati vengono configurati dopo avere definito la query del set di dati. È possibile specificare valori predefiniti in modo indipendente per ogni parametro del set di dati. Quando si aggiunge un set di dati condiviso a un report, non è possibile eseguire l'override dei parametri del set di dati contrassegnati come interni nel report. È possibile eseguire l'override dei parametri del set di dati che non sono contrassegnati come interni. È inoltre possibile creare parametri aggiuntivi. Per ulteriori informazioni, vedere Parametri dei set di dati di seguito in questo argomento.
Parametro di report Per ogni parametro del set di dati viene creato automaticamente un parametro del report. È anche possibile creare i parametri del report manualmente. È possibile configurare i parametri del report in modo che un utente possa immettere in modo interattivo i valori per personalizzare il contenuto o l'aspetto di un report. È inoltre possibile configurare i parametri del report in modo che un utente non possa modificare i valori preconfigurati. I parametri di report vengono gestiti in modo indipendente da un report pubblicato sul server di report. Per ulteriori informazioni, vedere Parametri di report di seguito in questo argomento.
È inoltre possibile salvare un parametro di report separatamente dal report come parte del report. Le parti di report vengono archiviate sul server di report e possono quindi essere utilizzate da altri utenti nei propri report. Le parti di report corrispondenti a parametri non possono essere gestite dal server di report. È possibile cercare i parametri in Raccolta parti del report e configurarli nel report dopo averli aggiunti. Per ulteriori informazioni, vedere Parti del report (Generatore report e SSRS).
Torna all'inizio
Parametri di report
I parametri vengono in genere utilizzati per modificare i dati del report recuperati dalle query del set di dati. In questo scenario agli utenti che eseguono il report viene chiesto di specificare uno o più valori, quindi la query del set di dati restituisce solo i dati richiesti. La query del set di dati include i parametri della query e l'elaboratore di report crea automaticamente i parametri del report indirettamente collegati ai parametri della query.
[!NOTA]
Poiché i parametri vengono gestiti in modo indipendente nel server, la ripubblicazione di un report principale con nuove impostazioni dei parametri non implica la sovrascrittura delle impostazioni dei parametri esistenti per il report principale o per quello collegato.
I parametri di report vengono creati nei modi seguenti:
Automaticamente, quando si definisce la query del set di dati contenente le variabili di query. Per ogni variabile di query, vengono creati un parametro del report e un parametro di query del set di dati con lo stesso nome. Un parametro di query può essere un riferimento a una variabile do query o a un parametro di input per una stored procedure.
Automaticamente, quando si aggiunge un riferimento a un set di dati condiviso contenente parametri di query.
Manualmente, quando si creano parametri del report nel riquadro dei dati del report. I parametri rappresentano una delle raccolte predefinite che è possibile includere in un'espressione di un report. Poiché le espressioni sono utilizzate per definire valori nell'intera definizione di un report, è possibile utilizzare i parametri per controllare l'aspetto del report o per passare i valori ai sottoreport o report correlati che utilizzano anch'essi i parametri.
Per impostazione predefinita, per i parametri creati automaticamente vengono utilizzati un nome generato automaticamente, un messaggio di richiesta e un tipo di dati. È possibile modificare le proprietà dei parametri del report utilizzando la finestra di dialogo Proprietà report nel riquadro dei dati del report. Nella tabella riportata di seguito vengono riepilogate le proprietà che è possibile impostare per ogni parametro.
Proprietà |
Descrizione |
||
|---|---|---|---|
Nome |
Digitare un nome con distinzione tra maiuscole e minuscole per il parametro. Il nome deve iniziare con una lettera e contenere lettere, numeri, un carattere di sottolineatura (_) e nessuno spazio. Per i parametri generati automaticamente, il nome corrisponde al parametro della query nella query del set di dati. Per impostazione predefinita, i parametri creati manualmente sono simili a ParametroReport1. |
||
Messaggio di richiesta |
Il testo che viene visualizzato accanto al parametro nella barra degli strumenti del visualizzatore di report. |
||
Tipo di dati |
Un parametro di report deve corrispondere a uno dei seguenti tipi di dati:
Quando sono definiti valori disponibili per un parametro, l'utente seleziona i valori in un elenco a discesa, anche quando il tipo di dati corrisponde a DateTime. Per ulteriori informazioni sui tipi di dati di report, vedere Tipi di dati RDL. |
||
Consenti nessun valore |
Selezionare questa opzione se il valore del parametro può corrispondere a una stringa vuota o a un valore vuoto. Se si specificano valori validi per un parametro e si desidera che uno di essi sia un valore vuoto, è necessario includere tale valore come uno dei valori specificati. La selezione di questa opzione non include automaticamente un valore vuoto tra i valori disponibili. |
||
Consenti valore Null |
Selezionare questa opzione se il valore del parametro può essere un valore Null. Se si specificano valori validi per un parametro e si desidera che uno dei valori sia Null, è necessario includere tale valore come uno dei valori specificati. La selezione di questa opzione non include automaticamente un valore Null tra i valori disponibili. |
||
Consenti più valori |
Fornire i valori disponibili per creare un elenco a discesa dal quale gli utenti possono scegliere. Si tratta di un metodo efficace per assicurarsi che nella query del set di dati vengano inviati solo valori validi. Selezionare questa opzione se il valore per il parametro può essere costituito da più valori visualizzati in un elenco a discesa. I valori Null non sono consentiti. Se questa opzione è selezionata, verranno aggiunte caselle di controllo all'elenco di valori disponibili nell'elenco a discesa dei parametri. Nella parte superiore dell'elenco è inclusa una casella di controllo Seleziona tutto. Gli utenti possono selezionare i valori desiderati. Se i dati che forniscono i valori cambiano rapidamente, l'utente potrebbe non visualizzare l'elenco più recente. |
||
Visibile |
Selezionare questa opzione per visualizzare il parametro nella parte superiore del report durante l'esecuzione. Questa opzione consente agli utenti di selezionare i valori del parametro in fase di esecuzione. |
||
Nascondi |
Selezionare questa opzione per nascondere il parametro nel report pubblicato. I valori dei parametri di report possono comunque essere impostati su un URL del report, nella definizione di una sottoscrizione oppure nel server di report utilizzando Gestione report. |
||
Interno |
Selezionare questa opzione per nascondere il parametro di report. Nel report pubblicato, il parametro di report potrà essere visualizzato solo nella relativa definizione. |
||
Valori disponibili |
Se sono stati specificati valori disponibili per un parametro, tali valori vengono sempre visualizzati sotto forma di elenco a discesa. Se ad esempio si forniscono i valori disponibili per un parametro DateTime, nel riquadro del parametro viene visualizzato un elenco a discesa per le date anziché un controllo calendario. Per assicurarsi che un elenco di valori sia coerente fra report e sottoreport, è possibile impostare un'opzione sull'origine dati per utilizzare una sola transazione per tutte le query nei set di dati associati a un'origine dati.
|
||
Valori predefiniti |
Impostare i valori predefiniti da una query o da un elenco statico. Il report viene eseguito automaticamente a prima vista quando ogni parametro ha un valore predefinito. |
||
Avanzate |
Impostare l'attributo di definizione del report UsedInQuery, un valore che indica se questo parametro influisce direttamente o indirettamente sui dati di un report.
|
.gif "Nota di attenzione")
AttenzioneTorna all'inizio
Parametri dei set di dati
Quando si compila una query in Progettazione query vengono definiti i parametri della query. Alcune estensioni per i dati consentono di selezionare i campi da includere come parametri. Altre estensioni per i dati identificano le variabili della query nel comando di query. Per ogni variabile della query viene generato automaticamente un parametro di query.
Non tutte le origini dati supportano i parametri di query. Nei casi in cui non è possibile filtrare i dati all'origine, è possibile utilizzare i parametri di report per offrire agli utenti la possibilità di filtrare i dati dopo che sono stati recuperati per il report. Anche se tutti i parametri di query prevedono parametri di report corrispondenti, è possibile definire parametri di report in modo indipendente. I parametri di report possono anche essere utilizzati per modificare l'aspetto o l'organizzazione di un report dopo il recupero dei dati.
Per filtrare i dati nella query del set di dati è possibile includere una clausola di restrizione che limita i dati recuperati specificando i valori da includere o escludere dal set dei risultati.
Utilizzare Progettazione query associata a un'origine dati per compilare una query con parametri.
Per query Transact-SQL, origini dati diverse supportano una sintassi diversa per i parametri. Supportare gli intervalli dei parametri identificati nella query in base alla posizione o al nome. Per ulteriori informazioni, vedere gli argomenti su tipi specifici di origini dati esterne in Aggiungere dati a un report (Generatore report e SSRS). Nella finestra Progettazione query relazionale, è necessario selezionare l'opzione del parametro di filtro per creare una query con parametri. Per ulteriori informazioni, vedere Interfaccia utente di Progettazione query relazionale (Generatore report).
Per query basate su un'origine di dati multidimensionale quale Microsoft SQL Server Analysis Services, SAP NetWeaver BI o Hyperion Essbase, è possibile specificare se creare un parametro basato su un filtro specificato in Progettazione query. Per ulteriori informazioni, vedere l'argomento relativo alla progettazione di query corrispondente all'estensione per i dati in Finestre di progettazione query (Generatore report).
Torna all'inizio
Parametri di propagazione
È possibile creare parametri di propagazione, in cui l'utente sceglie il valore per ogni parametro in un ordine specifico e ciascuna scelta limita i valori per il parametro successivo. I parametri di propagazione possono ridurre migliaia di scelte possibili a un numero gestibile. Un utente sceglie ad esempio una categoria di prodotti, quindi sceglie il prodotto dall'elenco dei prodotti disponibili nella categoria specificata, quindi sceglie la dimensione e il colore.
Per ulteriori informazioni, vedere Aggiunta di parametri di propagazione a un report (Generatore report e SSRS).
Torna all'inizio
Visualizzare parametri in un report
I parametri di un report sono una delle raccolte predefinite a cui è possibile fare riferimento da un'espressione. La sintassi dell'espressione varia a seconda che il parametro del report accetti uno o più valori. Per ulteriori informazioni, vedere Filtri di uso comune (Generatore report e SSRS) e Riferimenti alla raccolta dei parametri (Generatore report e SSRS).
Impostazione di parametri in un report drill-through
Le azioni drill-through vengono impostate nelle pagine delle proprietà di qualsiasi casella di testo di un elemento del report o sulle parti di un grafico o un misuratore. Questi parametri di report possono essere nascosti, utilizzando i valori nel report principale per selezionare i dati corretti per il report connesso o possono essere visibili all'utente in fase di esecuzione. L'impostazione del nome del report di destinazione per l'azione drill-through varia a seconda che si disponga o meno di una connessione attiva a un server di report. Per ulteriori informazioni, vedere Specifica di percorsi di elementi esterni (Generatore report e SSRS).
È anche possibile utilizzare l'accesso tramite URL per qualsiasi report indirizzabile tramite URL e includere i valori dei parametri del report nella sintassi dell'URL. Per ulteriori informazioni, vedere Accesso con URL (SSRS).
Impostazione di parametri in un sottoreport
Per impostare i parametri per un sottoreport, utilizzare la pagina Parametri della finestra di dialogo Proprietà sottoreport. L'impostazione del nome del sottoreport varia a seconda che si disponga o meno di una connessione attiva a un server di report. Per ulteriori informazioni, vedere Specifica di percorsi di elementi esterni (Generatore report e SSRS).
[!NOTA]
Se si utilizza un sottoreport in un'area dati Tablix, il sottoreport e i relativi parametri verranno elaborati per ogni riga dell'area dati nell'area dati. Se le righe sono numerose, è consigliabile valutare l'opportunità di utilizzare un report drill-through.
Per ulteriori informazioni, vedere Aggiungere un sottoreport e di parametri (Generatore report e SSRS).
Gestire parametri in un server di report o un sito di SharePoint
Quando si progetta un report, i parametri corrispondenti vengono salvati nella definizione del report. Quando si pubblica un report, i parametri corrispondenti vengono salvati e gestiti separatamente dalla definizione del report.
Per un report pubblicato, è possibile utilizzare gli elementi seguenti:
Proprietà dei parametri di report. Modificare i valori dei parametri del report direttamente nel server di report indipendentemente dalla definizione del report.
**Report memorizzati nella cache. **Per creare un piano cache per un report, ogni parametro deve disporre di un valore predefinito. Per ulteriori informazioni, vedere Memorizzazione dei report nella cache (SSRS).
**Set di dati condivisi memorizzati nella cache. **Per creare un piano cache per un set di dati condiviso, ogni parametro deve disporre di un valore predefinito. Per ulteriori informazioni, vedere Memorizzazione dei report nella cache (SSRS).
Report collegati. È possibile creare report collegati con valori di parametri preimpostati per filtrare i dati per diverse tipologie di pubblico. Per ulteriori informazioni, vedere Creare un report collegato.
Sottoscrizioni di report. È possibile specificare valori di parametri per filtrare i dati e recapitare report tramite sottoscrizioni. Per ulteriori informazioni, vedere Sottoscrizioni e recapito (Reporting Services).
Accesso a URL. È possibile specificare valori di parametri in un URL di un report. Inoltre è possibile eseguire report e specificare valori di parametri utilizzando l'accesso a URL. Per ulteriori informazioni, vedere Impostazione di parametri in un URL di report.
Le proprietà dei parametri per un report pubblicato vengono in genere mantenute se si pubblica nuovamente la definizione del 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 per un report pubblicato. I valori predefiniti dei parametri "basati su query" sono definiti nella definizione del report e non possono essere modificati nel server di 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.
Torna all'inizio
Impostazione di parametri in un URL di report
È possibile eseguire un report con parametri anche tramite un URL. È possibile specificare uno o più parametri in coppie nome-valore codificate utilizzando il carattere e commerciale (&) come separatore.
Parametri Null. Per i parametri Null è necessario utilizzare una sintassi speciale, ovvero specificare isnull per un valore Null. 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
Parametri con più valori. Specificare più valori ripetendo il nome del parametro. Ad esempio:
http://exampleWebServerName/reportserver? %2ffoldercontainingreports%2forders®ion=east®ion=west
Boolean. Utilizzare il valore 0 per false o 1 per true.
Float. Includere il separatore decimale corrispondente alle impostazioni locali del server.
DateTime. Utilizzare il formato AAAA-MM-GGTHH:MM:SS basato sullo standard ISO (International Organization for Standardization) 8601.
L'impostazione dei valori dei parametri di report è solo un modo per utilizzare la sintassi di accesso agli URL per visualizzare un report. Un altro esempio consiste nello specificare un parametro URL per visualizzare un report a partire da un numero di pagina specifico. Nell'esempio seguente viene aperto il report Product Catalog 2008 del database di esempio AdventureWorks2012 in corrispondenza della pagina 30:
http://exampleWebServerName/reportserver? %2fAdventureWorks2012+Sample+Reports%2fProduct+Catalog+2008&rs:Command=Render&rc:Section=30
Per ulteriori informazioni, vedere Riferimento ai parametri di accesso con URL.
Torna all'inizio
Impostazione di parametri per una sottoscrizione
È possibile definire una sottoscrizione per un report su richiesta o snapshot e specificare valori di parametri da utilizzare durante l'elaborazione della sottoscrizione.
Report su richiesta. Per un report su richiesta, è possibile specificare un valore di parametro diverso dal valore pubblicato per ogni parametro elencato per il report. Si supponga, ad esempio, di utilizzare il report delle chiamate al servizio di assistenza, per il quale viene utilizzato un parametro periodo di tempo che consente di restituire i dati sulle richieste pervenute al servizio di assistenza ai clienti in un determinato giorno, settimana o mese. Se il valore predefinito del parametro per il report è impostato su oggi, si potrebbe impostare la sottoscrizione in modo che utilizzi un valore diverso, ad esempio settimana o mese, per generare un report contenente dati settimanali o mensili.
Snapshot. Per uno snapshot, per la sottoscrizione è necessario utilizzare i valori di parametro definiti per lo snapshot. Nella sottoscrizione non è possibile definire un valore di parametro per sostituire il valore di parametro definito per uno snapshot. Si supponga, ad esempio, di sottoscrivere un report delle vendite per le regioni meridionali che viene eseguito come snapshot del report e che per lo snapshot sia specificato sud come valore di parametro relativo alle regioni. In questo caso, se si crea una sottoscrizione di questo report, è necessario utilizzare il valore di parametro sud nella sottoscrizione. Per consentire di individuare immediatamente i parametri che non possono essere modificati, i campi corrispondenti nella pagina di sottoscrizione sono di sola lettura.
[!NOTA]
Per le sottoscrizioni guidate dai dati è possibile utilizzare valori di parametri ottenuti da un'origine dei dati del Sottoscrittore. Per ulteriori informazioni, vedere Utilizzare un'origine dei dati esterna per i dati del Sottoscrittore (sottoscrizione guidata dai dati).
Se si modifica un valore di parametro nello snapshot del report dopo aver definito la sottoscrizione, questa viene disattivata dal server di report. La disattivazione della sottoscrizione indica che il report è stato modificato. Per attivare la sottoscrizione, aprirla e salvarla.
Per ulteriori informazioni, vedere Sottoscrizioni e recapito (Reporting Services).
Torna all'inizio
Impostazione di parametri per uno snapshot
Le opzioni di esecuzione del report possono influire sulle modalità di elaborazione dei parametri. Un report con parametri che viene eseguito come snapshot del report utilizza i valori dei parametri definiti per lo snapshot del report. I valori dei parametri vengono definiti nella pagina delle proprietà dei parametri del report. 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.
Se si modifica un valore di parametro nello snapshot del report, le sottoscrizioni per lo snapshot vengono disattivate. Per attivare la sottoscrizione, aprirla e salvarla.
Per ulteriori informazioni, vedere Prestazioni, snapshot, memorizzazione nella cache (Reporting Services).
Torna all'inizio
Parametri e sicurezza dei dati
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 diffusione 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.
.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, noto anche come 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 eseguire inavvertitamente script dannosi, aprire i report visualizzabili solo da origini attendibili. Per ulteriori informazioni sulla sicurezza dei report, vedere Garantire la sicurezza di report e risorse. |
Torna all'inizio
Procedure
In questa sezione vengono elencate le procedure in cui viene mostrato in dettaglio l'utilizzo di parametri e filtri.
Aggiungere, modificare o eliminare un parametro di report (Generatore report e SSRS)
Modificare l'ordine di un parametro del report (Generatore report e SSRS)
Aggiunta di parametri di propagazione a un report (Generatore report e SSRS)
Aggiungere un filtro a un set di dati (Generatore report e SSRS)
Torna all'inizio
Sezioni correlate
Utilizzo delle espressioni nei report (Generatore report e SSRS)
Espressioni (Generatore report e SSRS)
Filtro, raggruppamento e ordinamento di dati (Generatore report e SSRS)
Torna all'inizio
Vedere anche
Concetti
Ordinamento interattivo, mappe documento e collegamenti (Generatore report e SSRS)
Drill-through, drill-down, sottoreport e aree dati nidificate (Generatore report e SSRS)