Syntaxe des formules

À quoi sert l’éditeur de formule

L’éditeur de formule vous permet de construire un calcul personnalisé à partir de jetons saisis — opérateurs, nombres et références à des lignes, inducteurs, sous-positions et KPI. Même éditeur, même syntaxe, sur chaque méthode Formule partout dans l’application : lignes de Planification, inducteurs Planification, KPI et dashboards personnalisés.

En bref

Tapez un nombre ou un opérateur pour déposer un jeton. Tapez un nom pour autocompléter une référence. Chaque référence porte un décalage temporel optionnel (mois courant / mois précédent / il y a 1 an / Personnalisé) et, avec l’extension Départements, une source pour les références cross-département.

Jetons

Une formule est une séquence plate de jetons. La grille rend chaque jeton comme une pastille ; Backspace sur un champ vide retire la dernière pastille.

Nombres

Tapez n’importe quel nombre (100, 0.05, -1.2) et appuyez sur Entrée pour le déposer comme jeton numérique.

Opérateurs

Les cinq opérateurs binaires et les parenthèses :

+   -   *   /   ^   (   )

Tapez-en un avec le champ vide et l’éditeur l’insère immédiatement. Tapez une séquence comme (price * volume) / 12 et appuyez sur Entrée à chaque jeton.

Fonctions

Trois fonctions sont disponibles. Tapez le nom et l’éditeur dépose un squelette de fonction à compléter :

  • abs( ) — valeur absolue d’une seule expression, par exemple abs(Revenues - Plan).
  • min( , ) — la plus petite de deux expressions, par exemple min(Cash, 0).
  • max( , ) — la plus grande de deux expressions, par exemple max(EBT, 0).

abs prend un argument ; min et max en prennent exactement deux et comparent les valeurs dans la même période (elles n’opèrent pas sur une fenêtre glissante).

Références

Commencez à taper le nom d’une position, sous-position, compte, inducteur ou KPI. Le menu d’autocomplétion se rétrécit à chaque frappe ; appuyez sur Entrée pour insérer la meilleure correspondance, ou cliquez sur n’importe quel résultat pour l’insérer directement. Dans la formule, la référence se rend comme une pastille avec le libellé de la ligne.

Les références se choisissent dans un sélecteur groupé par source : P&L, BS, CF, KPI, plus inducteurs et sous-positions auxiliaires. Avec l’extension Départements, un onglet de source supplémentaire apparaît (voir Références cross-département plus bas).

Décalages temporels

Chaque référence porte un décalage temporel — la période d’où la référence lit, relative à la cellule courante.

Cliquez sur la pastille de décalage sur n’importe quelle pastille de référence pour choisir :

  • mois courant — month(0) (par défaut)
  • mois précédent — month(-1)
  • il y a 1 an — month(-12)
  • Personnalisé — ouvre une fenêtre où vous réglez un nombre de mois et une direction (suivant / précédent), ce qui rend accessibles par exemple month(-3) ou month(+6)

Les décalages temporels sont résolus au moment de l’évaluation : Revenues@month(-12) lit la valeur de Chiffre d’affaires douze mois avant la cellule en cours de calcul.

Fenêtres d’agrégation

En plus d’un décalage temporel, chaque référence peut porter une agrégation sur fenêtre glissante — au lieu de lire une seule période, la référence lit une fenêtre glissante et la réduit à une seule valeur. Cliquez sur la commande d’agrégation sur une pastille de référence pour choisir :

  • Somme — totalise la référence sur la fenêtre (se rend par exemple sous la forme Σ 12M).
  • Moyenne — la moyenne de la référence sur la fenêtre (se rend par exemple sous la forme avg 3M).

La longueur de la fenêtre est L3M (3 derniers mois), L6M, L12M ou Personnalisé (définissez votre propre nombre de mois). Une Somme sur L12M donne un total sur les douze derniers mois glissants ; une Moyenne sur L3M lisse une série mensuelle bruitée. L’agrégation se combine avec le décalage temporel — la fenêtre est mesurée à rebours depuis la période de décalage.

Références cross-département

Dans les contextes qui couvrent plusieurs départements (extension Départements), le sélecteur expose un onglet de source supplémentaire au-dessus de la liste de références :

  • Départements — choisissez la tranche d’un département précis comme source. Les références cross-département se rendent avec un préfixe de code court sur la pastille pour voir quel département est lu.
  • Tous les départements — une option agrégée qui somme la référence sur tous les départements.

La pastille n’expose que le code court de la source ; l’onglet de source dans le sélecteur est l’endroit où on le change.

Contrôles de l’éditeur

Dans l’éditeur :

  • Entrée — insérer le jeton tapé (nombre / opérateur / meilleure correspondance d’autocomplétion), ou valider la formule quand le champ est vide
  • Échap — abandonner l’édition courante
  • Backspace sur champ vide — retirer la dernière pastille

Validation

statycs valide les formules en continu. Les erreurs apparaissent comme un badge rouge ! à côté de la formule, avec une infobulle décrivant la cause :

  • Référence circulaire — la formule référence sa propre ligne, directement. Les cycles transitifs (A → B → A entre positions) ne sont pas détectés aujourd’hui.
  • Référence cassée — la ligne, sous-position ou inducteur vers lequel pointe la formule n’existe plus. Ouvrez la formule et retirez ou remplacez la pastille.
  • Division par zéro — le dénominateur s’évalue à zéro sur une ou plusieurs périodes. Encadrez le dénominateur d’un garde ou choisissez une autre référence.
  • Décalage hors plage de données — un décalage temporel (par exemple month(-12)) pointe sur une période avant le début des données disponibles. Apparaît comme un avertissement ; soit réduisez le décalage, soit acceptez les périodes manquantes.

Les erreurs ne bloquent pas l’enregistrement. Les cellules affectées s’évaluent à zéro tant que l’erreur n’est pas corrigée, donc une formule partiellement cassée ne vous empêche pas d’avancer — elle ne contribue simplement pas de valeur.

Liens utiles