Paramètres de rapport (Générateur de rapports et Concepteur de rapports)Report Parameters (Report Builder and Report Designer)

Cette rubrique décrit les utilisations courantes des paramètres de rapport Reporting ServicesReporting Services , les propriétés que vous pouvez définir, et bien d’autres aspects.This topic describes the common uses for Reporting ServicesReporting Services report parameters, the properties you can set, and much more. Les paramètres de rapport vous permettent de contrôler les données du rapport, d'interconnecter les rapports associés et de varier la présentation des rapports.Report parameters enable you to control report data, connect related reports together, and vary report presentation. Vous pouvez utiliser les paramètres de rapport dans les rapports paginés que vous créez dans Générateur de rapportsReport Builder et dans le Concepteur de rapports, ainsi que dans les rapports mobiles que vous créez dans Éditeur de rapports mobiles SQL ServerSQL Server Mobile Report Publisher.You can use report parameters in paginated reports you create in Générateur de rapportsReport Builder and Report Designer, and also in mobile reports you create in Éditeur de rapports mobiles SQL ServerSQL Server Mobile Report Publisher. En savoir plus sur les Concepts de paramètres de rapport.Read more about Report Parameters Concepts.

||
|-|
| S’applique à :Applies to: Générateur de rapportsReport Builder, mode SharePoint et mode natif de Reporting ServicesReporting Services|

Pour essayer d’ajouter vous-même un paramètre à un rapport, consultez Didacticiel : Ajouter un paramètre à un rapport (Générateur de rapports).To try adding a parameter to a report yourself, see Tutorial: Add a Parameter to Your Report (Report Builder).

Utilisations courantes des paramètres Common Uses for Parameters

Voici quelques-unes des utilisations les plus courantes des paramètres.Here are some of the most common ways to use parameters.

Contrôler les données des rapports paginés et mobilesControl Paginated and Mobile Report Data

  • Filtrez les données d’un rapport paginé au niveau de la source de données en écrivant des requêtes de jeu de données qui comportent des variables.Filter paginated report data at the data source by writing dataset queries that contain variables.

  • Filtrez les données à partir d'un dataset partagé.Filter data from a shared dataset. Lorsque vous ajoutez un jeu de données partagé à un rapport paginé, vous ne pouvez pas modifier la requête.When you add a shared dataset to a paginated report, you cannot change the query. Dans le rapport, vous pouvez ajouter un filtre de dataset qui inclut une référence à un paramètre de rapport de votre création.In the report, you can add a dataset filter that includes a reference to a report parameter that you create.

  • Filtrez les données à partir d’un jeu de données partagé dans un rapport mobile SQL ServerSQL Server .Filter data from a shared dataset in a SQL ServerSQL Server mobile report. Consultez la rubrique Create mobile reports with SQL Server Mobile Report Publisher (éventuellement en anglais) pour plus d'informations.See Create mobile reports with SQL Server Mobile Report Publisher for more information.

  • Permettez aux utilisateurs de spécifier des valeurs pour personnaliser les données d’un rapport paginé.Enable users to specify values to customize the data in a paginated report. Par exemple, fournissez deux paramètres pour la date de début et la date de fin des données de ventes.For example, provide two parameters for the start date and end date for sales data.

    Connecter des rapports associésConnect Related Reports

  • Utilisez des paramètres pour associer des rapports principaux à des rapports d'extraction, des sous-rapports et des rapports liés.Use parameters to relate main reports to drillthrough reports, to subreports, and to linked reports. Lorsque vous concevez un ensemble de rapports, vous pouvez élaborer chaque rapport pour obtenir des réponses à certaines questions.When you design a set of reports, you can design each report to answer certain questions. Chaque rapport peut offrir une vue différente ou un niveau de détail différent pour des informations connexes.Each report can provide a different view or a different level of detail for related information. Pour fournir un ensemble de rapports reliés entre eux, créez des paramètres pour les données associées sur les rapports cibles.To provide a set of interrelated reports, create parameters for the related data on target reports.

    Pour plus d’informations, consultez Rapports d’extraction (Générateur de rapports et SSRS), Sous-rapports (Générateur de rapports et SSRS) et Créer un rapport lié.For more information, see Drillthrough Reports (Report Builder and SSRS), Subreports (Report Builder and SSRS), and Create a Linked Report.

  • Personnalisez des ensembles de paramètres pour plusieurs utilisateurs.Customize sets of parameters for multiple users. Créez deux rapports liés basés sur un état des ventes sur le serveur de rapports.Create two linked reports based on a sales report on the report server. L'un des rapports liés utilise des valeurs de paramètres prédéfinies pour les commerciaux et l'autre rapport lié utilise des valeurs de paramètres prédéfinies pour les responsables commerciaux.One linked report uses predefined parameter values for sales persons and the second linked report uses predefined parameter values for sales managers. Les deux rapports utilisent la même définition de rapport.Both reports use the same report definition.

    Varier la présentation des rapportsVary Report Presentation

  • Envoyez des commandes à un serveur de rapports via une demande d'URL, pour personnaliser l'affichage d'un rapport.Send commands to a report server through a URL request, to customize the rendering of a report. Pour plus d’informations, consultez Accès URL (SSRS) et Passer un paramètre de rapport dans une URL.For more information, see URL Access (SSRS) and Pass a Report Parameter Within a URL.

  • Permettez aux utilisateurs de spécifier des valeurs pour contribuer à la personnalisation de l'apparence d'un rapport.Enable users to specify values to help customize the appearance of a report. Par exemple, fournissez un paramètre booléen pour indiquer s'il faut développer ou réduire tous les groupes de lignes imbriqués dans une table.For example, provide a Boolean parameter to indicate whether to expand or collapse all nested row groups in a table.

  • Autorisez les utilisateurs à personnaliser les données et l'apparence des rapports en incluant des paramètres dans une expression.Enable users to customize report data and appearance by including parameters in an expression.

    Pour plus d’informations, consultez Informations de référence sur la collection de paramètres (Générateur de rapports et SSRS).For more information, see Parameters Collection References (Report Builder and SSRS).

Affichage d’un rapport doté de paramètres Viewing a Report with Parameters

Quand vous visualisez un rapport qui comporte des paramètres, la barre d’outils de la visionneuse de rapports affiche chaque paramètre pour vous permettre de spécifier des valeurs de manière interactive.When you view a report that has parameters, the report viewer toolbar displays each parameter so you can interactively specify values. L’illustration suivante montre la zone de paramètres pour un rapport de withparameters @ReportMonth, @ReportYear, @EmployeeID, @ShowAll, @ExpandTableRows, @CategoryQuota, et @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>

Afficher le rapport avec des paramètresView report with parameters

  1. Volet Paramètres : la barre d’outils de la visionneuse de rapports affiche une invite et une valeur par défaut pour chaque paramètre.Parameters pane The report viewer toolbar displays a prompt and default value for each parameter. Vous pouvez personnaliser la disposition des paramètres dans le volet Paramètres.You can customize the layout of parameters in the parameters pane. Pour plus d’informations, consultez Personnaliser le volet Paramètres dans un rapport (Générateur de rapports).For more information, see Customize the Parameters Pane in a Report (Report Builder).

  2. @SalesDateparamètre le paramètre @SalesDate est de type de données DateTime.@SalesDate parameter The parameter @SalesDate is data type DateTime. L’invite de sélection de date s’affiche en regard de la zone de texte.The prompt Select the Date appears next to the text box. Pour modifier la date, tapez une nouvelle date dans la zone de texte ou utilisez le contrôle calendrier.To modify the date, type a new date in the text box or use the calendar control.

  3. @ShowAllparamètre le paramètre @ShowAll est de type de données booléenne.@ShowAll parameter The parameter @ShowAll is data type Boolean. Utilisez les cases d'option pour spécifier True ou False.Use the radio buttons to specify True or False.

  4. Poignée Afficher ou masquer la zone de paramètres : dans la barre d’outils de la visionneuse de rapports, cliquez sur cette flèche pour afficher ou masquer le volet Paramètres.Show or Hide Parameter Area handle On the report viewer toolbar, click this arrow to show or hide the parameters pane.

  5. @CategoryQuotaparamètre le paramètre @CategoryQuota est de type de données Float, afin qu’il prenne une valeur numérique.@CategoryQuota parameter The parameter @CategoryQuota is data type Float, so it takes a numeric value. @CategoryQuotaest défini pour autoriser les valeurs multiples.@CategoryQuota is set to allow multiple values.

  6. Afficher le rapport : après avoir entré les valeurs des paramètres, cliquez sur Afficher le rapport pour exécuter le rapport.View Report After you enter parameter values, click View Report to run the report. Si tous les paramètres possèdent des valeurs par défaut, le rapport s'exécute automatiquement au premier affichage.If all parameters have default values, the report runs automatically on first view.

Création de paramètres Creating Parameters

Vous pouvez créer des paramètres de rapport de différentes façons :You can create report parameters in a few different ways.

Note

Toutes les sources de données ne prennent pas en charge les paramètres.Not all data sources support parameters.

Requête de dataset ou procédure stockée avec paramètresDataset query or stored procedure with parameters

Ajoutez une requête de dataset qui contient des variables ou une procédure stockée de dataset qui contient des paramètres d'entrée.Add a dataset query that contains variables or a dataset stored procedure that contains input parameters. Un paramètre de dataset est créé pour chaque variable ou paramètre d'entrée, et un paramètre de rapport est créé pour chaque paramètre de dataset.A dataset parameter is created for each variable or input parameter, and a report parameter is created for each dataset parameter.

Propriétés du jeu de données paramètre Générateur de rapportsReport Builder Parameter Dataset Properties

Cette image du Générateur de rapports montre :This image from Report Builder shows:

  1. les paramètres du rapport dans le volet Données du rapport ;The report parameters in the Report Data pane.

  2. le dataset avec les paramètres ;The dataset with the parameters.

  3. le volet Paramètres ;The Parameters pane.

  4. les paramètres répertoriés dans la boîte de dialogue Propriétés du dataset.The parameters listed in the Dataset Properties dialog box.

    Le dataset peut être incorporé ou partagé.The dataset can be embedded or shared. Lorsque vous ajoutez un dataset partagé à un rapport, les paramètres de dataset marqués comme internes ne peuvent pas être substitués dans le rapport.When you add a shared dataset to a report, dataset parameters that are marked internal cannot be overridden in the report. Vous pouvez substituer les paramètres de dataset qui ne sont pas marqués comme internes.You can override dataset parameters that are not marked internal.

    Pour plus d'informations, consultez Requête de dataset dans cette rubrique.For more information, see Dataset Query in this topic.

    Créer manuellement un paramètreCreate a parameter manually

    Créez manuellement un paramètre à partir du volet des données de rapport.Create a parameter manually from the Report Data pane. Vous pouvez configurer des paramètres de rapport afin qu'un utilisateur puisse entrer de manière interactive des valeurs dans le but de personnaliser le contenu ou l'apparence d'un rapport.You can configure report parameters so that a user can interactively enter values to help customize the contents or appearance of a report. Vous pouvez également configurer des paramètres de rapport afin qu'un utilisateur ne puisse pas modifier les valeurs préconfigurées.You can also configure report parameters so that a user cannot change preconfigured values.

Note

Les paramètres sont gérés indépendamment sur le serveur ; par conséquent, si vous republiez un rapport principal avec de nouveaux paramètres, les paramètres existants du rapport ne sont pas remplacés.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.

Partie de rapport dotée d’un paramètreReport part with a parameter

Ajoutez une partie de rapport qui contient des références à un paramètre ou à un dataset partagé contenant des variables.Add a report part that contains references to a parameter or to a shared dataset that contains variables.

Les parties de rapports sont stockées sur le serveur de rapports et sont à la disposition des autres utilisateurs qui souhaitent s'en servir dans leurs rapports.Report parts are stored on the report server and available for others to use in their reports. Les parties de rapports qui sont des paramètres ne peuvent pas être gérées à partir du serveur de rapports.Report parts that are parameters cannot be managed from the report server. Vous pouvez rechercher des paramètres dans la bibliothèque de parties de rapports et les configurer une fois que vous les avez ajoutés à votre rapport.You can search for parameters in the Report Part Gallery and after you add them, configure them in your report. Pour plus d’informations, consultez Publication de parties de rapports (Générateur de rapports et SSRS).For more information, see Report Parts (Report Builder and SSRS).

Note

Les paramètres peuvent être publiés en tant que partie de rapport distincte pour les régions de données qui ont des datasets dépendants avec des paramètres.Parameters can be published as a separate report part for data regions that have dependent datasets with parameters. Bien que les paramètres apparaissent sous la forme d'une partie de rapport, vous ne pouvez pas ajouter directement un paramètre de partie de rapport à un rapport.Although parameters are listed as a report part, you cannot add a report part parameter directly to a report. À la place, ajoutez la partie de rapport pour que tous les paramètres de rapport nécessaires soient générés automatiquement à partir des requêtes de dataset qui sont contenues ou référencées par la partie de rapport.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. Pour plus d’informations sur les parties de rapport, consultez Publication de parties de rapports (Générateur de rapports et SSRS) et Parties de rapports dans le Concepteur de rapports (SSRS).For more information about report parts, see Report Parts (Report Builder and SSRS) and Report Parts in Report Designer (SSRS).

Valeurs des paramètresParameter Values

Utilisez les options suivantes pour sélectionner les valeurs de paramètre dans le rapport.The following are options for selecting parameter values in the report.

  • Sélectionnez une valeur de paramètre dans la liste déroulante.Select a single parameter value from a drop-down list.

  • Sélectionnez plusieurs valeurs de paramètre dans la liste déroulante.Select multiple parameter values from a drop-down list.

  • Sélectionnez une valeur dans la liste déroulante pour un paramètre, qui détermine les valeurs disponibles dans la liste déroulante pour un autre paramètre.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. Il s'agit de paramètres en cascade.These are cascading parameters. Les paramètres en cascade vous permettent de filtrer successivement les valeurs de paramètres afin de passer de milliers de valeurs à un nombre plus gérable.Cascading parameters enables you to successively filter parameter values from thousands of values to a manageable number.

    Pour plus d’informations, consultez Ajouter des paramètres en cascade à un rapport (Générateur de rapports et SSRS).For more information, see Add Cascading Parameters to a Report (Report Builder and SSRS).

  • Exécutez le rapport sans sélectionner une valeur de paramètre, car une valeur par défaut est créée pour le paramètre.Run the report without having to first select a parameter value because a default value has been created for the parameter.

Propriétés de paramètres de rapport Report Parameter Properties

Vous pouvez modifier les propriétés de paramètre de rapport en utilisant la boîte de dialogue Propriétés du rapport.You can change the report parameter properties by using the Report Properties dialog box. Le tableau suivant récapitule les propriétés que vous pouvez définir pour chaque paramètre :The following table summarizes the properties that you can set for each parameter:

PropriétéProperty DescriptionDescription
NomName Tapez un nom de paramètre qui respecte la casse.Type a case-sensitive name for the parameter. Le nom doit commencer par une lettre et contenir des lettres, des chiffres, un trait de soulignement ().The name must begin with a letter and can have letters, numbers, an underscore (). Le nom ne peut pas contenir d'espace.The name cannot have spaces. Les noms des paramètres générés automatiquement correspondent au paramètre dans la requête du dataset.For automatically-generated parameters, the name matches the parameter in the dataset query. Par défaut, les paramètres créés manuellement sont similaires à ReportParameter1.By default, manually-created parameters are similar to ReportParameter1.
DemanderPrompt Texte qui apparaît en regard du paramètre dans la barre d'outils de la visionneuse de rapports.The text that appears next to the parameter on the report viewer toolbar.
Type de donnéesData type Un paramètre de rapport doit avoir l'un des types de données suivants :A report parameter must be one of the following data types:

Boolean.Boolean. L'utilisateur sélectionne True ou False à l'aide d'une case d'option.The user selects True or False from a radio button.

DateTime.DateTime. L'utilisateur sélectionne une date à l'aide d'un contrôle calendrier.The user selects a date from a calendar control.

Entier.Integer. L'utilisateur tape des valeurs dans une zone de texte.The user types values in a text box.

Float.Float. L'utilisateur tape des valeurs dans une zone de texte.The user types values in a text box.

Texte.Text. L'utilisateur tape des valeurs dans une zone de texte.The user types values in a text box.

Notez que lorsque des valeurs disponibles sont définies pour un paramètre, l’utilisateur peut les sélectionner dans une liste déroulante, même quand le type de données est 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.

Pour plus d'informations sur les types de données de rapport, consultez RDL Data Types.For more information about report data types, see RDL Data Types.
Autoriser une valeur videAllow blank value Sélectionnez cette option si la valeur du paramètre peut être une chaîne ou une valeur vide.Select this option if the value of the parameter can be an empty string or a blank.

Si vous spécifiez les valeurs valides d'un paramètre et si vous souhaitez qu'une valeur vide soit l'une des valeurs valides, vous devez l'inclure dans les valeurs que vous spécifiez.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 sélection de cette option n'inclut pas automatiquement une valeur vide dans les valeurs disponibles.Selecting this option does not automatically include a blank for available values.
Autoriser les valeurs de type NULLAllow null value Sélectionnez cette option si la valeur du paramètre peut être Null.Select this option if the value of the parameter can be a null.

Si vous spécifiez les valeurs valides d'un paramètre et si vous souhaitez qu'une valeur Null soit l'une des valeurs valides, vous devez l'inclure dans les valeurs que vous spécifiez.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 sélection de cette option n'inclut pas automatiquement une valeur Null dans les valeurs disponibles.Selecting this option does not automatically include a null for available values.
Autoriser les valeurs multiplesAllow multiple values Fournissez les valeurs disponibles pour la création d'une liste déroulante dans laquelle vos utilisateurs peuvent effectuer des choix.Provide available values to create a drop-down list that your users can choose from. Cela constitue une bonne méthode pour s'assurer que seules les valeurs valides sont envoyées dans la requête de dataset.This is a good way to ensure that only valid values are submitted in the dataset query.

Sélectionnez cette option si la valeur pour le paramètre peut être plusieurs valeurs affichées dans une liste déroulante.Select this option if the value for the parameter can be multiple values that are displayed in a drop-down list. Les valeurs NULL ne sont pas autorisées.Null values are not allowed. Lorsque cette option est sélectionnée, les cases à cocher sont ajoutées à la liste de valeurs disponibles dans une liste déroulante de paramètre.When this option is selected, check boxes are added to the list of available values in a parameter drop-down list. Le haut de la liste comporte une case à cocher pour Sélectionner tout.The top of the list includes a check box for Select All. Les utilisateurs peuvent activer les valeurs qu'ils souhaitent.Users can check the values that they want.

Si les données qui fournissent des valeurs changent rapidement, il est possible que la liste visible par l'utilisateur ne soit pas actualisée.If the data that provides values changes rapidly, the list the user sees might not be the most current.
VisibleVisible Sélectionnez cette option pour afficher le paramètre de rapport en haut du rapport lorsqu'il est exécuté.Select this option to display the report parameter at the top of the report when it is run. Cette option permet aux utilisateurs de sélectionner des valeurs de paramètre au moment de l'exécution.This option allows users to select parameter values at run time.
CachéHidden Sélectionnez cette option pour masquer le paramètre de rapport dans le rapport publié.Select this option to hide the report parameter in the published report. Les valeurs de paramètre de rapport peuvent toujours être définies sur une URL de rapport, dans une définition d'abonnement ou sur le serveur de rapports.The report parameter values can still be set on a report URL, in a subscription definition, or on the report server.
InterneInternal Sélectionnez cette option pour masquer le paramètre de rapport.Select this option to hide the report parameter. Dans le rapport publié, le paramètre de rapport ne peut être affiché que dans la définition du rapport.In the published report, the report parameter can only be viewed in the report definition.
Valeurs disponiblesAvailable values Si vous avez spécifié les valeurs disponibles d'un paramètre, les valeurs valides s'affichent toujours sous forme de liste déroulante.If you have specified available values for a parameter, the valid values always appear as a drop-down list. Par exemple, si vous fournissez des valeurs disponibles pour un paramètre DateTime , une liste déroulante de dates s’affiche dans le volet des paramètres à la place d’un contrôle calendrier.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.

Pour vous assurer qu'une liste de valeurs est cohérente parmi un rapport et des sous-rapports, vous pouvez définir une option sur la source de données afin d'utiliser une transaction unique pour toutes les requêtes des datasets associés à une source de données.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.

** Note de sécurité *\* Dans un rapport qui comprend un paramètre de type de données Text, veillez à utiliser une liste de valeurs disponibles (aussi appelée liste de valeurs valides), et vérifiez que l’utilisateur exécutant le rapport dispose uniquement des autorisations requises pour afficher les données du rapport.** 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. Pour plus d’informations, consultez Sécurité (Générateur de rapports).For more information, see Security (Report Builder).
Valeurs par défautDefault values Définissez les valeurs par défaut à partir d'une requête ou d'une liste statique.Set default values from a query or from a static list.

Lorsque chaque paramètre a une valeur par défaut, le rapport s'exécute automatiquement au premier affichage.When each parameter has a default value, the report runs automatically on first view.
AvancéAdvanced Définissez l'attribut de définition de rapport UsedInQuery, valeur qui indique si ce paramètre affecte directement ou indirectement les données d'un rapport.Set the report definition attribute UsedInQuery, a value that indicates whether this parameter directly or indirectly affects the data in a report.

Déterminer automatiquement le moment de l'actualisationAutomatically determine when to refresh
Choisissez cette option lorsque vous souhaitez que le processeur de rapports détermine un paramètre pour cette valeur.Choose this option when you want the report processor to determine a setting for this value. La valeur est True si le processeur de rapports détecte une requête de dataset avec une référence directe ou indirecte à ce paramètre ou si le rapport possède des sous-rapports.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.

Toujours actualiserAlways refresh
Choisissez cette option lorsque le paramètre de rapport est utilisé directement ou indirectement dans une requête de dataset ou une expression de paramètre.Choose this option when the report parameter is used directly or indirectly in a dataset query or parameter expression. Cette option affecte la valeur True à UsedInQuery .This option sets UsedInQuery to True.

Ne jamais actualiserNever refresh
Choisissez cette option quand le paramètre de rapport n'est pas utilisé directement ou indirectement dans une requête de dataset ou une expression de paramètre.Choose this option when the report parameter is not used directly or indirectly in a dataset query or parameter expression. Cette option affecte la valeur False à UsedInQuery .This option sets UsedInQuery to False.

** Attention *\* Utilisez l’option Ne jamais actualiser avec précaution.** Caution *\* Use Never Refresh with caution. Sur le serveur de rapports, UsedInQuery permet de contrôler les options de cache pour les données de rapports et les rapports rendus, ainsi que les options de paramètres des rapports d'instantané.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. Si vous définissez l'option Ne jamais actualiser de manière incorrecte, vous risquez de provoquer la mise en cache incorrecte de rapports ou de données de rapports ou de provoquer la présence de données incohérentes dans un rapport d'instantané.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. Pour plus d’informations, consultez Langage de définition de rapport (SSRS, Report Definition Language).For more information, see Report Definition Language (SSRS).

Requête de dataset Dataset Query

Pour filtrer les données dans la requête de dataset, vous pouvez inclure une clause de restriction qui limite les données récupérées en spécifiant les valeurs à inclure ou exclure dans le jeu de résultats.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.

Utilisez le concepteur de requêtes pour la source de données pour générer plus facilement une requête paramétrable.Use the query designer for the data source to help build a parameterized query.

  • Pour les requêtes Transact-SQLTransact-SQL , différentes sources de données prennent en charge différentes syntaxes pour les paramètres.For Transact-SQLTransact-SQL queries, different data sources support different syntax for parameters. La prise en charge comprend les paramètres identifiés dans la requête par position ou par nom.Support ranges from parameters that are identified in the query by position or by name. Pour plus d'informations, consultez les rubriques relatives aux types de sources de données externes spécifiques dans Jeux de données du rapport (SSRS).For more information, see topics for specific external data source types in Report Datasets (SSRS). Dans le concepteur de requêtes relationnelles, vous devez sélectionner l'option de paramètre pour un filtre afin de créer une requête paramétrable.In the relational query designer, you must select the parameter option for a filter to create a parameterized query. Pour plus d’informations, consultez Interface utilisateur du Concepteur de requêtes relationnelles (Générateur de rapports).For more information, see Relational Query Designer User Interface (Report Builder).

  • Pour les requêtes basées sur une source de données multidimensionnelle telle que Microsoft SQL Server Analysis Services, SAP NetWeaver BI ou Hyperion Essbase, vous pouvez définir s'il faut créer un paramètre en fonction d'un filtre que vous spécifiez dans le concepteur de requêtes.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. Pour plus d’informations, consultez la rubrique relative au concepteur de requêtes dans Concepteurs de requêtes (Générateur de rapports) qui correspond à l’extension de données.For more information, see the query designer topic in Query Designers (Report Builder) that corresponds to the data extension.

Gestion des paramètres pour un rapport publié Parameter Management for a Published Report

Lorsque vous concevez un rapport, les paramètres de rapport sont enregistrés dans la définition de rapport.When you design a report, report parameters are saved in the report definition. Lorsque vous publiez un rapport, les paramètres de rapport sont enregistrés et gérés indépendamment de la définition de rapport.When you publish a report, report parameters are saved and managed separately from the report definition.

Pour un rapport publié, vous pouvez utiliser les éléments suivants :For a published report, you can use the following:

  • Propriétés des paramètres de rapport.Report parameter properties. Modifiez des valeurs de paramètres de rapport directement sur le serveur de rapports, indépendamment de la définition de rapport.Change report parameter values directly on the report server independently from the report definition.

  • Rapports mis en cache.Cached reports. Pour permettre la création d’un plan de cache pour un rapport, chaque paramètre doit avoir une valeur par défaut.To create a cache plan for a report, each parameter must have a default value. Pour plus d’informations, consultez Mise en cache de rapports (SSRS).For more information, see Caching Reports (SSRS).

  • Datasets partagés mis en cache.Cached shared datasets. Pour permettre la création d’un plan de cache pour un jeu de données partagé, chaque paramètre doit avoir une valeur par défaut.To create a cache plan for a shared dataset, each parameter must have a default value. Pour plus d’informations, consultez Mise en cache de rapports (SSRS).For more information, see Caching Reports (SSRS).

  • Rapports liés.Linked reports. Vous pouvez créer des rapports liés avec des valeurs de paramètres prédéfinies pour filtrer les données selon les différents publics.You can create linked reports with preset parameter values to filter data for different audiences. Pour plus d’informations, consultez Créer un rapport lié.For more information, see Create a Linked Report.

  • Abonnements aux rapports.Report subscriptions. Vous pouvez spécifier des valeurs de paramètres pour filtrer les données et remettre des rapports par le biais d’abonnements.You can specify parameter values to filter data and deliver reports through subscriptions. Pour plus d’informations, consultez Abonnements et remise (Reporting Services).For more information, see Subscriptions and Delivery (Reporting Services).

  • Accès URL.URL access. Vous pouvez spécifier des valeurs de paramètres dans une URL pointant vers un rapport.You can specify parameter values in a URL to a report. Vous pouvez également exécuter des rapports et spécifier des valeurs de paramètres à l'aide de l'accès URL.You can also run reports and specify parameter values using URL access. Pour plus d’informations, consultez Accès URL (SSRS).For more information, see URL Access (SSRS).

    Les propriétés de paramètres que vous définissez pour un rapport publié sont généralement conservées si vous republiez la définition du rapport.Parameter properties for a published report are generally preserved if you republish the report definition. Si la définition du rapport est republiée dans le même rapport, et si les noms des paramètres et les types de données restent les mêmes, vos valeurs de propriétés sont conservées.If the report definition is republished as the same report, and parameter names and data types remain the same, your property settings are retained. Si vous ajoutez ou supprimez des paramètres dans la définition de rapport, ou si vous modifiez le type de données ou le nom d'un paramètre existant, il peut être nécessaire de modifier les propriétés des paramètres dans le rapport publié.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.

    Tous les paramètres ne peuvent pas être modifiés dans tous les cas.Not all parameters can be modified in all cases. Si un paramètre de rapport obtient une valeur par défaut d'une requête de dataset, cette valeur ne peut pas être modifiée pour un rapport publié et ne peut pas être modifiée sur le serveur de rapports.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. La valeur utilisée au moment de l'exécution est déterminée lorsque la requête est lancée ou, dans le cas des paramètres basés sur une expression, lorsque celle-ci est évaluée.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.

    Les options d'exécution de rapport peuvent affecter le mode de traitement des paramètres.Report execution options can affect how parameters are processed. Un rapport qui s'exécute en tant qu'instantané ne peut pas utiliser les paramètres dérivés d'une requête sauf si cette requête inclut des valeurs par défaut pour les paramètres.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.

Paramètres d'un abonnement Parameters for a Subscription

Vous pouvez définir un abonnement pour un rapport à la demande ou un rapport d'instantané et spécifier les valeurs de paramètres à utiliser lors du traitement de l'abonnement.You can define a subscription for an on demand or for a snapshot and specify parameter values to use during subscription processing.

  • Rapport à la demande.On demand report. Pour un rapport à la demande, vous pouvez spécifier une valeur de paramètre différente de la valeur publiée pour chaque paramètre répertorié pour le rapport.For an on demand report, you can specify a different parameter value than the published value for each parameter listed for the report. Prenons l'exemple d'un rapport Service d'appel qui utilise un paramètre Période pour retourner les demandes du service client de la journée, de la semaine ou du mois en cours.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. Si la valeur par défaut du paramètre du rapport est égale à aujourd’hui, votre abonnement peut utiliser une valeur de paramètre différente (par exemple, semaine ou mois) pour produire un rapport contenant des chiffres hebdomadaires ou mensuels.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.

  • Instantané.Snapshot. Pour un instantané, votre abonnement doit utiliser les valeurs de paramètres définies pour l’instantané.For a snapshot, your subscription must use the parameter values defined for the snapshot. Votre abonnement ne peut pas passer outre une valeur de paramètre définie pour un instantané.Your subscription cannot override a parameter value that is defined for a snapshot. Supposons que vous vous abonniez à un rapport des ventes de la région Ouest s'exécutant en tant qu'instantané de rapport et que la valeur du paramètre régional de cet instantané soit définie sur Ouest .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. Dans ce cas, vous devez spécifier la valeur de paramètre Ouest dans l'abonnement que vous créez pour ce rapport.In this case, if you create a subscription to this report, you must use the parameter value Western in your subscription. Pour signaler visuellement que le paramètre est ignoré, les champs de paramètres de la page d'abonnement sont définis en lecture seule.To provide a visual indication that the parameter is ignored, the parameter fields on the subscription page are set to read-only fields.

    Les options d'exécution de rapport peuvent affecter le mode de traitement des paramètres.Report execution options can affect how parameters are processed. Les rapports paramétrables exécutés comme instantanés de rapport utilisent les valeurs de paramètre définies pour l'instantané.Parameterized reports that run as report snapshots use the parameter values defined for the report snapshot. Ces valeurs sont définies dans la page de propriétés des paramètres du rapport.Parameter values are defined in the parameter properties page of the report. Un rapport qui s'exécute en tant qu'instantané ne peut pas utiliser les paramètres dérivés d'une requête sauf si cette requête inclut des valeurs par défaut pour les paramètres.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.

    Si une valeur de paramètre est modifiée dans l'instantané du rapport une fois l'abonnement défini, le serveur de rapports désactive l'abonnement.If a parameter value changes in the report snapshot after the subscription is defined, the report server deactivates the subscription. Cette désactivation est une façon de signaler que le rapport a été modifié.Deactivating the subscription indicates that the report has been modified. Pour activer l'abonnement, ouvrez-le, puis enregistrez-le.To activate the subscription, open and then save the subscription.

Note

Les abonnements pilotés par les données peuvent utiliser des valeurs de paramètre obtenues à partir d'une source de données d'abonnés.Data-driven subscriptions can use parameter values that are obtained from a subscriber data source. Pour plus d’informations, consultez Utiliser une source de données externe pour les données des abonnés (abonnements pilotés par les données).For more information, see Use an External Data Source for Subscriber Data (Data-Driven Subscription).

Pour plus d’informations, consultez Abonnements et remise (Reporting Services).For more information, see Subscriptions and Delivery (Reporting Services).

Paramètres et sécurisation des données Parameters and Securing Data

Soyez attentif lorsque vous distribuez des rapports paramétrables qui contiennent des informations confidentielles ou sensibles.Use caution when distributing parameterized reports that contain confidential or sensitive information. Un utilisateur peut facilement remplacer un paramètre de rapport par une autre valeur, avec pour résultat une divulgation d'informations.A user can easily replace a report parameter with a different value, resulting in information disclosure that you did not intend.

Pour sécuriser l'utilisation des paramètres des données personnelles ou des employés, vous pouvez sélectionner les données en fonction d'expressions qui comprennent le champ UserID de la collection 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 collection Users permet d'obtenir l'identité de l'utilisateur qui exécute le rapport et d'utiliser cette identité pour extraire les données spécifiques à l'utilisateur.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.

Important

Dans un rapport qui inclut un paramètre de type String, veillez à utiliser une liste de valeurs disponibles (aussi appelée liste de valeurs valides) et vérifiez que l’utilisateur exécutant le rapport dispose uniquement des autorisations nécessaires à l’affichage des données du rapport.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. Lorsque vous définissez un paramètre de type String, la zone de texte qui apparaît vous permet d'entrer n'importe quelle valeur.When you define a parameter of type String, the user is presented with a text box that can take any value. Une liste de valeurs disponibles limite les valeurs susceptibles d'être entrées.An available values list limits the values that can be entered. Si le paramètre de rapport est lié à un paramètre de dataset et que vous n'utilisez pas une liste de valeurs disponibles, l'utilisateur d'un rapport peut taper la syntaxe SQL dans la zone de texte, ce qui peut exposer le rapport et votre serveur au risque d'une attaque par injection 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. Si l'utilisateur dispose d'autorisations suffisantes pour exécuter la nouvelle instruction SQL, cela risque de générer des résultats indésirables sur le serveur.If the user has sufficient permissions to execute the new SQL statement, it may produce unwanted results on the server.

Si un paramètre de rapport n'est pas lié à un paramètre de dataset et les valeurs de paramètre sont incluses dans le rapport, l'utilisateur d'un rapport peut taper la syntaxe de l'expression ou une URL dans la valeur de paramètre et rendre le rapport au format Excel ou 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. Si un autre utilisateur affiche ensuite le rapport et clique sur le contenu du paramètre de rendu, celui-ci peut exécuter accidentellement le lien ou le script malveillant.If another user then views the report and clicks the rendered parameter contents, the user may inadvertently execute the malicious script or link.

Pour réduire le risque d'exécution accidentelle de scripts malveillants, ouvrez les rapports rendus uniquement à partir de sources approuvées.To mitigate the risk of inadvertently running malicious scripts, open rendered reports only from trusted sources. Pour plus d’informations sur la sécurisation des rapports, consultez Sécurisation des rapports et des ressources.For more information about securing reports, see Secure Reports and Resources.

Rubriques de procédures How-To Topics

Cette section répertorie les procédures qui vous indiquent pas à pas comment utiliser les paramètres et les filtres.This section lists procedures that show you, step by step, how to work with parameters and filters.

Configuration de paramètres de rapport SSRS (quiz)Configuring SSRS Report Parameters (quiz)

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

Concepts de paramètres de rapportReport Parameters Concepts

Exemples de rapports (Générateur de rapports et SSRS)Report Samples (Report Builder and SSRS)

Utilisation d’expressions dans les rapports (Générateur de rapports et SSRS)Expression Uses in Reports (Report Builder and SSRS)

Expressions (Générateur de rapports et SSRS)Expressions (Report Builder and SSRS)

Filtrer, regrouper et trier des données (Générateur de rapports et SSRS)Filter, Group, and Sort Data (Report Builder and SSRS)

Sécurité (Générateur de rapports)Security (Report Builder)

Tri interactif, Explorateurs de documents et liens (Générateur de rapports et SSRS)Interactive Sort, Document Maps, and Links (Report Builder and SSRS)

Extraction, exploration, sous-rapports et régions de données imbriquées (Générateur de rapports et SSRS)Drillthrough, Drilldown, Subreports, and Nested Data Regions (Report Builder and SSRS)