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

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, consultez Spécification CLS (Common Language Specification) sur https://msdn.microsoft.com.

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, sélectionnez Masqué ou Interne.

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 Interne pour un paramètre, celui-ci n'est exposé que dans la définition de rapport. Un paramètre interne doit avoir une valeur par défaut, qui peut être Null si l'option Autoriser les valeurs de type Null a été sélectionnée.

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 ou utiliser une requête permettant de récupérer 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.

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 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, certains langages de requête ne retournent pas de valeurs Null dans un jeu de résultats.

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.

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.