Paramètres (Générateur de rapports version 3.0 et SSRS)

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. Pour concevoir un rapport qui utilise des paramètres efficacement, vous devez comprendre la façon dont les paramètres et les requêtes de dataset sont mis en relation, comment inclure des paramètres dans les expressions et comment gérer les paramètres de manière indépendante à partir d'une définition de rapport sur le serveur de rapports ou le site SharePoint.

Vous pouvez créer des paramètres de rapports des manières suivantes :

  • Créez ou ajoutez un dataset, incorporé ou partagé, dont la requête contient des variables de requête.

  • Créez manuellement un paramètre dans le volet Données du rapport.

  • Ajoutez une partie de rapport contenant des références à un paramètre ou à un dataset partagé qui contient des variables.

Une fois que vous avez publié un rapport, vous pouvez gérer les paramètres indépendamment de la définition de rapport. Vous pouvez même créer plusieurs ensembles de paramètres pour un même rapport. Pour plus d'informations, consultez Définition des propriétés de paramètres d'un rapport publié et Ajout, modification et suppression de rapports liés.

La barre d'outils de la visionneuse de rapports affiche chaque paramètre de sorte qu'un utilisateur peut spécifier des valeurs de façon interactive. L'illustration suivante montre la zone de paramètres d'un rapport qui contient les paramètres @StartDate, @EndDate, @Subcategory et @ShowAllRows.

Paramètres sur la barre d'outils de la visionneuse de rapports

  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. La mise en forme des paramètres de la barre d'outils est effectuée automatiquement. L'ordre suivi est déterminé par l'ordre d'affichage des paramètres dans le volet Données du rapport.

  2. **Paramètres @StartDate et @EndDate**   Le type de données du paramètre @StartDate est DateTime. L'invite de la date de début s'affiche en regard de la zone de texte. Pour modifier la date, tapez une nouvelle date dans la zone de texte ou utilisez le contrôle calendrier.

    Le paramètre @EndDate s'affiche en regard de @StartDate.

  3. **Paramètre @Subcategory**   Le type de données du paramètre @Subcategory est Text. Dans la mesure où @Subcategory comprend une liste de valeurs disponibles, les valeurs valides s'affichent dans une liste déroulante. Vous devez choisir des valeurs dans cette liste. Dans la mesure où @Subcategory est un paramètre à valeurs multiples, l'option Sélectionner tout s'affiche pour vous permettre de tout effacer et de sélectionner l'ensemble des valeurs de la liste.

  4. **Paramètre @ShowAllRows**   Le type de données du paramètre @ShowAllRows est Boolean. Utilisez les cases d'option pour spécifier True ou False.

  5. 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.

  6. Bouton Paramètres   Dans l'aperçu du Générateur de rapports, dans le Ruban, cliquez sur le bouton Paramètres pour afficher ou masquer le volet Paramètres.

  7. Bouton Afficher le rapport   Dans la barre d'outils de la visionneuse de rapports, cliquez sur Afficher le rapport pour exécuter le rapport après avoir entré des valeurs de paramètres. Si tous les paramètres possèdent des valeurs par défaut, le rapport s'exécute automatiquement au premier affichage.

Pour plus d'informations sur l'utilisation de paramètres, consultez Didacticiel : ajout d'un paramètre à un rapport (Générateur de rapports version 3.0), Didacticiel : Ajout de paramètres à un rapport (SSRS) ou Exemples de rapports (Générateur de rapports version 3.0 et SSRS)

Notes

Les paramètres peuvent être publiés en tant que partie de rapport distincte pour les régions de données ayant des datasets dépendants avec des paramètres. Bien que les paramètres soient listés dans une partie de rapport séparée, vous ne pouvez pas ajouter de paramètre de partie de rapport directement à un rapport. À la place, ajoutez la partie de rapport, et tous les paramètres de rapport nécessaires sont automatiquement générés à partir de requêtes de dataset contenues ou référencées par la partie de rapport. Pour plus d'informations sur les parties de rapport, consultez Parties de rapports (Générateur de rapports version 3.0) et Parties de rapport dans le Concepteur de rapports (SSRS).

Notes

Vous pouvez créer et modifier des définitions de rapports (.rdl) dans le Générateur de rapports version 3.0 et dans le Concepteur de rapports, dans Business Intelligence Development Studio. Chaque environnement de création offre différentes possibilités pour créer, ouvrir et enregistrer des rapports et des éléments connexes. Pour plus d'informations, consultez Conception de rapports dans le Concepteur de rapports et le Générateur de rapports version 3.0 (SSRS) sur le site Web Microsoft.

Dans cet article

Utilisations courantes des paramètres

Types de paramètres

Utilisation des paramètres de rapport

Utilisation des paramètres de dataset

Paramètres en cascade

Passage de paramètres à des rapports d'extraction ou des sous-rapports

Gestion des paramètres sur un serveur de rapports ou un site SharePoint

Dans cette section

Rubriques connexes

Utilisations courantes des paramètres

Voici quelques-unes des méthodes les plus communes pour utiliser des paramètres :

  • Permettez aux utilisateurs de spécifier des valeurs pour personnaliser les données d'un rapport. Par exemple, fournissez deux paramètres pour la date de début et la date de fin des données de ventes.

  • Permettez aux utilisateurs de spécifier des valeurs pour contribuer à la personnalisation de l'apparence d'un rapport. 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.

  • Créez une liste déroulante de valeurs à choisir, de sorte que l'utilisateur ne puisse sélectionner qu'une valeur valide.

  • Créez une valeur par défaut pour chaque paramètre, de sorte que le rapport s'exécute automatiquement au premier affichage.

  • Créez des valeurs en cascade, de sorte que la liste déroulante d'un paramètre représente l'ensemble des valeurs valides en fonction de la sélection d'un paramètre précédent. Cela vous permet de filtrer successivement les valeurs de paramètres afin de passer de milliers de valeurs à un nombre plus gérable.

  • Personnalisez des ensembles de paramètres pour plusieurs utilisateurs. Créez deux rapports liés basés sur un état des ventes sur le serveur de rapports. 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. Les deux rapports utilisent la même définition de rapport.

  • Permettez aux utilisateurs de filtrer les données à partir d'un dataset partagé. Lorsque vous ajoutez un dataset partagé à un rapport, vous ne pouvez pas modifier la requête. 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.

Icône de flèche utilisée avec le lien Retour au débutRetour au début

Types de paramètres

Les rapports incluent deux types de paramètres : les paramètres de dataset et les paramètres de rapport.

  • Paramètre de dataset   Un paramètre de dataset pour un dataset incorporé ou un dataset partagé est créé automatiquement pour chaque variable de requête dans la commande de requête de dataset. Certains concepteurs de requêtes fournissent une zone pour l'ajout de filtres appliqués en fonction des noms de champs, ainsi qu'une option pour l'ajout d'un paramètre de dataset en fonction du nom de champ.

    Les paramètres de dataset sont configurés une fois que vous avez défini la requête de dataset. Vous pouvez spécifier des valeurs par défaut de manière indépendante pour chaque paramètre de dataset. 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. Vous pouvez substituer les paramètres de dataset qui ne sont pas marqués comme internes. Vous pouvez également créer des paramètres supplémentaires. Pour plus d'informations, consultez Utilisation des paramètres de dataset dans cette rubrique.

  • Paramètre de rapport   Un paramètre de rapport est créé automatiquement pour chaque paramètre de dataset. Vous pouvez également créer manuellement des paramètres de rapport. 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. Vous pouvez également configurer des paramètres de rapport afin qu'un utilisateur ne puisse pas modifier les valeurs préconfigurées. Les paramètres de rapport sont gérés indépendamment d'un rapport publié sur le serveur de rapports. Pour plus d'informations, consultez Utilisation des paramètres de rapport dans cette rubrique.

    Vous pouvez également enregistrer un paramètre de rapport de manière séparée, en tant que partie d'un rapport. 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. Les parties de rapports qui sont des paramètres ne peuvent pas être gérées à partir du serveur de rapports. 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. Pour plus d'informations, consultez Parties de rapports (Générateur de rapports version 3.0).

La plupart du temps, vous utilisez des paramètres de rapport.

Icône de flèche utilisée avec le lien Retour au débutRetour au début

Utilisation des paramètres de rapport

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 ; en outre, le processeur de rapports crée automatiquement les paramètres de rapport qui sont indirectement liés aux paramètres de requête.

Par défaut, les paramètres créés automatiquement utilisent un nom, une invite et un type de données générés automatiquement. Vous pouvez modifier les propriétés des paramètres de rapport dans le volet Données du rapport à l'aide de la boîte de dialogue Propriétés du rapport. Le tableau suivant récapitule les propriétés que vous pouvez définir pour chaque paramètre :

Propriété

Description

Nom

Tapez un nom de paramètre qui respecte la casse. Le nom doit commencer par une lettre et contenir des lettres, des chiffres, un trait de soulignement (_) et aucun espace. Les noms des paramètres générés automatiquement correspondent au paramètre de requête dans la requête du dataset. Par défaut, les paramètres créés manuellement sont similaires à ReportParameter1.

Invite

Texte qui apparaît en regard du paramètre dans la barre d'outils de la visionneuse de rapports.

Type de données

Un paramètre de rapport doit avoir l'un des types de données suivants : Text, Integer, Float, DateTime, Boolean.

Le type de données détermine la façon dont un paramètre de rapport s'affiche dans la barre d'outils de la visionneuse de rapports. Le type de données peut également être important lorsque vous écrivez des expressions qui incluent une référence au paramètre.

Autoriser une valeur vide

Sélectionnez cette option si la valeur du paramètre peut être une chaîne ou une valeur vide.

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. La sélection de cette option n'inclut pas automatiquement une valeur vide dans les valeurs disponibles.

Autoriser les valeurs de type NULL

Sélectionnez cette option si la valeur du paramètre peut être 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. La sélection de cette option n'inclut pas automatiquement une valeur Null dans les valeurs disponibles.

Autoriser les valeurs multiples

Fournissez les valeurs disponibles pour la création d'une liste déroulante dans laquelle vos utilisateurs peuvent effectuer des choix. Cela constitue une bonne méthode pour s'assurer que seules les valeurs valides sont envoyées dans la requête de dataset.

Sélectionnez cette option si la valeur pour le paramètre peut être plusieurs valeurs affichées dans une liste déroulante. Les valeurs NULL ne sont pas autorisées. 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. Le haut de la liste comporte une case à cocher pour Sélectionner tout. Les utilisateurs peuvent activer les valeurs qu'ils souhaitent.

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.

Visible

Sélectionnez cette option pour afficher le paramètre de rapport en haut du rapport lorsqu'il est exécuté. Cette option permet aux utilisateurs de sélectionner des valeurs de paramètre au moment de l'exécution.

Masqué

Sélectionnez cette option pour masquer le paramètre de rapport dans le rapport. Les valeurs de paramètre de rapport peuvent être définies sur une URL de rapport, dans une définition d'abonnement ou sur le serveur de rapports à l'aide du Gestionnaire de rapports.

Interne

Sélectionnez cette option pour masquer le paramètre du rapport. Le paramètre du rapport ne peut être affiché que dans la définition du rapport.

Valeurs disponibles

Si vous avez spécifié les valeurs disponibles d'un paramètre, les valeurs valides s'affichent toujours sous forme de liste déroulante. Par exemple, si vous fournissez les valeurs disponibles d'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.

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.

Remarque relative à la sécuritéRemarque relative à la sécurité
Dans un rapport qui inclut un paramètre de type de données Text, 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. Pour plus d'informations, consultez Sécurité (Générateur de rapports version 3.0).

Valeurs par défaut

Définissez les valeurs par défaut à partir d'une requête ou d'une liste statique.

Lorsque chaque paramètre a une valeur par défaut, le rapport s'exécute automatiquement au premier affichage.

Avancé

Définissez une valeur qui indique si ce paramètre affecte directement ou indirectement les données d'un rapport.

Sur le serveur de rapports, cette valeur permet de déterminer les options de cache pour les rapports et les données de rapports.

Pour plus d'informations, consultez Boîte de dialogue Propriétés du paramètre de rapport, Options avancées (Générateur de rapports 3.0).

Icône de flèche utilisée avec le lien Retour au débutRetour au début

Utilisation des paramètres de dataset

Les paramètres de requête sont définis lorsque vous générez une requête dans un concepteur de requêtes. Certaines extensions de données offrent un moyen de sélectionner les champs à inclure comme paramètres. D'autres extensions de données identifient les variables de requête dans la commande de requête. Un paramètre de requête est créé automatiquement pour chaque variable de requête.

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. 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.

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.

Utilisez le concepteur de requêtes associé à une source de données pour générer plus facilement une requête paramétrable.

Icône de flèche utilisée avec le lien Retour au débutRetour au début

Paramètres en cascade

Vous pouvez créer des paramètres en cascade, où l'utilisateur choisit une valeur pour chaque paramètre dans un ordre spécifique, et chaque choix limite successivement les valeurs pour le paramètre suivant. Ces paramètres permettent de limiter des milliers de choix potentiels à un nombre raisonnable. Par exemple, un utilisateur choisit une catégorie de produit, puis choisit dans la liste des produits disponibles dans cette catégorie, puis choisit une taille, puis une couleur.

Pour plus d'informations, consultez Procédure : ajouter des paramètres en cascade à un rapport (Générateur de rapports version 3.0 et SSRS).

Icône de flèche utilisée avec le lien Retour au débutRetour au début

Passage de paramètres à des rapports d'extraction et des sous-rapports

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.

Pour plus d'informations, consultez Utilisation de paramètres pour établir des liaisons à d'autres rapports (Générateur de rapports version 3.0 et SSRS).

Gestion des paramètres sur un serveur de rapports ou un site SharePoint

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 pour un rapport ou un dataset partagé. Si vous concevez un rapport dont vous souhaitez planifier le traitement à des fins de mise en cache ou d'abonnements, des exigences supplémentaires peuvent s'appliquer aux paramètres. Pour plus d'informations, consultez les rubriques suivantes dans la documentation relative à Reporting Services au sein de la documentation en ligne de SQL Server.

  • **Rapports mis en cache.   **Pour permettre la création d'un plan de cache pour un rapport, chaque paramètre doit avoir une valeur par défaut. Pour plus d'informations, consultez Mise en cache d'un rapport dans Reporting Services.

  • **Mise en cache des datasets partagés.   **Pour permettre la création d'un plan de cache pour un dataset partagé, chaque paramètre doit avoir une valeur par défaut. Pour plus d'informations, consultez Mise en cache d'un rapport dans Reporting Services.

  • Rapports connexes.   Vous pouvez créer des rapports connexes avec des valeurs de paramètres prédéfinies pour filtrer les données selon les différents publics. Pour plus d'informations, consultez Ajout, modification et suppression de rapports liés.

  • Abonnements à un rapport.   Vous pouvez spécifier des valeurs de paramètres pour filtrer les données et remettre des rapports via des abonnements. Pour plus d'informations, consultez Définition des paramètres d'un abonnement et Abonnement et remise (Reporting Services).

  • Accès URL.   Vous pouvez spécifier des valeurs de paramètres dans une URL pointant vers un rapport. Vous pouvez également exécuter des rapports et spécifier des valeurs de paramètres à l'aide de l'accès URL. Pour plus d'informations, consultez Accès URL.

Icône de flèche utilisée avec le lien Retour au débutRetour au début

Rubriques de procédures

Cette section répertorie les procédures qui vous indiquent pas à pas comment utiliser les paramètres et les filtres.

Icône de flèche utilisée avec le lien Retour au débutRetour au début