• Article

Exécution d'un rapport paramétrable

Un rapport paramétrable est un rapport dont le traitement exige des valeurs d'entrée. Les exemples courants de rapports paramétrables sont les rapports qui appliquent des filtres sur des valeurs régionales, une catégorie de produit ou un identificateur. Les paramètres sont généralement utilisés pour compléter une requête qui sélectionne des données pour la génération d'un rapport. Si vous gérez ou exécutez un rapport paramétrable, vous devez bien comprendre l'incidence de votre sélection de paramètres sur le rapport que vous utilisez.

Notes

C'est l'auteur du rapport qui définit les paramètres utilisés. Une fois le rapport publié, vous pouvez modifier certaines propriétés de paramètres pour modifier les valeurs utilisées et la façon dont elles sont obtenues. Pour plus d'informations sur la création de paramètres, consultez Paramètres (Générateur de rapports version 3.0 et SSRS). Pour plus d'informations sur la gestion de paramètres, consultez Définition des propriétés de paramètres d'un rapport publié.

Stockage et appel des valeurs des paramètres

Pour obtenir une valeur de paramètre au moment de l'exécution, vous pouvez stocker une valeur par défaut dans le rapport ou inviter l'utilisateur à la taper ou la sélectionner. Le stockage d'une valeur de paramètre dans un rapport est utile si vous souhaitez que le rapport soit toujours traité avec une valeur spécifique. Par exemple, si une filiale locale possède un site Web dédié, vous pouvez héberger sur son site Web un rapport des ventes régionales qui utilise toujours un code régional spécifique.

Vous pouvez également inviter les utilisateurs à taper ou à sélectionner la valeur à utiliser lorsqu'ils ouvrent un rapport. Lorsque vous configurez un rapport de façon à ce que les valeurs des paramètres soient fournies par l'utilisateur, des champs de saisie sont affichés pour qu'il puisse taper ces valeurs. Après avoir tapé les valeurs, il doit cliquer sur Afficher le rapport pour exécuter le rapport. Si les valeurs sont valides, le rapport s'affiche. Dans le cas contraire, un message d'erreur s'affiche ou un rapport vide apparaît. Si vous utilisez des valeurs de paramètre stockées, le rapport s'ouvre sans afficher de champs d'entrée ni de bouton Afficher le rapport. Tous les utilisateurs qui exécutent le rapport utilisent la même valeur de paramètre.

Si le rapport inclut des paramètres de requête et que la source de données demande à ce que chaque utilisateur se connecte, des informations d'identification sont demandées à l'utilisateur avant que les champs d'entrée ne s'affichent sur la page. Dans ce cas, les informations d'identification doivent être fournies pour que les valeurs des paramètres puissent être récupérées.

Pour exécuter un rapport paramétrable, vous devez, en règle générale, savoir quelles valeurs indiquer. Un rapport peut comporter des zones de liste déroulante qui regroupent des valeurs valides parmi lesquelles il est possible de choisir.

Pour définir les propriétés de paramètre (y compris les valeurs par défaut) d'un rapport publié, utilisez le Gestionnaire de rapports. Pour plus d'informations, consultez Paramètres (Générateur de rapports version 3.0 et SSRS) et Définition des paramètres d'un abonnement.

Définition des paramètres dans une URL de rapport

L'autre méthode qui permet d'exécuter un rapport paramétrable est l'utilisation d'une URL. Vous pouvez spécifier un ou plusieurs paramètres dans des paires nom-valeur encodées en utilisant le caractère & pour les séparer.

Les paramètres Null utilisent une syntaxe spéciale : vous devez spécifier isnull pour une valeur Null. Si vous définissez une valeur Null pour un paramètre, toutes les autres valeurs spécifiées pour ce paramètre sont ignorées. L'exemple suivant montre plusieurs paramètres incluant des valeurs Null et des constantes :

http://exampleWebServerName/reportserver?/foldercontainingreports/orders&division=mailorder&region=west&sales:isnull=true

Les paramètres affichant plusieurs valeurs sont indiqués en répétant le nom du paramètre. Par exemple :

http://exampleWebServerName/reportserver?/foldercontainingreports/orders&region=east&region=west

Les paramètres du type Boolean prennent la valeur 0 ou 1.

Les paramètres du type Float doivent inclure le séparateur décimal associé aux paramètres régionaux définis sur le serveur.

Les paramètres du type DateTime doivent être spécifiés avec le format AAAA-MM-JJTHH:MM:SS qui est basé sur la norme ISO 8601. Pour plus d'informations sur la définition des paramètres dans une URL, consultez Utilisation de paramètres d'accès URL.