Calcola il totale dei valori del periodo precedente per un conto specificato.
Valore restituito
Restituisce una stringa di caratteri che rappresenta l'espressione corretta da utilizzare come parte della funzione HS.EXP.
Sintassi
Cumulative (PointOfView, View, NumPeriod)
Tabella 12-5 Sintassi della funzione Cumulative
| Parametro | Valori validi |
|---|---|
|
PointOfView |
Combinazione valida di Conto, Custom1...4, membri ICP, ad esempio, "A#CASH.C1#[None].I#[ICP Top]" |
|
Visualizzazione |
Deve essere uno di questi valori: "" " " (virgolette doppie) - In base alla vista predefinita per lo scenario in fase di elaborazione (Progressivo anno o Periodico). Progressivo anno - L'utente specifica l'opzione Progressivo anno, che forza la vista predefinita impostata per lo scenario. Periodico - Specifica l'opzione periodica, che forza la vista predefinita impostata per lo scenario. |
|
NumPeriod |
Numero intero che rappresenta il numero di periodi nello scenario corrente per l'accumulazione, a partire dal periodo corrente. Se NumPeriod è 0 o negativo, la funzione esegue l'aggregazione dall'inizio dell'anno corrente. |
Descrizione dettagliata
Questa funzione calcola la somma dei periodi specificati o la somma del progressivo anno per il conto specificato. Per impostazione predefinita, la vista dei dati accumulati è l'impostazione predefinita per lo scenario. È tuttavia possibile forzare questa impostazione per conti di tipo flusso.
Se il parametro Vista è Progressivo anno, la funzione accumula i valori progressivo anno.
Se il parametro Vista è Periodico, la funzione accumula i valori periodici.
Se il parametro Vista è vuoto ( " " ), la funziona accumula i dati utilizzando la vista predefinita dello scenario.
Esempio
Il conto di CASSA restituirà i valori seguenti per gennaio, febbraio e marzo 2014 in base al parametro Numero utilizzato nella funzione Cumulative.
Il conto VENDITE restituirà i valori seguenti per gennaio, febbraio e marzo 2014 in base ai parametri Vista e Numero utilizzati nella funzione Cumulative. La vista predefinita impostata per lo scenario in fase di elaborazione è Progressivo anno.
Tabella 12-6 Esempio di funzione Cumulative
| Conto | Oct2013 | Nov2013 | Dec2013 | Jan2014 | Feb2014 | Mar2014 |
|---|---|---|---|---|---|---|
|
A#Cash |
1,000 |
1,500 |
1,200 |
800 |
1,100 |
1,300 |
|
Cumulative ("A#Cash","0") |
N/D |
N/D |
N/D |
800 |
1,900 |
3,200 |
|
Cumulative("A#Cash", "3") |
N/D |
N/D |
N/D |
3,500 |
3,100 |
3,200 |
|
A#Sales |
9,000 |
10,500 |
11,700 |
800 |
1,900 |
3,200 |
|
Cumulative("A#Sales", "0") |
N/D |
N/D |
N/D |
800 |
2,700 |
5,900 |
|
Cumulative("A#Sales", "Periodic", "0") |
N/D |
N/D |
N/D |
800 |
1,900 |
3,200 |
|
Cumulative("A#Sales", "Periodic", "3") |
N/D |
N/D |
N/D |
3,500 |
3,100 |
3,200 |
Script campione
' 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