Collections intégrées dans les expressions dans un rapport paginé (Générateur de rapports)

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

Dans une expression figurant dans un rapport paginé, vous avez la possibilité d’inclure des références aux collections intégrées suivantes : ReportItems, Parameters, Fields, DataSets, DataSources, Variables, ainsi que des champs prédéfinis pour les informations globales telles que le nom du rapport. Les collections ne sont pas toutes répertoriées dans la boîte de dialogue Expression. En effet, les collections DataSets et DataSources ne sont disponibles qu'au moment de l'exécution pour les rapports publiés sur un serveur de rapports. La collection ReportItems représente l’ensemble des zones de texte figurant dans une partie du rapport, comme celles qui sont situées dans une page ou dans un en-tête de page.

Pour plus d’informations, consultez Expressions (Générateur de rapports).

Remarque

Il est possible de créer et de modifier des fichiers de définition de rapports (.rdl) paginés dans le Générateur de rapports Microsoft, dans Power BI Report Builder et dans le Concepteur de rapports de SQL Server Data Tools.

Fonctionnement des collections intégrées

Le tableau suivant répertorie les collections intégrées disponibles lorsque vous écrivez une expression. Chaque ligne inclut le nom programmatique qui respecte la casse de la collection. Le nom est indiqué si vous pouvez utiliser la boîte de dialogue Expression pour ajouter de manière interactive une référence à la collection, un exemple et une description indiquant quand les valeurs de la collection sont initialisées et disponibles pour être utilisées.

Collection intégrée	Catégorie dans la boîte de dialogue Expression	Exemple	Description
Globals	Champs prédéfinis	=Globals.ReportName - or - =Globals.PageNumber	Représente les variables globales utilisables pour des rapports, par exemple le nom du rapport ou le numéro de page. Toujours disponible. Pour plus d’informations, consultez Références à Globals et User intégrées (Générateur de rapports).
Utilisateur	Champs prédéfinis	=User.UserID - ou - =User.Language	Représente une collection de données sur l'utilisateur exécutant le rapport, par exemple le paramètre de langue ou l'ID utilisateur. Toujours disponible. Pour plus d’informations, consultez Références à Globals et User intégrées (Générateur de rapports).
Paramètres	Paramètres	=Parameters("ReportMonth").Value - ou - =Parameters!ReportYear.Value	Représente la collection des paramètres de rapport, chacun pouvant correspondre à une valeur unique ou à plusieurs valeurs. Non disponible tant que l'initialisation du traitement n'est pas terminée. Pour plus d’informations, consultez Informations de référence sur la collection de paramètres (Générateur de rapports).
Champs(<Dataset>)	Champs	=Fields!Sales.Value	Représente la collection des champs du dataset qui sont disponibles pour le rapport. Disponibles après extraction des données d'une source de données dans un dataset. Pour plus d’informations, consultez Référence à une collection de champs de jeu de données (Générateur de rapports).
DataSets	Non affichée	=DataSets("TopEmployees").CommandText	Représente la collection de sources de données référencées à partir du corps d'une définition de rapport. N'inclut pas les sources de données utilisées uniquement dans les en-têtes ou les pieds de page. Non disponible dans l'aperçu local. Pour plus d’informations, consultez Références à des collections DataSources et jeu de données (Générateur de rapports).
DataSources	Non affichée	=DataSources("AdventureWorks2022").Type	Représente la collection des sources de données référencées à partir du corps d'un rapport. N'inclut pas les sources de données utilisées uniquement dans les en-têtes ou les pieds de page. Non disponible dans l'aperçu local. Pour plus d’informations, consultez Références à des collections DataSources et jeu de données (Générateur de rapports).
Variables	Variables	=Variables!CustomTimeStamp.Value	Représente la collection des variables de rapport et de groupe. Pour plus d’informations, consultez Références à des collections de variables de rapport et de groupe (Générateur de rapports).
ReportItems	Non affichée	=ReportItems("Textbox1").Value	Représente la collection des zones de texte d'un élément de rapport. Cette collection peut être utilisée pour proposer un résumé des éléments présents dans la page en vue de leur inclusion dans un en-tête ou un pied de page. Pour plus d’informations, consultez Références à la collection ReportItems (Générateur de rapports).

Utilisation de la syntaxe de collection dans une expression

Pour faire référence à une collection à partir d’une expression, utilisez la syntaxe Microsoft Visual Basic standard pour un élément au sein d’une collection. Le tableau ci-après propose des exemples de syntaxe de collection.

Syntaxe	Exemple
Collection!NomObjet.Propriété	=Fields!Sales.Value
Collection!NomObjet("Propriété")	=Fields!Sales("Value")
Collection("NomObjet").Propriété	=Fields("Sales").Value
Collection("Membre")	=User("Language")
Collection.Membre	=User.Language

Contenu connexe

Ajouter une expression (Générateur de rapports)
Exemples d’expressions (Générateur de rapports)