Création de paramètres de rapport et définition des propriétés des paramètres de rapport

Nouveau : 17 juillet 2006

Les paramètres de rapport sont définis globalement pour le rapport. Les paramètres de rapport sont créés automatiquement si la requête de rapport comprend des paramètres, ou ils peuvent être créés manuellement. Une fois un paramètre de rapport créé, vous devez définir les propriétés qui l'identifient et qui contrôlent son utilisation dans le rapport.

Pour utiliser des paramètres avant la publication d'un rapport, recourez à la boîte de dialogue Paramètres du rapport du Concepteur de rapports. Pour plus d'informations, consultez Procédure : ajouter, modifier ou supprimer un paramètre de rapport (Concepteur de rapports).

Une fois qu'un rapport a été publié, vous pouvez modifier nombre des propriétés des paramètres du rapport à l'aide du Gestionnaire de rapports ou de SQL Server Management Studio. Pour plus d'informations sur la modification des propriétés des paramètres et sur les considérations relatives à la sécurité, consultez Définition des propriétés de paramètres d'un rapport publié.

Paramètres de rapport

Bien que des paramètres de rapport soient automatiquement créés pour les paramètres de requête, les paramètres de rapport ne sont jamais supprimés lors de la suppression d'un paramètre de requête.

Pour ouvrir la boîte de dialogue Paramètres du rapport, basculez en mode Données ou Disposition dans le Concepteur de rapports et à partir du menu Rapport, sélectionnez Propriétés du rapport. Dans le volet gauche, une liste de paramètres de rapport s'affiche. Sélectionnez le paramètre que vous voulez modifier.

Nom et type de données

Les noms de paramètres sont obligatoires et doivent être uniques à l'intérieur du rapport. Par défaut, un paramètre possède le type de données String. Vous pouvez choisir un autre type de données dans la liste déroulante. Si le paramètre de rapport est basé sur un paramètre de requête, assurez-vous que le type de données du paramètre de rapport correspond à celui du paramètre de requête. Étant donné que Reporting Services ne détecte pas les types de données des paramètres de requête, vous devez ajuster le type de données vous-même.

Les noms doivent respecter les normes de casse et de caractère de la spécification CLS (Common Language Specification). Pour plus d'informations, recherchez les termes « Common Language Specification » à l'adresse https://msdn.microsoft.com.

Invite

En règle générale, dans un rapport publié, les paramètres apparaissent sous la forme de zones de texte dans une zone d'entrée de paramètre en haut du rapport. La chaîne d'invite définit l'étiquette qui identifie le paramètre dans la zone d'entrée. Cette invite peut être simplement le nom du paramètre ou bien des instructions destinées à l'utilisateur, comme « Année » ou « Sélectionnez une année ». Si vous omettez de préciser une invite et qu'une valeur de paramètre par défaut existe, cette valeur apparaît en tant qu'invite, et la zone d'entrée du paramètre n'est pas affichée lorsque l'utilisateur exécute le rapport. En revanche, si aucune valeur de paramètre par défaut n'est spécifiée et que la zone d'invite reste vide, le rapport ne peut pas s'exécuter. Si vous ne voulez pas inviter l'utilisateur à entrer des valeurs de paramètre, marquez un paramètre comme étant Masqué ou Interne.

Paramètres masqués et internes

Vous pouvez définir des options qui contrôlent la visibilité des paramètres du rapport publié. La définition des options Masqué et Interne fournit différents niveaux de visibilité. Vous pouvez masquer le paramètre dans la zone d'entrée de paramètre du rapport publié, tout en pouvant définir ses valeurs dans une URL de rapport ou dans une définition d'abonnement. Si vous définissez un paramètre à interne uniquement, il n'est exposé que dans la définition du rapport.

Paramètres à valeur unique et à valeurs multiples

Vous pouvez définir un paramètre à valeurs multiples en sélectionnant l'option Valeurs multiples dans la boîte de dialogue Paramètres du rapport. Si cette case à cocher n'est pas activée, le paramètre est à valeur unique. Si vous sélectionnez l'option Valeurs multiples, des cases à cocher sont ajoutées aux valeurs disponibles dans une liste déroulante de paramètres au sein du rapport publié. Les utilisateurs peuvent sélectionner les valeurs souhaitées ; par exemple, dans l'exemple de rapport Sales Reason Comparisons, les utilisateurs peuvent sélectionner plusieurs produits pour afficher les données de leurs ventes combinées.

Lorsque vous spécifiez les valeurs disponibles, vous pouvez fournir une liste statique de chaînes ou utiliser une requête permettant d'extraire les valeurs disponibles d'une source de données. Un paramètre à valeurs multiples doit comprendre au moins une valeur. Les valeurs NULL ne sont pas autorisées. L'option Sélectionner tout est créé automatiquement, et elle est affichée uniquement lorsqu'il existe plusieurs valeurs.

Remarque :
Dans SQL Server 2005, si vous utilisez une source de données Analysis Services, ne choisissez pas l'option Sélectionner tout. L'option Sélectionner tout peut engendrer de mauvaises performances lors du traitement d'une requête MDX. Si vous souhaitez sélectionner toutes les valeurs, choisissez plutôt la liste de membres Tous.

Autoriser une valeur vide

Lorsque vous créez une liste de valeurs disponibles, si vous souhaitez que <Vide> soit autorisé comme valeur valide, vous devez l'inclure dans la liste des valeurs valides.

Autoriser les valeurs NULL

Autoriser les valeurs Null est une option pour les paramètres à valeur unique. Vous ne pouvez pas sélectionner cette valeur pour un paramètre à valeurs multiples. Lorsque vous sélectionnez Autoriser les valeurs Null, vous autorisez le paramètre à posséder une valeur Null. Par défaut, de nombreux langages de requête ne retournent pas de valeurs Null dans un jeu de résultats.

Valeurs disponibles

Lorsque vous définissez un paramètre de rapport, vous devez définir les valeurs utilisables avec le rapport. Ces valeurs sont dites disponibles ou valides. Une liste de valeurs disponibles contient un ensemble de paires valeur/étiquette. Lorsque le rapport est exécuté, l'utilisateur voit l'étiquette. S'il sélectionne l'étiquette, la valeur correspondante est utilisée comme valeur du paramètre. Les valeurs disponibles peuvent être prédéfinies en tant qu'expression ou que liste statique, ou extraites d'un dataset :

• Une liste non interrogée est une liste statique de paires valeur/étiquette. Toute cette liste figure dans la définition des paramètres de rapport. Chaque valeur et chaque étiquette peuvent être statiques ou être générées à partir d'une expression.
• Une liste interrogée amène le serveur de rapports à récupérer un ensemble de valeurs et d'étiquettes à partir d'un dataset lors de l'exécution du rapport. Pour définir une liste de ce type, vous devez sélectionner le dataset, le champ à utiliser pour la valeur et le champ à utiliser pour l'étiquette.

Lorsque vous établissez une liste interrogée de valeurs disponibles, il est recommandé de créer un dataset simplifié, qui sera tout spécialement utilisé par le paramètre, et non pas un dataset compliqué qu'emploient également des régions de données du rapport. L'utilisation d'un même dataset pour les régions de données du rapport et pour la liste de valeurs valides peut occasionner des résultats inattendus dans cette dernière.

Valeur par défaut

Vous pouvez attribuer une valeur par défaut à un paramètre. Si tous les paramètres d'un rapport possèdent des valeurs par défaut, le rapport est traité dès son ouverture par l'utilisateur ou dès sa prévisualisation dans le Concepteur de rapports. S'il manque au minimum une valeur par défaut à un paramètre, le rapport affiche des données uniquement après que l'utilisateur a entré toutes les valeurs de paramètres et a exécuté le rapport.

Vous pouvez utiliser une valeur non interrogée ou interrogée comme valeur par défaut. Une valeur par défaut non interrogée est une valeur statique ou une expression. Une valeur par défaut interrogée est une expression qui pointe vers un champ d'un dataset. Si la requête retourne plusieurs lignes, la valeur provenant de la première ligne du dataset retourné est employée.

Vous pouvez également vous abstenir de définir une valeur par défaut. Vous devez dans ce cas spécifier une invite.

Remarque :
Si vous utilisez un paramètre à valeurs multiples et que la requête retourne plusieurs lignes, toutes les lignes sont utilisées pour la valeur par défaut.

Voir aussi

Autres ressources

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

Aide et Informations

Assistance sur SQL Server 2005