Utilisation de champs dans un dataset de rapport (Générateur de rapports version 3.0 et SSRS)
Les champs de dataset représentent les données d'une connexion de données. Un champ peut représenter des données numériques ou non numériques. À titre d'exemples, citons des chiffres d'affaires, des totaux de ventes, des noms de client, des identificateurs de base de données, des URL, des images, des données spatiales et des adresses de messagerie. Sur l'aire de conception, les champs s'affichent sous la forme d'expressions dans les éléments de rapport tels que les zones de texte, les tables et les graphiques.
Un rapport comporte trois types de champs et les affiche dans le volet Données du rapport : champs de dataset, champs calculés de dataset et champs prédéfinis.
Champs de dataset. Métadonnées qui représentent la collection des champs retournés lorsque la requête de dataset s'exécute sur la source de données.
Champs calculés de dataset. Champs supplémentaires que vous créez pour le dataset. Chaque champ calculé est créé en évaluant une expression que vous définissez.
Champs prédéfinis. Métadonnées qui représentent une collection de champs fournie par le Générateur de rapports qui indique des informations sur le rapport, telles que le nom du rapport ou l'heure de son traitement. Pour plus d'informations, consultez Utilisation de références à des champs Globals et Users prédéfinis (Report Builder 3.0 et SSRS).
Les noms de champ de dataset sont enregistrés dans la définition de dataset du rapport. Pour plus d'informations, consultez Création et ajout de datasets (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.
Dans cet article
Champs de dataset et requêtes
Présentation des expressions par défaut pour les champs
Champs de dataset et types de données
Détection de champs manquants lors de l'exécution
Champs de dataset et requêtes
Les champs de dataset sont spécifiés par la commande de requête de dataset et par tout champ calculé que vous définissez. La collection de champs que vous voyez dans votre rapport dépend du type de dataset dont vous disposez :
Dataset partagé. La collection de champs correspond à la liste des champs pour la requête dans la définition du dataset partagé au moment où vous avez ajouté directement le dataset partagé à votre rapport, ou lorsque vous avez ajouté une partie de rapport incluant le dataset partagé. La collection de champs locale ne change pas lorsque la définition du dataset partagé est modifiée sur le serveur de rapports. Pour mettre à jour la collection de champs locale, vous devez actualiser la liste pour le dataset partagé local.
Dataset incorporé. La collection de champs correspond à la liste de champs retournée suite à l'exécution de la requête actuelle sur la source de données.
Pour plus d'informations, consultez Procédure : ajouter, modifier ou actualiser des champs dans le volet Données du rapport (Générateur de rapports version 3.0 et SSRS).
Si vous ne voyez pas les résultats escomptés dans votre collection de champs de dataset, consultez Dépannage de rapports : récupération des données de rapport.
.gif "Icône de flèche utilisée avec le lien Retour au début")
Retour au début
Champs calculés
Vous spécifiez un champ calculé manuellement en créant une expression. Les champs calculés peuvent être utilisés pour créer de nouvelles valeurs qui n'existent pas dans la source de données. Un champ calculé peut, par exemple, représenter une nouvelle valeur, un ordre de tri personnalisé pour un jeu de valeurs de champ ou un champ existant converti en type de données différent.
Les champs calculés sont définis localement pour un rapport et ne peuvent pas être enregistrés dans le cadre d'un dataset partagé.
Pour plus d'informations, consultez Procédure : ajouter, modifier ou actualiser des champs dans le volet Données du rapport (Générateur de rapports version 3.0 et SSRS).
Retour au début
Entités et champs d'entité
Si vous utilisez une source de données de modèle de rapport, spécifiez les entités et les champs d'entité en tant que données de rapport. Dans le concepteur de requêtes d'un modèle de rapport, vous pouvez explorer et sélectionner interactivement des entités associées et choisir les champs que vous souhaitez inclure dans votre dataset de rapport. Une fois la requête créée, vous pouvez consulter l'ensemble d'identificateurs d'entité et de champs d'entité dans le volet Données du rapport. Les identificateurs d'entité sont générés automatiquement par le modèle de rapport et ne sont généralement pas visibles par l'utilisateur final. Pour plus d'informations, consultez Interface utilisateur du Concepteur de requêtes de modèle de rapport (Générateur de rapports version 3.0).
Utilisation des propriétés de champ étendues
Les sources de données qui prennent en charge des requêtes multidimensionnelles, comme SQL Server Analysis Services, prennent en charge les propriétés de champ sur les champs. Les propriétés de champ apparaissent dans le jeu de résultats d'une requête, mais ne sont pas visibles dans le volet Données du rapport. Elles sont néanmoins disponibles pour les utiliser dans votre rapport. Pour vous référer à la propriété d'un champ, faites glisser le champ dans le rapport et remplacez la propriété par défaut Value par le nom de champ de la propriété souhaitée. Dans un cube Analysis Services par exemple, vous pouvez définir des formats pour les valeurs dans les cellules de cube. La valeur mise en forme est disponible à l'aide de la propriété de champ FormattedValue. Pour utiliser directement la valeur au lieu d'utiliser une valeur, puis de définir la propriété de format de la zone de texte, faites glisser le champ vers la zone de texte et remplacez l'expression par défaut =Fields!FieldName.Value par =Fields!FieldName.FormattedValue.
Notes
Certaines propriétés Field ne peuvent pas être utilisées pour toutes les sources de données. Les propriétés Value et IsMissing sont définies pour toutes les sources de données. D'autres propriétés prédéfinies (comme Key, UniqueName et ParentUniqueName pour les sources de données multidimensionnelles) ne sont prises en charge que si la source de données fournit ces propriétés. Certains fournisseurs de données prennent en charge les propriétés personnalisées. Pour plus d'informations, consultez les rubriques spécifiques relatives aux propriétés de champ étendues correspondant à votre type de source de données dans Création et ajout de datasets (Générateur de rapports version 3.0 et SSRS). Par exemple, pour une source de données SQL Server Analysis Services, consultez Utilisation de propriétés de champ étendues pour une base de données Analysis Services (SSRS).
Retour au début
Présentation des expressions par défaut pour les champs
Une zone de texte peut correspondre à un élément de rapport de zone de texte dans le corps du rapport ou il peut s'agir d'une zone de texte dans une cellule d'une région de données de tableau matriciel. Lorsque vous liez un champ à une zone de texte, l'emplacement de celle-ci détermine l'expression par défaut pour la référence du champ. Dans le corps du rapport, une expression de valeur de zone de texte doit spécifier un agrégat et un dataset. S'il n'existe qu'un seul dataset dans le rapport, cette expression par défaut est créée à votre place. Pour un champ qui représente une valeur numérique, la fonction d'agrégation par défaut est Sum. Pour un champ qui représente une valeur non numérique, l'agrégat par défaut est First.
Dans une région de données de tableau matriciel, l'expression de champ par défaut dépend des appartenances aux lignes et aux groupes de la zone de texte à laquelle vous ajoutez le champ. L'expression de champ pour le champ Sales, lorsqu'il est ajouté à une zone de texte dans la ligne de détails d'une table, est [Sales]. Si vous ajoutez ce même champ à une zone de texte dans un en-tête de groupe, l'expression par défaut est (Sum[Sales]), car l'en-tête de groupe affiche des valeurs résumées pour le groupe et non des valeurs de détails. Lors de l'exécution du rapport, le processeur de rapports évalue chaque expression et substitue le résultat dans le rapport.
Pour plus d'informations sur les expressions, consultez Expressions (Générateur de rapports version 3.0 et SSRS).
Retour au début
Types de données de champ
Lorsque vous créez un dataset, il se peut que les types de données des champs sur la source de données ne correspondent pas exactement aux types de données utilisés dans un rapport. Les types de données peuvent passer par une ou deux couches de mappage. L'extension pour le traitement des données ou le fournisseur de données peuvent mapper les types de données de la source de données en types de données CLR (Common Language Runtime). Les types de données retournés par les extensions pour le traitement des données sont mappés à un sous-ensemble de types de données CLR (Common Language Runtime) à partir du .NET Framework.
Dans la source de données, les données sont stockées dans des types de données pris en charge par la source de données. Par exemple, les données d'une base de données SQL Server doivent correspondre à l'un des types de données SQL Server pris en charge, tels que nvarchar ou datetime. Lorsque vous récupérez des données à partir de la source de données, celles-ci sont transmises par l'intermédiaire d'une extension pour le traitement des données ou d'un fournisseur de données associé au type de source de données. Selon l'extension pour le traitement des données utilisée, les données peuvent être converties à partir des types de données utilisés par la source de données en types de données pris en charge par l'extension pour le traitement des données. Reporting Services utilise des types de données pris en charge par le Common Language Runtime (CLR) qui est installé avec Business Intelligence Development Studio. Le fournisseur de données mappe chaque colonne contenue dans le jeu de résultats du type de données natif en un type de données CLR (Common Language Runtime) .NET Framework.
À chaque étape, les données sont représentées par les types de données comme décrit dans la liste suivante :
Source de données Il s'agit des types de données pris en charge par la version du type de source de données à laquelle vous vous connectez.
Par exemple, les types de données classiques pour une source de données SQL Server incluent int, datetime et varchar. Les types de données introduits par SQL Server 2008 ont ajouté la prise en charge de date, time, datetimetz et datetime2. Pour plus d'informations, consultez Types de données (Transact-SQL).
Fournisseur de données ou extension pour le traitement des données Il s'agit des types de données pris en charge par la version du fournisseur de données ou de l'extension pour le traitement des données que vous sélectionnez lorsque vous vous connectez à la source de données. Les fournisseurs de données se basant sur le .NET Framework utilisent des types de données pris en charge par le CLR. Pour plus d'informations sur les types de données des fournisseurs de données .NET Framework, consultez Mappages de types de données (ADO.NET) et Utilisation des types de base sur MSDN.
Par exemple, des types de données classiques pris en charge par le .NET Framework sont notamment Int32 et String. Les dates et heures de calendrier sont prises en charge par la structure DateTime. .NET Framework 2.0 Service Pack 1 a introduit la prise en charge de la structure DateTimeOffset pour les dates ayant un décalage de fuseau horaire.
Notes
Le serveur de rapports utilise les fournisseurs de données qui sont installés et configurés sur le serveur de rapports. Les clients de création de rapports en mode Aperçu utilisent les extensions pour le traitement des données installées et configurées sur l'ordinateur client. Vous devez tester votre rapport à la fois dans l'environnement de client de rapports et de serveur de rapports.
Processeur de rapports Les types de données se basent sur la version du CLR installée lorsque vous avez installé Reporting Services. SQL Server 2008 Reporting Services installe le CLR en se basant sur .NET Framework 3.5.
Par exemple, les types de données que le processeur de rapports utilise pour les nouveaux types de date et d'heure introduits dans SQL Server 2008 sont indiqués dans le tableau ci-dessous :
Type de données SQL
Type de données CLR
Description
Date
DateTime
Date uniquement
Time
TimeSpan
Heure uniquement
DateTimeTZ
DateTimeOffset
Date et heure avec décalage de fuseau horaire
DateTime2
DateTime
Date et heure avec fractions de milliseconde
Pour plus d'informations sur les types de bases de données SQL Server, consultez Types de données (moteur de base de données) et Types de données et fonctions de date et d'heure (Transact-SQL).
Pour plus d'informations sur l'inclusion de références dans un champ de dataset à partir d'une expression, consultez Utilisation des types de données dans les expressions (Générateur de rapports version 3.0 et SSRS).
Retour au début
Détection de champs manquants lors de l'exécution
Lorsque le rapport est traité, le jeu de résultats pour un dataset peut ne pas contenir de valeurs pour toutes les colonnes spécifiées, car les colonnes n'existent plus dans la source de données. Vous pouvez utiliser la propriété de champ IsMissing pour détecter si des valeurs ont été retournées pour un champ lors de l'exécution. Pour plus d'informations, consultez Utilisation de références à une collection de champs de dataset (Générateur de rapports version 3.0 et SSRS).
Retour au début