Références à la collection de champs de jeux de données dans un rapport paginé (Générateur de rapports)

S’applique à : Générateur de rapports Microsoft (SSRS) Power BI Report Builder Report Designer dans SQL Server Data Tools

Chaque jeu de données figurant dans un rapport paginé contient une collection Champs. La collection Champs comprend l’ensemble de champs spécifiés par la requête de jeu de données, ainsi que tous les autres champs calculés 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. Cette valeur 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) et Collection Champs d’un jeu de données (Générateur de rapports).

Affichez la collection de champs pour un jeu de données

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 Informations de référence sur les fonctions d’agrégation (Générateur de rapports).

Pour afficher des valeurs résumées pour une collection de champs dans une zone de texte directement sur l'aire de conception qui n'appartient à aucune région de données, vous devez spécifier le nom du jeu de données 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 Champs 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 jeu de données en fonction du type de source de données.

Détectez les valeurs Null pour un champ de jeu de données

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étectez les 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 jeu de données 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 elle peut être SELECT * FROM <table> où la définition de table a changé.

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 affichant un champ dans un jeu de données, vous devez d'abord définir une fonction de code personnalisé. Cette fonction doit retourner une valeur booléenne. La valeur est fonction de l'absence ou non du champ. 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, vous devez écrire un code personnalisé. Ce code doit retourner le texte que vous pouvez utiliser en remplacement lorsque le champ est manquant. Par exemple, la fonction de code personnalisé suivante retourne la valeur du champ si celui-ci existe. En outre, le code retourne 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 représentent d'autres propriétés définies sur un champ par l'extension de traitement des données. Le type de source de données détermine le jeu de données. 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 de champ étendues pour une base de données Analysis Services (SSRS).

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.

Contenu connexe

• Exemples d’expressions (Générateur de rapports)
• Jeux de données de rapport