Parametri report (Generatore report e Progettazione report)Report Parameters (Report Builder and Report Designer)

Questo argomento descrive gli usi comuni per i parametri di report Reporting ServicesReporting Services , le proprietà che è possibile impostare e altre informazioni.This topic describes the common uses for Reporting ServicesReporting Services report parameters, the properties you can set, and much more. I parametri del report consentono di controllare i dati del report, connettere report correlati e variare la presentazione del report.Report parameters enable you to control report data, connect related reports together, and vary report presentation. È possibile usare i parametri del report in report impaginati creati in Generatore reportReport Builder e Progettazione report, nonché in report per dispositivi mobili creati in SQL Server Mobile Report PublisherSQL Server Mobile Report Publisher.You can use report parameters in paginated reports you create in Generatore reportReport Builder and Report Designer, and also in mobile reports you create in SQL Server Mobile Report PublisherSQL Server Mobile Report Publisher. Altre informazioni sui Concetti relativi ai parametri di report.Read more about Report Parameters Concepts.

||
|-|
| Si applica a:Applies to: Generatore reportReport Builder, modalità SharePoint e modalità nativa di Reporting ServicesReporting Services Generatore reportReport Builder, Reporting ServicesReporting Services SharePoint mode and Native mode|

Per provare ad aggiungere un parametro a un report manualmente, vedere Esercitazione: Aggiungere un parametro al report (Generatore report).To try adding a parameter to a report yourself, see Tutorial: Add a Parameter to Your Report (Report Builder).

Utilizzi comuni per i parametri Common Uses for Parameters

Di seguito sono elencate alcune delle modalità più comuni in cui è possibile usare i parametri.Here are some of the most common ways to use parameters.

Controllare i dati dei report per dispositivi mobili e impaginatiControl Paginated and Mobile Report Data

  • Filtrare i dati del report impaginato nell'origine dati scrivendo query del set di dati contenenti variabili.Filter paginated report data at the data source by writing dataset queries that contain variables.

  • Filtrare i dati da un set di dati condiviso.Filter data from a shared dataset. Quando si aggiunge un set di dati condiviso a un report impaginato, non è possibile modificare la query.When you add a shared dataset to a paginated report, you cannot change the query. Nel report è possibile aggiungere un filtro del set di dati che include un riferimento a un parametro di report creato.In the report, you can add a dataset filter that includes a reference to a report parameter that you create.

  • Filtrare i dati da un set di dati condiviso in un report per dispositivi mobili di SQL ServerSQL Server .Filter data from a shared dataset in a SQL ServerSQL Server mobile report. Per ulteriori informazioni, vedere Create mobile reports with SQL Server Mobile Report Publisher .See Create mobile reports with SQL Server Mobile Report Publisher for more information.

  • Consentire agli utenti di specificare i valori per personalizzare i dati di un report impaginato.Enable users to specify values to customize the data in a paginated report. È ad esempio possibile fornire due parametri per la data di inizio e la data di fine dei dati di vendita.For example, provide two parameters for the start date and end date for sales data.

    Connettere report correlatiConnect Related Reports

  • Usare parametri per correlare report principali a report drill-through, sottoreport e report collegati.Use parameters to relate main reports to drillthrough reports, to subreports, and to linked reports. Durante la progettazione di un set di report, ogni report viene progettato in modo da rispondere a domande specifiche.When you design a set of reports, you can design each report to answer certain questions. In particolare, ogni report è in grado di offrire una vista diversa o un livello di dettaglio diverso per le informazioni correlate.Each report can provide a different view or a different level of detail for related information. Per ottenere un set di report correlati tra loro, creare i parametri per i dati correlati nei report di destinazione.To provide a set of interrelated reports, create parameters for the related data on target reports.

    Per ulteriori informazioni, vedere report drill-through ( Generatore report e SSRS ) , Sottoreport ( Generatore report e SSRS ) , e creare un Report collegato.For more information, see Drillthrough Reports (Report Builder and SSRS), Subreports (Report Builder and SSRS), and Create a Linked Report.

  • Personalizzare set di parametri per più utenti.Customize sets of parameters for multiple users. Creare due report collegati basati su un report relativo alle vendite sul server di report.Create two linked reports based on a sales report on the report server. In un report collegato vengono usati i valori di parametro predefiniti per i venditori mentre nel secondo report collegato vengono usati i valori di parametro predefiniti per i responsabili vendite.One linked report uses predefined parameter values for sales persons and the second linked report uses predefined parameter values for sales managers. In entrambi i report viene usata la stessa definizione report.Both reports use the same report definition.

    Variare la presentazione del reportVary Report Presentation

  • Inviare comandi a un server di report tramite una richiesta URL, per personalizzare il rendering di un report.Send commands to a report server through a URL request, to customize the rendering of a report. Per ulteriori informazioni, vedere accesso con URL ( SSRS ) e passare un parametro di Report all'interno di un URL.For more information, see URL Access (SSRS) and Pass a Report Parameter Within a URL.

  • Consentire agli utenti di specificare valori per personalizzare l'aspetto di un report.Enable users to specify values to help customize the appearance of a report. È ad esempio possibile fornire un parametro booleano per indicare se espandere o comprimere tutti i gruppi di righe nidificati in una tabella.For example, provide a Boolean parameter to indicate whether to expand or collapse all nested row groups in a table.

  • Consentire agli utenti di personalizzare l'aspetto e i dati del report includendo parametri in un'espressione.Enable users to customize report data and appearance by including parameters in an expression.

    Per altre informazioni, vedere Riferimenti alla raccolta dei parametri (Generatore report e SSRS).For more information, see Parameters Collection References (Report Builder and SSRS).

Visualizzazione di un report con parametri Viewing a Report with Parameters

Quando si visualizza un report con parametri, ogni parametro viene visualizzato nella barra degli strumenti del visualizzatore di report in modo che gli utenti possano specificarne i valori in modo interattivo.When you view a report that has parameters, the report viewer toolbar displays each parameter so you can interactively specify values. La figura seguente mostra l'area dei parametri di un report di withparameters @ReportMonth, @ReportYear, @EmployeeID, @ShowAll, @ExpandTableRows, @CategoryQuota, e @SalesDate.</span><span class="sxs-lookup">The following illustration shows the parameter area for a report withparameters @ReportMonth, @ReportYear, @EmployeeID, @ShowAll, @ExpandTableRows, @CategoryQuota, and @SalesDate.</span></span>

Visualizzare i report con parametriView report with parameters

  1. Riquadro Parametri Nella barra degli strumenti del visualizzatore di report vengono visualizzati un messaggio di richiesta e un valore predefinito per ogni parametro.Parameters pane The report viewer toolbar displays a prompt and default value for each parameter. È possibile personalizzare il layout dei parametri nel riquadro Parametri.You can customize the layout of parameters in the parameters pane. Per altre informazioni, vedere Personalizzare il riquadro dei parametri in un report (Generatore report).For more information, see Customize the Parameters Pane in a Report (Report Builder).

  2. @SalesDateparametro il parametro @SalesDate è di tipo di dati DateTime.@SalesDate parameter The parameter @SalesDate is data type DateTime. Accanto alla casella di testo viene visualizzata la richiesta di selezionare la data.The prompt Select the Date appears next to the text box. Per modificare la data, digitare una nuova data nella casella di testo o usare il controllo calendario.To modify the date, type a new date in the text box or use the calendar control.

  3. @ShowAllparametro il parametro @ShowAll è di tipo di dati booleano.@ShowAll parameter The parameter @ShowAll is data type Boolean. Usare i pulsanti di opzione per specificare True o False.Use the radio buttons to specify True or False.

  4. 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.Show or Hide Parameter Area handle On the report viewer toolbar, click this arrow to show or hide the parameters pane.

  5. @CategoryQuotaparametro il parametro @CategoryQuota è di tipo di dati Float, in modo da un valore numerico.@CategoryQuota parameter The parameter @CategoryQuota is data type Float, so it takes a numeric value. @CategoryQuotaè impostata su Consenti più valori.@CategoryQuota is set to allow multiple values.

  6. Visualizza report Dopo aver immesso i valori dei parametri, fare clic su Visualizza report per eseguire il report.View Report After you enter parameter values, click View Report to run the report. Se tutti i parametri hanno valori predefiniti, il report viene eseguito automaticamente a prima vista.If all parameters have default values, the report runs automatically on first view.

Creazione di parametri Creating Parameters

È possibile creare i parametri dei report in alcuni modi diversi.You can create report parameters in a few different ways.

Nota

Non tutte le origini dati supportano i parametri.Not all data sources support parameters.

Query o stored procedure del set di dati con parametriDataset query or stored procedure with parameters

Aggiungere una query del set di dati contenente variabili o una stored procedure del set di dati contenente parametri di input.Add a dataset query that contains variables or a dataset stored procedure that contains input parameters. 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.A dataset parameter is created for each variable or input parameter, and a report parameter is created for each dataset parameter.

Proprietà set di dati del parametro Generatore reportReport Builder Parameter Dataset Properties

Questa immagine di Generatore report mostra:This image from Report Builder shows:

  1. I parametri del report nel riquadro dei dati del report.The report parameters in the Report Data pane.

  2. Il set di dati con i parametri.The dataset with the parameters.

  3. Il riquadro Parametri.The Parameters pane.

  4. I parametri elencati nella finestra di dialogo Proprietà set di dati.The parameters listed in the Dataset Properties dialog box.

    Il set di dati può essere incorporato o condiviso.The dataset can be embedded or shared. 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.When you add a shared dataset to a report, dataset parameters that are marked internal cannot be overridden in the report. È possibile eseguire l'override dei parametri del set di dati che non sono contrassegnati come interni.You can override dataset parameters that are not marked internal.

    Per altre informazioni, vedere Query del set di dati più avanti in questo argomento.For more information, see Dataset Query in this topic.

    Creare un parametro manualmenteCreate a parameter manually

    Creare manualmente un parametro dal riquadro dei dati del report.Create a parameter manually from the Report Data pane. È 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.You can configure report parameters so that a user can interactively enter values to help customize the contents or appearance of a report. È inoltre possibile configurare i parametri del report in modo che un utente non possa modificare i valori preconfigurati.You can also configure report parameters so that a user cannot change preconfigured values.

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.Because parameters are managed independently on the server, republishing a main report with new parameter settings does not overwrite the existing parameters settings on the report.

Parte del report con un parametroReport part with a parameter

Aggiungere una parte del report in cui siano inclusi riferimenti a un parametro o a un set di dati condiviso contenente variabili.Add a report part that contains references to a parameter or to a shared dataset that contains variables.

Le parti di report vengono archiviate sul server di report e possono quindi essere usate da altri utenti nei propri report.Report parts are stored on the report server and available for others to use in their reports. Le parti di report corrispondenti a parametri non possono essere gestite dal server di report.Report parts that are parameters cannot be managed from the report server. È possibile cercare i parametri in Raccolta parti del report e configurarli nel report dopo averli aggiunti.You can search for parameters in the Report Part Gallery and after you add them, configure them in your report. Per altre informazioni, vedere Report Parts (Report Builder and SSRS).For more information, see Report Parts (Report Builder and SSRS).

Nota

I parametri possono essere pubblicati come parte del report separata per aree dati che dispongono di set di dati dipendenti con parametri.Parameters can be published as a separate report part for data regions that have dependent datasets with parameters. Sebbene i parametri siano elencati come parte del report, non è possibile aggiungere un parametro della parte del report direttamente a un report.Although parameters are listed as a report part, you cannot add a report part parameter directly to a 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.Instead, add the report part, and any necessary report parameters are automatically generated from dataset queries that are contained or referenced by the report part. Per ulteriori informazioni sulle parti del report, vedere parti di Report ( Generatore report e SSRS ) e parti in Progettazione Report ( di Report SSRS ) .For more information about report parts, see Report Parts (Report Builder and SSRS) and Report Parts in Report Designer (SSRS).

Valori di parametriParameter Values

Di seguito sono riportate le opzioni per selezionare i valori di parametri nel report.The following are options for selecting parameter values in the report.

  • Selezionare un singolo valore di parametro da un elenco a discesa.Select a single parameter value from a drop-down list.

  • Selezionare più valori di parametro da un elenco a discesa.Select multiple parameter values from a drop-down list.

  • Selezionare un valore da un elenco a discesa per un parametro, che determina i valori disponibili nell'elenco a discesa per un altro parametro.Select a value from a drop-down list for one parameter, which determines the values that are available in the drop-down list for another parameter. Tali parametri sono definiti di propagazione.These are cascading parameters. I parametri di propagazione consentono di filtrare successivamente i valori di parametro da migliaia di valori a un numero gestibile.Cascading parameters enables you to successively filter parameter values from thousands of values to a manageable number.

    Per altre informazioni, vedere Aggiungere parametri di propagazione a un report (Generatore report e SSRS).For more information, see Add Cascading Parameters to a Report (Report Builder and SSRS).

  • Eseguire il report senza dovere selezionare prima un valore di parametro poiché per il parametro è stato creato un valore predefinito.Run the report without having to first select a parameter value because a default value has been created for the parameter.

Proprietà dei parametri di report Report Parameter Properties

È possibile modificare le proprietà dei parametri di report mediante la finestra di dialogo Proprietà report.You can change the report parameter properties by using the Report Properties dialog box. Nella tabella riportata di seguito vengono riepilogate le proprietà che è possibile impostare per ogni parametro.The following table summarizes the properties that you can set for each parameter:

ProprietàProperty DescriptionDescription
NomeName Digitare un nome con distinzione tra maiuscole e minuscole per il parametro.Type a case-sensitive name for the parameter. Il nome deve iniziare con una lettera e contenere lettere, numeri e un carattere di sottolineatura ().The name must begin with a letter and can have letters, numbers, an underscore (). Il nome non può contenere spazi.The name cannot have spaces. Per i parametri generati automaticamente, il nome corrisponde al parametro nella query del set di dati.For automatically-generated parameters, the name matches the parameter in the dataset query. Per impostazione predefinita, i parametri creati manualmente sono simili a ParametroReport1.By default, manually-created parameters are similar to ReportParameter1.
Messaggio di richiestaPrompt Il testo che viene visualizzato accanto al parametro nella barra degli strumenti del visualizzatore di report.The text that appears next to the parameter on the report viewer toolbar.
Tipo di datiData type Un parametro di report deve corrispondere a uno dei seguenti tipi di dati:A report parameter must be one of the following data types:

Valorebooleano.Boolean. L'utente seleziona True o False mediante un pulsante di opzione.The user selects True or False from a radio button.

DateTime.DateTime. L'utente seleziona una data da un controllo calendario.The user selects a date from a calendar control.

Integer.Integer. L'utente digita valori in una casella di testo.The user types values in a text box.

Float.Float. L'utente digita valori in una casella di testo.The user types values in a text box.

Text.Text. L'utente digita valori in una casella di testo.The user types values in a text box.

Si noti che quando sono definiti i valori disponibili per un parametro, l'utente sceglie i valori da un elenco a discesa, anche quando il tipo di dati è DateTime.Note that when available values are defined for a parameter, the user chooses values from a drop-down list, even when the data type is DateTime.

Per altre informazioni sui tipi di dati di report, vedere RDL Data Types.For more information about report data types, see RDL Data Types.
Consenti nessun valoreAllow blank value Selezionare questa opzione se il valore del parametro può corrispondere a una stringa vuota o a un valore vuoto.Select this option if the value of the parameter can be an empty string or a blank.

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.If you specify valid values for a parameter, and you want a blank value to be one of the valid values, you must include it as one of the values that you specify. La selezione di questa opzione non include automaticamente un valore vuoto tra i valori disponibili.Selecting this option does not automatically include a blank for available values.
Consenti valore NullAllow null value Selezionare questa opzione se il valore del parametro può essere un valore Null.Select this option if the value of the parameter can be a 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.If you specify valid values for a parameter, and you want null to be one of the valid values, you must include null as one of the values that you specify. La selezione di questa opzione non include automaticamente un valore Null tra i valori disponibili.Selecting this option does not automatically include a null for available values.
Consenti più valoriAllow multiple values Fornire i valori disponibili per creare un elenco a discesa dal quale gli utenti possono scegliere.Provide available values to create a drop-down list that your users can choose from. Si tratta di un metodo efficace per assicurarsi che nella query del set di dati vengano inviati solo valori validi.This is a good way to ensure that only valid values are submitted in the dataset query.

Selezionare questa opzione se il valore per il parametro può essere costituito da più valori visualizzati in un elenco a discesa.Select this option if the value for the parameter can be multiple values that are displayed in a drop-down list. I valori Null non sono consentiti.Null values are not allowed. Se questa opzione è selezionata, verranno aggiunte caselle di controllo all'elenco di valori disponibili nell'elenco a discesa dei parametri.When this option is selected, check boxes are added to the list of available values in a parameter drop-down list. Nella parte superiore dell'elenco è inclusa una casella di controllo Seleziona tutto.The top of the list includes a check box for Select All. Gli utenti possono selezionare i valori desiderati.Users can check the values that they want.

Se i dati che forniscono i valori cambiano rapidamente, l'utente potrebbe non visualizzare l'elenco più recente.If the data that provides values changes rapidly, the list the user sees might not be the most current.
VisibleVisible Selezionare questa opzione per visualizzare il parametro nella parte superiore del report durante l'esecuzione.Select this option to display the report parameter at the top of the report when it is run. Questa opzione consente agli utenti di selezionare i valori del parametro in fase di esecuzione.This option allows users to select parameter values at run time.
HiddenHidden Selezionare questa opzione per nascondere il parametro nel report pubblicato.Select this option to hide the report parameter in the published report. 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 usando Gestione report.The report parameter values can still be set on a report URL, in a subscription definition, or on the report server.
InternoInternal Selezionare questa opzione per nascondere il parametro di report.Select this option to hide the report parameter. Nel report pubblicato, il parametro di report potrà essere visualizzato solo nella relativa definizione.In the published report, the report parameter can only be viewed in the report definition.
Valori disponibiliAvailable values Se sono stati specificati valori disponibili per un parametro, tali valori vengono sempre visualizzati sotto forma di elenco a discesa.If you have specified available values for a parameter, the valid values always appear as a drop-down list. Se si forniscono i valori disponibili per un parametro DateTime , ad esempio, nel riquadro del parametro viene visualizzato un elenco a discesa per le date invece di un controllo calendario.For example, if you provide available values for a DateTime parameter, a drop-down list for dates appears in the parameter pane instead of a calendar control.

Per assicurarsi che un elenco di valori sia coerente fra report e sottoreport, è possibile impostare un'opzione sull'origine dati per usare una sola transazione per tutte le query nei set di dati associati a un'origine dati.To ensure that a list of values is consistent among a report and subreports, you can set an option on the data source to use a single transaction for all queries in the datasets that are associated with a data source.

** Nota per la sicurezza *\* In qualsiasi report che includa un parametro con il tipo di dati Text, assicurarsi di usare un elenco di valori disponibili, noto anche come elenco di valori validi, e verificare che ogni utente che esegue il report abbia solo le autorizzazioni necessarie per visualizzare i dati del report.** Security Note *\* In any report that includes a parameter of data type Text, be sure to use an available values list (also known as a valid values list) and ensure that any user running the report has only the permissions necessary to view the data in the report. Per altre informazioni, vedere Sicurezza (Generatore report).For more information, see Security (Report Builder).
Valori predefinitiDefault values Impostare i valori predefiniti da una query o da un elenco statico.Set default values from a query or from a static list.

Il report viene eseguito automaticamente a prima vista quando ogni parametro ha un valore predefinito.When each parameter has a default value, the report runs automatically on first view.
AvanzateAdvanced Impostare l'attributo di definizione del report UsedInQuery, un valore che indica se questo parametro influisce direttamente o indirettamente sui dati di un report.Set the report definition attribute UsedInQuery, a value that indicates whether this parameter directly or indirectly affects the data in a report.

Determina automaticamente quando eseguire l'aggiornamentoAutomatically determine when to refresh
Scegliere questa opzione se si desidera che l'impostazione per questo valore venga determinata dal componente Elaborazione report.Choose this option when you want the report processor to determine a setting for this value. Questo valore è True se il componente Elaborazione report rileva una query del set di dati con un riferimento diretto o indiretto a questo parametro oppure se il report contiene sottoreport.The value is True if the report processor detects a dataset query with a direct or indirect reference to this parameter, or if the report has subreports.

Aggiorna sempreAlways refresh
Scegliere questa opzione quando il parametro di report viene usato direttamente o indirettamente in una query del set di dati o in un'espressione del parametro.Choose this option when the report parameter is used directly or indirectly in a dataset query or parameter expression. Questa opzione determina l'impostazione di UsedInQuery su True.This option sets UsedInQuery to True.

Non aggiornare maiNever refresh
Scegliere questa opzione quando il parametro di report non viene usato direttamente o indirettamente in una query del set di dati o in un'espressione del parametro.Choose this option when the report parameter is not used directly or indirectly in a dataset query or parameter expression. Questa opzione determina l'impostazione di UsedInQuery su False.This option sets UsedInQuery to False.

** Attenzione *\* Usare Non aggiornare mai con cautela.** Caution *\* Use Never Refresh with caution. Nel server di report UsedInQuery viene usato per consentire il controllo delle opzioni della cache per i dati dei report sottoposti a rendering e delle opzioni di parametro per i report snapshot.On the report server, UsedInQuery is used to help control cache options for report data and for rendered reports, and parameter options for snapshot reports. L'impostazione non corretta dell'opzione Non aggiornare mai potrebbe determinare la memorizzazione nella cache di report o dati del report non corretti o la presenza di dati non coerenti in un report snapshot.If you set Never Refresh incorrectly, you could cause incorrect report data or reports to be cached, or cause a snapshot report to have inconsistent data. Per altre informazioni, vedere Report Definition Language (SSRS).For more information, see Report Definition Language (SSRS).

Query del set di dati Dataset Query

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.To filter data in the dataset query, you can include a restriction clause that limits the retrieved data by specifying values to include or exclude from the result set.

Usare Progettazione query per l'origine dati per compilare una query con parametri.Use the query designer for the data source to help build a parameterized query.

  • Per query Transact-SQLTransact-SQL , origini dati diverse supportano una sintassi diversa per i parametri.For Transact-SQLTransact-SQL queries, different data sources support different syntax for parameters. Supportare gli intervalli dei parametri identificati nella query in base alla posizione o al nome.Support ranges from parameters that are identified in the query by position or by name. Per ulteriori informazioni, vedere gli argomenti per i tipi di origini dati esterni specifici in i set di dati ( SSRS ) .For more information, see topics for specific external data source types in Report Datasets (SSRS). Nella finestra Progettazione query relazionale, è necessario selezionare l'opzione del parametro di filtro per creare una query con parametri.In the relational query designer, you must select the parameter option for a filter to create a parameterized query. Per altre informazioni, vedere Interfaccia utente di Progettazione query relazionale (Generatore report).For more information, see Relational Query Designer User Interface (Report Builder).

  • 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.For queries that are based on a multidimensional data source such as Microsoft SQL Server Analysis Services, SAP NetWeaver BI, or Hyperion Essbase, you can specify whether to create a parameter based on a filter that you specify in the query designer. Per altre informazioni, vedere l'argomento relativo alla progettazione query corrispondente all'estensione per i dati in Finestre di progettazione query (Generatore report).For more information, see the query designer topic in Query Designers (Report Builder) that corresponds to the data extension.

Gestione di parametri per un report pubblicato Parameter Management for a Published Report

Quando si progetta un report, i parametri corrispondenti vengono salvati nella definizione del report.When you design a report, report parameters are saved in the report definition. Quando si pubblica un report, i parametri corrispondenti vengono salvati e gestiti separatamente della definizione del report.When you publish a report, report parameters are saved and managed separately from the report definition.

Per un report pubblicato, è possibile usare gli elementi seguenti:For a published report, you can use the following:

  • Proprietà del parametro di report.Report parameter properties. Modificare i valori del parametro di report direttamente nel server di report, indipendentemente dalla definizione del report.Change report parameter values directly on the report server independently from the report definition.

  • Report memorizzati nella cache.Cached reports. Per creare un piano della cache per un report, ogni parametro deve avere un valore predefinito.To create a cache plan for a report, each parameter must have a default value. Per altre informazioni, vedere Memorizzazione dei report nella cache (SSRS).For more information, see Caching Reports (SSRS).

  • Set di dati condivisi memorizzati nella cache.Cached shared datasets. Per creare un piano della cache per un set di dati condiviso, ogni parametro deve avere un valore predefinito.To create a cache plan for a shared dataset, each parameter must have a default value. Per altre informazioni, vedere Memorizzazione dei report nella cache (SSRS).For more information, see Caching Reports (SSRS).

  • Report collegati.Linked reports. È possibile creare report collegati con valori di parametri preimpostati per filtrare i dati per diverse tipologie di pubblico.You can create linked reports with preset parameter values to filter data for different audiences. Per altre informazioni, vedere Creare un report collegato.For more information, see Create a Linked Report.

  • Sottoscrizioni di report.Report subscriptions. È possibile specificare valori di parametri per filtrare i dati e recapitare report tramite sottoscrizioni.You can specify parameter values to filter data and deliver reports through subscriptions. Per altre informazioni, vedere Sottoscrizioni e recapito (Reporting Services).For more information, see Subscriptions and Delivery (Reporting Services).

  • Accesso con URL.URL access. È possibile specificare valori del parametro in un URL di un report.You can specify parameter values in a URL to a report. Inoltre è possibile eseguire report e specificare valori di parametri usando l'accesso a URL.You can also run reports and specify parameter values using URL access. Per ulteriori informazioni, vedere accesso con URL ( SSRS ) .For more information, see URL Access (SSRS).

    Le proprietà dei parametri per un report pubblicato vengono in genere mantenute se si pubblica nuovamente la definizione del report.Parameter properties for a published report are generally preserved if you republish the report definition. 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.If the report definition is republished as the same report, and parameter names and data types remain the same, your property settings are retained. 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.If you add or delete parameters in the report definition, or change the data type or name of an existing parameter, you may need to change the parameter properties in the published report.

    Non è sempre possibile modificare tutti i parametri.Not all parameters can be modified in all cases. 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 né sarà possibile modificarlo nel server di report.If a report parameter gets a default value from a dataset query, that value cannot be modified for a published report and cannot be modified on the report server. Il valore usato 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.The value that is used at run time is determined when the query runs, or in the case of expression-based parameters, when the expression is evaluated.

    Le opzioni di esecuzione del report possono influire sulle modalità di elaborazione dei parametri.Report execution options can affect how parameters are processed. 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.A report that runs as a snapshot cannot use parameters that are derived from a query unless the query includes default values for the parameters.

Parametri per una sottoscrizione Parameters for a Subscription

È possibile definire una sottoscrizione per un report su richiesta o snapshot e specificare valori di parametri da usare durante l'elaborazione della sottoscrizione.You can define a subscription for an on demand or for a snapshot and specify parameter values to use during subscription processing.

  • Report su richiesta.On demand report. Per un report su richiesta, è possibile specificare un valore del parametro diverso dal valore pubblicato per ogni parametro elencato per il report.For an on demand report, you can specify a different parameter value than the published value for each parameter listed for the 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.For example, suppose you have a Call Service report that uses a Time Period parameter to return customer service requests for the current day, week, or month. 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.If the default parameter value for the report is set to today, your subscription can use a different parameter value (such as week or month) to produce a report that contains weekly or monthly figures.

  • Snapshot.Snapshot. La sottoscrizione deve usare i valori del parametro definiti per lo snapshot.For a snapshot, your subscription must use the parameter values defined for the snapshot. Nella sottoscrizione non è possibile definire un valore di parametro per sostituire il valore di parametro definito per uno snapshot.Your subscription cannot override a parameter value that is defined for a 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.For example, suppose you are subscribing to a Western regional sales report that runs as a report snapshot, and the snapshot specifies Western as a regional parameter value. In questo caso, se si crea una sottoscrizione di questo report, è necessario usare il valore di parametro sud nella sottoscrizione.In this case, if you create a subscription to this report, you must use the parameter value Western in your subscription. Per consentire di individuare immediatamente i parametri che non possono essere modificati, i campi corrispondenti nella pagina di sottoscrizione sono di sola lettura.To provide a visual indication that the parameter is ignored, the parameter fields on the subscription page are set to read-only fields.

    Le opzioni di esecuzione del report possono influire sulle modalità di elaborazione dei parametri.Report execution options can affect how parameters are processed. Un report con parametri che viene eseguito come snapshot del report usano i valori dei parametri definiti per lo snapshot del report.Parameterized reports that run as report snapshots use the parameter values defined for the report snapshot. I valori dei parametri vengono definiti nella pagina delle proprietà dei parametri del report.Parameter values are defined in the parameter properties page of the 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.A report that runs as a snapshot cannot use parameters that are derived from a query unless the query includes default values for the parameters.

    Se si modifica un valore di parametro nello snapshot del report dopo aver definito la sottoscrizione, questa viene disattivata dal server di report.If a parameter value changes in the report snapshot after the subscription is defined, the report server deactivates the subscription. La disattivazione della sottoscrizione indica che il report è stato modificato.Deactivating the subscription indicates that the report has been modified. Per attivare la sottoscrizione, aprirla e salvarla.To activate the subscription, open and then save the subscription.

Nota

Per le sottoscrizioni guidate dai dati è possibile usare valori di parametri ottenuti da un'origine dei dati del Sottoscrittore.Data-driven subscriptions can use parameter values that are obtained from a subscriber data source. Per altre informazioni, vedere Usare un'origine dati esterna per i dati del Sottoscrittore (sottoscrizione guidata dai dati).For more information, see Use an External Data Source for Subscriber Data (Data-Driven Subscription).

Per altre informazioni, vedere Sottoscrizioni e recapito (Reporting Services).For more information, see Subscriptions and Delivery (Reporting Services).

Parametri e sicurezza dei dati Parameters and Securing Data

Quando si distribuiscono report con parametri che contengono informazioni riservate è necessario fare attenzione.Use caution when distributing parameterized reports that contain confidential or sensitive information. Un utente può facilmente sostituire un parametro di report con un valore diverso, con la conseguente diffusione di informazioni potenzialmente riservate.A user can easily replace a report parameter with a different value, resulting in information disclosure that you did not intend.

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.A secure alternative to using parameters for employee or personal data is to select data based on expressions that include the UserID field from the Users collection. La raccolta Users consente di ottenere l'identità dell'utente che esegue il report e di usarla per recuperare i dati specifici per l'utente.The Users collection provides a way to get the identity of the user running the report, and use that identity to retrieve user-specific data.

Importante

In qualsiasi report che includa un parametro di tipo String, accertarsi di usare 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.In any report that includes a parameter of type String, be sure to use an available values list (also known as a valid values list) and ensure that any user running the report has only the permissions necessary to view the data in the report. Quando si definisce un parametro di tipo String, viene visualizzata una casella di testo che può accettare qualsiasi valore.When you define a parameter of type String, the user is presented with a text box that can take any value. Un elenco di valori disponibili consente di limitare i valori che è possibile immettere.An available values list limits the values that can be entered. Se un parametro di report è correlato a un parametro del set di dati e non si usa 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.If the report parameter is tied to a dataset parameter and you do not use an available values list, it is possible for a report user to type SQL syntax into the text box, potentially opening the report and your server to a SQL injection attack. Se l'utente dispone di autorizzazioni sufficienti per eseguire la nuova istruzione SQL, è possibile che nel server si verifichino risultati non desiderati.If the user has sufficient permissions to execute the new SQL statement, it may produce unwanted results on the server.

Se un parametro di report non è correlato a un parametro del set di dati 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.If a report parameter is not tied to a dataset parameter and the parameter values are included in the report, it is possible for a report user to type expression syntax or a URL into the parameter value, and render the report to Excel or HTML. Se il report viene in seguito visualizzato da un altro utente che fa clic sul contenuto dei parametri di cui è stato eseguito il rendering, è possibile che venga inavvertitamente eseguito il collegamento o lo script dannoso.If another user then views the report and clicks the rendered parameter contents, the user may inadvertently execute the malicious script or link.

Per ridurre il rischio di eseguire inavvertitamente script dannosi, aprire i report visualizzabili solo da origini attendibili.To mitigate the risk of inadvertently running malicious scripts, open rendered reports only from trusted sources. Per altre informazioni sulla sicurezza dei report, vedere Garantire la sicurezza di report e risorse.For more information about securing reports, see Secure Reports and Resources.

Procedure How-To Topics

In questa sezione vengono elencate le procedure in cui viene mostrato in dettaglio l'utilizzo di parametri e filtri.This section lists procedures that show you, step by step, how to work with parameters and filters.

Configurazione dei parametri di report SSRS (quiz)Configuring SSRS Report Parameters (quiz)

Esercitazione: Aggiungere un parametro al report (Generatore report)Tutorial: Add a Parameter to Your Report (Report Builder)

Concetti relativi ai parametri di reportReport Parameters Concepts

Esempi di report (Generatore report e SSRS)Report Samples (Report Builder and SSRS)

Uso delle espressioni nei report (Generatore report e SSRS)Expression Uses in Reports (Report Builder and SSRS)

Espressioni (Generatore report e SSRS)Expressions (Report Builder and SSRS)

Filtrare, raggruppare e ordinare i dati (Generatore report e SSRS)Filter, Group, and Sort Data (Report Builder and SSRS)

Sicurezza (Generatore report)Security (Report Builder)

Ordinamento interattivo, mappe documento e collegamenti (Generatore report e SSRS)Interactive Sort, Document Maps, and Links (Report Builder and SSRS)

Drill-through, drill-down, sottoreport e aree dati annidate (Generatore report e SSRS)Drillthrough, Drilldown, Subreports, and Nested Data Regions (Report Builder and SSRS)