• Article

Fonction RunningValue (Générateur de rapports version 3.0 et SSRS)

Retourne un agrégat cumulé de toutes les valeurs numériques non Null spécifiées par l'expression, évaluée pour l'étendue donnée.

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.

Syntaxe

RunningValue(expression, function, scope)

Paramètres

  • expression
    Expression sur laquelle effectuer l'agrégation, par exemple, [Quantity].

  • function
    (Enum) Nom de la fonction d'agrégation à appliquer à l'expression, par exemple, Sum. Cette fonction ne peut pas être de type RunningValue, RowNumber ou Aggregate.

  • scope
    (String) Constante de chaîne qui correspond au nom d'un dataset, d'une région de données ou d'un groupe, ou valeur Null (Nothing en Visual Basic), qui spécifie le contexte dans lequel évaluer l'agrégation. Nothing spécifie le contexte le plus extérieur, généralement le dataset du rapport.

Type de valeur retournée

Déterminé par la fonction d'agrégation spécifiée dans le paramètre function.

Notes

La valeur de RunningValue se réinitialise à 0 pour chaque nouvelle instance de l'étendue. Si vous spécifiez un groupe, la valeur d'exécution est réinitialisée lorsque l'expression de groupe change. Si vous indiquez une région de données, le cumul est réinitialisé pour chaque nouvelle instance de la région de données. Si vous spécifiez un dataset, la valeur d'exécution n'est pas réinitialisée dans l'ensemble du dataset.

RunningValue ne peut pas être utilisé dans une expression de filtre ou de tri.

Le jeu des données pour lequel la valeur d'exécution est calculée doit avoir le même type de données. Pour convertir des données qui ont plusieurs types de données numériques en un même type de données, utilisez des fonctions de conversion telles que CInt, CDbl ou CDec. Pour plus d'informations, consultez Fonctions de conversion de types de données.

Le paramètre Scope ne peut pas être une expression.

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

  • Le paramètre Scope 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ètre Scope des agrégats imbriqués ne peut pas être le nom d'un dataset.

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

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

Pour calculer la valeur d'exécution du nombre de lignes, utilisez RowNumber. Pour plus d'informations, consultez Fonction RowNumber (Générateur de rapports version 3.0 et SSRS).

Pour plus d'informations, consultez Référence aux fonctions d'agrégation (Générateur de rapports version 3.0 et SSRS) et Présentation de l'étendue des expressions pour les totaux, les agrégats et les collections intégrées (Générateur de rapports version 3.0 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 version 3.0 et SSRS).

Description

L'exemple de code suivant fournit le cumul du champ nommé Cost de l'étendue la plus à l'extérieur, à savoir le dataset.

Code

=RunningValue(Fields!Cost.Value, Sum, Nothing)