跳至主要內容
Adaptive Planning
上次更新時間 :2023-06-23
參照︰屬性的標記法

參照︰屬性的標記法

與程式設計語言中的物件參照類似,您可以在公式中使用「標記法」。
標記法在具有以下形式的公式中特別有用
IFF
陳述式,因為它允許公式根據目前的位置而變化。例如,以下公式在實際值版本中與在計畫版本中計算指標的方式就有所不同︰
範例︰此公式會在實際值中以一種方式計算指標,而在計畫版本中則以另一種方式計算指標︰
IFF(this.Version.IsActuals, ACCT.ActualsValue, ACCT.PlanValue)
範例︰對於使用逗號做為小數點的瀏覽器︰
IFF(this.Version.IsActuals; ACCT.ActualsValue; ACCT.PlanValue)
使用標記法屬性參照維度值、屬性內容值和層級的公式,在參照時必須使用代碼,以免在名稱相符時造成混淆。如果您變更維度值、屬性內容值或層級的「代碼」,請更新公式以符合「代碼」。

運算元

運算元運算式語法使用標準化的
this
項,以指出儲存格的目前位置。
屬性
說明
this.Version
傳回版本物件,該物件可與其他點 (
.
) 屬性,例如
this.Version.Name
。請參閱下方的「物件類型」。
this.Level
傳回層級物件,該物件可與其他點 (
.
) 屬性。
this.Account
傳回科目物件,該物件可與其他點 (
.
) 屬性。
this.
dimension_name
傳回指定維度中目前儲存格的維度值。如果目前儲存格中沒有指定維度的值,則傳回空的 (空白) 物件。僅當維度的名稱為合法 ID (以非數字開頭且僅包含字母、數字和底線) 時,才能存取此屬性。無法在公式中擷取具有非 ID 名稱的維度 (例如名稱中包含多個字詞的維度)。
this.
attribute_name
傳回指定屬性內容中目前儲存格的屬性內容值。如果目前儲存格中沒有指定屬性內容的值,則傳回空物件。僅當屬性內容的名稱為合法 ID (以非數字開頭且僅包含字母、數字和底線) 時,才能存取此屬性。無法在公式中擷取具有非 ID 名稱的屬性內容 (例如名稱中包含多個字詞的屬性內容)。
this.<stratum_code>
傳回
Timeperiod
包含目前儲存格時間座標的要求級別類型。如果要求的級別低於 (精細度低於) 目前儲存格的級別,則此函數會傳回
第一個級別。
Timeperiod
在目前儲存格的級別範圍內找到該級別的 。

物件類型

資料類型表示物件,允許「標記法」存取這些物件的屬性。可用的物件屬性有︰

版本

參照項目中目前版本的各種屬性
IF
陳述式
範例︰
IF (this.Version.Name = "Budget 2018", x, y)
範例︰對於使用逗號做為小數點的瀏覽器︰
IF (this.Version.Name = "Budget 2018"; x; y)
屬性
說明
Version.Name
傳回表示版本名稱的字串。如果實際值儲存格套疊在計畫版本上,則該實際值版本會被視為儲存格的版本。
Version.ShortName
傳回表示版本簡稱的字串。
Version.Description
傳回表示版本說明的字串。
Version.Type
傳回表示版本類型的字串,如在
exportVersions
API傳回下列其中一項︰
PLANNING, ACTUALS, VERSION_FOLDER, JOURNAL_ENTRY
Version.StartDate
傳回日期值,此值表示該時段的第一天,即該版本的開始日期。
Version.EndDate
傳回日期值,此值表示該時段的最後一天,即該版本的結束日期。
Version.PositionOf
傳回提供的時段在該版本整個跨度內的相對順序。初始序列從 0 (而不是 1) 開始,如果時段較版本開始時間早,則順序數字可以為負數。此函數也適用於版本結束時間後的時段。
Version.IsActuals
傳回布林值,此值指出此版本是否為實際值版本 (包括類型
ACTUALS
,
SUBACTUALS
, 和
JOURNAL_ENTRY
)。
Version.IsGroup
傳回布林值,此值指出此版本是否為版本群組 (而不是包含資料的版本)。
Version.IsParent
傳回布林值,此值指出此版本是否有子系版本。
Version.Parent
傳回此版本的父系版本。

層級

參照項目中目前層級的各種屬性
IF
陳述式
範例︰
IF (this.Level.Name = "Sales", x, y)
範例︰對於使用逗號做為小數點的瀏覽器︰
IF (this.Level.Name = "Sales"; x; y)
屬性
說明
Level.Code
傳回表示層級代碼的字串。
Level.Name
傳回表示層級名稱的字串。
Level.ShortName
傳回表示層級簡稱的字串。
Level.InWorkflow
傳回布林值,此值指出該層級是否包含在工作流程中。對於停用工作流程的實例,所有層級都將傳回 False。
Level.IsElimination
傳回布林值,此值指出該層級是否為銷除層級。對於沒有銷除功能的實例,所有層級都將傳回 False。
Level.IsTradingPartner
傳回布林值,此值指出該層級是否為銷除交易夥伴層級。對於沒有銷除功能的實例,所有層級都將傳回 False。
Level.Currency
傳回表示層級 ISO 貨幣代碼的字串 (例如,
EUR
USD
)。
Level.Parent
傳回層級 代碼 這是此層級的父系,如果此層級沒有父系 (根層級),則為特殊的「空值」層級物件。
Level.IsLeaf
傳回布林值,此值指出該層級是否為分葉層級 (意即如果該層級沒有子系,則此屬性傳回 True)。

Account

參照項目中目前科目的各種屬性 (
非值
)。
IF
陳述式
範例︰
IF (this.Account.IFRS_Category.Name = "Assets", 1, 0)
範例︰對於使用逗號做為小數點的瀏覽器︰
IF (this.Account.IFRS_Category.Name = "Assets"; 1; 0)
屬性
說明
Account.Code
傳回表示科目代碼的字串。
Account.Name
傳回表示科目名稱的字串。
Account.ShortName
傳回表示科目簡稱的字串。
Account.Description
傳回表示科目說明的字串。
Account.Parent
傳回此科目的父系科目,如果此科目沒有父系 (根科目),則傳回特殊的「空值」科目物件。
Account.<
attribute_name
>
傳回與指定屬性內容相關聯的維度值物件。僅當屬性內容的名稱為合法 ID (以非數字開頭且僅包含字母、數字和底線) 時,才能存取此屬性。無法在公式中擷取具有非 ID 名稱的屬性內容 (例如名稱中包含多個字詞的屬性內容)。
Account.isCredit
如果帳戶具有以下屬性,則傳回布林值。BalanceType 的CREDIT 與否。請注意,某些科目 (例如指標科目) 既不是借項也不是貸項。
Account.isDebit
如果帳戶具有以下屬性,則傳回布林值。BalanceType 的借或不借。請注意,某些科目 (例如指標科目) 既不是借項也不是貸項。

維度和屬性內容

屬性
說明
DimensionValue
.Code
傳回在指定維度中表示維度值代碼的字串。
範例︰
IF (this.Region.Code = "East01", 1, 0)
DimensionValue
.Name
傳回在指定維度中表示維度值名稱的字串。
範例︰
IF (this.Region.Name = "East", 1, 0)
DimensionValue
.ShortName
傳回表示維度值簡稱的字串。
DimensionValue
.Description
傳回表示維度值說明的字串。
DimensionValue
.Parent
傳回此值的父系維度值,如果此值在維度內沒有父系,則傳回特殊的空物件 (例如,「父系」是維度本身的根)。
範例︰
this.DimensionValue.Parent.Name
會傳回此維度值的父系名稱。
DimensionValue
.IsLeaf
傳回布林值,此值指出指定維度中的維度值是否為該維度中的分葉值。
DimensionValue
.<
attribute_code
>
傳回指定屬性內容的值代碼 (與維度值相對應)。
DimensionValue
.<
attribute_name
>
傳回指定屬性內容的值 (與維度值相對應)。
AttributeValue
.Code
傳回表示屬性內容值代碼的字串。
AttributeValue
.Name
傳回表示屬性內容值名稱的字串。
AttributeValue
.ShortName
傳回表示屬性內容值簡稱的字串。
AttributeValue
.Description
傳回表示屬性內容值說明的字串。
AttributeValue
.Parent
傳回屬性內容值 代碼 這是此值的父系,如果此值在維度內沒有父系,則為特殊的空物件 (例如,「父系」是維度本身的根)。
AttributeValue
.IsLeaf
傳回布林值,以指出指定屬性內容中的屬性內容值是否為該屬性內容中的分葉值。

時段

時段表示任何已配置的行事曆級別的特定時段。無法將時段資料類型與任何其他資料類型進行比較。
範例︰
IF (this.Month.NumberOfDays > 30, 1, 0) IF (this.Year.PositionOf (this.Month) > 6, "Past sixth month", "Not") IF (this.Quarter.PositionOf (this.Week) = 1, "First week of qtr", "Not")
屬性
說明
Timeper
.Code
傳回該時段的代碼。此會比對時間判別式中對時段的參照方式。
Timeper
.NumberOfDays
傳回時段 (含) 內的總天數。
範例︰
IF (this.Month.NumberOfDays > 30, 1, 0)
Timeper
.Parent
傳回包含目前時段且在級別連續體上高一個級別 (較粗略) 的時段。如果沒有更高的級別,則傳回目前的時段。
Timeper
.StartDate
傳回表示時段第一天的日期 (與
Version.StartDate).
Timeper
.EndDate
傳回表示時段最後一天的日期 (與
Version.EndDate).
Timeper
.PositionOf(tp)
傳回整數,該整數表示時段的位置 (
tp
) 內 (相對於其級別的其他成員)。退貨
0
如果指定的時段 (
tp
) 的級別不小於
Timeper
已指定,或
tp
不在
Timeper
已指定。