Fonction RunningValue (Générateur de rapports 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 rapport (.rdl) dans le Générateur de rapports et dans le Concepteur de rapports dans SQL Server Data Tools. 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 en Concepteur de rapports et Report Builder (SSRS) sur le web sur microsoft.com.
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 est le nom d’un jeu de données, d’une région de données ou d’un groupe, ou null (Nothing
en Visual Basic), qui spécifie le contexte dans lequel évaluer l’agrégation. Nothing
spécifie le contexte le plus à l'extérieur, habituellement le dataset du rapport.
Type de retour
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.
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.
L’expression ne doit pas contenir de
First
fonctions ,Last
,Previous
ouRunningValue
.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 et SSRS).
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).
Exemples
L'exemple de code suivant fournit le cumul du champ nommé Cost
de l'étendue la plus à l'extérieur, à savoir le dataset.
=RunningValue(Fields!Cost.Value, Sum, Nothing)
L'exemple de code suivant fournit le cumul du champ nommé Score
dans le dataset nommé DataSet1
.
=RunningValue(Fields!Score.Value,sum,"DataSet1")
L'exemple de code suivant fournit le cumul du champ nommé Traffic Charges
dans l'étendue la plus à l'extérieure.
=RunningValue(Fields!Traffic Charges.Value, Sum, Nothing)
Voir aussi
Utilisation d'expressions dans les rapports (Générateur de rapport et SSRS)
Exemples d'expressions (Générateur de rapports et SSRS)
Types de données dans les expressions (Générateur de rapports et SSRS)
Étendue des expressions pour les totaux, les agrégats et les collections intégrées (Générateur de rapports et SSRS)