Utilisation de références à une collection de champs de dataset (Générateur de rapports version 3.0 et SSRS)
Chaque dataset dans un rapport contient une collection Fields. 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 Données du rapport vers une cellule de table sur l'aire de conception, [Sales] 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 version 3.0 et SSRS) et Utilisation de champs dans un dataset de rapport (Générateur de rapports version 3.0 et SSRS).
Notes
Vous pouvez créer et modifier des définitions de rapports (.rdl) dans le Générateur de rapports version 3.0 et dans le Concepteur de rapports, dans Business Intelligence Development Studio. Chaque environnement de création offre différentes possibilités pour créer, ouvrir et enregistrer des rapports et des éléments connexes. Pour plus d'informations, consultez Conception de rapports dans le Concepteur de rapports et le Générateur de rapports version 3.0 (SSRS) sur le site Web Microsoft.
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 aux fonctions d'agrégation (Générateur de rapports version 3.0 et SSRS).
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 dans 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 Fields 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 <table> où la définition de table a changé.
Notes
IsMissing détecte les modifications dans le 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 associé 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, par exemple 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 à la propriété Hidden de la colonne l'expression suivante :
=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 Utilisation de 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 dans 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 dans 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.