Partager via


Références à la collection de paramètres intégrée dans un rapport paginé (Power BI Report Builder)

S’APPLIQUE À : Power BI Report Builder Power BI Desktop

Les paramètres de rapport paginé sont l’une des collections intégrées que vous pouvez référencer depuis une expression dans Power BI Report Builder. En incluant des paramètres dans une expression, vous pouvez personnaliser les données et l'apparence d'un rapport en fonction des choix faits par un utilisateur. Des expressions peuvent être utilisées pour toutes les propriétés des éléments de rapport ou propriétés des zones de texte qui comportent l’option (Fx) ou <Expression> Les expressions sont également utilisées pour contrôler différemment le contenu et l'apparence d'un rapport. Si vous souhaitez en savoir plus, veuillez consulter la rubrique Exemples d’expressions (Power BI Report Builder).

Lorsque vous comparez des valeurs de paramètres à des valeurs de champs de dataset au moment de l'exécution, les types de données des deux éléments que vous comparez doivent être identiques. Les types des paramètres de rapport sont les suivants : Boolean, DateTime, Integer, Float ou Text, qui représente le type de données sous-jacent String. Si nécessaire, vous pouvez convertir le type de données de la valeur du paramètre pour qu'il corresponde à la valeur du dataset. Si vous souhaitez en savoir plus, veuillez consulter la rubrique Types de données dans les expressions (Power BI Report Builder).

Pour inclure une référence de paramètre dans une expression, vous devez comprendre comment spécifier la syntaxe correcte pour la référence de paramètre, laquelle varie suivant que le paramètre est un paramètre à valeur unique ou à valeurs multiples.

Utiliser un paramètre à valeur unique dans une expression

Le tableau suivant présente des exemples de la syntaxe à utiliser lorsque vous incluez une référence à un paramètre à valeur unique de n'importe quel type de données dans une expression.

Exemple Description
=Parameters!<ParameterName>.IsMultiValue Retourne False.

Vérifie si un paramètre est à valeurs multiples. Si True, le paramètre est à valeurs multiples et il s’agit d’une collection d’objets. Si False, le paramètre est à valeur unique et il s’agit d’un seul objet.
=Parameters!<ParameterName>.Count Retourne la valeur entière 1. Pour un paramètre à valeur unique, le nombre est toujours 1.
=Parameters!<ParameterName>.Label Retourne l'étiquette du paramètre, qui est souvent utilisée comme nom complet dans une liste déroulante de valeurs disponibles.
=Parameters!<ParameterName>.Value Retourne la valeur du paramètre. Si la propriété Libellé n’a pas été définie, cette valeur apparaît dans la liste déroulante des valeurs disponibles.
=CStr(Parameters!<ParameterName>.Value) Retourne la valeur du paramètre sous forme de chaîne.
=Fields(Parameters!<ParameterName>.Value).Value Retourne la valeur du champ qui possède le même nom que le paramètre.

Si vous souhaitez en savoir plus sur l’utilisation de paramètres dans un filtre, veuillez consulter la rubrique Ajouter des filtres de jeu de données, des filtres de régions de données et des filtres de groupes (Power BI Report Builder).

Utiliser un paramètre à valeurs multiples dans une expression

Le tableau suivant présente des exemples de la syntaxe à utiliser lorsque vous incluez une référence à un paramètre à valeurs multiples de n'importe quel type de données dans une expression.

Exemple Description
=Parameters!<MultivalueParameterName>.IsMultiValue Retourne True ou False.

Vérifie si un paramètre est à valeurs multiples. Si True, le paramètre est à valeurs multiples et il s’agit d’une collection d’objets. Si False, le paramètre est à valeur unique et il s’agit d’un seul objet.
=Parameters!<MultivalueParameterName>.Count Retourne une valeur entière.

Fait référence au nombre de valeurs. Pour un paramètre à valeur unique, le nombre est toujours 1. Pour un paramètre à valeurs multiples, le nombre est 0 ou plus.
=Parameters!<MultivalueParameterName>.Value(0) Retourne la première valeur dans un paramètre à valeurs multiples.
=Parameters!<MultivalueParameterName>.Value(Parameters!<MultivalueParameterName>.Count-1) Retourne la dernière valeur dans un paramètre à valeurs multiples.
=Split("Value1,Value2,Value3",",") Retourne un tableau de valeurs.

Permet de créer un tableau de valeurs pour un paramètre de type String à valeurs multiples. Vous pouvez utiliser un délimiteur dans le second paramètre pour établir un fractionnement (Split). Cette expression peut être utilisée pour définir les valeurs par défaut d'un paramètre à valeurs multiples ou pour créer un paramètre à valeurs multiples à envoyer à un rapport d'extraction ou de type sous-rapport.
=Join(Parameters!<MultivalueParameterName>.Value,", ") Retourne une valeur de type String qui est composée d’une liste de valeurs délimitées par des virgules dans un paramètre à valeurs multiples. Vous pouvez utiliser un délimiteur dans le second paramètre pour établir une liaison (Join).

Si vous souhaitez en savoir plus sur l’utilisation de paramètres dans un filtre, veuillez consulter la rubrique Paramètres de rapport (Power BI Report Builder et Report Designer).

Étapes suivantes

Modifier l’ordre d’un paramètre de rapport paginé - Power BI Report Builder

Ajouter un paramètre à valeurs multiples à un rapport paginé - Power BI Report Builder

Personnaliser le volet Paramètres dans un rapport paginé - Power BI Report Builder