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

In questa esercitazione viene aggiunto un parametro in un report impaginato di Reporting ServicesReporting Services per consentire ai lettori del report di filtrare i dati in base a uno o più valori.In this tutorial, you add a parameter to a Reporting ServicesReporting Services paginated report so report readers can filter report data for one or more values.

report-builder-parameter-tutorial

I parametri di report vengono creati automaticamente per ogni parametro di query incluso in una query del set di dati.Report parameters are created automatically for each query parameter that you include in a dataset query. Il tipo di dati determina il modo in cui il parametro viene presentato sulla barra degli strumenti della visualizzazione report.The parameter data type determines how it appears on the report view toolbar.

Nota

In questa esercitazione, i passaggi per la procedura guidata sono consolidati in un'unica procedura.In this tutorial, the steps for the wizard are consolidated into one procedure. Per istruzioni dettagliate su come selezionare un server di report, come scegliere un'origine dati e come creare un set di dati, vedere la prima esercitazione di questa serie: Esercitazione: Creazione di un report tabella semplice (Generatore report).For step-by-step instructions about how to browse to a report server, choose a data source, and create a dataset, see the first tutorial in this series: Tutorial: Creating a Basic Table Report (Report Builder).

Tempo stimato per il completamento dell'esercitazione: 25 minuti.Estimated time to complete this tutorial: 25 minutes.

RequisitiRequirements

Per informazioni sui requisiti, vedere Prerequisiti per le esercitazioni (Generatore report).For information about requirements, see Prerequisites for Tutorials (Report Builder).

1. Creare un report matrice e un set di dati nella Creazione guidata tabella o matrice1. Create a Matrix Report and Dataset in the Table or Matrix Wizard

Creare un report matrice, un'origine dati e un set di dati.Create a matrix report, a data source, and a dataset.

Nota

Nella query di questa esercitazione sono contenuti i valori dei dati in modo che non sia necessaria un'origine dati esterna.In this tutorial, the query contains the data values, so that it does not need an external data source. Tale condizione rende tuttavia la query piuttosto lunga.This makes the query quite long. In una query di un ambiente aziendale non sarebbe incluso alcun dato.In a business environment, a query would not contain the data. Questo esempio è solo a scopo illustrativo.This is for learning purposes only.

Per creare un nuovo report matriceTo create a new matrix report

  1. Avviare Generatore report dal computer, dal portale Web di Reporting ServicesReporting Services o in modalità integrata SharePoint.Start Report Builder either from your computer, the Reporting ServicesReporting Services web portal, or SharePoint integrated mode.

    Si apre la finestra di dialogo Nuovo report o set di dati .The New Report or Dataset dialog box opens.

    Se la finestra di dialogo Nuovo report o set di dati non viene visualizzata, scegliere Nuovo dal menu File.If you don't see the New Report or Dataset dialog box, on the File menu > New.

  2. Nel riquadro sinistro assicurarsi che sia selezionata l'opzione Nuovo report .In the left pane, make sure New Report is selected.

  3. Nel riquadro destro fare clic su Creazione guidata tabella o matrice.In the right pane, click Table or Matrix Wizard.

  4. Nella pagina Scegliere un set di dati fare clic su Crea un set di dati > Avanti.On the Choose a dataset page, click Create a dataset > Next.

  5. Nella pagina Scegliere una connessione a un'origine dei dati selezionare un'origine dati dall'elenco o passare al server di report per selezionarne una.On the Choose a connection to a data source page, select a data source from the list or browse to the report server to select one. Selezionare un'origine dati di tipo SQL Server.Select any data source that is type SQL Server.

  6. Scegliere Avanti.Click Next.

    Potrebbe essere necessario immettere le credenziali.You may need to enter your credentials.

  7. Nella pagina Progetta query fare clic su Modifica come testo.On the Design a query page, click Edit as Text.

  8. Incollare la query seguente nel riquadro vuoto superiore:Paste the following query into the empty pane at the top:

    ;WITH CTE (StoreID, Subcategory, Quantity)   
    AS (  
    SELECT 200 AS StoreID, 'Digital SLR Cameras' AS Subcategory, 2002 AS Quantity  
    UNION SELECT  200 AS StoreID, 'Camcorders' AS Subcategory, 1954 AS Quantity  
    UNION SELECT  200 AS StoreID, 'Accessories' AS Subcategory, 1895 AS Quantity  
    UNION SELECT  199 AS StoreID, 'Digital Cameras' AS Subcategory, 1849 AS Quantity  
    UNION SELECT  306 AS StoreID, 'Digital SLR Cameras' AS Subcategory, 1579 AS Quantity  
    UNION SELECT  306 AS StoreID, 'Camcorders' AS Subcategory, 1561 AS Quantity  
    UNION SELECT  306 AS StoreID, 'Digital Cameras' AS Subcategory, 1553 AS Quantity  
    UNION SELECT  306 AS StoreID, 'Accessories' AS Subcategory, 1534 AS Quantity  
    UNION SELECT 307 AS StoreID, 'Accessories' AS Subcategory, 1755 AS Quantity  
    UNION SELECT 307 AS StoreID, 'Camcorders' AS Subcategory, 1631 AS Quantity  
    UNION SELECT 307 AS StoreID, 'Digital SLR Cameras' AS Subcategory, 1772 AS Quantity)  
    SELECT StoreID, Subcategory, Quantity  
    FROM CTE  
    

    Questa query combina i risultati di diverse istruzioni SELECT di Transact-SQLTransact-SQL in un'espressione di tabella comune per specificare valori basati sui dati di vendita semplificati per le fotocamere del database di esempio Contoso.This query combines the results of several Transact-SQLTransact-SQL SELECT statements inside a common table expression to specify values that are based on simplified sales data for cameras from the Contoso sample database. Le sottocategorie sono costituite da fotocamere digitali, fotocamere single lens reflex (SLR), cineprese e accessori.The subcategories are digital cameras, digital single lens reflex (SLR) cameras, camcorders, and accessories.

  9. Sulla barra degli strumenti di Progettazione query fare clic su Esegui (!) per visualizzare i dati.On the query designer toolbar, click Run (!) to see the data.

    Il set di risultati include 11 righe di dati che mostrano la quantità di articoli venduti per ogni sottocategoria in quattro punti vendita nelle colonne seguenti: StoreID, Subcategory, Quantity. Il nome del punto vendita non è incluso nel set di risultati.The result set consists of 11 rows of data that show the quantity of items sold for each subcategory for four stores, in the following columns: StoreID, Subcategory, Quantity.The store name is not part of the result set. Più avanti in questa esercitazione, si cercherà il nome del punto vendita che corrisponde all'identificatore del punto vendita in un set di dati separato.Later in this tutorial, you will look up the name of the store that corresponds to the store identifier from a separate dataset.

    Questa query non contiene parametri di query.This query does not contain query parameters. Verranno aggiunti più avanti in questa esercitazione.You will add query parameters later in this tutorial.

  10. Scegliere Avanti.Click Next.

2. Organizzare i dati e scegliere il layout nella procedura guidata2. Organize Data and Choose Layout in the Wizard

La procedura guidata offre una progettazione iniziale per la visualizzazione dei dati.The wizard provides a starting design for displaying data. Il riquadro di anteprima nella procedura guidata consente di visualizzare il risultato del raggruppamento di dati prima di completare la progettazione della tabella o della matrice.The preview pane in the wizard helps you to visualize the result of grouping data before you complete the table or matrix design.

Per organizzare i dati in gruppiTo organize data into groups

  1. Nella pagina Disponi campi trascinare Subcategory in Gruppi di righe.On the Arrange fields page, drag Subcategory to Row groups.

  2. Trascinare StoreID in Gruppi di colonne.Drag StoreID to Column groups.

  3. Trascinare Quantity in Valori.Drag Quantity to Values.

    I valori delle quantità vendute sono stati organizzati in righe raggruppate per sottocategoria, con una colonna per ogni punto vendita.You have organized the quantity sold values in rows grouped by subcategory, with one column for each store.

  4. Scegliere Avanti.Click Next.

  5. Nella pagina Scegliere il layout in Opzioniverificare che la casella Mostra subtotali e totali complessivi sia selezionata.On the Choose the Layout page, under Options, make sure Show subtotals and grand totals is selected.

    Quando si esegue il report, nell'ultima colonna verrà mostrata la quantità totale di ogni sottocategoria per tutti i punti vendita mentre nell'ultima riga verrà mostrata la quantità totale per tutte le sottocategorie per ogni punto vendita.When you run the report, the last column will show the total quantity of each subcategory for all stores, and the last row will show the total quantity for all subcategories for each store.

  6. Scegliere Avanti.Click Next.

  7. Fare clic su Fine.Click Finish.

    La matrice viene aggiunta all'area di progettazione.The matrix is added to the design surface. Nella matrice sono visualizzate tre colonne e tre righe.The matrix displays three columns and three rows. Il contenuto delle celle nella prima riga è Sottocategoria, [StoreID] e Totale.The contents of the cells in the first row are Subcategory, [StoreID], and Total. Nelle celle della seconda riga sono visualizzate le espressioni che rappresentano la sottocategoria, la quantità di articoli venduti per ogni punto vendita e la quantità totale per ogni sottocategoria per tutti i punti vendita.The contents of the cells in the second row contain expressions that represent the subcategory, the quantity of items sold for each store, and the total quantity for each subcategory for all stores. Nelle celle della riga finale è visualizzato il totale complessivo per ogni punto vendita.The cells in the final row display the grand total for each store.

    ssRB_ParamTut_Design

  8. Fare clic nella matrice, posizionare il puntatore sul bordo della prima colonna, fare clic sul quadratino di ridimensionamento ed espandere la larghezza della colonna.Click in the matrix, hover over the edge of the first column, grab the handle, and expand the column width.

    ssRB_ParamTut_Drag

  9. Fare clic su Esegui per visualizzare l'anteprima del report.Click Run to preview the report.

Il report verrà eseguito nel server di report, con il titolo e l'ora di elaborazione del report visualizzati.The report runs on the report server and displays the title and the time the report processing occurred.

ssRB_ParamTut__Preview1

Le intestazioni di colonna visualizzano l'identificatore ma non il nome del punto vendita.So far the column headings display the store identifier but not the store name. Più avanti in questa esercitazione, verrà aggiunta un'espressione per cercare il nome del punto vendita in un set di dati che contiene la coppia identificatore/nome del punto vendita.Later, you will add an expression to look up the store name in a dataset that contains store identifier/store name pairs.

3. Aggiungere un parametro di query per creare un parametro di report3. Add a Query Parameter to Create a Report Parameter

Quando si aggiunge un parametro di query a una query, in Generatore report viene creato automaticamente un parametro di report a valore singolo con proprietà predefinite per nome, messaggio di richiesta e tipo di dati.When you add a query parameter to a query, Report Builder automatically creates a single-valued report parameter with default properties for name, prompt, and data type.

Per aggiungere un parametro di queryTo add a query parameter

  1. Fare clic su Progettazione per tornare alla visualizzazione della struttura.Click Design to switch back to Design view.

  2. Nel riquadro Dati report espandere la cartella Set di dati , fare clic con il pulsante destro del mouse su DataSet1e quindi fare clic su Query.In the Report Data pane, expand the Datasets folder, right-click DataSet1, and then click Query.

  3. Aggiungere la seguente clausola Transact-SQLTransact-SQL WHERE come ultima riga della query:Add the following Transact-SQLTransact-SQL WHERE clause as the last line in the query:

    WHERE StoreID = (@StoreID)  
    

    Viene aperta la finestra di dialogo WHERE limita i dati recuperati all'identificatore del punto vendita specificato dal parametro di query @StoreID.The WHERE clause limits the retrieved data to the store identifier that is specified by the query parameter @StoreID.

  4. Nella barra degli strumenti Progettazione query fare clic su Esegui (!).On the query designer toolbar, click Run (!). Viene aperta la finestra di dialogo Definisci parametri query nella quale viene richiesto un valore per il parametro di query @StoreID.The Define Query Parameters dialog box opens and prompts for a value for the query parameter @StoreID.

  5. In Valore parametrodigitare 200.In Parameter Value, type 200.

  6. Fare clic su OK.Click OK.

    Nel set di risultati vengono visualizzate le quantità vendute di accessori, cineprese e fotocamere SLR digitali per l'identificatore del punto vendita 200.The result set displays the quantities sold for Accessories, Camcorders, and Digital SLR Cameras for the store identifier 200.

  7. Fare clic su OK.Click OK.

  8. Nel riquadro Dati report espandere la cartella Parametri .In the Report Data pane, expand the Parameters folder.

Si noti che è ora presente un parametro del report denominato @StoreIDe un riquadro Parametri in cui visualizzare i parametri del report.Note there is now a report parameter named @StoreID, and a Parameters pane where you can lay out the report parameters.

ssRB_ParamPane

Non è visualizzato un riquadro Parametri?Don't see a Parameters pane? Nel menu Visualizza selezionare Parametri.On the View menu, select Parameters.

4. Modificare il tipo di dati e altre proprietà predefiniti per un parametro di report4. Change Default Data Type and Other Properties for a Report Parameter

Dopo aver creato un parametro di report, è possibile impostare i valori predefiniti per le proprietà.After you create a report parameter, you can adjust the default values for properties.

Per modificare il tipo di dati predefinito per un parametro di reportTo change the default data type for a report parameter

Per impostazione predefinita, il parametro creato ha il tipo di dati Text.By default, the parameter you created has the data type Text. Poiché l'identificatore del punto vendita è un intero, è possibile modificare il tipo di dati in Integer.Because the store identifier is an integer, you can change the data type to Integer.

  1. Nel riquadro Dati report nel nodo Parametri fare clic con il pulsante destro del mouse su @StoreIDe quindi fare clic su Proprietà parametri.In the Report Data pane under the Parameters node, right-click @StoreID, then click Parameter Properties.

  2. In Messaggio di richiestadigitare Identificatore punto vendita?In Prompt, type Store identifier? Questo testo viene visualizzato nella barra degli strumenti del visualizzatore di report quando si esegue il report.This text appears on the report viewer toolbar when you run the report.

  3. In Tipo di datiselezionare Integernell'elenco a discesa.In Data type, from the drop-down list, select Integer.

  4. Accettare i valori predefiniti rimanenti nella finestra di dialogo.Accept the remaining default values in the dialog box.

  5. Fare clic su OK.Click OK.

  6. Fare clic su Esegui per visualizzare l'anteprima del report.Click Run to preview the report. Il visualizzatore di report visualizza il messaggio di richiesta Store Identifier? per @StoreID.The report viewer displays the prompt Store Identifier? for @StoreID.

  7. Nella barra degli strumenti del visualizzatore di report, accanto a Store ID, digitare 200e quindi fare clic su Visualizza report.On the report viewer toolbar, next to Store ID, type 200, and then click View Report.

SSRB_ParamTutStoreID

4a.4a. Aggiungere un set di dati per fornire i valori disponibili e i nomi visualizzatiAdd a Dataset to Provide Available Values and Display Names

Per assicurarsi che i lettori del report digitino solo valori validi per un parametro, è possibile creare un elenco a discesa di valori tra cui scegliere.To make sure your report readers type only valid values for a parameter, you can create a drop-down list of values to choose from. I valori possono provenire da un set di dati o da un elenco che si specifica.The values can come from a dataset or from a list that you specify. I valori disponibili devono provenire da un set di dati con una query che non contiene un riferimento al parametro.Available values must be supplied from a dataset with a query that does not contain a reference to the parameter.

Per creare un set di dati per i valori validi per un parametroTo create a dataset for valid values for a parameter

  1. Fare clic su Progettazione per passare alla visualizzazione della struttura.Click Design to switch to Design view.

  2. Nel riquadro Dati report fare clic con il pulsante destro del mouse sula cartella Datasets e quindi fare clic su Aggiungi set di dati.In the Report Data pane, right-click the Datasets folder, and then click Add Dataset.

  3. In Nomedigitare Punti vendita.In Name, type Stores.

  4. Scegliere Utilizzare un set di dati incorporato nel report.Select Use a dataset embedded in my report.

  5. In Origine datiscegliere l'origine dati usata nella prima procedura dall'elenco a discesa.In Data source, from the drop-down list, choose the data source you used in the first procedure.

  6. In Tipo di queryverificare che sia selezionata l'opzione Testo .In Query type, verify that Text is selected.

  7. In Queryincollare il testo seguente:In Query, paste the following text:

    SELECT 200 AS StoreID, 'Contoso Catalog Store' as StoreName  
    UNION SELECT 199 AS StoreID, 'Contoso North America Online Store' as StoreName  
    UNION SELECT 307 AS StoreID, 'Contoso Asia Online Store' as StoreName  
    UNION SELECT 306 AS StoreID, 'Contoso Europe Online Store' as StoreName  
    
  8. Fare clic su OK.Click OK.

    Nel riquadro Dati report sono visualizzati i campi StoreID e StoreName nel nodo del set di dati Punti vendita .The Report Data pane displays the fields StoreID and StoreName under the Stores dataset node.

4b.4b. Specificare i valori disponibili da visualizzare in un elencoSpecify Available Values to Show in a List

Dopo aver creato un set di dati per offrire i valori disponibili, modificare le proprietà del report per specificare il set di dati e il campo da usare per popolare l'elenco a discesa di valori validi nella barra degli strumenti del visualizzatore di report.After you create a dataset to provide available values, you change the report properties to specify which dataset and which field to use to populate the drop-down list of valid values on the Report Viewer toolbar.

Per fornire i valori disponibili per un parametro da un set di datiTo provide available values for a parameter from a dataset

  1. Nel riquadro Dati report fare clic con il pulsante destro del mouse sul parametro @StoreIDe quindi fare clic su Proprietà parametri.In the Report Data pane, right-click the parameter @StoreID, then click Parameter Properties.

  2. Fare clic su Valori disponibilie quindi su Ottieni valori da una query.Click Available Values, and then click Get values from a query.

  3. In Set di datifare clic su Punti venditanell'elenco a discesa.In Dataset, from the drop-down list, click Stores.

  4. In Campo valorifare clic su StoreID nell'elenco a discesa.In Value field, from the drop-down list, click StoreID.

  5. In Campo etichettefare clic su StoreName nell'elenco a discesa.In Label field, from the drop-down list, click StoreName. Il campo etichette consente di specificare il nome visualizzato per il valore.The label field specifies the display name for the value.

  6. Fare clic su Generale.Click General.

  7. In Promptmodificare Identificatore punto vendita? in Nome punto vendita?In Prompt, change Store Identifer? to Store name?

    I lettori del report effettueranno ora la selezione da un elenco di nomi di punti vendita anziché un elenco di identificatori.Report readers will now select from a list of store names instead of store identifiers. Si noti che il tipo di dati del parametro rimane Integer perché il parametro si basa sull'identificatore del punto vendita, non sul nome.Note that the parameter data type remains Integer because the parameter is based on the store identifier, not the store name.

  8. Fare clic su OK.Click OK.

  9. Visualizzare l'anteprima del report.Preview the report.

    Nella barra degli strumenti del visualizzatore di report, la casella di testo del parametro è ora un elenco a discesa denominato Selezionare un valore.In the report viewer toolbar, the parameter text box is now a drop-down list that displays Select a Value.

  10. Nell'elenco a discesa selezionare Contoso Catalog Store e quindi fare clic su Visualizza report.From the drop-down list, select Contoso Catalog Store, then click View Report.

Nel report viene visualizzata la quantità venduta di accessori, cineprese e fotocamere SLR digitali per l'identificatore del punto vendita 200.The report displays the quantity sold for Accessories, Camcorders, and Digital SLR Cameras for the store identifier 200.

4c.4c. Specificare un valore predefinitoSpecify a Default Value

È possibile specificare un valore predefinito per ciascun parametro in modo che il report venga eseguito automaticamente.You can specify a default value for each parameter so the report runs automatically.

Per specificare un valore predefinito da un set di datiTo specify a default value from a dataset

  1. Passare alla Visualizzazione della struttura.Switch to Design view.

  2. Nel riquadro Dati report fare clic con il pulsante destro del mouse su @StoreIDe quindi fare clic su Proprietà parametri.In the Report Data pane, right-click @StoreID, then click Parameter Properties.

  3. Fare clic su Valori predefinitie quindi su Ottieni valori da una query.Click Default Values, then click Get values from a query.

  4. In Set di datifare clic su Punti venditanell'elenco a discesa.In Dataset, from the drop-down list, click Stores.

  5. In Campo valorifare clic su StoreID nell'elenco a discesa.In Value field, from the drop-down list, click StoreID.

  6. Fare clic su OK.Click OK.

  7. Visualizzare l'anteprima del report.Preview the report.

For @StoreID, nel Visualizzatore di report viene visualizzato il valore "Contoso North America Online Store" perché è il primo valore dal set di risultati per il set di dati Punti vendita.For @StoreID, the report viewer displays the value "Contoso North America Online Store" because it's the first value from the result set for the dataset Stores. Nel report viene visualizzata la quantità venduta di fotocamere digitali per l'identificatore del punto vendita 199.The report displays the quantity sold for Digital Cameras for store identifier 199.

Per specificare un valore predefinito personalizzatoTo specify a custom default value

  1. Passare alla Visualizzazione della struttura.Switch to Design view.

  2. Nel riquadro Dati report fare clic con il pulsante destro del mouse su @StoreIDe quindi fare clic su Proprietà parametri.In the Report Data pane, right-click @StoreID, and then click Parameter Properties.

  3. Fare clic su Valori predefiniti > Specifica valori > Aggiungi.Click Default Values > Specify values > Add. Verrà aggiunta una nuova riga di valori.A new value row is added.

  4. In Valoredigitare 200.In Value, type 200.

  5. Fare clic su OK.Click OK.

  6. Visualizzare l'anteprima del report.Preview the report.

For @StoreIDviene visualizzato "Contoso Catalog Store" poiché si tratta del nome visualizzato per l'identificatore di punto vendita 200.For @StoreID, the report viewer displays "Contoso Catalog Store" because it's the display name for store identifier 200. Nel report viene visualizzata la quantità venduta di accessori, cineprese e fotocamere SLR digitali per l'identificatore del punto vendita 200.The report displays the quantity sold for Accessories, Camcorders, and Digital SLR Cameras for the store identifier 200.

4d.4d. Cercare una coppia nome/valoreLook up a Name/Value Pair

Un set di dati potrebbe contenere sia l'identificatore e che il campo del nome corrispondente.A dataset might contain both the identifier and the corresponding name field. Quando si dispone solo di un identificatore, è possibile cercare il nome corrispondente in un set di dati creato che include coppie nome/valore.When you only have an identifier, you can look up the corresponding name in a dataset that you created that includes name/value pairs.

Per cercare un valore in un set di datiTo look up a value from a dataset

  1. Passare alla Visualizzazione della struttura.Switch to Design view.

  2. Nell'area di progettazione nella matrice nell'intestazione di colonna della prima riga fare clic con il pulsante destro del mouse su [StoreID] e fare clic su Espressione.On the design surface, in the matrix, in the first row column header, right-click [StoreID] and then click Expression.

  3. Nel riquadro dell'espressione eliminare qualsiasi testo eccetto il segno di uguale (=) iniziale.In the expression pane, delete all text except the beginning equals sign (=).

  4. In Categoriaespandere Funzioni comunie fare clic su Varie.In Category, expand Common Functions, and click Miscellaneous. Nel riquadro Elemento è visualizzato un set di funzioni.The Item pane displays a set of functions.

  5. In Elemento fare doppio clic su Ricerca.In Item, double-click Lookup. Nel riquadro dell'espressione viene visualizzato =Lookup(.The expression pane displays =Lookup(. Nel riquadro Esempio viene visualizzato un esempio di sintassi di Lookup.The Example pane displays an example of Lookup syntax.

  6. Digitare l'espressione seguente:Type the following expression:

    =Lookup(Fields!StoreID.Value,Fields!StoreID.Value,Fields!StoreName.Value,"Stores")      
    

    La funzione di ricerca accetta il valore per StoreID, lo cerca nel set di dati "Punti vendita" e restituisce il valore StoreName.The Lookup function takes the value for StoreID, looks it up in the "Stores" dataset, and returns the StoreName value.

  7. Fare clic su OK.Click OK.

    Nell'intestazione di colonna del punto vendita è contenuto il testo visualizzato per un'espressione complessa: Expr.The store column header contains the display text for a complex expression: Expr.

  8. Visualizzare l'anteprima del report.Preview the report.

L'intestazione di colonna nella parte superiore di ogni colonna visualizza il nome del punto vendita anziché l'identificatore.The column header at the top of each column displays the store name instead of the store identifier.

5. Visualizzare il valore del parametro selezionato nel report5. Display the Selected Parameter Value in the Report

Quando un lettore ha delle domande su un report, è utile sapere quali valori di parametri sono stati scelti.When your report readers have questions about a report, it helps to know which parameter values they chose. È possibile mantenere i valori selezionati dall'utente per ogni parametro nel report.You can preserve user-selected values for each parameter in the report. Un modo consiste nel visualizzare i parametri in una casella di testo nel piè di pagina della pagina.One way is to display the parameters in a text box in the page footer.

  1. Passare alla Visualizzazione della struttura.Switch to Design view.

  2. Fare clic con il pulsante destro del mouse sul piè di pagina della pagina > Inserisci > Casella di testo.Right-click the page footer > Insert > Text Box. Trascinare la casella di testo accanto alla casella di testo con il timestamp.Drag the text box next to the text box with the time stamp. Fare clic sul quadratino di ridimensionamento laterale della casella di testo ed espanderla in larghezza.Grab the side handle of the text box and expand the width.

  3. Trascinare il parametro @StoreID dal riquadro Dati report alla casella di testo.From the Report Data pane, drag the parameter @StoreID to the text box. Nella casella di testo viene visualizzato [@StoreID].The text box displays [@StoreID].

  4. Per visualizzare l'etichetta del parametro, fare clic nella casella di testo finché il cursore di inserimento non viene visualizzato dopo l'espressione esistente, immettere uno spazio, quindi trascinare un'altra copia del parametro dal riquadro dei dati del report nella casella di testo.To display the parameter label, click in the text box until the insert cursor appears after the existing expression, type a space, and then drag another copy of the parameter from the Report Data pane to the text box. Nella casella di testo viene visualizzato [@StoreID] [@StoreID].The text box displays [@StoreID] [@StoreID].

  5. Fare clic con il pulsante destro del mouse sulla prima occorrenza di [@StoreID] e quindi fare clic su Espressione.Right-click the first [@StoreID] and click Expression. Verrà visualizzata la finestra di dialogo Espressione .The Expression dialog box opens. Sostituire il testo Value con Label.Replace the text Value with Label.

  6. Fare clic su OK.Click OK.

    Verrà visualizzato il testo: [@StoreID.Label] [@StoreID].The text displays: [@StoreID.Label] [@StoreID].

  7. Visualizzare l'anteprima del report.Preview the report.

6. Utilizzare il parametro del report in un filtro6. Use the Report Parameter in a Filter

I filtri consentono di controllare quali dati utilizzare in un report dopo averli recuperati da un'origine dati esterna.Filters help control which data to use in a report after it is retrieved from an external data source. Per consentire ai lettori del report di controllare i dati visualizzati, è possibile includere il parametro del report in un filtro per la matrice.To let report readers control the data they want to see, you can include the report parameter in a filter for the matrix.

Per specificare un parametro in un filtro della matriceTo specify a parameter in a matrix filter

  1. Passare alla Visualizzazione della struttura.Switch to Design view.

  2. Fare clic con il pulsante destro del mouse sul quadratino di ridimensionamento dell'intestazione di una riga o colonna della matrice e quindi fare clic su Proprietà Tablix.Right-click a row or column header handle on the matrix, and then click Tablix Properties.

  3. Fare clic su Filtrie quindi su Aggiungi.Click Filters, and then click Add. Verrà visualizzata una nuova riga del filtro.A new filter row appears.

  4. In Espressioneselezionare il campo del set di dati StoreID nell'elenco a discesa.In Expression, from the drop-down list, select the dataset field StoreID. I dati visualizzati sono di tipo Integer.The data type displays Integer. Se il valore dell'espressione è un campo del set di dati, il tipo di dati viene impostato automaticamente.When the expression value is a dataset field, the data type is set automatically.

  5. In Operatoreverificare che sia selezionato il segno di uguale (=).In Operator, verify that the equals sign (=) is selected.

  6. In Valoredigitare [@StoreID].In Value, type [@StoreID].

    [@StoreID] è la sintassi dell'espressione semplice che rappresenta =Parameters!StoreID.Value.[@StoreID] is the simple expression syntax that represents =Parameters!StoreID.Value.

  7. Fare clic su OK.Click OK.

  8. Visualizzare l'anteprima del report.Preview the report.

    La matrice visualizza dati solo per "Contoso Catalog Store".The matrix displays data only for "Contoso Catalog Store".

  9. Nella barra degli strumenti del visualizzatore di report, per Nome punto vendita?selezionare Contoso Asia Online Storee quindi fare clic su Visualizza report.On the report viewer toolbar, for Store name?, select Contoso Asia Online Store, and then click View Report.

La matrice visualizza dati che corrispondono al punto vendita che è stato selezionato.The matrix displays data that corresponds to the store that you selected.

7. Modificare il parametro di report in modo che vengano accettati più valori7. Change the Report Parameter to Accept Multiple Values

Per modificare un parametro da singolo a multivalore, è necessario modificare la query e tutte le espressioni che contengono un riferimento a quel parametro, inclusi i filtri.To change a parameter from single to multivalued, you must change the query and all expressions that contain a reference to the parameter, including filters. Un parametro multivalore è una matrice di valori.A multivalued parameter is an array of values. In una query del set di dati, la sintassi della query deve verificare l'inclusione di un valore in un set di valori.In a dataset query, query syntax must test for inclusion of one value in a set of values. In un'espressione di report, la sintassi dell'espressione deve accedere a una matrice di valori anziché a un valore singolo.In a report expression, expression syntax must access an array of values instead of an individual value.

Per modificare un parametro da singolo a multivaloreTo change a parameter from single to multivalued

  1. Passare alla Visualizzazione della struttura.Switch to Design view.

  2. Nel riquadro Dati report fare clic con il pulsante destro del mouse su @StoreIDe quindi fare clic su Proprietà parametri.In the Report Data pane, right-click @StoreID, and then click Parameter Properties.

  3. Selezionare Consenti più valori.Select Allow multiple values.

  4. Fare clic su OK.Click OK.

  5. Nel riquadro Dati report espandere la cartella Set di dati , fare clic con il pulsante destro del mouse su DataSet1e quindi fare clic su Query.In the Report Data pane, expand the Datasets folder, right-click DataSet1, and then click Query.

  6. Modificare il segno di uguale (=) in IN nella clausola Transact-SQLTransact-SQL WHERE clause nella clausola last line nella clausola query:Change the equals sign (=) to IN in the Transact-SQLTransact-SQL WHERE clause in the last line in the query:

    WHERE StoreID IN (@StoreID)  
    

    L'operatore IN verifica un valore per l'inclusione in un set di valori.The IN operator tests a value for inclusion in a set of values.

  7. Fare clic su OK.Click OK.

  8. Fare clic con il pulsante destro del mouse sul quadratino di ridimensionamento dell'intestazione di una riga o colonna della matrice e quindi fare clic su Proprietà Tablix.Right-click a row or column header handle on the matrix, and then click Tablix Properties.

  9. Fare clic su Filtri.Click Filters.

  10. In Operatoreselezionare In.In Operator, select In.

  11. Fare clic su OK.Click OK.

  12. Nella casella di testo in cui è visualizzato il parametro nel piè di pagina, eliminare qualsiasi testo.In the text box that displays the parameter in the page footer, delete all text.

  13. Fare clic con il pulsante destro del mouse sulla casella di testo e quindi fare clic su Espressione.Right-click the text box, and then click Expression. Digitare l'espressione seguente: =Join(Parameters!StoreID.Label, ", ")Type the following expression: =Join(Parameters!StoreID.Label, ", ")

    Questa espressione concatena tutti i nomi dei punti vendita che l'utente ha selezionato, separati da una virgola e uno spazio.This expression concatenates all store names that the user selected, separated by a comma and a space.

  14. Fare clic su OK.Click OK.

  15. Fare clic nella casella di testo che precede l'espressione appena creata e quindi digitare quanto segue:Click in the text box in front of the expression that you just created, and then type the following:

    Valori del parametro selezionati:Parameter Values Selected:

  16. Visualizzare l'anteprima del report.Preview the report.

  17. Fare clic sull'elenco a discesa accanto a Nome punto vendita?Click the drop-down list next to Store Name?

    Ogni valore valido appare accanto a una casella di controllo.Each valid value appears next to a check box.

  18. Fare clic su Seleziona tuttoquindi fare clic su Visualizza report.Click Select All, and then click View Report.

    Il report visualizza la quantità venduta per tutte le sottocategorie per tutti i punti vendita.The report displays the quantity sold for all subcategories for all stores.

  19. Dall'elenco a discesa fare clic su Seleziona tutto per cancellare l'elenco, fare clic su "Contoso Catalog Store" e "Contoso Asia Online Store" e quindi scegliere Visualizza report.From the drop-down list, click Select All to clear the list, click "Contoso Catalog Store" and "Contoso Asia Online Store", and then click View Report.

    report-builder-parameter-multiselect

8. Aggiungere un parametro booleano per la visibilità condizionale8. Add a Boolean Parameter for Conditional Visibility

Per aggiungere un parametro booleanoTo add a Boolean parameter

  1. Nell'area di progettazione nel riquadro Dati report fare clic con il pulsante destro del mouse su Parametrie fare clic su Aggiungi parametro.On the design surface, in the Report Data pane, right-click Parameters, and click Add Parameter.

  2. Nella casella Nomedigitare ShowSelections.In Name, type ShowSelections.

  3. In Messaggio di richiestadigitare Mostra selezioni?In Prompt, type Show selections?

  4. In Tipo di dati, fare clic su booleano.In Data type, click Boolean.

  5. Fare clic su Valori predefiniti.Click Default Values.

  6. Fare clic su Imposta valorie quindi su Aggiungi.Click Specify value, and then click Add.

  7. In Valoredigitare False.In Value, type False.

  8. Fare clic su OK.Click OK.

Per impostare la visibilità in base a un parametro booleanoTo set visibility based on a Boolean parameter

  1. Nell'area di progettazione fare clic con il pulsante destro del mouse nella casella di testo nel piè di pagina che visualizza i valori del parametro e quindi fare clic su Proprietà casella di testo.On the design surface, right-click the text box in the page footer that displays the parameter values, and then click Text Box Properties.

  2. Fare clic su Visibilità.Click Visibility.

  3. Selezionare l'opzione Mostra o nascondi in base a un'espressionee quindi fare clic sul pulsante di espressione Fx.Select the option Show or hide based on an expression, and then click the expression button Fx.

  4. Digitare l'espressione seguente: =Not Parameters!ShowSelections.ValueType the following expression: =Not Parameters!ShowSelections.Value

    L'opzione di visibilità della casella di testo viene controllata dalla proprietà Hidden.The text box Visibility option is controlled by the property Hidden. Applicare l'operatore Not in modo che quando viene selezionato il parametro, la proprietà Hidden sia impostata su false e venga visualizzata la casella di testo.Apply the Not operator so that when the parameter is selected, the Hidden property is false, and the text box will be displayed.

  5. Fare clic su OK.Click OK.

  6. Fare clic su OK.Click OK.

  7. Visualizzare l'anteprima del report.Preview the report.

    La casella di testo che visualizza le opzioni per il parametro nel piè di pagina non è visualizzata.The text box that displays the parameter choices in the footer does not appear.

  8. Nella barra degli strumenti del visualizzatore di report accanto a Mostra selezionifare clic su True > Visualizza report.In the report viewer toolbar, next to Show selections, click True > View Report.

    Viene visualizzata la casella di testo nel piè di pagina contenente tutti i nomi di punto vendita selezionati.The text box in the page footer appears, showing all the store names you selected.

9. Aggiungere un titolo al report9. Add a Report Title

Per aggiungere il titolo di un reportTo add a report title

  1. Passare alla Visualizzazione della struttura.Switch to Design view.

  2. Nell'area di progettazione fare clic su Fare clic per aggiungere il titolo.On the design surface, click Click to add title.

  3. Digitare Vendite prodotto con parametri, quindi fare clic all'esterno della casella di testo.Type Parameterized Product Sales, and then click outside the text box.

10. Salvare il report10. Save the Report

Per salvare il report in un server di reportTo save the report on a report server

  1. Fare clic sul pulsante Generatore report , quindi su Salva con nome.From the Report Builder button, click Save As.

  2. Fare clic su Siti e server recenti.Click Recent Sites and Servers.

  3. Selezionare o digitare il nome del server di report per il quale si dispone delle autorizzazioni di salvataggio dei report.Select or type the name of the report server where you have permission to save reports.

    Viene visualizzato il messaggio Connessione al server di report.The message Connecting to report server appears. Al termine della connessione, verrà visualizzato il contenuto della cartella di report specificata dall'amministratore del server di report come posizione predefinita per i report.When the connection is complete, you see the contents of the report folder that the report server administrator specified as the default location for reports.

  4. In Nomesostituire il nome predefinito con Report delle vendite con parametri.In Name, replace the default name with Parameterized Sales Report.

  5. Fare clic su Salva.Click Save.

Il report verrà salvato sul server di report.The report is saved to the report server. Il server di report al quale si è connessi verrà visualizzato sulla barra di stato nella parte inferiore della finestra.The report server that you are connected to appears in the status bar at the bottom of the window.

Passaggi successiviNext Steps

Questa operazione conclude la procedura dettagliata per l'aggiunta di un parametro al report.This concludes the walkthrough for how to add a parameter to your report. Per altre informazioni sui parametri, vedere Parametri report (Generatore report e Progettazione report).To learn more about parameters, see Report Parameters (Report Builder and Report Designer).

Vedere ancheSee Also