Collections intégrées – Information de références sur la collection de champs de jeu de données dans un rapport paginé (Générateur de rapports Power BI)

Article
06/30/2023

S’APPLIQUE À : Générateur de rapports Power BI Power BI Desktop

Chaque jeu de données figurant dans un rapport paginé contient une collection de champs. La collection Fields comprend l’ensemble de champs spécifiés par la requête de dataset, ainsi que tous les champs calculés supplémentaires que vous créez. Après avoir créé un dataset, la collection de champs apparaît dans le volet Données du rapport .

Une référence de champ simple dans une expression s'affiche sur l'aire de conception comme une expression simple. Par exemple, lorsque vous faites glisser le champ Sales du volet des données de rapport vers une cellule de table sur l'aire de conception, [Sales] s'affiche. Cela représente l’expression sous-jacente =Fields!Sales.Value définie sur la propriété Value de la zone de texte. Lorsque le rapport s'exécute, le processeur de rapports évalue cette expression et affiche les données effectives de la source de données dans la zone de texte dans la cellule de table. Pour plus d’informations, consultez Expressions (Générateur de rapports Power BI) et Collection de champs de jeu de données (Générateur de rapports Power BI).

Affichage de la collection de champs pour un dataset

Pour afficher les valeurs individuelles pour une collection de champs, faites glisser chaque champ vers une ligne de détails du tableau et exécutez le rapport. Les références de la ligne de détails d'une région de données de table ou de liste affichent une valeur pour chaque ligne du dataset.

Pour afficher des valeurs résumées pour un champ, faites glisser chaque champ numérique vers la zone de données d'une matrice. La fonction d'agrégation par défaut pour la ligne des totaux est Sum, par exemple =Sum(Fields!Sales.Value). Vous pouvez modifier la fonction par défaut pour calculer des totaux différents. Pour plus d’informations, consultez Référence sur les fonctions d’agrégation (Power BI Report Builder).

Pour afficher des valeurs résumées pour une collection de champs dans une zone de texte directement sur l'aire de conception (n'appartenant à aucune région de données), vous devez spécifier le nom du dataset comme une étendue pour la fonction d'agrégation. Par exemple, pour un dataset nommé SalesData, l’expression suivante spécifie le total de toutes les valeurs pour le champ Sales: =Sum(Fields!Sales,"SalesData").

Lorsque vous utilisez la boîte de dialogue Expression pour définir une référence de champ simple, vous pouvez sélectionner la collection Fields dans le volet Catégorie et afficher la liste des champs disponibles dans le volet Champ . Chaque champ a plusieurs propriétés, notamment Value et IsMissing. Les propriétés restantes sont des propriétés de champ étendues prédéfinies qui peuvent être disponibles pour le dataset en fonction du type de source de données.

Détection de valeurs Null pour un champ de dataset

Pour détecter une valeur de champ Null (Nothing en Visual Basic), vous pouvez utiliser la fonction IsNothing. Lorsqu'elle est placée dans une zone de texte dans la ligne Détails d'un tableau, l'expression suivante teste le champ MiddleName et substitue le texte « No Middle Name » lorsque la valeur est Null, et la valeur de champ elle-même lorsque la valeur n'est pas Null :

=IIF(IsNothing(Fields!MiddleName.Value),"No Middle Name",Fields!MiddleName.Value)

Détection de champs manquants pour les requêtes dynamiques au moment de l'exécution

Par défaut, les éléments de la collection Champs disposent de deux propriétés : Value et IsMissing. La propriété IsMissing indique si un champ défini pour un dataset au moment de la conception figure dans les champs récupérés au moment de l’exécution. Par exemple, votre requête peut appeler une procédure stockée dans laquelle le jeu de résultats varie avec un paramètre d’entrée, ou votre requête peut être SELECT * FROM <une table> où la définition de table a changé.

Notes

IsMissing détecte les modifications du schéma de dataset entre le moment de la conception et celui de l’exécution pour tout type de source de données. IsMissing ne peut pas être utilisé pour détecter des membres vides dans un cube multidimensionnel et n’est pas lié aux concepts de langage de requête MDX EMPTY et NON EMPTY.

Vous pouvez tester la propriété IsMissing dans le code personnalisé pour déterminer si un champ est présent dans le jeu de résultats. Vous ne pouvez pas tester sa présence à l’aide d’une expression avec un appel de fonction Visual Basic comme IIF ou SWITCH, car Visual Basic évalue tous les paramètres dans l’appel à la fonction, ce qui provoque une erreur lorsque la référence au champ manquant est évaluée.

Exemple de contrôle de la visibilité d'une colonne dynamique pour un champ manquant

Pour définir une expression qui contrôle la visibilité d’une colonne qui affiche un champ dans un dataset, vous devez d’abord définir une fonction de code personnalisé qui retourne une valeur booléenne si le champ manque. Par exemple, la fonction de code personnalisé suivante retourne la valeur True si le champ manque et la valeur False si le champ existe.

Public Function IsFieldMissing(field as Field) as Boolean  
 If (field.IsMissing) Then  
 Return True  
  Else   
  Return False  
 End If  
End Function

Pour utiliser cette fonction pour contrôler la visibilité d’une colonne, affectez l’expression suivante à la propriété Hidden de la colonne :

=Code.IsFieldMissing(Fields!FieldName)

La colonne est masquée lorsque le champ n'existe pas.

Exemple de contrôle de la valeur de zone de texte pour un champ manquant

Pour remplacer la valeur d’un champ manquant par un texte que vous écrivez, vous devez écrire un code personnalisé qui retourne le texte que vous pouvez utiliser à la place d’une valeur de champ lorsque le champ est manquant. Par exemple, la fonction de code personnalisé suivante retourne la valeur du champ si le champ existe et le message que vous spécifiez comme deuxième paramètre si le champ n'existe pas :

Public Function IsFieldMissingThenString(field as Field, strMessage as String) as String  
 If (field.IsMissing) Then  
  Return strMessage  
 Else   
  Return field.Value  
  End If  
End Function

Pour utiliser cette fonction dans une zone de texte, ajoutez l’expression suivante à la propriété Value :

=Code.IsFieldMissingThenString(Fields!FieldName,"Missing")

La zone de texte affiche la valeur de champ ou le texte que vous avez spécifié.

Utilisation des propriétés de champ étendues

Les propriétés de champ étendues sont des propriétés supplémentaires définies sur un champ par l'extension pour le traitement des données, qui est déterminée par le type de source de données du dataset. Les propriétés de champ étendues sont prédéfinies ou spécifiques à un type de source de données. Pour plus d’informations, consultez Propriétés étendues du champ pour une base de données Analysis Services (Rapports paginés).

Si vous spécifiez une propriété qui n’est pas prise en charge pour ce champ, l’expression prend la valeur null (Nothing en Visual Basic). Si un fournisseur de données ne prend pas en charge les propriétés de champ étendues ou si le champ est introuvable lors de l’exécution de la requête, la valeur de la propriété est null (Nothing en Visual Basic) pour les propriétés de type String et Object, et zéro (0) pour les propriétés de type Integer. Une extension pour le traitement des données peut tirer parti des propriétés prédéfinies en optimisant les requêtes qui intègrent cette syntaxe.

Partager via