Création de paramètres de rapport et définition des propriétés des paramètres de rapport
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 (Reporting Services).
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 ServerManagement 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
Des paramètres de rapport sont automatiquement créés pour les paramètres de requête lorsqu'une requête de dataset est enregistrée, mais vous pouvez aussi en créer manuellement. Après avoir créé un paramètre de rapport, vous pouvez être amené à ajuster les valeurs par défaut de ses propriétés afin d'obtenir les fonctionnalités voulues. Par exemple, vous pouvez avoir à modifier le type de données, créer un dataset pour fournir une liste des valeurs disponibles, créer un dataset pour les valeurs par défaut ou indiquer si les valeurs peuvent être vides ou Null.
Si vous souhaitez qu'un paramètre autorise plusieurs valeurs, vous devez modifier la requête de dataset de sorte qu'elle autorise également plusieurs valeurs. Pour plus d'informations, consultez Utilisation de paramètres à valeur unique et à valeurs multiples. En outre, si vous incluez un paramètre à valeurs multiples dans une expression, vous devez comprendre comment écrire l'expression pour accéder aux valeurs voulues. Pour plus d'informations, consultez Utilisation de références à la collection Parameters dans des expressions (Reporting Services).
Pour créer ou modifier un paramètre de rapport, cliquez avec le bouton droit sur le nœud Paramètres dans le volet Données et ouvrez la boîte de dialogue Propriétés du paramètre de rapport.
[!REMARQUE]
Si vous supprimez ou modifiez le nom d'un paramètre de requête, le paramètre de rapport correspondant n'est pas supprimé ou modifié automatiquement. Si vous modifiez le nom d'un paramètre de requête, lorsque vous enregistrez la requête, un nouveau paramètre de rapport correspondant au nom modifié est créé. Vous pouvez renommer le paramètre de rapport pour qu'il corresponde au nom du nouveau paramètre de requête, puis mettre à jour les propriétés du paramètre de dataset afin de lier le paramètre de requête au paramètre de rapport. Si vous supprimez un paramètre de requête et que vous n'avez pas besoin du paramètre de rapport correspondant, vous devez le supprimer manuellement.
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, consultez Spécification CLS (Common Language Specification) sur 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, sélectionnez 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 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.
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 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.
[!REMARQUE]
Dans Reporting Services, 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, dans le concepteur de requêtes, choisissez plutôt la liste de membres Tous MDX.
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, certains 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