參照︰屬性的標記法
與程式設計語言中的物件參照類似,您可以在公式中使用「標記法」。標記法在具有以下形式的公式中特別有用
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
|