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à comethis.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 eJOURNAL_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 oUSD ). |
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 diTimeper
tp non si trova all'interno diTimeper
|