Concetto: Elementi costitutivi delle formule

Termini per descrivere le formule

Una formula ha:

Operandi: gli elementi da calcolare. Si separano gli operandi con gli operatori. Gli operandi in Adaptive Planning includono:

Riferimenti: conti con modificatori, ipotesi, righe (colonne di fogli modellati).

Costanti: numeri o valori di testo immessi direttamente in una formula.

Modificatori: istruzione aggiuntiva che specifica il riferimento a tempo, livello, valore dimensione o valore attributo specifici.

Operatori: specificare il tipo di calcolo da eseguire. È possibile usare:

Simboli Esempio: l'operatore asterisco (*) moltiplica i numeri. È possibile trovare la maggior parte dei simboli nell'Assistente alle formule oppure digitarli con la tastiera.

Funzioni: modelli con sintassi precisa che combinano operandi e operatori. È necessario sostituire le variabili con riferimenti, modificatori ed espressioni propri. Esempio: per la funzione di arrotondamento, Arrotonda (N), sostituire N con un calcolo complesso e la funzione lo arrotonda al numero intero più vicino.

Inoltre, i seguenti termini descrivono parti di una formula:

Espressione: descrive una parte specifica di una formula. Esempio: in questa formula logica Iff ((ACCT.001 > ACCT.002, 1, 0), "ACCT > ACCT.002" è un'espressione.

Termine: il riferimento, combinato con eventuali modificatori. Esempio: ACCT.001 [time = this - 1] è un termine.

Sintassi: il modo in cui è necessario fare riferimento ai dati nel modello per creare una formula valida. Esempio: per fare riferimento a un conto, la sintassi è ACCT.<codice_conto>.

Notazione punto: un insieme avanzato di regole sintattiche che puntano agli elementi del modello e consentono funzionalità aggiuntive. Il caso d'uso principale della notazione con punto è per le istruzioni Iff. Esempio: è possibile aggiungere this.Month.NumberOfDays < 30 a un'istruzione Iff per applicare un calcolo diverso per il mese di febbraio.

Informazioni sulla sintassi nella documentazione

Alcune note sulla sintassi nella documentazione:

Per indicare le variabili vengono utilizzate lettere maiuscole tra parentesi, come (N) o testo all'interno di galloni, come <account_code>. È necessario sostituire le variabili con costanti, riferimenti conto o espressioni di formula validi.

Per separare i termini vengono utilizzate le virgole, in base agli standard di molti paesi. Se il browser utilizza le virgole come punti decimali, è necessario separare i termini con un punto e virgola.

Vengono aggiunti spazi per rendere leggibili le formule, anche se non sono necessari. È anche possibile aggiungere spazi o lasciarli fuori dalle formule.

Le funzioni vengono utilizzate in maiuscolo, ad esempio Divf, e vengono utilizzate tutte le maiuscole per gli elementi, come ACCT, ma le formule non fanno distinzione tra maiuscole e minuscole.

Esempio: la sintassi per aggiungere un modificatore di livello a un conto è ACCT.<code> [level = <level_code>]. È necessario:

Utilizzare ACCT. per fare riferimento a un conto.

Sostituire <code> con un codice conto effettivo. Assicurarsi di rimuovere anche i galloni.

Utilizzare le parentesi quadre per definire i modificatori.

Utilizzare level = per modificare in base al livello.

Sostituire <level_name> con il codice effettivo di un livello e rimuovere i galloni.

Operandi: riferimenti e costanti

I riferimenti sono un tipo di operando. In Adaptive Planning, il riferimento estrae nella formula un valore da un'altra posizione del modello. Esempio: è possibile fare riferimento a un conto. Il riferimento del conto estrae il valore per quel conto per una versione, un livello e un'ora specifici. È possibile aggiungere alle formule i seguenti riferimenti di base:

Riferimenti	Sintassi	Esempio
Conti CoGe, personalizzati o metrica	ACCT.<AccountCode>	ACCT.6113 Dove 6113 è il codice conto.
Conti cubo e modellati	ACCT.<SheetCode.AccountCode>	ACCT.RevenueCube.003 Dove RevenueCube è il codice del foglio e 003 è il codice conto.
Conti di ipotesi	ASSUM.<AccountCode>	ASSUM.123 Dove 123 è il codice conto.
Colonne in un foglio modellato Disponibile solo per i conti calcolati modellati.	ROW.<column_code>	ROW.StartDate Dove StartDate è il codice colonna per il campo Data inizio nel foglio modellato.
Ricerche di distribuzioni e valori nei fogli modellati Disponibile solo per i conti calcolati modellati.	ROW.<lookup_name>	Row.BenefitLookup Dove BenefitLookup è il nome della tabella di ricerca valori.
Costanti	Qualsiasi numero	500

È anche possibile fare riferimento alle celle di un foglio utilizzando il metodo di acquisizione, che popola la formula con il conto ed eventuali modificatori presenti, come tempo e livelli. Consultare Concetto: Digitare le formule di base nelle celle del foglio.

Modificatori

È possibile aggiungere la precisione con i modificatori quando si fa riferimento a un conto o a una riga. I modificatori trovano una sezione specifica dei dati del conto. Esempio: si desidera il valore di un conto per un livello o un periodo di tempo specifico.

I modificatori vengono aggiunti:

Accanto al riferimento del conto senza spazi.

Tra parentesi quadre

Separato da virgole o punto e virgola se si utilizzano virgole per le virgole decimali.

Utilizzando i codici e i nomi esatti esistenti nel modello.

Modificatore	Sintassi	Esempio
Tempo	[time = <strata_code>]	ACCT.001 [time = 2023] Dove 2023 è lo strato di rollup dell'anno. Estrae il valore di rollup 2023 del conto.
Livelli	[level = <level_code>]	ACCT.001 [level = sales] Dove vendite è il codice del livello. Estrae il valore del conto solo a livello Vendite.
Dimensione personalizzata	[<dimension_code> = <dimension_value_code>]	ACCT.001 [product = shirts] Dove prodotto è il codice dimensione e camicie è il codice valore dimensione. Estrae i dati del conto contrassegnati con magliette.
Attributi	[<attribute_code> =<attribute_value_code>]	ACCT.001 [productgroup = tops] Dove productgroup è l'attributo della dimensione Product e top è il valore dell'attributo. Estrae i dati del conto contrassegnati con qualsiasi valore dimensione corrispondente al valore dell'attributo massimi.
Più modificatori	[<modifier1> = <code>, <modifier2> = <code>, <modifier3> = <code>]	ACCT.001 [time = 2023, level = Sales, product = Shirts] Estrae il rollup temporale del 2023 per il livello Vendite per le camicie.

È possibile avere più modificatori per riferimento, ma è possibile avere un solo valore per modificatore. Pertanto, quando si desidera estrarre il valore per più di un livello:

Errato: ACCT.001 [level = Sales, Marketing]

Errato: ACCT.001 [level = Sales, level = Marketing]

Corretto: ACCT.001 [level = Sales] + ACCT.001 [level = Marketing]

L'aggiunta di un modificatore potrebbe essere sufficiente per un'intera formula.

Operatori: simboli matematici comuni

Gli operatori sono simboli matematici che forniscono calcoli. È possibile utilizzare formule matematiche di base con i tasti della tastiera. In Assistente alle formule, il primo insieme di pulsanti della barra degli strumenti fornisce semplici operatori matematici che è possibile inserire nella formula tra i termini.

Gli operandi più semplici delle formule matematiche sono i numeri. Gli operatori più semplici sono quelli che è possibile trovare sulla tastiera. Non sono necessari spazi tra operandi e operatori, ma è possibile aggiungerli per semplificare la lettura della formula. È anche possibile inserire calcoli semplici in formule più complesse che fanno riferimento a conti e modificatori.

Di seguito sono riportati alcuni esempi di semplici formule matematiche che è possibile utilizzare:

Operatore matematico	Formula di esempio
Aggiunta (+)	ACCT.001 + ACCT.002
Sottrazione (-)	ACCT.001 - ACCT.002
Moltiplicazione (*)	ACCT.001 * ACCT.002
Divisione (Divf)	Divf (ACCT.001, ACCT.002) Divide ACCT.001 (il dividendo) per ACCT.002 (il divisore)
Modulo (%)	10 % 3 Calcola il resto del quoziente. Restituisce 1 perché 10 diviso 3 = 3 resto 1.
Parentesi ()	(ACCT.001 + ACCT.002) * 12 Detta l'ordine dell'operazione: aggiungere i conti prima di moltiplicare per 12.
Arrotonda(N)	Arrotondamento (ACCT.001) Arrotonda al numero intero più vicino. Nell'esempio, se il valore di ACCT.001 è 5,75, la formula restituisce 6.

Funzioni formula

Una funzione formula è un modello che utilizza operatori e variabili diversi. Quando si utilizza una funzione, le variabili vengono sostituite con riferimenti, costanti o espressioni di formule complete. Le funzioni raramente funzionano da sole; invece, si raggruppano le funzioni per creare la formula.

Esempio: per il conto spese si desidera utilizzare il valore dell'anno precedente e applicare un tasso di inflazione che in genere viene archiviato in un conto di ipotesi. Per evitare di fare riferimento a celle vuote, è possibile creare un'istruzione IF utilizzando un'istruzione logica. Il modello ha il seguente aspetto: Iff (EXPR, T, F).

Ecco come utilizzare la funzione per creare la formula:

Sostituire la Variabile	Esempio	Descrizione
Sostituire EXPR con la funzione logica IsBlank creando una funzione all'interno di una funzione.	Iff (isBlank (N) , T, F)	La costante o la costante su cui si basano i calcoli Vero e Falso.
Sostituire N con l'ipotesi Tasso di inflazione, che ha il codice conto: infl.	Iff (isBlank (ASSUM.Infl ), T, F)	Se l'ipotesi Tasso di inflazione è vuota...
Sostituire T con un calcolo che si attiva se EXPR è vero.	Iff (isBlank (ASSUM.Infl), *ACCT.this [time = this - 12] (1.05)** , F)	Se l'ipotesi Tasso di inflazione è vuota, prendere il valore del conto di 12 mesi fa e moltiplicare per 1,05.
Sostituire F con un calcolo che si attiva se EXPR è falso.	Iff (isBlank (ASSUM.Infl), ACCT.this [time = this - 12] * (1,05), *ACCT.this [time = this - 12] ASSUM.Infl** )	Se l'ipotesi Tasso di inflazione non è vuota, prendere il valore del conto di 12 mesi fa e moltiplicarlo per l'ipotesi Tasso di inflazione.

In Assistente alle formule, le funzioni delle formule vengono classificate nei seguenti gruppi:

Matematici

Logica

Data

String

È possibile selezionare una categoria e quindi precompilare il campo della formula con i modelli disponibili. Consultare Riferimenti: Funzioni delle formule.

Posizionamento nella griglia

Esiste una formula nella griglia di Adaptive Planning. Un foglio di calcolo tipico ha due assi: Conti e ore. I conti sono nelle righe e il tempo è nella colonna. Ogni cella rappresenta un'intersezione specifica tra il conto e il periodo di tempo.

In Adaptive Planning, la griglia è multidimensionale, il che significa che sono presenti più di due assi oltre il foglio bidimensionale visualizzato sullo schermo. Esempio: i dati per Ricavi sono presenti all'intersezione tra il livello Vendite, la versione Budget 2025, il conto Ricavi nella gerarchia della contabilità generale, il valore della dimensione personalizzata Prodotto Camicie, il periodo di tempo di gennaio 2025 e così via. Quando si fa riferimento a un punto dati in una formula, si fa riferimento a ogni asse o dimensione. A meno che non si specifichi la dimensione, vengono applicate alcune impostazioni predefinite, in base alla posizione della formula. Le seguenti dimensioni contribuiscono a ogni intersezione di dati:

Dimensione	Valore predefinito in Riferimento
Tempo e Livello	Uguale alla sede corrente, a meno che non si modifichi il riferimento con l'ora o il livello. Esempio: una formula per ACCT.001 è ACCT.002 * 10. Per gennaio 2024 la formula assume il valore di ACCT.002 per gennaio 2024. Per febbraio 2024, prende il valore dal 24 febbraio e così via, a meno che non si specifichi qualcosa di diverso per il tempo nella formula. Lo stesso vale per i livelli. I calcoli estraggono i valori allo stesso livello correntemente calcolato.
costante	La valuta definita del livello corrente.
Account	Il conto corrente, a meno che non si faccia riferimento a un altro conto.
Ogni dimensione personalizzata	Il valore dimensione nella sede corrente. Se non esiste alcun valore dimensione nella sede corrente, il valore predefinito è Non categorizzato.