Cumulative

Berechnet die Summe der Werte der vorherigen Periode für ein angegebenes Konto.

Rückgabewert

Gibt eine Zeichenfolge zurück, die den korrekten Ausdruck darstellt, der als Bestandteil der Funktion HS.EXP verwendet werden soll.

Syntax

Cumulative (PointOfView, View, NumPeriod)

Tabelle 12-5 Syntax der Funktion Cumulative

Parameter Gültige Werte

PointOfView

Gültige Kombination aus den Elementen Account, Custom1….4, ICP, z.B. "A#CASH.C1#[None].I#[ICP Top]"

View

Muss einer der folgenden Werte sein:

"" " " (doppelte Anführungszeichen) - Basierend auf der Standardansicht, die für das verarbeitete Szenario definiert wurde ("YTD" oder "Periodic").

YTD - Der Benutzer gibt diese Option an, die die für das Szenario festgelegte Standardansicht überschreibt.

Periodic - Geben Sie diese Option an, die die für das Szenario festgelegte Standardansicht überschreibt.

NumPeriod

Eine ganze Zahl, die die Anzahl der Perioden im aktuellen Szenario angibt, die kumuliert werden sollen, beginnend mit der aktuellen Periode.

Wenn NumPeriod 0 oder eine negative Zahl ist, aggregiert die Funktion ab dem Anfang des aktuellen Jahres.

Detaillierte Beschreibung

Diese Funktion berechnet die Summe der angegebenen Perioden oder des kumulierten Jahres für das angegebene Konto. Standardmäßig ist die Ansicht der kumulierten Daten der Szenariostandardwert. Sie können diesen Wert jedoch für Bewegungskonten überschreiben.

  • Wenn der Parameter View "YTD" ist, kumuliert die Funktion die kumulierten Jahreswerte.

  • Wenn der Parameter View "Periodic" ist, kumuliert die Funktion die periodischen Werte.

  • Wenn der Parameter View leer ist (" "), kumuliert die Funktion die Daten mithilfe der Standardansicht des Szenarios.

Beispiel

Das Konto CASH gibt je nach dem in der Funktion Cumulative verwendeten Parameter Number die folgenden Werte für Januar, Februar und März 2014 zurück.

Das Konto SALES gibt je nach den in der Funktion Cumulative verwendeten Parametern View und Number die folgenden Werte für Januar, Februar und März 2014 zurück. Die Standardansicht, die für das verarbeitete Szenario festgelegt wird, ist "YTD".

Tabelle 12-6 Beispiel für die Funktion Cumulative

Konto Oct2013 Nov2013 Dec2013 Jan2014 Feb2014 Mar2014

A#Cash

1.000

1.500

1.200

800

1.100

1.300

Cumulative ("A#Cash","0")

N/V

N/V

N/V

800

1.900

3.200

Cumulative("A#Cash", "3")

N/V

N/V

N/V

3.500

3.100

3.200

A#Sales

9.000

10.500

11.700

800

1.900

3.200

Cumulative("A#Sales", "0")

N/V

N/V

N/V

800

2.700

5.900

Cumulative("A#Sales", "Periodic", "0")

N/V

N/V

N/V

800

1.900

3.200

Cumulative("A#Sales", "Periodic", "3")

N/V

N/V

N/V

3.500

3.100

3.200

Beispielskript

' 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