Referenz: Punktnotation für Eigenschaften
Ähnlich wie bei Objektreferenzen in Programmiersprachen können Sie in Formeln die
Punktnotation
verwenden. Die Punktnotation ist besonders in Formeln mit hilfreich IFF
-Anweisungen, da die Formel je nach aktuellem Standort variieren kann. Beispielsweise berechnet die folgende Formel die Metrik in einer Istzahlen-Version anders als in einer Planversion: Beispiel: Die Formel berechnet eine Metrik in Istzahlen auf die eine und in Planversionen auf die andere Art und Weise:
IFF(this.Version.IsActuals, ACCT.ActualsValue, ACCT.PlanValue)
Beispiel: Für Browser, die Kommas für Dezimalzahlen verwenden:
IFF(this.Version.IsActuals; ACCT.ActualsValue; ACCT.PlanValue)
Formeln, die Dimensions-, Attributwerte und Ebenen mithilfe von Punktnotations-Eigenschaften referenzieren, müssen diese mithilfe von Code referenzieren, um Mehrdeutigkeiten bei übereinstimmenden Namen zu vermeiden. Wenn Sie den Code für einen Dimensions-, Attributwert oder eine Ebene ändern, aktualisieren Sie Ihre Formeln, damit sie mit dem Code übereinstimmen.
Operanden
Die Syntax des Operandenausdrucks verwendet die standardisierte this
einen Begriff, um die aktuelle Position einer Zelle anzugeben.
Eigenschaft | Beschreibung |
|---|---|
this.Version
| Gibt ein Versionsobjekt zurück, das mit einem zusätzlichen Punkt ( . ) Eigenschaften, wie z. Bthis.Version.Name . Siehe Objektarten unten. |
this.Level
| Gibt ein Ebenenobjekt zurück, das mit einem zusätzlichen Punkt kombiniert werden kann. . )-Eigenschaften. |
this.Account
| Gibt ein Kontoobjekt zurück, wenn es mit einem zusätzlichen Punkt kombiniert werden kann. . )-Eigenschaften. |
this.
dimension_name
| Gibt den Dimensionswert der aktuellen Zelle in der angegebenen Dimension zurück. Wenn die aktuelle Zelle keinen Wert für die angegebene Dimension hat, wird ein leeres Objekt zurückgegeben. Diese Eigenschaft ist nur zugänglich, wenn die Dimension einen Namen hat, der eine zulässige ID darstellt (also mit einem nicht-numerischen Zeichen beginnt und nur aus Buchstaben, Zahlen und dem Unterstrich besteht). Dimensionen mit Namen, die keine IDs sind (z. B. solche mit mehr als einem Wort im Namen), können in einer Formel nicht abgerufen werden. |
this.
attribute_name
| Gibt den Attributwert der aktuellen Zelle im angegebenen Attribut zurück. Wenn die aktuelle Zelle keinen Wert für das angegebene Attribut hat, wird ein leeres Objekt zurückgegeben. Diese Eigenschaft ist nur zugänglich, wenn das Attribut einen Namen hat, der eine zulässige ID darstellt (also mit einem nicht-numerischen Zeichen beginnt und nur aus Buchstaben, Zahlen und dem Unterstrich besteht). Attribute mit Namen, die keine IDs sind (z. B. solche mit mehr als einem Wort im Namen), können in einer Formel nicht abgerufen werden. |
this.<stratum_code>
| Gibt zurück Timeperiod der angeforderten Schichtart, die die Zeitkoordinate der aktuellen Zelle enthält. Wenn die angeforderten Schichten unter dem Status der aktuellen Zelle liegen (feiner strukturiert sind), gibt diese Funktion die erste zurückTimeperiod der Schicht dieser Schicht, die sich im Bereich der Schicht der aktuellen Zelle befindet. |
Objektarten
Datentypen stellen Objekte dar, sodass die „Punktnotation“ auf Eigenschaften dieser Objekte zugreifen kann. Die folgenden Objekteigenschaften sind verfügbar:Version
Bezieht sich auf verschiedene Eigenschaften der aktuellen Version in einer IF
Anweisung.
Beispiel:
IF (this.Version.Name = "Budget 2018", x, y)
Beispiel: Für Browser, die Kommas für Dezimalzahlen verwenden:
IF (this.Version.Name = "Budget 2018"; x; y)
Eigenschaft | Beschreibung |
|---|---|
Version.Name
| Gibt die Zeichenfolge zurück, die den Namen der Version darstellt. Wird eine Istzahlen-Zelle in einer Planversion überlagert, wird die Istzahlen-Version als Version der Zelle betrachtet. |
Version.ShortName
| Gibt die Zeichenfolge zurück, die den Kurznamen der Version darstellt. |
Version.Description
| Gibt die Zeichenfolge zurück, die die Beschreibung der Version darstellt. |
Version.Type
| Gibt eine Zeichenfolge zurück, die die Art der Version darstellt, wie in zurückgegeben exportVersions API Gibt eine der folgenden Werte zurück:PLANNING, ACTUALS, VERSION_FOLDER, JOURNAL_ENTRY . |
Version.StartDate
| Gibt einen Datumswert zurück, der den ersten Tag der Zeitperiode darstellt, den Versionsstart. |
Version.EndDate
| Gibt einen Datumswert zurück, der den letzten Tag der Zeitperiode darstellt, das Versionsende. |
Version.PositionOf
| Gibt die relative Reihenfolge der angegebenen Zeitperiode innerhalb der gesamten Zeitspanne der Version zurück. Die Ausgangssequenz beginnt mit 0 (nicht 1) und die Auftragsnummer kann negativ sein, wenn die Zeitperiode vor dem Versionsstart liegt. Diese Funktion funktioniert auch mit einer Zeitperiode, die über das Versionsende hinausgeht. |
Version.IsActuals
| Gibt einen booleschen Wert zurück, der angibt, ob es sich bei dieser Version um eine Istzahlen-Version handelt (dies schließt Arten ein). ACTUALS , SUBACTUALS , undJOURNAL_ENTRY ). |
Version.IsGroup
| Gibt einen booleschen Wert zurück, der angibt, ob diese Version eine Versionsgruppe ist (und keine Version, die Daten enthält). |
Version.IsParent
| Gibt einen booleschen Wert zurück, der angibt, ob diese Version untergeordnete Versionen hat. |
Version.Parent
| Gibt die Version zurück, die dieser Version übergeordnet ist. |
Ebene
Bezieht sich auf verschiedene Eigenschaften der aktuellen Ebene in einer IF
Anweisung.
Beispiel:
IF (this.Level.Name = "Sales", x, y)
Beispiel: Für Browser, die Kommas für Dezimalzahlen verwenden:
IF (this.Level.Name = "Sales"; x; y)
Eigenschaft | Beschreibung |
|---|---|
Level.Code
| Gibt die Zeichenfolge zurück, die den Code der Ebene darstellt. |
Level.Name
| Gibt die Zeichenfolge zurück, die den Namen der Ebene darstellt. |
Level.ShortName
| Gibt die Zeichenfolge zurück, die den Kurznamen der Ebene darstellt. |
Level.InWorkflow
| Gibt einen booleschen Wert zurück, der angibt, ob die Ebene im Workflow enthalten ist. Bei Instanzen mit deaktiviertem Workflow geben alle Ebenen den Wert „false“ zurück. |
Level.IsElimination
| Gibt einen booleschen Wert zurück, der angibt, ob die Ebene eine Eliminierungsebene ist. Bei Instanzen ohne das Feature „Eliminierungen“ geben alle Ebenen den Wert „false“ zurück. |
Level.IsTradingPartner
| Gibt einen booleschen Wert zurück, der angibt, ob die Ebene eine Ebene „Eliminierungshandelspartner“ ist. Bei Instanzen ohne das Feature „Eliminierungen“ geben alle Ebenen den Wert „false“ zurück. |
Level.Currency
| Gibt die Zeichenfolge zurück, die den ISO-Währungscode der Ebene darstellt (z. B. EUR oderUSD ). |
Level.Parent
| Gibt den Code der Ebene zurück, die dieser Ebene übergeordnet ist, oder das spezielle Objekt für 0 Ebenen, wenn diese Ebene keine übergeordnete Ebene hat (die Root-Ebene). |
Level.IsLeaf
| Gibt einen booleschen Wert zurück, der angibt, ob die Ebene eine Leaf-Ebene ist oder nicht (d. h. diese Eigenschaft gibt „true“ zurück, wenn die Ebene keine untergeordneten Ebenen hat). |
Konto
Bezieht sich auf die verschiedenen Eigenschaften (nicht den Wert
) des Girokontos in einem IF
Anweisung.
Beispiel:
IF (this.Account.IFRS_Category.Name = "Assets", 1, 0)
Beispiel: Für Browser, die Kommas als Dezimalzahlen verwenden:
IF (this.Account.IFRS_Category.Name = "Assets"; 1; 0)
Eigenschaft | Beschreibung |
|---|---|
Account.Code
| Gibt die Zeichenfolge zurück, die den Code des Kontos darstellt. |
Account.Name
| Gibt die Zeichenfolge zurück, die den Namen des Kontos darstellt. |
Account.ShortName
| Gibt die Zeichenfolge zurück, die den Kurznamen des Kontos darstellt. |
Account.Description
| Gibt die Zeichenfolge zurück, die die Beschreibung des Kontos darstellt. |
Account.Parent
| Gibt ein Konto zurück, das das übergeordnete Konto dieses Kontos ist, oder das spezielle Objekt für 0 Konten, wenn dieses Konto kein übergeordnetes Konto hat (ein Root-Konto). |
Account.<
attribute_name > | Gibt ein Dimensionswertobjekt zurück, das dem angegebenen Attribut zugeordnet ist. Auf diese Eigenschaft kann nur zugegriffen werden, wenn das Attribut einen zulässigen Namen hat (also mit einem nicht-numerischen Zeichen beginnt und nur aus Buchstaben, Zahlen und dem Unterstrich besteht). Attribute mit Namen, die keine IDs sind (z. B. solche mit mehr als einem Wort im Namen), können in einer Formel nicht abgerufen werden. |
Account.isCredit
| Gibt einen booleschen Wert zurück, wenn das Konto einen hatSaldoart vonObligo oder nicht. Beachten Sie, dass einige Konten (z. B. Metrikkonten) weder Soll- noch Habenkonten sind. |
Account.isDebit
| Gibt einen booleschen Wert zurück, wenn das Konto einen hatSaldoart vonSoll oder nicht. Beachten Sie, dass einige Konten (z. B. Metrikkonten) weder Soll- noch Habenkonten sind. |
Dimensionen und Attribute
Eigenschaft | Beschreibung |
|---|---|
DimensionValue .Code | Gibt die Zeichenfolge zurück, die den Code des Dimensionswerts in der angegebenen Dimension darstellt. Beispiel:
IF (this.Region.Code = "East01", 1, 0)
|
DimensionValue .Name | Gibt die Zeichenfolge zurück, die den Namen des Dimensionswerts in der angegebenen Dimension darstellt. Beispiel:
IF (this.Region.Name = "East", 1, 0)
|
DimensionValue .ShortName | Gibt die Zeichenfolge zurück, die den Kurznamen des Dimensionswerts darstellt. |
DimensionValue .Description | Gibt die Zeichenfolge zurück, die die Beschreibung des Dimensionswerts darstellt. |
DimensionValue .Parent | Gibt den Dimensionswert zurück, der diesem Wert übergeordnet ist, oder das spezielle leere Objekt, wenn dieser Wert keinen übergeordneten Wert in der Dimension hat (wenn z. B. der „übergeordnete Wert“ der Root-Wert der Dimension selbst ist). Beispiel:
this.DimensionValue.Parent.Name würde den Namen des übergeordneten Elements für diesen Dimensionswert zurückgeben. |
DimensionValue .IsLeaf | Gibt einen booleschen Wert zurück, der angibt, ob der Dimensionswert in der angegebenen Dimension ein Leaf-Wert in dieser Dimension ist. |
DimensionValue .<attribute_code > | Gibt den Wertcode des angegebenen Attributs zurück (das dem Dimensionswert entspricht). |
DimensionValue .<attribute_name > | Gibt den Wert des angegebenen Attributs zurück (das dem Dimensionswert entspricht). |
AttributeValue .Code | Gibt die Zeichenfolge zurück, die den Code des Attributwerts darstellt. |
AttributeValue .Name | Gibt die Zeichenfolge zurück, die den Namen des Attributwerts darstellt. |
AttributeValue .ShortName | Gibt die Zeichenfolge zurück, die den Kurznamen des Attributwerts darstellt. |
AttributeValue .Description | Gibt die Zeichenfolge zurück, die die Beschreibung des Attributwerts darstellt. |
AttributeValue .Parent | Gibt den Code des Attributwerts zurück, der diesem Wert übergeordnet ist, oder das spezielle leere Objekt, wenn dieser Wert keinen übergeordneten Wert in der Dimension hat (wenn z. B. der „übergeordnete Wert“ der Root-Wert der Dimension selbst ist). |
AttributeValue .IsLeaf | Gibt einen booleschen Wert zurück, der besagt, ob der Attributwert im angegebenen Attribut ein Leaf-Wert in diesem Attribut ist. |
Zeitperiode
Eine Zeitperiode stellt eine bestimmte Zeitperiode einer konfigurierten Kalenderschicht dar. Die Datentypen von Zeitperioden können nicht mit anderen Datentypen verglichen werden.
Beispiele:
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")
Eigenschaft | Beschreibung |
|---|---|
Timeper .Code | Gibt den Code der Zeitperiode zurück. Dadurch wird abgeglichen, wie auf die Zeitperiode in Zeitdiskriminatoren Bezug genommen wird. |
Timeper .NumberOfDays | Gibt die Gesamtanzahl der Tage in der Zeitperiode (einschließlich) zurück. Beispiel:
IF (this.Month.NumberOfDays > 30, 1, 0)
|
Timeper .Parent | Gibt die Zeitperiode zurück, die die aktuellen Zeitperiode enthält und die im Schichtkontinuum eine Schicht höher liegt (gröbere Schicht). Wenn keine höhere Schicht vorhanden ist, wird die aktuelle Zeitperiode zurückgegeben. |
Timeper .StartDate | Gibt ein Datum zurück, das den ersten Tag der Zeitperiode darstellt (identisch mit Version.StartDate).
|
Timeper .EndDate | Gibt ein Datum zurück, das den letzten Tag der Zeitperiode darstellt (identisch mit Version.EndDate).
|
Timeper .PositionOf(tp) | Gibt eine Ganzzahl zurück, die die Position der Zeitperiode darstellt ( tp ) innerhalb der Quellzeitperiode (relativ zu den anderen Elementen ihrer Schicht). Retouren 0 wenn die angegebene Zeitperiode (tp ) ist keine kleinere Schicht als dieTimeper
tp liegt nicht innerhalb derTimeper
|