Ajout de paramètres à un rapport (Générateur de rapports version 2.0)
Dans le Générateur de rapports version 2.0, les paramètres de rapport permettent de spécifier les données à utiliser dans un rapport, de relier les rapports connexes et de modifier la présentation du rapport. Pour concevoir un rapport qui utilise des paramètres efficacement, vous devez comprendre la façon dont les paramètres et requêtes de dataset fonctionnent ensemble, la façon dont les paramètres et expressions fonctionnent ensemble, la façon dont les paramètres peuvent être gérés sur le serveur de rapports pour un rapport publié, ainsi que les questions auxquelles un rapport doit répondre. Vos choix de paramètres peuvent influencer la conception et la mise en page du rapport.
Les paramètres de requête sont ajoutés à une requête de dataset par les Concepteurs de requêtes ou la boîte de dialogue Propriétés du dataset. Après avoir créé une requête avec les paramètres, Reporting Services lie automatiquement les paramètres de requête aux paramètres de rapport avec le même nom. Les nouveaux paramètres de rapport sont ajoutés et modifiés par le biais du volet de données du rapport.
Utilisation de paramètres dans Reporting Services
L'utilisation la plus courante des paramètres consiste à modifier les données de rapport récupérées par les requêtes de dataset. Dans ce scénario, les utilisateurs sont invités à indiquer une ou des valeurs lorsqu'ils exécutent le rapport, et la requête de dataset récupère uniquement les données demandées. La requête de dataset comprend des paramètres de requête et le processeur de rapports crée automatiquement les paramètres de rapport correspondants qui sont indirectement liés aux paramètres de requête. Vous pouvez modifier les propriétés des paramètres de rapport dans les outils de conception du rapport pour inclure une liste de valeurs valides et une invite d'utilisateur qui s'affiche au moment de l'exécution.
Vous pouvez également créer des paramètres en cascade, qui récupèrent des données hiérarchiques d'une source de données. Par exemple, le premier paramètre peut filtrer sur la catégorie de produit, et le deuxième paramètre peut filtrer sur le produit. Les paramètres en cascade sont utilisés pour organiser et limiter le nombre de valeurs disponibles pour l'utilisateur.
Les sources de données ne prennent pas toutes en charge les paramètres de requête. Dans les cas où vous ne pouvez pas filtrer les données de la source, vous pouvez utiliser des paramètres de rapport pour permettre aux utilisateurs de filtrer les données une fois qu'elles ont été récupérées pour le rapport. Alors que tous les paramètres de requête ont des paramètres de rapport correspondants, vous pouvez définir indépendamment des paramètres de rapport dans les outils du Concepteur de rapports. Les paramètres de rapport peuvent également être utilisés pour modifier l'apparence ou l'organisation d'un rapport après que les données ont été récupérées.
Les paramètres permettent de relier les rapports aux sous-rapports et rapports d'extraction. Ces paramètres de rapport peuvent être masqués, en utilisant des valeurs dans le rapport principal pour sélectionner les données correctes pour le rapport connecté, ou ils peuvent être visibles par l'utilisateur au moment de l'exécution.
Après avoir créé un paramètre de rapport, vous pouvez modifier les valeurs par défaut et d'autres propriétés de paramètre, telles que la visibilité. Par exemple, les paramètres de rapport peuvent utiliser des variables intégrées comme UserID et vous pouvez souhaiter créer un rapport avec un paramètre masqué qui sélectionne des données spécifiques à l'utilisateur qui exécute le rapport. Les paramètres peuvent contenir des valeurs uniques ou multiples, utiliser une liste de valeurs valides statiques ou basées sur des requêtes, et accepter des valeurs Null ou vides. Les paramètres à valeurs multiples permettent aux utilisateurs de sélectionner plusieurs valeurs au moment de l'exécution.
Une fois qu'un rapport a été publié, les paramètres peuvent être gérés indépendamment de la définition de rapport. 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é. Ils peuvent également créer des jeux de paramètres liés à la même définition de rapport qui personnalisent le rapport pour plusieurs audiences.
Vous pouvez également exécuter des rapports et spécifier des valeurs de paramètre à l'aide de l'accès URL. Pour plus d'informations, consultez la rubrique « Using URL Access Parameters » dans la documentation Reporting Services de la documentation en ligne SQL Server.
.gif "Remarque relative à la sécurité") 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 une URL ou la syntaxe de l'expression dans la valeur de paramètre et restituer 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 rendus uniquement à partir de sources approuvées. Pour plus d'informations sur la sécurisation des rapports, consultez la rubrique « Sécurisation des rapports et des ressources » dans la documentation Reporting Services de la Documentation en ligne de SQL Server. |
Dans cette section
Utilisation de paramètres pour contrôler les données d'un rapport (Générateur de rapports version 2.0)
Explique comment utiliser des paramètres pour filtrer les données de rapport, changer l'ordre de tri des données de détails et de groupe, et modifier les requêtes pour utiliser des fournisseurs de données spécifiques.Utilisation de paramètres de requête avec des sources de données spécifiques (Générateur de rapports version 2.0)
Décrit la syntaxe de requête escomptée par les différentes sources de données.Utilisation de paramètres pour contrôler l'apparence d'un rapport (Générateur de rapports version 2.0)
Explique comment utiliser des paramètres pour modifier l'apparence du rapport à l'aide de propriétés basées sur des expressions, y compris le masquage conditionnel des éléments de rapport et le changement conditionnel de la couleur de texte selon les valeurs d'une zone de texte.Utilisation de paramètres pour établir des liaisons à d'autres rapports (Générateur de rapports version 2.0)
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 (Générateur de rapports version 2.0)
Explique comment utiliser des paramètres à valeur unique et à valeurs multiples.Création de paramètres de rapport et définition des propriétés des paramètres de rapport (Générateur de rapports version 2.0)
Explique comment créer et définir des propriétés sur un paramètre de rapport lorsque vous créez le rapport, y compris les type de données, valeurs par défaut, messages relatifs aux paramètres, valeurs disponibles, valeurs multiples, et si les paramètres sont internes, masqués ou visibles par l'utilisateur au moment de l'exécution.
Voir aussi