Calcule le total des valeurs de la période précédente pour un compte spécifique.
Valeur renvoyée
Renvoie une chaîne de caractères représentant l'expression correcte à utiliser dans le cadre de la fonction HS.EXP.
Syntaxe
Cumulative (PointOfView, View, NumPeriod)
Tableau 12-5 Syntaxe de la fonction Cumulative
| Paramètre | Valeurs valides |
|---|---|
|
PointOfView |
Combinaison valide des membres Account, Custom1….4, ICP, par exemple, "A#CASH.C1#[None].I#[ICP Top]" |
|
View |
Doit avoir l'une des valeurs suivantes : "" " " (guillemets) : en fonction de la vue par défaut définie pour le scénario en cours de traitement (YTD ou Periodic). YTD : l'utilisateur indique l'option de cumul annuel, qui remplace la vue par défaut définie pour le scénario. Periodic : spécifiez l'option périodique, qui remplace la vue par défaut définie pour le scénario. |
|
NumPeriod |
Nombre entier représentant le nombre de périodes dans le scénario actuel à cumuler, à partir de la période en cours. Si NumPeriod est égal à 0 ou est négatif, la fonction agrège les valeurs à partir du début de l'année en cours. |
Description détaillée
Cette fonction calcule la somme des périodes spécifiées ou la somme du cumul de l'exercice pour le compte spécifié. Par défaut, la vue des données cumulées est le scénario par défaut ; vous pouvez cependant la remplacer pour les comptes de type Flux.
Si le paramètre View est YTD, la fonction cumule les valeurs du cumul de l'exercice.
Si le paramètre View est Periodic, la fonction cumule les valeurs périodiques.
Si le paramètre View est vide ( " " ), la fonction cumule les données à l'aide de la vue par défaut du scénario.
Exemple
Le compte CASH renvoie les valeurs suivantes pour janvier, février et mars 2014 en fonction du paramètre Number utilisé dans la fonction Cumulative.
Le compte SALES renvoie les valeurs suivantes pour janvier, février et mars 2014 en fonction des paramètres View et Number utilisés dans la fonction Cumulative. La vue par défaut définie pour le scénario en cours de traitement est YTD.
Tableau 12-6 Exemple de fonction Cumulative
| Compte | Oct2013 | Nov2013 | Dec2013 | Jan2014 | Feb2014 | Mar2014 |
|---|---|---|---|---|---|---|
|
A#Cash |
1 000 |
1 500 |
1 200 |
800 |
1 100 |
1 300 |
|
Cumulative ("A#Cash","0") |
Sans objet |
Sans objet |
Sans objet |
800 |
1 900 |
3 200 |
|
Cumulative("A#Cash", "3") |
Sans objet |
Sans objet |
Sans objet |
3 500 |
3 100 |
3 200 |
|
A#Sales |
9 000 |
10 500 |
11 700 |
800 |
1 900 |
3 200 |
|
Cumulative("A#Sales", "0") |
Sans objet |
Sans objet |
Sans objet |
800 |
2 700 |
5 900 |
|
Cumulative("A#Sales", "Periodic", "0") |
Sans objet |
Sans objet |
Sans objet |
800 |
1 900 |
3 200 |
|
Cumulative("A#Sales", "Periodic", "3") |
Sans objet |
Sans objet |
Sans objet |
3 500 |
3 100 |
3 200 |
Exemple de script
' sample statement written in the calling routine
Sub Calculate()
HS.EXP "A#TOT_Cash =" &Cumulative("A#Cash","" ,0)
End Sub
' programming of the Cumulative function
Function Cumulative(StrPov, StrVIEW, nPERIOD)
DIM strCUM DIM i
IF nPERIOD <= 0 THEN
nPERIOD = HS.PERIOD.NUMBER() - 1
ELSE
nPERIOD = nPERIOD - 1
END IF
IF strVIEW = "" THEN
strVIEW = HS.SCENARIO.DEFAULTVIEW("")
END IF
strPOV = UCASE(strPOV) strVIEW = UCASE(strVIEW)
IF strVIEW = "PERIODIC" THEN
strVIEW = ".W#PERIODIC"
ELSEIF strVIEW = "YTD" THEN
strVIEW = ".W#YTD"
ELSE
EXIT FUNCTION
END IF
FOR i = 0 TO nPERIOD
IF i = 0 THEN
strCUM = strPOV & strVIEW
ELSE
strCUM = strCUM &"+" & strPOV & strVIEW &".P#CUR-" &i
END IF
NEXT
Cumulative = ""("" & strCUM &"")
END FUNCTION