Referentie: puntnotatie voor eigenschappen

Adaptive Planning

Net als bij objectverwijzingen in programmeertalen kunt u puntnotatie
gebruiken in formules. Puntnotatie is met name handig in formules met

IFF

-statements omdat de formule kan variëren op basis van de huidige locatie. Met de volgende formule bijvoorbeeld wordt een metriekwaarde in een versie met werkelijke waarden anders berekend dan in een planversie:

Voorbeeld: de formule berekent een metriek op een manier in werkelijke waarden en op een andere manier in planversies:

IFF(this.Version.IsActuals, ACCT.ActualsValue, ACCT.PlanValue)

Voorbeeld: voor browsers die komma's voor decimalen gebruiken:

IFF(this.Version.IsActuals; ACCT.ActualsValue; ACCT.PlanValue)

Formules die eigenschappen voor puntnotatie gebruiken om te verwijzen naar dimensiewaarden, kenmerkwaarden en niveaus, moeten er met Code naar verwijzen om dubbelzinnigheid te voorkomen bij overeenkomende namen. Als u de code voor een dimensiewaarde, kenmerkwaarde of niveau wijzigt, moet u de formules bijwerken zodat ze overeenkomen met de code.

Operands

De syntaxis van de operandexpressie maakt gebruik van de gestandaardiseerde

this

term om de huidige locatie van een cel aan te geven.

Eigenschap	Omschrijving
this.Version	Retourneert een versieobject, dat kan worden gecombineerd met een extra punt ( . ) eigenschappen zoals this.Version.Name . Zie Objecttypen hieronder.
this.Level	Retourneert een niveauobject, dat kan worden gecombineerd met een extra punt ( . ) eigenschappen.
this.Account	Retourneert een rekeningobject, wanneer kan worden gecombineerd met een aanvullende punt ( . ) eigenschappen.
this. dimension_name	Retourneert de dimensiewaarde van de huidige cel in de opgegeven dimensie. Als de huidige cel geen waarde heeft voor de opgegeven dimensie, wordt een leeg object geretourneerd. Deze eigenschap is alleen toegankelijk als de naam van de dimensie een geldige ID is (die begint met iets anders dan een cijfer en alleen uit letters, cijfers en het onderstrepingsteken bestaat). Dimensies waarvan de namen geen ID zijn (zoals dimensies met meer dan één woord in de naam) kunnen niet worden opgehaald in een formule.
this. attribute_name	Retourneert de kenmerkwaarde van de huidige cel in het opgegeven kenmerk. Als de huidige cel geen waarde heeft voor het opgegeven kenmerk, wordt een leeg object geretourneerd. Deze eigenschap is alleen toegankelijk als de naam van het kenmerk een geldige ID is (die begint met iets anders dan een cijfer en alleen uit letters, cijfers en het onderstrepingsteken bestaat). Kenmerken waarvan de namen geen ID zijn (zoals kenmerken met meer dan één woord in de naam) kunnen niet worden opgehaald in een formule.
this.<stratum_code>	Retourneert de Timeperiod van het aangevraagde stratatype dat de tijdcoördinaat van de huidige cel bevat. Als het aangevraagde stratum lager is dan (fijner dan) het statum van de huidige cel, retourneert deze functie het eerste Timeperiod van dat stratum gevonden in het bereik van het stratum van de huidige cel.

Objecttypen

Gegevenstypen vertegenwoordigen objecten, waardoor de puntnotatie toegang heeft tot eigenschappen van die objecten. De beschikbare objecteigenschappen zijn:

Versie

Verwijst naar verschillende eigenschappen van de huidige versie in een

verklaring.

Voorbeeld:

IF (this.Version.Name = "Budget 2018", x, y)

Voorbeeld: voor browsers die komma's voor decimalen gebruiken:

IF (this.Version.Name = "Budget 2018"; x; y)

Eigenschap	Omschrijving
Version.Name	Retourneert de tekenreeks die de naam van de versie vertegenwoordigt. In geval van overlapping van een cel met werkelijke waarden in een planversie, wordt de versie met werkelijke waarden beschouwd als de versie van de cel.
Version.ShortName	Retourneert de tekenreeks die de korte naam van de versie vertegenwoordigt.
Version.Description	Retourneert de tekenreeks die de omschrijving van de versie vertegenwoordigt.
Version.Type	Retourneert een tekenreeks die het type van de versie vertegenwoordigt, zoals geretourneerd in de exportVersions API. Retourneert een van de volgende items: PLANNING, ACTUALS, VERSION_FOLDER, JOURNAL_ENTRY .
Version.StartDate	Retourneert een datumwaarde die de eerste dag vertegenwoordigt van de periode aan het begin van de versie.
Version.EndDate	Retourneert een datumwaarde die de laatste dag vertegenwoordigt van de periode aan het einde van de versie.
Version.PositionOf	Retourneert de relatieve volgorde van de opgegeven periode binnen het volledige bereik van de versie. De eerste reeks begint met 0 (niet 1) en het volgnummer kan negatief zijn als de periode vóór het begin van de versie valt. Deze functie werkt ook met een periode die na het einde van de versie valt.
Version.IsActuals	Retourneert een Boole-waarde die aangeeft of deze versie een versie met werkelijke waarden is (inclusief typen) ACTUALS , SUBACTUALS , and JOURNAL_ENTRY ).
Version.IsGroup	Retourneert een Boole-waarde die aangeeft of deze versie een versiegroep is (en geen versie die gegevens bevat).
Version.IsParent	Retourneert een Boole-waarde die aangeeft of deze versie onderliggende versies heeft.
Version.Parent	Retourneert de bovenliggende versie van deze versie.

Niveau

Verwijst naar verschillende eigenschappen van het huidige niveau in een

verklaring.

Voorbeeld:

IF (this.Level.Name = "Sales", x, y)

Voorbeeld: voor browsers die komma's voor decimalen gebruiken:

IF (this.Level.Name = "Sales"; x; y)

Eigenschap	Omschrijving
Level.Code	Retourneert de tekenreeks die de niveaucode vertegenwoordigt.
Level.Name	Retourneert de tekenreeks die de niveaunaam vertegenwoordigt.
Level.ShortName	Retourneert de tekenreeks die de korte naam van het niveau vertegenwoordigt.
Level.InWorkflow	Retourneert een Boole-waarde die aangeeft of het niveau is opgenomen in Werkstroom. Voor instances waarvoor Werkstroom is uitgeschakeld, retourneren alle niveaus False.
Level.IsElimination	Retourneert een Boole-waarde die aangeeft of het niveau een eliminatieniveau is. Voor instances zonder de functie Eliminaties retourneren alle niveaus False.
Level.IsTradingPartner	Retourneert een Boole-waarde die aangeeft of het niveau een eliminatieniveau voor handelspartners is. Voor instances zonder de functie Eliminaties retourneren alle niveaus False.
Level.Currency	Retourneert de tekenreeks die de ISO-valutacode van het niveau vertegenwoordigt (bijvoorbeeld EUR of USD ).
Level.Parent	Retourneert de niveaucode die het bovenliggende item van dit niveau is, of het speciale niveauobject Null als dit niveau geen bovenliggend item heeft (het hoofdniveau).
Level.IsLeaf	Retourneert een Boole-waarde die aangeeft of het niveau een laagst niveau is (dat wil zeggen dat deze eigenschap True retourneert als het niveau geen onderliggende niveaus heeft).

Rekening

Verwijst naar de verschillende eigenschappen (niet de waarde
) van de lopende rekening in een

verklaring.

Voorbeeld:

IF (this.Account.IFRS_Category.Name = "Assets", 1, 0)

Voorbeeld: voor browsers die komma's als decimalen gebruiken:

IF (this.Account.IFRS_Category.Name = "Assets"; 1; 0)

Eigenschap	Omschrijving
Account.Code	Retourneert de tekenreeks die de rekeningcode vertegenwoordigt.
Account.Name	Retourneert de tekenreeks die de rekeningnaam vertegenwoordigt.
Account.ShortName	Retourneert de tekenreeks die de korte naam van de rekening vertegenwoordigt.
Account.Description	Retourneert de tekenreeks die de omschrijving van de rekening vertegenwoordigt.
Account.Parent	Retourneert de bovenliggende rekening van deze rekening, of het speciale null-rekeningobject als deze rekening geen bovenliggende rekening heeft (een hoofdrekening).
Account.<attribute_name >	Retourneert een dimensiewaardeobject dat is gekoppeld aan het opgegeven kenmerk. Deze eigenschap is alleen toegankelijk als de naam van het kenmerk een geldige ID is (die begint met iets anders dan een cijfer en alleen uit letters, cijfers en het onderstrepingsteken bestaat). Kenmerken waarvan de namen geen ID zijn (zoals kenmerken met meer dan één woord in de naam) kunnen niet worden opgehaald in een formule.
Account.isCredit	Retourneert een Boole-waarde als de rekening een heeftSaldoType vanCREDIT of niet. Houd er rekening mee dat sommige rekeningen (bijvoorbeeld metriekrekeningen) noch debet noch credit zijn.
Account.isDebit	Retourneert een Boole-waarde als de rekening een heeftSaldoType vanDEBIT of niet. Houd er rekening mee dat sommige rekeningen (bijvoorbeeld metriekrekeningen) noch debet noch credit zijn.

Dimensies en kenmerken

Eigenschap	Omschrijving
DimensionValue .Code	Retourneert de tekenreeks die de code van de dimensiewaarde in de opgegeven dimensie vertegenwoordigt. Voorbeeld: IF (this.Region.Code = "East01", 1, 0)
DimensionValue .Name	Retourneert de tekenreeks die de naam van de dimensiewaarde in de opgegeven dimensie vertegenwoordigt. Voorbeeld: IF (this.Region.Name = "East", 1, 0)
DimensionValue .ShortName	Retourneert de tekenreeks die de korte naam van de dimensiewaarde vertegenwoordigt.
DimensionValue .Description	Retourneert de tekenreeks die de omschrijving van de dimensiewaarde vertegenwoordigt.
DimensionValue .Parent	Retourneert de dimensiewaarde die het bovenliggende item van deze dimensiewaarde is, of het speciale lege object als deze waarde geen bovenliggend item in de dimensie heeft (de bovenliggende waarde is bijvoorbeeld het hoofdniveau van de dimensie zelf). Voorbeeld: this.DimensionValue.Parent.Name zou de naam van het bovenliggende niveau voor deze dimensiewaarde retourneren.
DimensionValue .IsLeaf	Retourneert een Boole-waarde die aangeeft of de dimensiewaarde in de opgegeven dimensie een laagste waarde in die dimensie is.
DimensionValue .<attribute_code >	Retourneert de waardecode van het opgegeven kenmerk (dat overeenkomt met de dimensiewaarde).
DimensionValue .<attribute_name >	Retourneert de waarde van het opgegeven kenmerk (dat overeenkomt met de dimensiewaarde).
AttributeValue .Code	Retourneert de tekenreeks die de code van de kenmerkwaarde vertegenwoordigt.
AttributeValue .Name	Retourneert de tekenreeks die de naam van de kenmerkwaarde vertegenwoordigt.
AttributeValue .ShortName	Retourneert de tekenreeks die de korte naam van de kenmerkwaarde vertegenwoordigt.
AttributeValue .Description	Retourneert de tekenreeks die de omschrijving van de kenmerkwaarde vertegenwoordigt.
AttributeValue .Parent	Retourneert de code van de dimensiewaarde die het bovenliggende item van deze waarde is, of het speciale lege object als deze waarde geen bovenliggend item in de dimensie heeft (de bovenliggende waarde is bijvoorbeeld het hoofdniveau van de dimensie zelf).
AttributeValue .IsLeaf	Retourneert een Boole-waarde die aangeeft of de kenmerkwaarde in het opgegeven kenmerk een laagste waarde in dat kenmerk is.

Periode

Een periode vertegenwoordigt een bepaalde periode van een geconfigureerd kalenderstratum. Gegevenstypen voor perioden kunnen niet worden vergeleken met andere gegevenstypen.

Voorbeelden:

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")

Eigenschap	Omschrijving
Timeper .Code	Retourneert de code van de periode. Deze komt overeen met de manier waarop naar de periode wordt verwezen in tijdsdiscriminanten.
Timeper .NumberOfDays	Retourneert het totale aantal dagen in de periode, inclusief einddatum. Voorbeeld: IF (this.Month.NumberOfDays > 30, 1, 0)
Timeper .Parent	Retourneert de periode die de huidige periode bevat en één stratum hoger (grover) is op het stratacontinuüm. Als er geen hoger stratum is, wordt de huidige periode geretourneerd.
Timeper .StartDate	Retourneert een datum die de eerste dag van de periode vertegenwoordigt (zelfde als Version.StartDate).
Timeper .EndDate	Retourneert een datum die de laatste dag van de periode vertegenwoordigt (zelfde als Version.EndDate).
Timeper .PositionOf(tp)	Retourneert een geheel getal dat de positie van tijdsperiode ( tp ) binnen de bronperiode (ten opzichte van de andere leden van het stratum). Retouren 0 als de opgegeven periode ( tp ) is geen kleiner stratum dan de Timeper opgegeven, of als tp ligt niet binnen de Timeper opgegeven.