Partager via


Fonctions du Générateur de rapports - Fonction First 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

Retourne la première valeur dans l’étendue donnée de l’expression spécifiée dans un rapport paginé.

Notes

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.

Syntaxe

  
First(expression, scope)  

Paramètres

expression
(Variant ou Binaire) Expression sur laquelle effectuer l’agrégation, par exemple =Fields!FieldName.Value.

scope
(Chaîne) Facultatif. Nom d'un dataset, d'un groupe ou d'une région de données qui contient les éléments de rapport auxquels appliquer la fonction d'agrégation. Si le paramètre scope n'est pas spécifié, l'étendue actuelle est utilisée.

Type de retour

Déterminé par le type d'expression.

Notes

La fonction First retourne la première valeur d'un jeu de données après que l'étendue spécifiée a été correctement triée et filtrée.

La fonction First ne peut être utilisée dans les expressions de filtre de groupe qu’avec l’étendue actuelle (par défaut).

Vous pouvez également utiliser First dans un en-tête de page pour retourner la première valeur de la collection ReportItems pour une page afin de produire des en-têtes de type dictionnaire qui affichent la première et la dernière entrées d’une page.

La valeur du paramètre scope doit être une constante de chaîne et ne peut pas être une expression. Pour les agrégats externes ou les agrégats qui ne spécifient pas d'autres agrégats, le paramètre scope doit faire référence à l'étendue actuelle ou à une étendue contenante. Pour les agrégats d'agrégats, les agrégats imbriqués peuvent spécifier une étendue enfant.

Expression peut contenir des appels aux fonctions d'agrégation imbriquées avec les exceptions et conditions suivantes :

  • Le paramètreScope des agrégats imbriqués doit être identique à l'étendue de l'agrégat externe ou contenu par celle-ci. Pour toutes les étendues distinctes de l'expression, une étendue doit figurer dans une relation enfant avec toutes les autres étendues.

  • Le paramètreScope des agrégats imbriqués ne peut pas être le nom d'un dataset.

  • Expression ne doit pas contenir les fonctions First, Last, Previousou RunningValue .

  • Expression ne doit pas contenir les agrégats imbriqués qui spécifient recursive.

Pour plus d’informations, consultez Référence aux fonctions d’agrégation (Générateur de rapports et SSRS) et Étendue des expressions pour les totaux, les agrégats et les collections intégrées (Générateur de rapports et SSRS).

Pour plus d’informations sur les agrégats récursifs, consultez Création de groupes de hiérarchies récursives (Générateur de rapports et SSRS).

Exemple

L'exemple de code ci-dessous retourne le premier numéro de produit du groupe Category d'une région de données :

=First(Fields!ProductNumber.Value, "Category")