Didacticiel : ajouter un paramètre à un rapport (Générateur de rapports)Tutorial: Add a Parameter to Your Report (Report Builder)

Dans ce didacticiel, vous ajoutez un paramètre à un rapport paginé Reporting ServicesReporting Services pour que les lecteurs de ce dernier puissent filtrer ses données en fonction d’une ou de plusieurs valeurs.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

Les paramètres de rapport sont créés automatiquement pour chaque paramètre de requête que vous incluez dans une requête de dataset.Report parameters are created automatically for each query parameter that you include in a dataset query. Le type de données du paramètre détermine son apparence dans la barre d'outils de l'affichage du rapport.The parameter data type determines how it appears on the report view toolbar.

Note

Dans ce didacticiel, les étapes de l'Assistant sont consolidées en une seule procédure.In this tutorial, the steps for the wizard are consolidated into one procedure. Pour obtenir des instructions pas à pas sur l’accès à un serveur de rapports, le choix d’une source de données et la création d’un dataset, consultez le premier didacticiel de cette série : Didacticiel : création d’un rapport de tableau de base (Générateur de rapports).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).

Durée estimée pour effectuer le didacticiel : 25 minutes.Estimated time to complete this tutorial: 25 minutes.

SpécificationsRequirements

Pour plus d’informations sur les spécifications, consultez Éléments requis pour les didacticiels (Générateur de rapports).For information about requirements, see Prerequisites for Tutorials (Report Builder).

1. Créer un rapport de matrice et un dataset dans l’Assistant Tableau ou matrice1. Create a Matrix Report and Dataset in the Table or Matrix Wizard

Créez un rapport de matrice, une source de données et un dataset.Create a matrix report, a data source, and a dataset.

Note

Dans ce didacticiel, la requête contient les valeurs de données, afin qu'il ne soit pas nécessaire de disposer d'une source de données externe.In this tutorial, the query contains the data values, so that it does not need an external data source. Cela rend la requête assez longue.This makes the query quite long. Dans un environnement métier, une requête ne contient pas les données.In a business environment, a query would not contain the data. Ceci est nécessaire à des fins de formation uniquement.This is for learning purposes only.

Pour créer un rapport de matriceTo create a new matrix report

  1. Démarrez le Générateur de rapports depuis votre ordinateur, depuis le portail web Reporting ServicesReporting Services ou en mode intégré SharePoint.Start Report Builder either from your computer, the Reporting ServicesReporting Services web portal, or SharePoint integrated mode.

    La boîte de dialogue Nouveau rapport ou dataset s’ouvre.The New Report or Dataset dialog box opens.

    Si vous ne voyez pas la boîte de dialogue Nouveau rapport ou Dataset, dans le menu Fichier, choisissez Nouveau.If you don't see the New Report or Dataset dialog box, on the File menu > New.

  2. Dans le volet gauche, vérifiez que Nouveau rapport est sélectionné.In the left pane, make sure New Report is selected.

  3. Dans le volet droit, cliquez sur Assistant Tableau ou matrice.In the right pane, click Table or Matrix Wizard.

  4. Dans la page Choisir un dataset , cliquez sur Créer un dataset > Suivant.On the Choose a dataset page, click Create a dataset > Next.

  5. Dans la page Choisir une connexion à une source de données , sélectionnez une source de données dans la liste ou naviguez jusqu’au serveur de rapports pour en sélectionner une.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. Sélectionnez n’importe quelle source de données de type SQL Server.Select any data source that is type SQL Server.

  6. Cliquez sur Suivant.Click Next.

    Vous devrez peut-être entrer vos informations d’identification.You may need to enter your credentials.

  7. Dans la page Créer une requête , cliquez sur Modifier en tant que texte.On the Design a query page, click Edit as Text.

  8. Collez la requête suivante dans le volet vide en haut :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  
    

    Cette requête combine les résultats de plusieurs instructions SELECT Transact-SQLTransact-SQL dans une expression de table commune pour spécifier des valeurs basées sur des données simplifiées de ventes d’appareils photo de l’exemple de base de données 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. Les sous-catégories sont les appareils photo numériques, les appareils photo numériques reflex à lentille unique (SLR), les caméscopes et les accessoires.The subcategories are digital cameras, digital single lens reflex (SLR) cameras, camcorders, and accessories.

  9. Dans la barre d’outils du Concepteur de requêtes, cliquez sur Exécuter (!) pour voir les données.On the query designer toolbar, click Run (!) to see the data.

    Le jeu de résultats comprend 11 lignes de données qui montrent le volume d’articles vendus pour chaque sous-catégorie dans quatre magasins, dans les colonnes suivantes : StoreID, Subcategory et Quantity. Le nom du magasin ne fait pas partie du jeu de résultats.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. Ultérieurement, dans ce didacticiel, vous rechercherez le nom du magasin qui correspond à l'identificateur de magasin d'un dataset distinct.Later in this tutorial, you will look up the name of the store that corresponds to the store identifier from a separate dataset.

    Cette requête ne contient pas de paramètres de requête.This query does not contain query parameters. Vous ajouterez ultérieurement des paramètres de requête dans ce didacticiel.You will add query parameters later in this tutorial.

  10. Cliquez sur Suivant.Click Next.

2. Organiser les données et choisir la disposition dans l’Assistant2. Organize Data and Choose Layout in the Wizard

L’Assistant fournit une conception initiale pour l’affichage des données.The wizard provides a starting design for displaying data. Le volet de visualisation de l'Assistant vous aide à visualiser le résultat du regroupement des données avant de terminer la conception de la table ou de la matrice.The preview pane in the wizard helps you to visualize the result of grouping data before you complete the table or matrix design.

Pour organiser les données en groupesTo organize data into groups

  1. Dans la page Organiser les champs , faites glisser Subcategory vers Groupes de lignes.On the Arrange fields page, drag Subcategory to Row groups.

  2. Faites glisser StoreID vers Groupes de colonnes.Drag StoreID to Column groups.

  3. Faites glisser Quantity vers Valeurs.Drag Quantity to Values.

    Vous avez organisé les valeurs des quantités vendues dans des lignes regroupées par sous-catégorie, avec une colonne par magasin.You have organized the quantity sold values in rows grouped by subcategory, with one column for each store.

  4. Cliquez sur Suivant.Click Next.

  5. Dans la page Choisir la disposition , sous Options, vérifiez que Afficher les sous-totaux et les totaux généraux est sélectionné.On the Choose the Layout page, under Options, make sure Show subtotals and grand totals is selected.

    Lorsque vous exécuterez le rapport, la dernière colonne affichera la quantité totale de chaque sous-catégorie pour tous les magasins, et la dernière ligne affichera la quantité totale pour toutes les sous-catégories pour chaque magasin.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. Cliquez sur Suivant.Click Next.

  7. Cliquez sur Terminer.Click Finish.

    La matrice est ajoutée à l'aire de conception.The matrix is added to the design surface. La matrice affiche trois colonnes et trois lignes.The matrix displays three columns and three rows. Les cellules de la première ligne contiennent Subcategory, [StoreID] et Total.The contents of the cells in the first row are Subcategory, [StoreID], and Total. Les cellules de la deuxième ligne contiennent des expressions qui représentent la sous-catégorie, la quantité d'articles vendus pour chaque magasin, ainsi que la quantité totale de chaque sous-catégorie pour tous les magasins.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. Les cellules de la dernière ligne affichent le total global pour chaque magasin.The cells in the final row display the grand total for each store.

    ssRB_ParamTut_Design

  8. Cliquez dans la matrice, pointez sur le bord de la première colonne, saisissez la poignée, puis augmentez la largeur de la colonne.Click in the matrix, hover over the edge of the first column, grab the handle, and expand the column width.

    ssRB_ParamTut_Drag

  9. Cliquez sur Exécuter pour afficher un aperçu du rapport.Click Run to preview the report.

Le rapport s'exécute sur le serveur de rapports en présentant son titre et l'heure à laquelle il a été traité.The report runs on the report server and displays the title and the time the report processing occurred.

ssRB_ParamTut__Preview1

Jusqu’à maintenant, les en-têtes de colonnes affichent l’identificateur du magasin mais pas le nom du magasin.So far the column headings display the store identifier but not the store name. Ultérieurement, vous ajouterez une expression pour rechercher le nom de magasin dans un dataset qui contient des paires nom d'identificateur/nom de magasin.Later, you will add an expression to look up the store name in a dataset that contains store identifier/store name pairs.

3. Ajouter un paramètre de requête pour créer un paramètre de rapport3. Add a Query Parameter to Create a Report Parameter

Lorsque vous ajoutez un paramètre de requête à une requête, le Générateur de rapports crée automatiquement un paramètre de rapport à valeur unique avec des propriétés par défaut pour le nom, le texte affiché à l'invite et le type de données.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.

Pour ajouter un paramètre de requêteTo add a query parameter

  1. Cliquez sur Conception pour rebasculer en mode Conception.Click Design to switch back to Design view.

  2. Dans le volet des données de rapport, développez le dossier Datasets , cliquez avec le bouton droit sur DataSet1, puis cliquez sur Requête.In the Report Data pane, expand the Datasets folder, right-click DataSet1, and then click Query.

  3. Ajoutez la clause Transact-SQLTransact-SQL WHERE suivante comme dernière ligne de la requête :Add the following Transact-SQLTransact-SQL WHERE clause as the last line in the query:

    WHERE StoreID = (@StoreID)  
    

    La boîte de dialogue WHERE limite les données récupérées à l’identificateur de magasin spécifié par le paramètre de requête @StoreID.The WHERE clause limits the retrieved data to the store identifier that is specified by the query parameter @StoreID.

  4. Dans la barre d’outils du Concepteur de requêtes, cliquez sur Exécuter (!).On the query designer toolbar, click Run (!). La boîte de dialogue Définir les paramètres de la requête s’ouvre et vous êtes invité à définir une valeur pour le paramètre de requête @StoreID.The Define Query Parameters dialog box opens and prompts for a value for the query parameter @StoreID.

  5. Dans Valeur du paramètre, tapez 200.In Parameter Value, type 200.

  6. Cliquez sur OK.Click OK.

    Le jeu de résultats affiche les quantités vendues des articles « Accessories », « Camcorders » et « Digital SLR Cameras » pour l’identificateur de magasin 200.The result set displays the quantities sold for Accessories, Camcorders, and Digital SLR Cameras for the store identifier 200.

  7. Cliquez sur OK.Click OK.

  8. Dans le volet des données de rapport, développez le dossier Paramètres .In the Report Data pane, expand the Parameters folder.

Remarque : Vous disposez désormais d’un paramètre de rapport nommé @StoreID, ainsi que d’un volet Paramètres où vous pouvez disposer les paramètres du rapport.Note there is now a report parameter named @StoreID, and a Parameters pane where you can lay out the report parameters.

ssRB_ParamPane

Vous ne voyez pas un volet Paramètres ?Don't see a Parameters pane? Dans le menu Affichage , sélectionnez Paramètres.On the View menu, select Parameters.

4. Modifier le type de données par défaut et d'autres propriétés pour un paramètre de rapport4. Change Default Data Type and Other Properties for a Report Parameter

Après avoir créé un paramètre de rapport, vous pouvez ajuster les valeurs par défaut des propriétés.After you create a report parameter, you can adjust the default values for properties.

Pour modifier le type de données par défaut d'un paramètre de rapportTo change the default data type for a report parameter

Par défaut, le paramètre que vous avez créé a pour type de données Texte.By default, the parameter you created has the data type Text. Dans la mesure où l’identificateur de magasin est un entier, vous pouvez remplacer le type de données par le type Entier.Because the store identifier is an integer, you can change the data type to Integer.

  1. Dans le volet des données de rapport sous le nœud Paramètres , cliquez avec le bouton droit sur @StoreID, puis cliquez sur Propriétés du paramètre.In the Report Data pane under the Parameters node, right-click @StoreID, then click Parameter Properties.

  2. Dans Invite, tapez Identificateur du magasin ?.In Prompt, type Store identifier? Ce texte s'affiche sur la barre d'outils de la visionneuse de rapports lorsque vous exécutez le rapport.This text appears on the report viewer toolbar when you run the report.

  3. Dans Type de données, dans la liste déroulante, sélectionnez Entier.In Data type, from the drop-down list, select Integer.

  4. Acceptez les valeurs par défaut restantes dans la boîte de dialogue.Accept the remaining default values in the dialog box.

  5. Cliquez sur OK.Click OK.

  6. Cliquez sur Exécuter pour afficher un aperçu du rapport.Click Run to preview the report. La visionneuse de rapports affiche l’invite Store Identifier? pour @StoreID.The report viewer displays the prompt Store Identifier? for @StoreID.

  7. Dans la barre d’outils de la visionneuse de rapports, en regard de StoreID, tapez 200, puis cliquez sur Afficher le rapport.On the report viewer toolbar, next to Store ID, type 200, and then click View Report.

SSRB_ParamTutStoreID

4a.4a. Ajouter un dataset pour fournir des valeurs disponibles et des noms d'affichageAdd a Dataset to Provide Available Values and Display Names

Pour que les lecteurs de votre rapport ne puissent taper que des valeurs valides pour un paramètre, vous pouvez créer une liste déroulante de valeurs à choisir.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. Les valeurs peuvent provenir d'un dataset ou d'une liste que vous spécifiez.The values can come from a dataset or from a list that you specify. Les valeurs disponibles doivent être fournies à partir d’un dataset avec une requête qui ne contient pas de référence au paramètre.Available values must be supplied from a dataset with a query that does not contain a reference to the parameter.

Pour créer un dataset de valeurs valides pour un paramètreTo create a dataset for valid values for a parameter

  1. Cliquez sur Conception pour basculer en mode Conception.Click Design to switch to Design view.

  2. Dans le volet des données de rapport, cliquez avec le bouton droit sur le dossier Datasets , puis cliquez sur Ajouter un dataset.In the Report Data pane, right-click the Datasets folder, and then click Add Dataset.

  3. Dans Nom, tapez Stores.In Name, type Stores.

  4. Cliquez sur Utiliser un dataset incorporé dans mon rapport.Select Use a dataset embedded in my report.

  5. Dans Source de données, dans la liste déroulante, choisissez la source de données que vous avez utilisée au cours de la première procédure.In Data source, from the drop-down list, choose the data source you used in the first procedure.

  6. Dans Type de requête, assurez-vous que Texte est sélectionné.In Query type, verify that Text is selected.

  7. Dans Requête, collez le texte suivant :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. Cliquez sur OK.Click OK.

    Le volet des données de rapport affiche les champs StoreID et StoreName sous le nœud du dataset Stores .The Report Data pane displays the fields StoreID and StoreName under the Stores dataset node.

4b.4b. Spécifier les valeurs disponibles à afficher dans une listeSpecify Available Values to Show in a List

Après avoir créé un dataset pour fournir des valeurs disponibles, vous modifiez les propriétés de rapport pour spécifier quel dataset et quel champ utiliser pour remplir la liste déroulante à l’aide de valeurs valides dans la barre d’outils Visionneuse de rapports.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.

Pour fournir des valeurs disponibles pour un paramètre à partir d'un datasetTo provide available values for a parameter from a dataset

  1. Dans le volet des données de rapport, cliquez avec le bouton droit sur le paramètre @StoreID, puis cliquez sur Propriétés du paramètre.In the Report Data pane, right-click the parameter @StoreID, then click Parameter Properties.

  2. Cliquez sur Valeurs disponibles, puis sur Obtenir les valeurs à partir d’une requête.Click Available Values, and then click Get values from a query.

  3. Dans la liste déroulante Dataset, cliquez sur Stores.In Dataset, from the drop-down list, click Stores.

  4. Dans la liste déroulante Champ de valeur, cliquez sur StoreID.In Value field, from the drop-down list, click StoreID.

  5. Dans la liste déroulante Champ d’étiquette, cliquez sur StoreName.In Label field, from the drop-down list, click StoreName. Le champ d'étiquette spécifie le nom d'affichage de la valeur.The label field specifies the display name for the value.

  6. Cliquez sur Général.Click General.

  7. Dans Invite, remplacez Identificateur du magasin ? par Sparre name?.In Prompt, change Store Identifer? to Store name?

    Les lecteurs du rapport sélectionneront désormais un nom dans une liste de noms de magasins au lieu d’identificateurs de magasin.Report readers will now select from a list of store names instead of store identifiers. Notez que le type de données du paramètre reste Entier , car le paramètre est basé sur l’identificateur de magasin au lieu du nom de magasin.Note that the parameter data type remains Integer because the parameter is based on the store identifier, not the store name.

  8. Cliquez sur OK.Click OK.

  9. Affichez l'aperçu du rapport.Preview the report.

    Dans la barre d’outils de la visionneuse de rapports, la zone de texte de paramètre est maintenant une liste déroulante affichant Sélectionner une valeur.In the report viewer toolbar, the parameter text box is now a drop-down list that displays Select a Value.

  10. Dans la liste déroulante, sélectionnez « Contoso Catalog Store », puis cliquez sur Afficher le rapport.From the drop-down list, select Contoso Catalog Store, then click View Report.

Le rapport affiche les quantités vendues des articles « Accessories », « Camcorders » et « Digital SLR Cameras » pour l’identificateur de magasin 200.The report displays the quantity sold for Accessories, Camcorders, and Digital SLR Cameras for the store identifier 200.

4c.4c. Spécifier une valeur par défautSpecify a Default Value

Vous pouvez spécifier une valeur par défaut pour chaque paramètre afin que le rapport s'exécute automatiquement.You can specify a default value for each parameter so the report runs automatically.

Pour spécifier une valeur par défaut à partir d'un datasetTo specify a default value from a dataset

  1. Basculez en mode Conception.Switch to Design view.

  2. Dans le volet des données de rapport, cliquez avec le bouton droit sur @StoreID, puis cliquez sur Propriétés du paramètre.In the Report Data pane, right-click @StoreID, then click Parameter Properties.

  3. Cliquez sur Valeurs par défaut, puis sur Obtenir les valeurs à partir d’une requête.Click Default Values, then click Get values from a query.

  4. Dans la liste déroulante Dataset, cliquez sur Stores.In Dataset, from the drop-down list, click Stores.

  5. Dans la liste déroulante Champ de valeur, cliquez sur StoreID.In Value field, from the drop-down list, click StoreID.

  6. Cliquez sur OK.Click OK.

  7. Affichez l'aperçu du rapport.Preview the report.

For @StoreID, la visionneuse de rapports affiche la valeur « Contoso North America Online Store », car il s’agit de la première valeur du jeu de résultats pour le dataset Stores.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. Le rapport affiche la quantité vendue des articles « Digital Cameras » pour l’identificateur de magasin 199.The report displays the quantity sold for Digital Cameras for store identifier 199.

Pour spécifier une valeur par défaut personnaliséeTo specify a custom default value

  1. Basculez en mode Conception.Switch to Design view.

  2. Dans le volet des données de rapport, cliquez avec le bouton droit sur @StoreID, puis cliquez sur Propriétés du paramètre.In the Report Data pane, right-click @StoreID, and then click Parameter Properties.

  3. Cliquez sur Valeurs par défaut > Spécifier les valeurs > Ajouter.Click Default Values > Specify values > Add. Une nouvelle ligne de valeurs est ajoutée.A new value row is added.

  4. Dans Valeur, tapez 200.In Value, type 200.

  5. Cliquez sur OK.Click OK.

  6. Affichez l'aperçu du rapport.Preview the report.

For @StoreID, la visionneuse de rapports affiche « Contoso Catalog Store », car il s’agir du nom d’affichage pour l’identificateur de magasin 200.For @StoreID, the report viewer displays "Contoso Catalog Store" because it's the display name for store identifier 200. Le rapport affiche les quantités vendues des articles « Accessories », « Camcorders » et « Digital SLR Cameras » pour l’identificateur de magasin 200.The report displays the quantity sold for Accessories, Camcorders, and Digital SLR Cameras for the store identifier 200.

4d.4d. Rechercher une paire nom/valeurLook up a Name/Value Pair

Un dataset peut contenir à la fois l'identificateur et le champ Nom correspondant.A dataset might contain both the identifier and the corresponding name field. Lorsque vous avez seulement un identificateur, vous pouvez rechercher le nom correspondant dans un dataset que vous avez créé et qui inclut des paires nom/valeur.When you only have an identifier, you can look up the corresponding name in a dataset that you created that includes name/value pairs.

Pour rechercher une valeur dans un datasetTo look up a value from a dataset

  1. Basculez en mode Conception.Switch to Design view.

  2. Dans l’aire de conception, dans la matrice, dans le premier en-tête de ligne ou de colonne, cliquez avec le bouton droit sur [StoreID] , puis cliquez sur Expression.On the design surface, in the matrix, in the first row column header, right-click [StoreID] and then click Expression.

  3. Dans le volet Expression, supprimez tout le texte sauf le signe égal (=) de début.In the expression pane, delete all text except the beginning equals sign (=).

  4. Dans Catégorie, développez Fonctions communes, puis cliquez sur Divers.In Category, expand Common Functions, and click Miscellaneous. Le volet Élément affiche un ensemble de fonctions.The Item pane displays a set of functions.

  5. Dans Élément, double-cliquez sur Recherche.In Item, double-click Lookup. Le volet Expression affiche =Lookup(.The expression pane displays =Lookup(. Le volet d'exemple affiche un exemple de syntaxe de recherche.The Example pane displays an example of Lookup syntax.

  6. Tapez l’expression suivante :Type the following expression:

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

    La fonction de recherche prend la valeur de StoreID, la recherche dans le dataset « Stores », puis retourne la valeur StoreName.The Lookup function takes the value for StoreID, looks it up in the "Stores" dataset, and returns the StoreName value.

  7. Cliquez sur OK.Click OK.

    L’en-tête de colonne de magasin contient le texte affiché pour une expression complexe : Expr.The store column header contains the display text for a complex expression: Expr.

  8. Affichez l'aperçu du rapport.Preview the report.

L’en-tête de colonne en haut de chaque colonne affiche le nom de magasin au lieu de l’identificateur de magasin.The column header at the top of each column displays the store name instead of the store identifier.

5. Afficher la valeur de paramètre sélectionnée dans le rapport5. Display the Selected Parameter Value in the Report

Quand les lecteurs de votre rapport ont des questions sur un rapport, il est utile de connaître les valeurs de paramètres qu’ils ont choisies.When your report readers have questions about a report, it helps to know which parameter values they chose. Vous pouvez conserver les valeurs sélectionnées par l'utilisateur pour chaque paramètre du rapport.You can preserve user-selected values for each parameter in the report. L'une des solutions possibles consiste à afficher les paramètres dans une zone de texte au sein du pied de page.One way is to display the parameters in a text box in the page footer.

  1. Basculez en mode Conception.Switch to Design view.

  2. Cliquez avec le bouton droit sur le pied de page, puis choisissez Insérer > Zone de texte.Right-click the page footer > Insert > Text Box. Faites glisser la zone de texte en regard de la zone de texte comportant l'horodatage.Drag the text box next to the text box with the time stamp. Saisissez la poignée latérale de la zone de texte et augmentez la largeur de cette dernière.Grab the side handle of the text box and expand the width.

  3. Dans le volet des données de rapport, faites glisser le paramètre @StoreID vers la zone de texte.From the Report Data pane, drag the parameter @StoreID to the text box. La zone de texte affiche [@StoreID].The text box displays [@StoreID].

  4. Pour afficher l'étiquette de paramètre, cliquez dans la zone de texte jusqu'à ce que le curseur d'insertion s'affiche après l'expression existante, tapez un espace, puis faites glisser une autre copie du paramètre du volet des données de rapport vers la zone de texte.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. La zone de texte affiche [@StoreID] [@StoreID].The text box displays [@StoreID] [@StoreID].

  5. Cliquez avec le bouton droit sur le premier [@StoreID] , puis cliquez sur Expression.Right-click the first [@StoreID] and click Expression. La boîte de dialogue Expression s'affiche.The Expression dialog box opens. Remplacez le texte Value par Label.Replace the text Value with Label.

  6. Cliquez sur OK.Click OK.

    Le texte affiche : [@StoreID.Label] [@StoreID].The text displays: [@StoreID.Label] [@StoreID].

  7. Affichez l'aperçu du rapport.Preview the report.

6. Utiliser le paramètre de rapport dans un filtre6. Use the Report Parameter in a Filter

Les filtres permettent de contrôler les données à utiliser dans un rapport une fois qu'il a été récupéré à partir d'une source de données externe.Filters help control which data to use in a report after it is retrieved from an external data source. Pour permettre aux lecteurs du rapport de contrôler les données qu’ils souhaitent afficher, vous pouvez inclure le paramètre de rapport dans un filtre pour 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.

Pour spécifier un paramètre dans un filtre de matriceTo specify a parameter in a matrix filter

  1. Basculez en mode Conception.Switch to Design view.

  2. Cliquez avec le bouton droit sur une ligne ou un descripteur d’en-tête de colonne dans la matrice, puis cliquez sur Propriétés du tableau matriciel.Right-click a row or column header handle on the matrix, and then click Tablix Properties.

  3. Cliquez sur Filtres, puis sur Ajouter.Click Filters, and then click Add. Une nouvelle ligne de filtres apparaît.A new filter row appears.

  4. Dans la liste déroulante Expression,, sélectionnez le champ de dataset StoreID.In Expression, from the drop-down list, select the dataset field StoreID. Le type de données affiche Entier.The data type displays Integer. Lorsque la valeur d'expression est un champ de dataset, le type de données est défini automatiquement.When the expression value is a dataset field, the data type is set automatically.

  5. Dans Opérateur, vérifiez que le signe égal (=) est sélectionné.In Operator, verify that the equals sign (=) is selected.

  6. Dans Valeur, tapez [@StoreID].In Value, type [@StoreID].

    [@StoreID] est la syntaxe d’expression simple qui représente =Parameters!StoreID.Value.[@StoreID] is the simple expression syntax that represents =Parameters!StoreID.Value.

  7. Cliquez sur OK.Click OK.

  8. Affichez l'aperçu du rapport.Preview the report.

    La matrice affiche des données uniquement pour « Contoso Catalog Store ».The matrix displays data only for "Contoso Catalog Store".

  9. Dans la barre d’outils de la visionneuse de rapports, pour Nom du magasin ?, sélectionnez Contoso Asia Online Store, puis cliquez sur Afficher le rapport.On the report viewer toolbar, for Store name?, select Contoso Asia Online Store, and then click View Report.

La matrice affiche les données qui correspondent au magasin que vous avez sélectionné.The matrix displays data that corresponds to the store that you selected.

7. Modifier le paramètre de rapport pour accepter plusieurs valeurs7. Change the Report Parameter to Accept Multiple Values

Pour changer un paramètre à valeur unique en paramètre à valeurs multiples, vous devez modifier la requête et toutes les expressions qui contiennent une référence au paramètre, notamment les filtres.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 paramètre à valeurs multiples est un tableau de valeurs.A multivalued parameter is an array of values. Dans une requête de dataset, la syntaxe de requête doit tester l'inclusion d'une valeur dans un ensemble de valeurs.In a dataset query, query syntax must test for inclusion of one value in a set of values. Dans une expression de rapport, la syntaxe d'expression doit accéder à un tableau de valeurs au lieu d'une valeur individuelle.In a report expression, expression syntax must access an array of values instead of an individual value.

Pour changer un paramètre à valeur unique en paramètre à valeurs multiplesTo change a parameter from single to multivalued

  1. Basculez en mode Conception.Switch to Design view.

  2. Dans le volet des données de rapport, cliquez avec le bouton droit sur @StoreID, puis cliquez sur Propriétés du paramètre.In the Report Data pane, right-click @StoreID, and then click Parameter Properties.

  3. Sélectionnez Autoriser les valeurs multiples.Select Allow multiple values.

  4. Cliquez sur OK.Click OK.

  5. Dans le volet des données de rapport, développez le dossier Datasets , cliquez avec le bouton droit sur DataSet1, puis cliquez sur Requête.In the Report Data pane, expand the Datasets folder, right-click DataSet1, and then click Query.

  6. Remplacez le signe égal (=) par IN dans la clause Transact-SQLTransact-SQL WHERE clause dans la clause last line dans la clause 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’opérateur IN teste l’inclusion d’une valeur dans un ensemble de valeurs.The IN operator tests a value for inclusion in a set of values.

  7. Cliquez sur OK.Click OK.

  8. Cliquez avec le bouton droit sur une ligne ou un descripteur d’en-tête de colonne dans la matrice, puis cliquez sur Propriétés du tableau matriciel.Right-click a row or column header handle on the matrix, and then click Tablix Properties.

  9. Cliquez sur Filtres.Click Filters.

  10. Dans Opérateur, sélectionnez In.In Operator, select In.

  11. Cliquez sur OK.Click OK.

  12. Dans la zone de texte qui affiche le paramètre au sein du pied de page, supprimez l'ensemble du texte.In the text box that displays the parameter in the page footer, delete all text.

  13. Cliquez avec le bouton droit sur la zone de texte, puis cliquez sur Expression.Right-click the text box, and then click Expression. Tapez l’expression suivante : =Join(Parameters!StoreID.Label, ", ")Type the following expression: =Join(Parameters!StoreID.Label, ", ")

    Cette expression concatène tous les noms de magasins que l’utilisateur a sélectionnés, séparés par une virgule et un espace.This expression concatenates all store names that the user selected, separated by a comma and a space.

  14. Cliquez sur OK.Click OK.

  15. Cliquez dans la zone de texte devant l'expression que vous venez de créer, puis tapez ce qui suit :Click in the text box in front of the expression that you just created, and then type the following:

    Valeurs de paramètres sélectionnées :Parameter Values Selected:

  16. Affichez l'aperçu du rapport.Preview the report.

  17. Cliquez sur la liste déroulante en regard de Nom du magasin ?Click the drop-down list next to Store Name?

    Chaque valeur valide s'affiche en regard d'une case à cocher.Each valid value appears next to a check box.

  18. Cliquez sur Sélectionner tout, puis sur Afficher le rapport.Click Select All, and then click View Report.

    Le rapport affiche les quantités vendues pour toutes les sous-catégories de tous les magasins.The report displays the quantity sold for all subcategories for all stores.

  19. Dans la liste déroulante, cliquez sur Sélectionner tout afin d’effacer la liste, cliquez sur « Contoso Catalog Store » et sur « Contoso Asia Online Store », puis cliquez sur Afficher le rapport.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. Ajouter un paramètre booléen pour la visibilité conditionnelle8. Add a Boolean Parameter for Conditional Visibility

Pour ajouter un paramètre booléenTo add a Boolean parameter

  1. Dans l’aire de conception, dans le volet des données de rapport, cliquez avec le bouton droit sur Paramètres, puis cliquez sur Add Ajouter un paramètre.On the design surface, in the Report Data pane, right-click Parameters, and click Add Parameter.

  2. Dans la zone Nom, tapez ShowSelections.In Name, type ShowSelections.

  3. Dans Invite, tapez Afficher les sélections ?In Prompt, type Show selections?

  4. Dans Type de données, cliquez sur Booléen.In Data type, click Boolean.

  5. Cliquez sur Valeurs par défaut.Click Default Values.

  6. Cliquez sur Spécifier les valeurs, puis sur Ajouter.Click Specify value, and then click Add.

  7. Dans la zone Valeur, tapez False.In Value, type False.

  8. Cliquez sur OK.Click OK.

Pour définir la visibilité en fonction d’un paramètre booléenTo set visibility based on a Boolean parameter

  1. Dans l’aire de conception, cliquez avec le bouton droit sur la zone de texte du pied de page qui affiche les valeurs de paramètres, puis cliquez sur Propriétés de la zone de texte.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. Cliquez sur Visibilité.Click Visibility.

  3. Sélectionnez l’option Afficher ou masquer en fonction d’une expression, puis cliquez sur le bouton Expression Fx.Select the option Show or hide based on an expression, and then click the expression button Fx.

  4. Tapez l’expression suivante : =Not Parameters!ShowSelections.ValueType the following expression: =Not Parameters!ShowSelections.Value

    L'option de visibilité de la zone de texte est contrôlée par la propriété Hidden.The text box Visibility option is controlled by the property Hidden. Appliquez l’opérateur Not afin que quand le paramètre est sélectionné, la valeur False soit affectée à la propriété Hidden et que la zone de texte soit affichée.Apply the Not operator so that when the parameter is selected, the Hidden property is false, and the text box will be displayed.

  5. Cliquez sur OK.Click OK.

  6. Cliquez sur OK.Click OK.

  7. Affichez l'aperçu du rapport.Preview the report.

    La zone de texte qui affiche les choix de paramètre dans le pied de page ne s’affiche pas.The text box that displays the parameter choices in the footer does not appear.

  8. Dans la barre d’outils de la visionneuse de rapports, en regard de Afficher les sélections, cliquez sur Vrai > Afficher le rapport.In the report viewer toolbar, next to Show selections, click True > View Report.

    La zone de texte située dans le pied de page apparaît, montrant tous les noms de magasins que vous avez sélectionnés.The text box in the page footer appears, showing all the store names you selected.

9. Ajouter un titre de rapport9. Add a Report Title

Pour ajouter un titre de rapportTo add a report title

  1. Basculez en mode Conception.Switch to Design view.

  2. Dans l'aire de conception, cliquez sur Cliquez pour ajouter un titre.On the design surface, click Click to add title.

  3. Tapez Ventes de produits paramétrables, puis cliquez en dehors de la zone de texte.Type Parameterized Product Sales, and then click outside the text box.

10. Enregistrer le rapport10. Save the Report

Pour enregistrer le rapport sur un serveur de rapportsTo save the report on a report server

  1. À partir du bouton Générateur de rapports , cliquez sur Enregistrer sous.From the Report Builder button, click Save As.

  2. Cliquez sur Sites et serveurs récents.Click Recent Sites and Servers.

  3. Sélectionnez ou tapez le nom du serveur de rapports sur lequel vous êtes autorisé à enregistrer des rapports.Select or type the name of the report server where you have permission to save reports.

    Le message Connexion au serveur de rapportss’affiche.The message Connecting to report server appears. Une fois la connexion établie, le contenu du dossier de rapports spécifié par l'administrateur du serveur de rapports s'affiche comme emplacement par défaut des rapports.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. Dans la zone Nom, remplacez le nom par défaut par État des ventes paramétrable.In Name, replace the default name with Parameterized Sales Report.

  5. Cliquez sur Enregistrer.Click Save.

Le rapport est enregistré sur le serveur de rapports.The report is saved to the report server. Le serveur de rapports auquel vous êtes connecté est indiqué dans la barre d'état située au bas de la fenêtre.The report server that you are connected to appears in the status bar at the bottom of the window.

Étapes suivantesNext Steps

Ceci conclut la procédure pas à pas décrivant comment ajouter un paramètre à votre rapport.This concludes the walkthrough for how to add a parameter to your report. Pour en savoir plus sur les paramètres, consultez Paramètres de rapport (Générateur de rapports et Concepteur de rapports).To learn more about parameters, see Report Parameters (Report Builder and Report Designer).

Voir aussiSee Also