Utilisation de paramètres dans Reporting Services

Mis à jour : 17 juillet 2006

Dans une configuration Reporting Services, les paramètres permettent de spécifier les données à utiliser dans un rapport, de relier les rapports connexes et de modifier la présentation du rapport. Il existe deux types de paramètres dans un rapport : les paramètres de requête et les paramètres de rapport.

• Lorsque vous définissez une requête de dataset qui inclut des variables, Reporting Services crée les paramètres de requête correspondants. Les paramètres de requête permettent de faire en sorte que seules les données nécessaires pour le rapport soient extraites de la source de données.
• Les paramètres de rapport apparaissent sur la barre d'outils Rapports et permettent aux lecteurs de sélectionner ou d'entrer des valeurs qui sont utilisées lors du traitement d'un rapport. Dans le Concepteur de rapports, les paramètres de rapport sont automatiquement créés à partir des paramètres de requête. Dans le Générateur de rapports, les paramètres de rapport sont créés lorsque vous définissez une invite sur une clause de filtre. Vous pouvez également définir des paramètres de rapport qui ne sont pas liés aux paramètres de requête. Dans les expressions, vous pouvez inclure des références à des paramètres de rapport à l'aide de la collection globale de paramètres. Étant donné que les expressions peuvent être utilisées tout au long d'une définition de rapport pour contrôler le contenu ou l'apparence du rapport, les paramètres de rapport constituent un moyen très efficace de personnaliser un rapport.

La liste suivante récapitule brièvement les aspects fondamentaux des paramètres et décrit leur mode d'utilisation dans Reporting Services :

• Les paramètres de rapport sont traités par le serveur de rapports, tandis que les paramètres de requête sont traités sur le serveur de la source de données.
• Par défaut, chaque valeur du paramètre de requête est associée à la valeur du paramètre de rapport correspondante. Ainsi, les utilisateurs peuvent sélectionner des valeurs pour les paramètres de rapport et faire en sorte qu'elles soient transmises dans la requête pour limiter les données récupérées à partir de la source de données.
• Les paramètres de rapport qui ne sont pas liés à des paramètres de requête sont utilisés pour modifier la présentation, filtrer les données, contrôler le tri et le regroupement, et modifier les propriétés des zones de texte. Pour cela, vous devez écrire des expressions qui incluent des paramètres. Lorsque le rapport est traité, les expressions sont évaluées à l'aide des configurations de paramètres en cours. Ainsi, vous pouvez utiliser des paramètres de rapport pour modifier l'aspect d'un rapport qui vous autorise à spécifier une expression.
• Vous pouvez définir des propriétés de paramètres de rapport qui déterminent si les paramètres sont à valeur unique, à valeurs multiples, visibles au moment de l'exécution, s'ils utilisent une liste de valeurs valides statique ou basée sur une requête, s'ils possèdent des valeurs par défaut et s'ils acceptent des valeurs NULL ou vides. Grâce aux paramètres à valeurs multiples, il est possible de sélectionner plusieurs valeurs.
• Vous pouvez créer des paramètres en cascade qui définissent la liste des valeurs valides des autres paramètres du rapport (par exemple, le choix d'une catégorie de produit spécifique détermine la liste des produits disponibles).
• Vous pouvez utiliser les paramètres pour lier un rapport parent à un rapport d'extraction ou à un sous-rapport incorporé.
• Après avoir publié un rapport, vous pouvez gérer les propriétés de paramètre du rapport publié indépendamment de la définition de paramètre initiale. Suivant la façon dont vous configurez le paramètre dans le rapport au moment de la conception, les administrateurs de serveur de rapports peuvent modifier de nombreuses propriétés de paramètre dans le rapport publié. Pour plus d'informations, consultez Définition des propriétés de paramètres d'un rapport publié.
• Les paramètres peuvent être définis dans des abonnements. Chaque utilisateur qui s'abonne à un rapport peut spécifier des valeurs de paramètres qui sont stockées et utilisées avec l'abonnement. Pour plus d'informations, consultez Définition des paramètres d'un abonnement.
• Les paramètres peuvent être définis via un accès d'URL. Pour plus d'informations, consultez Using URL Access Parameters.

Remarque relative à la sécurité :

Dans un rapport qui inclut un paramètre de type String, veillez à utiliser une liste de valeurs disponibles (également appelée liste de valeurs valides) et assurez-vous que l'utilisateur qui exécute le rapport dispose uniquement des autorisations nécessaires à l'affichage des données du rapport. 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. Une liste de valeurs disponibles limite les valeurs susceptibles d'être entrées. Si le paramètre de rapport est lié à un paramètre de requête et 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 de rapports au risque d'une attaque par injection SQL. 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. Si un paramètre de rapport n'est pas lié à un paramètre de requête 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. Si un autre utilisateur affiche ensuite le rapport et clique sur le contenu du paramètre rendu, l'utilisateur peut exécuter par inadvertance le lien ou le script malveillant. Pour réduire le risque d'exécution accidentelle de scripts malveillants, ouvrez les rapports uniquement à partir de sources approuvées. Pour plus d'informations sur la sécurisation des rapports, consultez Sécurisation des rapports et des ressources.

Dans cette section

• Utilisation de paramètres pour contrôler les données des rapports
  Explique comment utiliser des paramètres pour contrôler les données d'un rapport.

• Utilisation de paramètres pour contrôler l'apparence d'un rapport
  Explique comment utiliser des paramètres pour contrôler l'apparence d'un rapport, notamment les propriétés de visibilité, d'ordre de tri, de filtrage, de couleur et de zone de texte.

• Utilisation de paramètres pour établir des liaisons à d'autres rapports
  Explique comment utiliser des paramètres pour établir des liaisons à des rapports d'extraction, des sous-rapports et des rapports liés.

• Utilisation de paramètres à valeur unique et à valeurs multiples
  Explique comment utiliser les paramètres à une seule valeur et les paramètres à valeurs multiples.

• Création de paramètres de rapport et définition des propriétés des paramètres de rapport
  Explique comment créer un paramètre de rapport et définir ses propriétés.

• Utilisation de paramètres dans les expressions
  Explique comment inclure des paramètres dans une expression et décrit, entre autres, la syntaxe des paramètres à une seule valeur et à valeurs multiples.

Voir aussi

Tâches

Procédure : ajouter un filtre (Générateur de rapports)
Procédure : associer un paramètre de requête à un paramètre de rapport (Générateur de rapports)
Procédure : ajouter, modifier ou supprimer un paramètre de rapport (Concepteur de rapports)

Concepts

Utilisation de données dans une mise en page de rapport
Ajout de fonctionnalités interactives
Filtrage de données dans un rapport
Définition des propriétés de paramètres d'un rapport publié

Autres ressources

Didacticiel : Ajout de paramètres à un rapport tabulaire de base
Didacticiel : Fonctionnalités avancées utilisant les paramètres
Paramètres du rapport (Générateur de rapports)

Aide et Informations

Assistance sur SQL Server 2005