Concept : blocs de création de formules

Termes pour décrire les formules

Une formule a :

Opérandes : éléments à calculer. Vous séparez les opérandes à l’aide d’opérateurs. Les opérandes de Adaptive Planning incluent :

Références : comptes avec modificateurs, hypothèses, rangées (colonnes de feuilles modélisées).

Constantes : nombres ou valeurs de texte entrés directement dans une formule.

Modificateurs : instruction supplémentaire qui précise la référence à un moment, à un niveau, à une valeur de dimension ou à une valeur d’attribut donnés.

Opérateurs : indiquez le type de calcul à effectuer. Vous pouvez utiliser :

Symboles. Exemple : l’opérateur astérisque (*) multiplie les nombres. Vous pouvez trouver la plupart des symboles dans Formule Assistant ou les saisir à l’aide de votre clavier.

Fonctions : modèles avec une syntaxe précise qui combinent des opérandes et des opérateurs. Vous devez remplacer les variables par vos propres références, modificateurs et expressions. Exemple : pour la fonction d’arrondissement, Arrondir (N), remplacez la valeur N par un calcul complexe et la fonction l’arrondit au nombre entier le plus proche.

En outre, ces termes décrivent des parties d’une formule :

Expression : décrit une partie précise d’une formule. Exemple : dans cette formule logique Sif ((Acct.001 > Acct.002, 1, 0), « Acct > Acct.002 » est une expression.

Terme : la référence, combinée avec des modificateurs. Exemple : ACCT.001 [time = présente - 1] est un terme.

Syntaxe : la façon dont vous devez référencer les données dans votre modèle pour créer une formule valide. Exemple : pour référencer un compte, la syntaxe est ACCT.<account_code>.

Notation par points : un ensemble avancé de règles de syntaxe qui pointent vers des éléments de votre modèle et autorisent des fonctionnalités supplémentaires. Le cas d’utilisation principal de la notation par points concerne les instructions Sif. Exemple : vous pouvez ajouter ceci.Month.NumberOfDays < 30 à un énoncé Si pour appliquer un calcul différent pour le mois de février.

À propos de la syntaxe dans la documentation

Quelques remarques sur la syntaxe dans la documentation :

Nous utilisons des lettres majuscules entre les parenthèses, comme (N) ou du texte à l’intérieur des confirmations, comme <account_code>, pour indiquer les variables. Vous devez remplacer les variables par des constantes, des références de compte ou des expressions de formule valides.

Nous utilisons des virgules pour séparer les termes, selon la norme de nombreux pays. Si votre navigateur utilise des virgules comme des points décimaux, vous devez séparer les termes par des points-virgules.

Nous ajoutons des espaces pour rendre les formules lisibles, même si elles ne sont pas nécessaires. Vous pouvez également ajouter des espaces ou les exclure de vos formules.

Nous immobilisons les fonctions, telles que Divf, et utilisons tous les plafonds pour les éléments, comme ACCT, mais les formules ne sont pas sensibles à la casse.

Exemple : la syntaxe pour ajouter un modificateur de niveau à un compte est ACCT.<code> [level = <level_code>]. Vous devez :

Utilisez la fonction ACCT. pour référencer un compte.

Remplacez <code> par un code de compte réel. Assurez-vous de retirer les chevauchements également.

Utilisez les crochets pour définir des modificateurs.

Utilisez Niveau = pour modifier par niveau.

Remplacez <niveau_name> par le code réel d’un niveau et supprimez les chevauchements.

Opérandes : références et constantes

Les références sont un type d’opérande. Dans Adaptive Planning, la référence extrait une valeur provenant d’un autre endroit du modèle et l’entre dans la formule. Exemple : vous pouvez référencer un compte. La référence de compte extrait la valeur de ce compte pour une version, un niveau et un moment précis. Vous pouvez ajouter ces références de base aux formules :

Référence	Syntax	Exemple
Comptes de grand livre, personnalisés ou d’indicateurs.	ACCT.<AccountCode>	ACCT.6113 Où 6113 est le code de compte.
Comptes cubes et comptes modélisés.	ACCT.<SheetCode.AccountCode>	ACCT.RevenueCube.003 Où RevenueCube est le code de la feuille et 003 est le code du compte.
Comptes d’hypothèse	ASSUM.<AccountCode>	ASSUM.123 Où 123 est le code de compte.
Colonnes dans une feuille modélisée Disponible uniquement pour les comptes calculés modélisés.	ROW.<column_code>	ROW.StartDate Où StartDate est le code de colonne pour le champ Date de début dans la feuille modélisée.
Tables de répartition et tables de recherche de valeurs dans les feuilles modélisées Disponible uniquement pour les comptes calculés modélisés.	ROW.<lookup_name>	Row.BenefitLookup Où BenefitLookup est le nom de la table de consultation de valeurs.
Constantes	N'importe quel nombre	500

Vous pouvez également faire référence aux cellules d’une feuille à l’aide de la méthode de saisie, qui remplit la formule avec le compte et tous les modificateurs actuels, tels que le temps et les niveaux. Voir : Concept : type de formules de base dans les cellules de la feuille.

Modificateurs

Vous pouvez ajouter de la précision à l’aide de modificateurs lorsque vous faites référence à un compte ou à une rangée. Les modificateurs recherchent une tranche précise des données du compte. Exemple : vous voulez la valeur d’un compte pour un niveau ou une période temporelle spécifiques.

Vous ajoutez des modificateurs :

À côté de la référence du compte sans espaces.

Entre crochets.

Séparé par des virgules ou des points-virgules si vous utilisez des virgules pour les décimales.

En utilisant les codes et les noms exacts qui existent dans votre modèle.

Modificateur	Syntax	Exemple
Temps	[time = <strata_code>]	ACCT.001 [time = 2023] Où 2023 est la strate d’agrégat d’années. Récupère la valeur d'agrégat de 2023 du compte.
Niveaux	[level = <level_code>]	ACC.001 [level = ventes] Où ventes est le code de niveau. Extrait la valeur du compte au niveau des ventes uniquement.
Dimension personnalisée	[<dimension_code> = <dimension_value_code>]	ACCT.001 [product = ches] Où « produit » est le code de la dimension et « chemise » est le code de la valeur de la dimension. Récupère les données du compte marquées avec des T-ends.
Attributs	[<attribute_code> =<attribute_value_code>]	ACCT.001 [productgroup = Tops] Où Productgroup est l’attribut de la dimension Produit et Tops est la valeur de l’attribut. Extrait les données de compte marquées avec toutes les valeurs de dimension qui correspondent à la valeur d’attribut Tops.
Modificateurs multiples	[<modifier1> = <code>, <modifier2> = <code>, <modifier3> = <code>]	ACCT.001 [time = 2 023, niveau = ventes, produit = chemises] Récupère l’agrégat de temps de 2023 pour le niveau des ventes de Personnalisers.

Vous pouvez avoir plusieurs modificateurs par référence, mais vous ne pouvez avoir qu’une seule valeur par modificateur. Ainsi, lorsque vous souhaitez extraire la valeur de plus d’un niveau :

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

Erreur : Acct.001 [level = Sales, Level = Marketing]

Corriger : Acct.001 [level = Sales] + Acct.001 [level = Marketing]

L’ajout d’un modificateur peut être tout ce que vous devez faire pour une formule entière.

Opérateurs : symboles mathématiques communs

Les opérateurs sont des symboles mathématiques qui fournissent des calculs. Vous pouvez utiliser des formules mathématiques de base avec les clés de votre clavier. Dans Assistant de formule, le premier ensemble de boutons de la barre d’outils fournit des opérateurs mathématiques simples que vous pouvez insérer dans la formule entre les deux termes.

Les opérandes les plus simples des formules mathématiques sont des nombres. Les opérateurs les plus simples sont ceux que vous pouvez trouver sur votre clavier. Vous n’avez pas besoin d’espacer entre les opérandes et les opérateurs, mais vous pouvez en ajouter pour faciliter la lecture de la formule. Vous pouvez également intégrer des calculs simples dans des formules plus complexes qui font référence à des comptes et à des modificateurs.

Voici quelques exemples de formules mathématiques simples que vous pouvez utiliser :

Opérateur mathématiques	Exemple de formule
Ajout (+)	ACCT.001 + ACCT.002
Soustraction (-)	ACCT.001 - ACCT.002
Multiplication (*)	ACCT.001 * ACCT.002
Subdivision (divf)	Divf (Acct.001, Acct.002) Divise ACCT.001 (le dividendes) par ACCT.002 (le diviseur)
Modulo (%)	10 % 3 Calcule le reste du guillemet. Renvoie 1, car 10 divisent 3 = 3, reste 1.
Parenthèse ()	(ACCT.001 + ACCT.002) * 12 Détermine l’ordre des opérations : ajoutez les comptes avant de multiplier par 12.
Round(N)	Arrondir (Acct.001) Arrondit au nombre entier le plus proche. Dans l’exemple qui suit, si la valeur de Acct.001 est 5,75, la formule renvoie 6.

Fonctions de formule

Une fonction de formule est un modèle qui utilise différents opérateurs et variables. Lorsque vous utilisez une fonction, vous remplacez les variables par des références, des constantes ou des expressions de formule complète. Les fonctions fonctionnent parfois seules; au lieu de cela, vous associez des fonctions pour créer votre formule.

Exemple : pour le compte Charges, vous souhaitez utiliser la valeur de l’année précédente et appliquer un taux d’indexation que vous stockez généralement dans un compte d’hypothèse. Pour éviter de référencer des cellules en blanc, vous pouvez créer un énoncé IF à l’aide d’un énoncé logique. Le modèle ressemble à ceci : Siff (EXPR, T, F).

Voici comment vous pouvez utiliser la fonction pour créer des formules :

Remplacer la variable	Exemple	Description
Remplacez EXPR par la fonction logique IsBlank pour créer une fonction dans une fonction.	Sif (isBlank (N) , T, F)	Constante soit ou soit sur laquelle reposent les calculs Vrai et Faux.
Remplacez N par l’hypothèse Taux d’enquête, dont le code de compte est infl.	Sif (isBlank (ASCUM.Infl ), T, F)	Si l’hypothèse Taux d’enquête est vide...
Remplacez T par un calcul qui se déclenche si EXPR est vraie.	Sif (isBlank (Assum.Infl), *ACCT.This [time =This - 12] (1,05)** , F)	Si l’hypothèse Taux d’enquête est vide, prenez la valeur de ce compte à partir d’il y a 12 mois et multipliez-la par 1,05.
Remplacez F par un calcul qui se déclenche si la valeur de la valeur EXPR est fausse.	Sif (isBlank (Assum.Infl), ACCT. Charge à	Si l’hypothèse Taux d’enquête n’est pas vide, prenez la valeur de ce compte d’il y a 12 mois et multipliez-la par l’hypothèse Taux d’enquête.

Dans Assistant de formule, nous classons les fonctions de formule dans les groupes suivants :

Mathématique

Logique

Date

Chaîne

Vous pouvez sélectionner une catégorie, puis préremplir le champ de formule avec les modèles disponibles. Voir : Référence : fonctions de formules.

Positionnement dans la grille

Une formule existe dans la grille Adaptive Planning. Une feuille de calcul classique comporte deux axes : les comptes et le temps. Les comptes se trouvent dans les rangées et le temps dans la colonne. Chaque cellule représente une intersection précise entre le compte et la période.

Dans Adaptive Planning, la grille est multidimensionnelle, ce qui signifie qu’il existe plus de deux axes au-delà de la feuille bidimensionnelle que vous voyez à l’écran. Exemple : les données pour l’option Produits existent à l’intersection du niveau des ventes, de la version du budget 2025, du compte des produits dans la hiérarchie du grand livre, de la valeur de la dimension personnalisée Produit, de la période de janvier 2025, etc. Lorsque vous faites référence à un point de données dans une formule, vous faites référence à chacun des axes ou à chacun des dimensions. Sauf si vous précisez la dimension, certaines valeurs par défaut s’appliquent en fonction de l’emplacement de la formule. Les dimensions suivantes contribuent à chaque intersection de données :

Dimension	Valeur par défaut dans la référence
Durée et niveau	Identique à l’emplacement actuel, sauf si vous modifiez votre référence en fonction du temps ou du niveau. Exemple : une formule pour Acct.001 est Acct.002 × 10. Pour janvier 2024, la formule prend la valeur ACCT.002 pour janvier 2024. Pour février 2024, il prend la valeur du 24 février, et ainsi de suite, sauf si vous précisez autre chose pour le temps dans la formule. Pour les niveaux, il en est de même. Les calculs extraient les valeurs au même niveau que celui qui est actuellement calculé.
Devise	La devise définie du niveau actuel.
Compte	Le compte actuel, sauf si vous faites référence à un autre compte.
Chaque dimension personnalisée	La valeur de dimension à l’emplacement actuel. S’il n’existe aucune valeur de dimension à l’emplacement actuel, la valeur par défaut est la valeur Sans catégorie.