Collections intégrées – Informations de références sur la collection d’éléments ReportItems dans un rapport paginé (Générateur de rapports Power BI)

S’APPLIQUE À : Power BI Report Builder Power BI Desktop

La collection intégrée ReportItems constitue l’ensemble des zones de texte des éléments de rapport, tels que les lignes d’une région de données ou les zones de texte de l’aire de conception du rapport paginé. La collection ReportItems comprend les zones de texte situées dans l’étendue actuelle d’un en-tête de page, d’un pied de page ou du corps du rapport. Cette collection est déterminée au moment de l'exécution par le processeur de rapports et le convertisseur de rapports. L'étendue actuelle change à mesure que le processeur de rapports combine successivement les données du rapport et ses éléments de mise en page lorsque l'utilisateur visualise les pages du rapport. Vous pouvez utiliser la collection intégrée ReportItems pour produire des en-têtes de page de type dictionnaire, qui représentent le premier et le dernier éléments de chaque page.

Utilisation de la propriété Value de ReportItems

Les éléments de la collection ReportItems ont une seule propriété : Value. La valeur d’un élément ReportItems peut être utilisée pour afficher ou pour calculer des données provenant d’un autre champ du rapport. Pour accéder à la valeur de la zone de texte actuelle, vous pouvez utiliser l’entité Visual Basic globale intégrée Me.Value ou simplement Value. Dans les fonctions de rapport telles que First et les fonctions d'agrégation, il convient toutefois d'utiliser la syntaxe complète.

Par exemple :

  • Cette expression, placée dans une zone de texte, affiche la valeur d’une zone de texte ReportItem nommée Textbox1:

    =ReportItems!Textbox1.Value

  • Cette expression, placée dans la propriété Color d’une zone de texte ReportItem, affiche le texte en noir quand la valeur est > 0 ; sinon la valeur est affichée en rouge :

    =IIF(Me.Value > 0,"Black","Red")

  • Cette expression, placée dans une zone de texte dans l’en-tête ou le pied de page, affiche la première valeur par page du rapport rendu pour une zone de texte nommée LastName:

    =First(ReportItems("LastName").Value)

Expressions d'en-tête de page de type dictionnaire

Vous pouvez créer un en-tête de page pour afficher le premier et le dernier clients qui figurent sur la page. Une zone de texte de l’en-tête de page ne pouvant pas faire référence à la collection intégrée ReportItems plus d’une fois dans une expression, vous devez ajouter deux zones de texte à l’en-tête de page : une pour le premier nom de client (=First(ReportItems!textboxLastName.Value) et une pour le dernier (=Last(ReportItems!textboxLastName.Value).

Dans une section d’en-tête ou de pied de page, seules les zones de texte de la page actuelle sont disponibles en tant que membres de la collection ReportItems . Par exemple, si ReportItems!textboxLastName.Value fait référence à une zone de texte qui ne figure que sur la première page d’une région de données qui en comprend plusieurs, vous voyez une valeur pour la première page, mais toutes les autres pages affichent #Erreur pour indiquer que l’expression n’a pas pu être évaluée comme écrite.

Étendue de la collection ReportItems

À mesure que le rapport est traité, chaque zone de texte du corps du rapport ou d'une région de données est évaluée dans le contexte de son dataset, de sa région de données et des associations de groupes. L’étendue d’une référence à la collection ReportItems est l’étendue actuelle ou tout point situé plus haut.

Par exemple, une zone de texte d'une ligne située dans un groupe parent ne doit pas contenir d'expression faisant référence au nom d'une zone de texte d'une ligne située dans un groupe enfant. Une telle expression ne donne pas de valeur dans le rapport, car la zone de texte de la ligne enfant n'appartient pas à l'étendue. Pour plus d’informations, consultez Informations de référence sur les fonctions d’agrégation (Report Builder).

Étapes suivantes