Concept : composants de base des formules

Termes pour décrire les formules

Une formule contient :

Opérandes : éléments à calculer. Vous séparez les opérandes par des opérateurs. Les opérandes d'Adaptive Planning sont les suivants :

Références : comptes avec modificateurs, hypothèses, lignes (colonnes de feuilles modèles).

Constantes : chiffres ou valeurs de texte directement saisis dans une formule.

Modificateurs : instruction supplémentaire qui spécifie la référence à une période, un périmètre, une valeur de dimension ou une valeur d'attribut spécifique.

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

Symboles. Exemple : l'opérateur astérisque (*) multiplie les nombres. La plupart des symboles se trouvent dans l'assistant de formule ou vous pouvez les saisir avec votre clavier.

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

De plus, les termes suivants décrivent les parties d'une formule :

Expression : décrit une partie spécifique d'une formule. Exemple : dans cette formule logique Iff ((ACCT.001 > ACCT.002, 1, 0), "ACCT > ACCT.002" est une expression.

Terme : la référence, combinée à d'éventuels modificateurs. Exemple : ACCT.001 [time = this - 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 à points : ensemble avancé de règles de syntaxe qui pointent vers des éléments de votre modèle et qui permettent d'ajouter des fonctionnalités. Le cas d'utilisation principal de la notation par points concerne les instructions Iff. Exemple : vous pouvez ajouter this.Month.NumberOfDays < 30 à une instruction Iff pour appliquer un calcul différent pour le mois de février.

Comprendre la syntaxe dans la documentation

Quelques remarques sur la syntaxe dans la documentation :

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

Séparons les termes par des virgules, conformément à la norme de nombreux pays. Si votre navigateur utilise la virgule comme séparateur décimal, vous devez séparer les termes par des points-virgules.

Nous ajoutons des espaces pour rendre les formules lisibles, bien qu'ils ne soient pas nécessaires. Vous pouvez également ajouter des espaces ou les laisser en dehors de vos formules.

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

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

Utiliser ACCT. pour référencer un compte.

Remplacez <code> par un code de compte réel. Veillez à retirer également les chevauchements.

Utilisez des crochets pour définir les modificateurs.

Utilisez Périmètre = pour modifier par périmètre.

Remplacez <nom_périmètre> par le code réel d'un périmètre 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 d'un autre élément du modèle pour l'intégrer à la formule. Exemple : vous pouvez référencer un compte. La référence du compte intègre la valeur de ce compte pour une version, un périmètre et un temps spécifiques. Vous pouvez ajouter les références de base suivantes aux formules :

Référence	Syntaxe	Exemple
Comptes GL, personnalisés ou métriques.	ACCT.<AccountCode>	ACCT.6113 Où 6113 est le code du compte.
Comptes cubes et modèles.	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 du compte.
Colonnes dans une feuille modèle Disponible uniquement pour les comptes modèles calculés.	ROW.<column_code>	ROW.StartDate Où StartDate est le code de la colonne du champ Date de début de la feuille modèle.
Tables de répartition et de valeur dans les feuilles modèles Disponible uniquement pour les comptes modèles calculés.	ROW.<lookup_name>	Row.BenefitLookup Où BenefitLookup est le nom de la table de recherche de valeurs.
Constantes	N'importe quel nombre	500

Vous pouvez également faire référence aux cellules d'une feuille en utilisant la méthode de capture, qui alimente la formule avec le compte et tous les modificateurs actuels, tels que le temps et les périmètres. Voir Concept : saisir des formules de base dans les cellules d'une feuille.

Modificateurs

Vous pouvez ajouter des modificateurs de précision lorsque vous référencez un compte ou une ligne. Les modificateurs recherchent une tranche spécifique des données du compte. Exemple : vous voulez la valeur d'un compte pour un périmètre ou une période spécifique.

Vous ajoutez des modificateurs :

En regard de la référence du compte sans espaces.

Entre crochets.

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

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

Modificateur	Syntaxe	Exemple
Temps	[time = <strata_code>]	ACCT.001 [time = 2023] Où 2023 est la strate d'agrégat de l'année. Extrait la valeur d'agrégat 2023 du compte.
Périmètres	[level = <level_code>]	ACCT.001 [level = Sales] Où Ventes est le code du périmètre. Extrait la valeur du compte du périmètre Ventes uniquement.
Dimension personnalisée	[<dimension_code> = <dimension_value_code>]	ACCT.001 [product = Chemises] Où le produit est le code de la dimension et Chemises est le code de la valeur de dimension. Extrait les données du compte marquées avec des Chemises.
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 du compte marquées avec les valeurs de dimension correspondant à la valeur d'attribut supérieure.
Modificateurs multiples	[<modifier1> = <code>, <modifier2> = <code>, <modifier3> = <code>]	ACCT.001 [time = 2023, Périmètre = Ventes, Produit = Chemises] Extrait l'agrégat de temps de 2023 du périmètre Ventes pour Chemises.

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 pour plusieurs périmètres :

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

Faux : 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 touches de votre clavier. Dans l'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 termes.

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

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

Opérateur de mathématiques	Exemple de formule
Ajout (+)	ACCT.001 + ACCT.002
Soustraction (-)	ACCT.001 - ACCT.002
Multiplication (*)	ACCT.001 * ACCT.002
Divf (division)	Divf (ACCT.001, ACCT.002) Divise ACCT.001 (divide) par ACCT.002 (diviseur)
Modulo (%)	10 % 3 Calcule le reste du quotient. Renvoie 1 car 10 divisé 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) Est arrondi au nombre entier le plus proche. Dans l'exemple si la valeur 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ètes. Les fonctions travaillent rarement seules ; au lieu de cela, vous enchaînez les fonctions ensemble pour créer votre formule.

Exemple : pour le compte de charges, vous voulez utiliser la valeur de l'année dernière et appliquer un taux d'inflation que vous stockez généralement dans un compte d'hypothèse. Pour éviter de référencer des cellules vides, vous pouvez créer une instruction IF à l'aide d'une instruction logique. Le modèle ressemble à ceci : Iff (EXPR, T, F).

Voici comment 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.	Iff (isBlank (N) , T, F)	La constante ou au contraire de l'une ou l'autre sur laquelle reposent les calculs Vrai et Faux.
Remplacez N par l'hypothèse Taux de l'inflation, qui a le code du compte : infl.	Iff (isBlank (ASSUM.Infl ), T, F)	Si l'hypothèse du taux d'inflation est vide...
Remplacez T par un calcul qui se déclenche si la valeur EXPR est vraie.	Iff (isBlank (ASSUM.Infl), *ACCT.this [time = this - 12] (1.05)** , F)	Si l'hypothèse du taux d'inflation est vide, prenez la valeur de ce compte il y a 12 mois et multipliez-la par 1,05.
Remplacez F par un calcul qui se déclenche si la valeur EXPR est fausse.	Iff (isBlank (ASSUM.Infl), ACCT.this [time = this - 12] * (1.05), *ACCT.this [time = this - 12] ASSUM.Infl** )	Si l'hypothèse Taux d'inflation n'est pas vide, prenez la valeur de ce compte datant de 12 mois il y a 12 mois et multipliez-la par l'hypothèse Taux d'inflation.

Dans l'assistant de formule, nous répartissons les fonctions de formule dans les groupes suivants :

Mathématique

Logique

Date

String

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

Positionnement dans la grille

Une formule existe dans la grille d'Adaptive Planning. Une feuille de calcul classique comporte deux axes : Comptes et Temps. Les comptes sont présentés en lignes et le temps est affiché dans la colonne. Chaque cellule représente une intersection spécifique 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 du compte Produit existent à l'intersection du périmètre Ventes, de la version Budget 2025, du compte Produit dans la hiérarchie du Grand livre, de la valeur de 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 dimensions. Sauf si vous spécifiez 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 en référence
Temps et Périmètre	Identique au site actuel, sauf si vous modifiez votre référence avec le temps ou le périmètre. Exemple : la formule pour ACCT.001 est ACCT.002 × 10. Pour janvier 2024, la formule prend la valeur ACCT.002 pour janvier 2024. Pour Fév. 2024, elle prend la valeur du 24 février, et ainsi de suite, sauf si vous indiquez quelque chose de différent pour le temps dans la formule. Pour les périmètres, même valeur. Les calculs extraient les valeurs du même périmètre que celui qui est actuellement calculé.
Devise	La devise définie pour le périmètre actuel.
Compte	Le compte actuel, sauf si vous référencez un autre compte.
Chaque dimension personnalisée.	Valeur de dimension à l'emplacement actuel. Si aucune valeur de dimension n'existe à l'emplacement actuel, la valeur par défaut est la valeur Sans catégorie.