La propriété formule : guide avancé

Faire des calculs entre attributs dans Suivi

6 minutes de lecture

L'éditeur de formules

L'éditeur propose plusieurs aides pour rédiger vos formules :

  • Coloration syntaxique : les fonctions, champs et opérateurs sont colorés pour faciliter la lecture
  • Panneau de fonctions : parcourez les fonctions disponibles par catégorie en cliquant sur les onglets (Attributs, Texte, Nombres, Date, Logique)
  • Recherche : tapez le nom d'une fonction ou d'un attribut pour le retrouver rapidement
  • Aide au survol : survolez une fonction pour voir sa syntaxe, un exemple et sa description
  • Insertion au clic : cliquez sur une fonction ou un attribut pour l'insérer dans votre formule
  • Validation en temps réel : un indicateur vous montre si la formule est valide ou non

Utiliser un attribut dans une formule

Pour utiliser la valeur d'un autre attribut dans votre formule, entourez son nom d'accolades :

{Nom de la propriété}

Le panneau Attributs de l'éditeur liste tous les attributs du board disponibles — cliquez sur l’un d'eux pour l'insérer automatiquement.


Format de sortie

Chaque formule produit un résultat qui peut être affiché de différentes manières. Choisissez le format qui correspond au type de résultat attendu :

Texte

Le résultat est affiché tel quel, sous forme de texte.

Exemple : CONCATENATE({Prénom}, " ", {Nom})Jean Dupont

Nombre

Le résultat est affiché comme un nombre, avec plusieurs variantes :

VarianteDescriptionExemple
BrutNombre simple, avec unité optionnelle42 €, 1 500 kg
PourcentagePourcentage avec barre de progression optionnelle75% ████░░
DuréeNombre accompagné d'une unité de durée3 jours, 8 heures
NotationÉtoiles ou icônes★★★☆☆
ScoreValeur sur un intervalle7 / 10

Options disponibles :

  • Unité et sa position (avant ou après le nombre) — pour le format Brut
  • Précision — nombre de décimales affichées
  • Barre de progression — affichage visuel pour le pourcentage
  • Nombre d'icônes, couleur et type d'icône — pour la notation
  • Minimum/Maximum — pour le score

Date

Le résultat est interprété comme une date et affiché selon le mode choisi (standard, relatif, ISO, etc.).

Exemple : ADD_DAYS({Date de début}, 14)15/05/2026


Fonctions disponibles

Fonctions Texte

FonctionDescriptionExempleRésultat
CONCATENATE(t1, t2, ...)Joint plusieurs textesCONCATENATE({Prénom}, " ", {Nom})Jean Dupont
LEFT(texte, n)Premiers n caractèresLEFT("Bonjour", 3)Bon
RIGHT(texte, n)Derniers n caractèresRIGHT("Bonjour", 4)jour
MID(texte, début, n)Extrait n caractères à partir de la positionMID("Bonjour", 4, 4)jour
LEN(texte)Longueur du texteLEN("Bonjour")7
LOWER(texte)Convertit en minusculesLOWER("HELLO")hello
UPPER(texte)Convertit en majusculesUPPER("hello")HELLO
REPLACE(texte, début, n, nouveau)Remplace une portion de texteREPLACE("Bonjour", 1, 3, "Sal")Saljour
SEARCH(recherche, texte)Vérifie si un texte contient un autreSEARCH("jour", "Bonjour")true
SUBSTITUTE(texte, ancien, nouveau)Remplace toutes les occurrencesSUBSTITUTE("a-b-c", "-", "/")a/b/c

Astuce : L'opérateur + peut aussi servir à concaténer du texte tel que par exemple {Prénom} + " " + {Nom}

Fonctions Nombres

FonctionDescriptionExempleRésultat
SUM(n1, n2, ...)SommeSUM({Effort}, {Bonus})15
AVERAGE(n1, n2, ...)MoyenneAVERAGE(10, 20, 30)20
MIN(n1, n2, ...)Valeur minimaleMIN({Estimation}, {Réel})5
MAX(n1, n2, ...)Valeur maximaleMAX({Estimation}, {Réel})12
ABS(n)Valeur absolueABS(-5)5
ROUND(n, décimales)ArrondiROUND(3.14159, 2)3.14
CEILING(n)Arrondi au supérieurCEILING(4.3)5
FLOOR(n)Arrondi à l'inférieurFLOOR(4.7)4
MOD(n, diviseur)Reste de la divisionMOD(10, 3)1
POWER(base, exposant)PuissancePOWER(2, 3)8
SQRT(n)Racine carréeSQRT(16)4
EXP(n)Exponentielle (e^n)EXP(1)2.718...
LOG(n, base)Logarithme (base 10 par défaut)LOG(100, 10)2

Opérateurs arithmétiques : +, -, *, /, ^ (puissance)

Fonctions Date

FonctionDescriptionExempleRésultat
TODAY()Date du jourTODAY()2026-04-29
NOW()Date et heure actuellesNOW()2026-04-29T14:30:00
DAYS(fin, début)Nombre de jours entre deux datesDAYS({Échéance}, TODAY())15
ADD_DAYS(date, n)Ajoute n jours à une dateADD_DAYS(TODAY(), 7)2026-05-06
YEAR(date)Extrait l'annéeYEAR({Date de création})2026
MONTH(date)Extrait le mois (1 à 12)MONTH({Date de création})4
WEEKDAY(date)Jour de la semaine (1=dim … 7=sam)WEEKDAY(TODAY())4
HOUR(date)Extrait l'heureHOUR({Horodatage})14
MINUTE(date)Extrait les minutesMINUTE({Horodatage})30
SECOND(date)Extrait les secondesSECOND({Horodatage})0
FORMAT_DATE(date, format)Formate une dateFORMAT_DATE(TODAY(), "dd/MM/yyyy")29/04/2026
FORMAT_DURATION(secondes)Convertit des secondes en HH:MM:SSFORMAT_DURATION(3661)01:01:01

Fonctions Logique

FonctionDescriptionExempleRésultat
IF(condition, alors, sinon)Si… alors… sinonIF({Points} > 10, "Élevé", "Bas")Élevé
AND(c1, c2, ...)Vrai si toutes les conditions sont vraiesAND({Actif}, {Validé})true
OR(c1, c2, ...)Vrai si au moins une condition est vraieOR({Urgent}, {Bloqué})true
NOT(condition)Inverse une conditionNOT({Archivé})true
SWITCH(expr, v1, r1, …, défaut)Aiguillage multi-valeursSWITCH({Priorité}, "Haute", 3, "Moyenne", 2, 1)3
ISBLANK(valeur)Vrai si la valeur est videISBLANK({Description})false
IFERROR(valeur, repli)Valeur de repli en cas d'erreurIFERROR({Prix} / {Quantité}, 0)0

Opérateurs de comparaison : == (égal), != (différent), <, >, <=, >=


Options avancées — Jours ouvrés

Pour les formules utilisant des calculs de dates, vous pouvez activer le mode Jours ouvrés uniquement :

  1. Dans l'éditeur de formules, ouvrez la section Options avancées
  1. Activez Jours ouvrés uniquement
  1. Configurez optionnellement les jours fériés :
    • Ajoutez des dates individuellement via le sélecteur
    • Ou importez une liste de dates via un fichier CSV

Quand cette option est activée :

  • DAYS() ne compte que les jours ouvrés (week-ends et jours fériés exclus)
  • ADD_DAYS() ajoute des jours ouvrés (saute les week-ends et jours fériés)

Exemple : Si le lundi est le 29/04/2026, ADD_DAYS(TODAY(), 3) retournera le 04/05/2026 (lundi suivant) au lieu du 02/05/2026, car le samedi et le dimanche sont ignorés.


Ligne de total (Spare Row)

Pour les formules avec un format de sortie Nombre, la ligne de total en bas du tableau affiche automatiquement une agrégation :

VarianteAgrégation affichée
BrutSomme de toutes les valeurs
DuréeSomme de toutes les valeurs
PourcentageMoyenne de toutes les valeurs
NotationMoyenne de toutes les valeurs
ScoreMoyenne de toutes les valeurs

Attributs utilisables dans une formule

Seuls certains types d’attributs peuvent être référencés dans une formule :

Type de propriétéValeur injectée dans la formule
TexteLe contenu textuel
NombreLa valeur numérique
DateLa date au format ISO
TagLes noms des tags, séparés par des virgules
UtilisateurLe nom de l'utilisateur
Numéro autoLa valeur numérique auto-incrémentée
Date de créationLa date de création de l'entité
Date de dernière modificationLa date de dernière modification
Créé parLe nom du créateur
Modifié parLe nom du dernier modificateur
LookupLa valeur miroir, uniquement si la propriété miroir est elle-même d'un type autorisé ci-dessus

Non supportés : Formule, Relation, Fichiers, URL, Checklist, Texte riche, Localisation, Lien vers board, Livrables, Vote, Connexion.


Limites et bonnes pratiques

  • Performances : les formules sont compilées et mises en cache automatiquement. Pour les boards avec beaucoup d’éléments, privilégiez des formules simples
  • NOW() et TODAY() : ces fonctions retournent la date/heure au moment de l'affichage. Elles se mettent à jour à chaque rafraîchissement de la page, mais pas en temps réel
  • Comparaison de dates : les opérateurs <, >, ==, !=, <=, >= fonctionnent directement sur les dates
  • Texte + Nombre : l'opérateur + concatène automatiquement si l'un des opérandes est du texte ("Total: " + {Points}"Total: 42")
  • Valeurs vides : si un attribut référencé n'a pas de valeur, il est traité comme une chaîne vide (""). Utilisez ISBLANK() pour vérifier et IFERROR() pour gérer les erreurs

Articles associés

Cette page a-t-elle été utile ?