Passa al contenuto principale
Adaptive Planning
Ultimo aggiornamento: 2023-06-23
Riferimenti: Notazione con punto per le proprietà

Riferimenti: Notazione con punto per le proprietà

Analogamente ai riferimenti ad oggetti nei linguaggi di programmazione, è possibile utilizzare la
notazione con punto
nelle formule. La notazione con punto è particolarmente utile nelle formule con
IFF
istruzioni perché consente alla formula di variare in base alla posizione corrente. Ad esempio, la formula seguente calcola una metrica in modo diverso in una versione degli importi effettivi rispetto a una versione pianificata:
Esempio: la formula calcola una metrica unidirezionale negli importi effettivi e in un altro modo nelle versioni pianificate:
IFF(this.Version.IsActuals, ACCT.ActualsValue, ACCT.PlanValue)
Esempio: per i browser che utilizzano le virgole per i decimali:
IFF(this.Version.IsActuals; ACCT.ActualsValue; ACCT.PlanValue)
Le formule che utilizzano le proprietà della notazione con punto per fare riferimento a valori dimensione, valori attributo e livelli devono fare riferimento a tali valori utilizzando il codice per evitare ambiguità quando i loro nomi corrispondono. Se si modifica il codice per un valore dimensione, un valore attributo o un livello, aggiornare le formule in modo che corrispondano al codice.

Operandi

La sintassi dell'espressione operando utilizza standardized
this
per indicare la posizione corrente di una cella.
Proprietà
Descrizione
this.Version
Restituisce un oggetto versione, che può essere combinato con un punto aggiuntivo (
.
) proprietà come
this.Version.Name
. Fare riferimento ai tipi di oggetto riportati di seguito.
this.Level
Restituisce un oggetto livello, che può essere combinato con un punto aggiuntivo (
.
)
this.Account
Restituisce un oggetto conto, quando può essere combinato con un punto aggiuntivo (
.
)
this.
dimension_name
Restituisce il valore dimensione della cella corrente nella dimensione specificata. Se la cella corrente non ha un valore per la dimensione specificata, restituisce un oggetto vuoto. Questa proprietà è accessibile solo se la dimensione ha un nome che è un identificativo legale (inizia con un carattere che non è una cifra ed è composto solo da lettere, numeri e il carattere trattino basso). Le dimensioni con nomi non identificativi (ad esempio quelle con più di una parola nel nome) non sono recuperabili in una formula.
this.
attribute_name
Restituisce il valore attributo della cella corrente nell'attributo specificato. Se la cella corrente non ha un valore per l'attributo specificato, restituisce un oggetto vuoto. Questa proprietà è accessibile solo se l'attributo ha un nome che è un identificativo legale (inizia con un carattere diverso da una cifra ed è composto solo da lettere, numeri e il carattere trattino basso). Gli attributi con nomi non identificativi (ad esempio quelle con più di una parola nel nome) non sono recuperabili in una formula.
this.<stratum_code>
Restituisce
Timeperiod
del tipo di strati richiesto che contiene le coordinate temporali della cella corrente. Se gli strati richiesti sono inferiori (a grana più fine di) allo stato della cella corrente, questa funzione restituisce il
primo
Timeperiod
di quello strato trovato nell'ambito dello strato della cella corrente.

Tipi di oggetto

I tipi di dati rappresentano gli oggetti, consentendo alla "notazione con punto" di accedere alle proprietà di tali oggetti. Le proprietà degli oggetti disponibili sono:

Versione

Si riferisce a varie proprietà della versione corrente in un file
IF
istruzione
Esempio:
IF (this.Version.Name = "Budget 2018", x, y)
Esempio: per i browser che utilizzano le virgole per i decimali:
IF (this.Version.Name = "Budget 2018"; x; y)
Proprietà
Descrizione
Version.Name
Restituisce la stringa che rappresenta il nome della versione. Se una cella importi effettivi viene sovrapposta in una versione pianificata, la versione importi effettivi viene considerata la versione della cella.
Version.ShortName
Restituisce la stringa che rappresenta il nome abbreviato della versione.
Version.Description
Restituisce la stringa che rappresenta la descrizione della versione.
Version.Type
Restituisce una stringa che rappresenta il tipo di versione, come restituito in
exportVersions
API Restituisce uno dei seguenti elementi:
PLANNING, ACTUALS, VERSION_FOLDER, JOURNAL_ENTRY
.
Version.StartDate
Restituisce un valore data che rappresenta il primo giorno del periodo di tempo, ovvero l'inizio della versione.
Version.EndDate
Restituisce un valore data che rappresenta l'ultimo giorno del periodo di tempo, ovvero la fine della versione.
Version.PositionOf
Restituisce l'ordine relativo del periodo di tempo specificato all'interno dell'intero intervallo della versione. La sequenza iniziale inizia con 0 (non 1) e il numero d'ordine può essere negativo se il periodo di tempo cade prima dell'inizio della versione. Questa funzione funziona anche con un periodo di tempo successivo alla fine della versione.
Version.IsActuals
Restituisce un valore booleano che indica se questa versione è una versione importi effettivi o meno (inclusi i tipi
ACTUALS
,
SUBACTUALS
e
JOURNAL_ENTRY
).
Version.IsGroup
Restituisce un valore booleano che indica se questa versione è un gruppo di versioni (e non una versione contenente dati).
Version.IsParent
Restituisce un valore booleano che indica se questa versione include versioni figlio.
Version.Parent
Restituisce la versione padre di questa versione.

Level

Si riferisce a varie proprietà del livello corrente in un
IF
istruzione
Esempio:
IF (this.Level.Name = "Sales", x, y)
Esempio: per i browser che utilizzano le virgole per i decimali:
IF (this.Level.Name = "Sales"; x; y)
Proprietà
Descrizione
Level.Code
Restituisce la stringa che rappresenta il codice del livello.
Level.Name
Restituisce la stringa che rappresenta il nome del livello.
Level.ShortName
Restituisce la stringa che rappresenta il nome abbreviato del livello.
Level.InWorkflow
Restituisce un valore booleano che indica se il livello è incluso in Workflow. Per le istanze con Workflow disabilitato, tutti i livelli restituiscono falso.
Level.IsElimination
Restituisce un valore booleano che indica se il livello è un livello di eliminazione. Per le istanze senza la funzionalità Eliminazioni, tutti i livelli restituiscono falso.
Level.IsTradingPartner
Restituisce un valore booleano che indica se il livello è un livello di Partner commerciale eliminazione. Per le istanze senza la funzionalità Eliminazioni, tutti i livelli restituiscono falso.
Level.Currency
Restituisce la stringa che rappresenta il codice valuta ISO del livello (ad esempio,
EUR
o
USD
).
Level.Parent
Restituisce il livello codice che è il padre di questo livello o l'oggetto livello speciale "null" se questo livello non ha padre (il livello radice).
Level.IsLeaf
Restituisce un valore booleano che indica se il livello è un livello foglia (in altre parole, questa proprietà restituisce vero se il livello non ha figli).

Account

Si riferisce alle varie proprietà (
non al valore
) del conto corrente in un
IF
istruzione
Esempio:
IF (this.Account.IFRS_Category.Name = "Assets", 1, 0)
Esempio: per i browser che utilizzano le virgole come decimali:
IF (this.Account.IFRS_Category.Name = "Assets"; 1; 0)
Proprietà
Descrizione
Account.Code
Restituisce la stringa che rappresenta il codice del conto.
Account.Name
Restituisce la stringa che rappresenta il nome del conto.
Account.ShortName
Restituisce la stringa che rappresenta il nome abbreviato del conto.
Account.Description
Restituisce la stringa che rappresenta la descrizione del conto.
Account.Parent
Restituisce un conto che è il padre di questo conto o l'oggetto conto speciale "null" se il conto non ha padre (un conto radice).
Account.<
attribute_name
>
Restituisce un oggetto valore dimensione associato all'attributo specificato. Questa proprietà è accessibile solo se l'attributo ha un nome che è un identificativo legale (inizia con un carattere che non è una cifra ed è composto solo da lettere, numeri e il carattere trattino basso). Gli attributi con nomi non identificativi (ad esempio quelle con più di una parola nel nome) non sono recuperabili in una formula.
Account.isCredit
Restituisce un valore booleano se il conto ha aBalanceType diCREDITO o meno. Si noti che alcuni conti (ad esempio i conti metrica) non saranno né Dare né Avere.
Account.isDebit
Restituisce un valore booleano se il conto ha aBalanceType diDEBITO o meno. Si noti che alcuni conti (ad esempio i conti metrica) non saranno né Dare né Avere.

Dimensioni e attributi

Proprietà
Descrizione
DimensionValue
.Code
Restituisce la stringa che rappresenta il codice del valore dimensione nella dimensione specificata.
Esempio:
IF (this.Region.Code = "East01", 1, 0)
DimensionValue
.Name
Restituisce la stringa che rappresenta il nome del valore dimensione nella dimensione specificata.
Esempio:
IF (this.Region.Name = "East", 1, 0)
DimensionValue
.ShortName
Restituisce la stringa che rappresenta il nome abbreviato del valore dimensione.
DimensionValue
.Description
Restituisce la stringa che rappresenta la descrizione del valore dimensione.
DimensionValue
.Parent
Restituisce il valore dimensione padre di questo valore o l'oggetto speciale vuoto se il valore non ha padre all'interno della dimensione (ad esempio, il padre è la radice della dimensione stessa).
Esempio:
this.DimensionValue.Parent.Name
restituirà il nome del padre per questo valore dimensione.
DimensionValue
.IsLeaf
Restituisce un valore booleano che indica se il valore dimensione nella dimensione specificata è un valore foglia in tale dimensione.
DimensionValue
.<
attribute_code
>
Restituisce il codice valore dell'attributo specificato (che corrisponde al valore dimensione).
DimensionValue
.<
attribute_name
>
Restituisce il valore dell'attributo specificato (che corrisponde al valore dimensione).
AttributeValue
.Code
Restituisce la stringa che rappresenta il codice del valore attributo.
AttributeValue
.Name
Restituisce la stringa che rappresenta il nome del valore attributo.
AttributeValue
.ShortName
Restituisce la stringa che rappresenta il nome abbreviato del valore attributo.
AttributeValue
.Description
Restituisce la stringa che rappresenta la descrizione del valore attributo.
AttributeValue
.Parent
Restituisce il valore dell'attributo codice che è il padre di questo valore o l'oggetto vuoto speciale se il valore non ha un padre all'interno della dimensione (ad esempio, il "padre" è la radice della dimensione stessa).
AttributeValue
.IsLeaf
Restituisce un valore booleano che indica se il valore attributo nell'attributo specificato è un valore foglia in tale attributo.

Periodo di tempo

Un periodo di tempo rappresenta un determinato periodo di tempo di qualsiasi strato del calendario configurato. I tipi di dati per il periodo di tempo non possono essere confrontati con altri tipi di dati.
Esempi:
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")
Proprietà
Descrizione
Timeper
.Code
Restituisce il codice del periodo di tempo. Corrisponderà al modo in cui viene fatto riferimento al periodo di tempo nelle discriminanti di tempo.
Timeper
.NumberOfDays
Restituisce il numero totale di giorni inclusi nel periodo di tempo.
Esempio:
IF (this.Month.NumberOfDays > 30, 1, 0)
Timeper
.Parent
Restituisce il periodo di tempo che contiene il periodo di tempo corrente ed è uno strato più alto (più grossolano) nel continuo degli strati. Se non è presente uno strato superiore, restituisce il periodo di tempo corrente.
Timeper
.StartDate
Restituisce una data che rappresenta il primo giorno del periodo di tempo (uguale a
Version.StartDate).
Timeper
.EndDate
Restituisce una data che rappresenta l'ultimo giorno del periodo di tempo (come
Version.EndDate).
Timeper
.PositionOf(tp)
Restituisce un numero intero che rappresenta la posizione del periodo di tempo (
tp
) entro il periodo di tempo di origine (relativo agli altri membri del relativo strato). Resi
0
se il periodo di tempo specificato (
tp
) non è uno strato più piccolo di
Timeper
specificato o se
tp
non si trova all'interno di
Timeper
specificato.