累計

針對指定的帳戶,計算先前期間的值總計。

傳回值

傳回字元字串,代表要作為 HS.EXP 函數一部分使用的正確表示式。

語法

Cumulative (PointOfView, View, NumPeriod)

表格 12-5 Cumulative 函數的語法

參數 有效值

PointOfView

Account、Custom1….4、ICP 成員的有效組合,例如「A#CASH.C1#[None].I#[ICP Top]」

View

必須為以下值之一:

"" " " (雙引號) - 依據為要處理的案例所定義的預設檢視 (YTD 或 Periodic)。

YTD - 使用者指定迄今年度選項,這個選項會置換案例的預設檢視設定。

Periodic - 指定定期選項,這個選項會置換案例的預設檢視設定。

NumPeriod

整數代表要累計之目前案例中的期間數量,從目前期間開始。

如果 NumPeriod 是 0 或負數,函數就會從目前年度期初開始彙總。

詳細說明

這個函數會針對指定帳戶,來計算指定的期間總數或迄今年度總數。依預設,累計的資料檢視是案例預設;但是,您可以針對流程類型帳戶置換這個檢視。

  • 如果 View 參數是 YTD,則函數會累計迄今年度值。

  • 如果 View 參數是 Periodic,則函數會累計定期值。

  • 如果 View 參數是空白 ( " " ),則函數會使用案例預設檢視來累計資料。

範例

CASH 帳戶會根據 Cumulative 函數中使用的 Number 參數,傳回 2014 年一月、二月和三月的這些值。

SALES 帳戶會根據 Cumulative 函數中使用的 ViewNumber 參數,傳回 2014 年一月、二月和三月的這些值。要處理的案例預設檢視設定為 YTD。

表格 12-6 Cumulative 函數的範例

科目 Oct2013 Nov2013 Dec2013 Jan2014 Feb2014 Mar2014

A#Cash

1,000

1,500

1,200

800

1,100

1,300

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

N/A

N/A

N/A

800

1,900

3,200

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

N/A

N/A

N/A

3,500

3,100

3,200

A#Sales

9,000

10,500

11,700

800

1,900

3,200

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

N/A

N/A

N/A

800

2,700

5,900

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

N/A

N/A

N/A

800

1,900

3,200

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

N/A

N/A

N/A

3,500

3,100

3,200

範例指令碼

' 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