Cumulative

Calcula el total de los valores del periodo anterior para una cuenta especificada.

Valor de retorno

Devuelve una cadena de caracteres que representa la expresión correcta que utilizar como parte de la función HS.EXP.

Sintaxis

Cumulative (PointOfView, View, NumPeriod)

Tabla 12-5 Sintaxis de la función Acumulado

Parámetro Valores válidos

PointOfView

Combinación válida de cuenta, Custom1….4, miembros de ICP, por ejemplo "A#CASH.C1#[None].I#[ICP Top]"

Vista

Debe ser uno de los siguientes valores:

"" " "(comillas dobles): se basa en la vista predeterminada definida para el escenario que se procesa (ya sea YTD o Periodic).

YTD: el usuario especifica la opción de acumulado anual, la cual reemplazará la vista predeterminada establecida para el escenario.

Periodic: especifique la opción de periódico, la cual reemplazará la vista predeterminada establecida para el escenario.

NumPeriod

Un número entero que representa el número de periodos que acumular en el escenario actual, empezando por el periodo actual.

Si NumPeriod es 0 o negativo, la función agrega desde el inicio del año actual.

Descripción detallada

Esta función calcula la suma de cualquiera de los periodos especificados o la suma del acumulado anual para la cuenta especificada. De forma predeterminada, la vista de los datos acumulados es el escenario predeterminado; sin embargo, puede reemplazarlo en las cuentas de tipo de flujo.

  • Si el parámetro de View es YTD, la función acumula los valores del acumulado anual.

  • Si el parámetro de View es Periodic, la función acumula los valores periódicos.

  • Si se deja en blanco el parámetro View (" "), la función acumula los datos con la vista de escenario predeterminada.

Ejemplo

La cuenta CASH devolverá los siguientes valores para enero, febrero y marzo de 2014, dependiendo del parámetro Number utilizado en la función Acumulado.

La cuenta SALES devolverá los siguientes valores para enero, febrero y marzo de 2014, dependiendo de los parámetros View y Number de la función Acumulado. La vista predeterminada establecida para el escenario que se está procesando es YTD.

Tabla 12-6 Ejemplo de la función Acumulado

Cuenta Oct2013 Nov2013 Dic2013 Ene2014 Feb2014 Mar2014

A#Cash

1000

1500

1200

800

1100

1300

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

N/A

N/A

N/A

800

1900

3200

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

N/A

N/A

N/A

3500

3100

3200

A#Sales

9000

10 500

11 700

800

1900

3200

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

N/A

N/A

N/A

800

2700

5900

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

N/A

N/A

N/A

800

1900

3200

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

N/A

N/A

N/A

3500

3100

3200

Script de ejemplo

' 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