Parametri di report impaginati in Generatore report

Questo articolo descrive gli usi comuni per i parametri di report impaginati, le proprietà che è possibile impostare e altre informazioni. I parametri del report consentono di controllare i dati del report, connettere report correlati e variare la presentazione del report. È possibile usare i parametri del report nei report impaginati creati in Generatore di report e Progettazione report. È anche possibile usare parametri di report nei report per dispositivi mobili creati in SQL Server Mobile Report Publisher. Per altre informazioni sui parametri, vedere Concetti dei parametri nei report impaginati (Generatore di report).

Per maggiori informazioni su come aggiungere un parametro a un report, vedere Esercitazione: Aggiungere un parametro al report (Generatore report).

Utilizzi comuni per i parametri

Gli utilizzi comuni per i parametri includono:

• Controllare i dati con filtri che è possibile modificare con un'interfaccia personalizzabile. Per altre informazioni, vedere Controllare i dati impaginati e dei report per dispositivi mobili.
• Connettere il report principale con report drill-through che risolvono una domanda specifica. Per altre informazioni, consultare Report relativi a Connect..
• Modificare la presentazione del report modificando il rendering. Per altre informazioni, vedere Variare la presentazione del report.

Controllare i dati dei report per dispositivi mobili e impaginati

Generatore report e Progettazione report offrono opzioni per filtrare i dati in base al tipo di dati disponibili:

• Filtrare i dati del report impaginato nell'origine dati scrivendo query del set di dati contenenti variabili.

• Filtrare i dati da un set di dati condiviso. Quando si aggiunge un set di dati condiviso a un report impaginato, 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.

• Filtrare i dati da un set di dati condiviso in un report per dispositivi mobili di SQL Server. Per altre informazioni, vedere Creare report per dispositivi mobili con SQL Server Mobile Report Publisher.

• Consentire agli utenti di specificare i valori per personalizzare i dati di un report impaginato. È ad esempio possibile fornire due parametri per la data di inizio e la data di fine dei dati di vendita.

Connettere report correlati

Usare 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. Per altre informazioni, vedere Report drill-through in un report impaginato (Generatore report), Sottoreport in report impaginati (Generatore report) e Creare un report collegato.

Personalizzare set di parametri per più utenti. Creare due report collegati basati su un report relativo alle vendite sul server di report. Un report collegato usa valori di parametro predefiniti per i venditori. Il secondo report collegato usa valori di parametro predefiniti per i responsabili delle vendite. In entrambi i report viene usata la stessa definizione report.

Variare la presentazione del report

Generatore report fornisce strumenti che è possibile usare per variare le presentazioni:

• Per personalizzare il rendering di un report, inviare comandi a un server di report tramite una richiesta URL, per personalizzare il rendering di un report. Per altre informazioni, vedere Accesso con URL (SSRS) e Passare un parametro del report in un URL.

• È possibile concedere agli utenti la possibilità di specificare i valori in modo che possano 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.

• È possibile fornire agli utenti l’opzione di personalizzare l'aspetto e i dati del report includendo parametri in un'espressione. Per altre informazioni, vedere Riferimenti alla raccolta dei parametri in un report impaginato (Generatore di report).

Visualizzazione di un report con parametri

Quando si visualizza un report con parametri, nel riquadro Parametri viene visualizzato ogni parametro in modo che gli utenti possano specificarne i valori in modo interattivo. L’immagine seguente illustra il riquadro dei parametri di un report contenente i parametri @ReportMonth, @ReportYear, @EmployeeID, @ShowAll, @ExpandTableRows, @CategoryQuota, e @SalesDate.

1. Riquadro Parametri: Nel riquadro dei Parametri vengono visualizzati un messaggio di richiesta e un valore predefinito per ogni parametro. È possibile personalizzare il layout dei Parametri. Per altre informazioni, vedere Personalizzare il riquadro dei parametri in un report impaginato (Generatore di report).

2. Parametro @SalesDate: Il parametro @SalesDate ha il tipo di dati DateTime. Accanto alla casella di testo viene visualizzata la richiesta di selezionare la data. Per modificare la data, digitare una nuova data nella casella di testo o usare il controllo calendario.

3. Parametro @ShowAll: Il parametro @ShowAll ha il tipo di dati Boolean. Usare i pulsanti di opzione per specificare True o False.

4. Handle mostra o nasconde l'area dei parametri: Nella barra degli strumenti del visualizzatore di report selezionare questa freccia per mostrare o nascondere il riquadro dei Parametri.

5. Parametro @CategoryQuota: Il parametro @CategoryQuota ha il tipo di dati Float e di conseguenza accetta un valore numerico. @CategoryQuota è impostato per consentire più valori.

6. Visualizza report Dopo aver immesso i valori dei parametri, selezionare Visualizza report per eseguire il report. Se tutti i parametri hanno valori predefiniti, il report viene eseguito automaticamente a prima vista.

Creare un parametro

È possibile creare i parametri dei report in alcuni modi:

• Usare una query del set di dati con variabili o stored procedure contenenti parametri. Per altre informazioni, vedere Query o stored procedure del set di dati con parametri.
• Creare un parametro manualmente. Per ulteriori informazioni, vedere Creare un parametro manualmente.
• Aggiungere una parte del report contenente riferimenti a un parametro. Per altre informazioni, vedere Parte di un report con un parametro.

Query o stored procedure del set di dati con parametri

Aggiungere una query del set di dati contenente variabili o una stored procedure del set di dati contenente parametri di input. Verrà creato un parametro del set di dati per ogni variabile o parametro di input e verrà creato un parametro di report per ogni parametro del set di dati.

Questa immagine di Generatore report mostra:

1. I parametri del report nel riquadro Dati del report.

2. Il set di dati con i parametri.

3. Il riquadro Parametri.

4. I parametri elencati nella finestra di dialogo Proprietà set di dati.

Il set di dati può essere incorporato o condiviso. 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.

Per altre informazioni, vedere Query sui set di dati.

Creare un parametro manualmente

Creare un parametro manualmente dal riquadro Dati del report. È 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.

Parte del report con un parametro

Aggiungere una parte del report in cui siano inclusi riferimenti a un parametro o a un set di dati condiviso contenente variabili.

Le parti di report vengono archiviate sul server di report e possono quindi essere usate 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 nella raccolta parti del report. Dopo averli aggiunti, è possibile configurarli nel report. Per altre informazioni, vedere Parti del report (Generatore report e SSRS).

Valori parametro

Di seguito sono riportate le opzioni per selezionare i valori di parametri nel report:

• Selezionare un singolo valore di parametro da un elenco a discesa.

• Selezionare più valori di parametro da un elenco a discesa.

• Selezionare un valore da un elenco a discesa per un parametro, che determina i valori disponibili nell'elenco a discesa per un altro parametro. Tali valori sono parametri di propagazione. I parametri di propagazione consentono di filtrare successivamente i valori di parametro da migliaia di valori a un numero gestibile.

  Per altre informazioni, vedere Aggiungere parametri di propagazione a un report impaginato (Generatore report).

• Eseguire il report senza dovere selezionare prima un valore di parametro poiché per il parametro esiste già un valore predefinito.

Proprietà dei parametri del report

È possibile modificare le proprietà dei parametri dei report usando la finestra di dialogo Proprietà report. Nella tabella riportata di seguito vengono riepilogate le proprietà che è possibile impostare per ogni parametro.

Query del set di dati

Per filtrare i dati nella query del set di dati, includere una clausola di restrizione che limita i dati recuperati specificando i valori da includere o escludere dal set dei risultati.

Usare Progettazione query per l'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 altre informazioni, vedere gli articoli sui tipi specifici di origini dati esterne in Set di dati del report (SSRS). Nella finestra Progettazione query relazionale, è necessario selezionare l'opzione del parametro di filtro per creare una query con parametri. Per altre informazioni, vedere Interfaccia utente di Progettazione query relazionale (Generatore report).

• È possibile specificare se creare un parametro in base a un filtro specificato in Progettazione query. È possibile effettuare questa specifica per query basate su un'origine di dati multidimensionale quale Microsoft SQL Server Analysis Services, SAP NetWeaver BI o Hyperion Essbase. Per altre informazioni, vedere l’articolo relativo alla progettazione query corrispondente all'estensione per i dati in Strumenti di progettazione query (SSRS).

Gestione di parametri per un report pubblicato

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 della definizione del report.

Per un report pubblicato, è possibile usare gli strumenti seguenti:

• Proprietà del parametro di report: Modificare i valori dei parametri del report direttamente nel server di report indipendentemente dalla definizione del report.

• Report nella cache: Per creare un piano della cache per un report, ogni parametro deve avere un valore predefinito. Per altre informazioni, vedere Report della cache (SSRS).

• Set di dati condivisi nella cache: Per creare un piano della cache per un set di dati condiviso, ogni parametro deve avere un valore predefinito. Per altre informazioni, vedere Report della cache (SSRS).

• Report collegati: È possibile creare report collegati con valori di parametri preimpostati per filtrare i dati per diverse tipologie di pubblico. Per altre informazioni, vedere Creare un report collegato.

• Sottoscrizioni di report: È possibile specificare valori di parametri per filtrare i dati e recapitare report tramite sottoscrizioni. Per altre informazioni, vedere Sottoscrizioni e recapito (Reporting Services).

• Accesso ad URL: È possibile specificare valori del parametro in un URL di un report. Inoltre è possibile eseguire report e specificare valori di parametri usando l'accesso a URL. Per altre informazioni, vedere Accesso con URL (SSRS).

Le proprietà dei parametri per un report pubblicato vengono 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. Potrebbe essere necessario modificare le proprietà dei parametri nel report pubblicato se si aggiungono o eliminano parametri nella definizione del report. Oppure potrebbe essere necessario modificare le proprietà per modificare il tipo di dati o il nome di un parametro esistente.

Non è sempre possibile modificare tutti i parametri. Se un parametro di report ottiene un valore predefinito da una query del set di dati, non sarà possibile modificare tale valore per un report pubblicato. Non può essere modificata anche nel server di report. Il valore utilizzato in fase di esecuzione viene determinato quando viene eseguita la query. Se si usano parametri basati su espressioni, viene determinato quando viene valutata l'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 usare parametri derivati da una query, a meno che la query non includa valori predefiniti per i parametri.

Parametri per una sottoscrizione

È possibile definire una sottoscrizione per un report su richiesta o snapshot e specificare valori di parametri da usare durante l'elaborazione della sottoscrizione.

• Report su richiesta: Per un report su richiesta, è possibile specificare un valore del parametro diverso dal valore pubblicato per ogni parametro elencato per il report. Si supponga, ad esempio, di usare il report delle chiamate al servizio di assistenza, per il quale viene usato 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, la sottoscrizione può usare un valore diverso, ad esempio settimana o mese, per generare un report contenente dati settimanali o mensili.

• Snapshot: La sottoscrizione deve usare i valori del 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 usare 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.

• 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 usano 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 usare 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 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 altre informazioni, vedere Sottoscrizioni e recapito (Reporting Services).

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’impostazione di parametri per i dati personali o relativi ai dipendenti consiste nel selezionare i dati basati su espressioni che includono il campo UserID dalla Campi predefiniti. La UserID consente di ottenere l'identità dell'utente che esegue il report e di usarla per recuperare i dati specifici per l'utente.

Contenuto correlato

• Esercitazione: Aggiungere un parametro al report (Generatore di report)
• Concetti relativi ai parametri di report nei report impaginati (Generatore report)
• Strumenti disponibili in SQL Server Reporting Services