Zum Hauptinhalt wechseln
Adaptive Planning
Zuletzt aktualisiert: 2023-06-23
Referenz: Punktnotation für Eigenschaften

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. B
this.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ück
Timeperiod
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
, und
JOURNAL_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
oder
USD
).
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 die
Timeper
angegeben ist oder
tp
liegt nicht innerhalb der
Timeper
angegeben.