Fonctions

Les expressions dynamiques deviennent plus puissantes grâce à l'utilisation de fonctions. Ces outils intégrés vous aident à effectuer des calculs, à transformer du texte et à formater des données, vous permettant de créer un contenu plus dynamique et personnalisé.

Que Sont les Fonctions ?

Les fonctions dans les expressions dynamiques sont des commandes spéciales qui prennent des valeurs d'entrée (appelées arguments) et renvoient un résultat. Elles peuvent être utilisées pour des opérations mathématiques, la manipulation de texte et des décisions basées sur la logique.

Les fonctions sont écrites entre accolades {{ ... }} et peuvent être combinées avec des variables de données, des littéraux et des opérateurs.

Exemple : {{ ROUND(AVERAGE(sessionUser.stats.likes, 10)) }} – cet exemple calcule la moyenne entre le nombre total de « likes » de l'utilisateur et le nombre 10, et arrondit le résultat au nombre entier le plus proche.

Fonctions de Manipulation de Texte

• UPPERCASE(texte) : Convertit le texte en majuscules.
  • Exemple : {{ UPPERCASE("bonjour monde") }} → "BONJOUR MONDE" (texte)
• LOWERCASE(texte) : Convertit le texte en minuscules.
  • Exemple : {{ LOWERCASE("BONJOUR") }} → "bonjour" (texte)
• CAPITALIZE(texte) : Met en majuscule la première lettre de la chaîne.
  • Exemple : {{ CAPITALIZE("ideanote") }} → "Ideanote" (texte)
• TRIM(texte) : Supprime les espaces de début et de fin de la chaîne.
  • Exemple : {{ TRIM(" collecte d'idées ") }} → "collecte d'idées" (texte)
• REPLACE(texte, recherche, remplacement) : Remplace une partie d'une chaîne par une autre chaîne.
  • Exemple : {{ REPLACE("Pôle Innovation", "Pôle", "Centre") }} → "Centre Innovation" (texte)
• TRUNCATE(texte, longueur) : Raccourcit une chaîne à une longueur spécifique.
  • Exemple : {{ TRUNCATE("Bienvenue au programme d'innovation !", 10) }} → "Bienvenue ..." (texte)
• CONCAT(...chaînes) : Combine plusieurs chaînes de texte en une seule.
  • Exemple : {{ CONCAT("Bonjour, ", "monde") }} → "Bonjour, monde" (texte)
• REPEAT(texte, compte) : Répète une chaîne un nombre spécifique de fois.
  • Exemple : {{ REPEAT("Salut ! ", 3) }} → "Salut ! Salut ! Salut !" (texte)
• APPEND(texte, suffixe) : Ajoute un suffixe à la fin d'une chaîne.
  • Exemple : {{ APPEND("bonjour", ", monde") }} → "bonjour, monde" (texte)
• PREPEND(texte, préfixe) : Ajoute un préfixe au début d'une chaîne.
  • Exemple : {{ PREPEND("monde", "bonjour, ") }} → "bonjour, monde" (texte)
• STARTS_WITH(texte, recherche) : Indique si une chaîne commence par une autre chaîne.
  • Exemple : {{ STARTS_WITH("bonjour", "bo") }} → true (booléen)
• ENDS_WITH(texte, recherche) : Indique si une chaîne se termine par une autre chaîne.
  • Exemple : {{ ENDS_WITH("bonjour", "jour") }} → true (booléen)
• INCLUDES(texte, recherche) : Vérifie si une chaîne contient une autre chaîne.
  • Exemple : {{ INCLUDES("bonjour", "onj") }} → true (booléen)
• LENGTH(texte) : Renvoie la longueur du texte.
  • Exemple : {{ LENGTH("Idées") }} → 5 (nombre)

Fonctions Mathématiques

• ABS(nombre) : Renvoie la valeur absolue (non négative) d'un nombre.
  • Exemple : {{ ABS(-15) }} → 15 (nombre)
• ADD(...nombres) : Renvoie la somme d'une liste de nombres.
  • Exemple : {{ ADD(1, 2, 3) }} → 6 (nombre)
• SUBTRACT(nombre, soustracteur) : Renvoie le résultat de la soustraction de deux nombres.
  • Exemple : {{ SUBTRACT(10, 2) }} → 8 (nombre)
• MULTIPLY(nombre, multiplicateur) : Renvoie le résultat de la multiplication de deux nombres.
  • Exemple : {{ MULTIPLY(2, 3) }} → 6 (nombre)
• DIVIDE(nombre, diviseur) : Divise un nombre par un autre.
  • Exemple : {{ DIVIDE(10, 2) }} → 5 (nombre)
• MOD(nombre, diviseur) : Renvoie le reste de la division de deux nombres.
  • Exemple : {{ MOD(10, 3) }} → 1 (nombre)
• ROUND(nombre) : Arrondit un nombre à l'entier le plus proche.
  • Exemple : {{ ROUND(4.7) }} → 5 (nombre)
• CEIL(nombre) : Renvoie le plus petit entier supérieur ou égal à un nombre.
  • Exemple : {{ CEIL(1.5) }} → 2 (nombre)
• FLOOR(nombre) : Renvoie le plus grand entier inférieur ou égal à un nombre.
  • Exemple : {{ FLOOR(1.5) }} → 1 (nombre)
• MAX(...nombres) : Renvoie le plus grand nombre de la liste.
  • Exemple : {{ MAX(10, 20, 5) }} → 20 (nombre)
• MIN(...nombres) : Renvoie le plus petit nombre de la liste.
  • Exemple : {{ MIN(10, 20, 5) }} → 5 (nombre)
• POW(nombre, exposant) : Renvoie le résultat de l'élévation d'un nombre à la puissance d'un autre nombre.
  • Exemple : {{ POW(2, 3) }} → 8 (nombre)
• AVERAGE(...nombres) : Renvoie la moyenne d'une liste de nombres.
  • Exemple : {{ AVERAGE(1, 2, 3) }} → 2 (nombre)

Fonctions de Formatage et Utilitaires

• FORMAT(valeur) : Formate une valeur (telle qu'un nombre ou une date) selon les préférences de l'utilisateur.
  • Exemple : {{ FORMAT(10000) }} → "10 000" (texte)
• PREFIX(texte, préfixe) : Ajoute un préfixe au début d'une chaîne.
  • Exemple : {{ PREFIX("monde", "bonjour, ") }} → "bonjour, monde" (texte)
• SUFFIX(texte, suffixe) : Ajoute un suffixe à la fin d'une chaîne.
  • Exemple : {{ SUFFIX("bonjour", ", monde") }} → "bonjour, monde" (texte)

Conseils de Gestion des Erreurs

1. Vérifiez les valeurs nulles : Assurez-vous que les variables que vous utilisez existent.
2. Évitez la division par zéro : Utilisez MAX pour vous assurer que les diviseurs ne sont jamais nuls, par exemple en écrivant {{ DIVIDE(10, MAX(valeur, 1)) }}.
3. Faites correspondre les parenthèses : Assurez-vous que toutes les fonctions et les conditions ont des parenthèses correspondantes.
4. Examinez les messages d'erreur : Passer la souris sur une valeur "Non calculée" dans votre espace de travail peut fournir des indices sur la cause sous-jacente.

En maîtrisant ces fonctions, vous pouvez transformer votre espace de travail en un environnement entièrement dynamique, personnalisé et efficace qui s'adapte aux entrées et aux données de l'utilisateur.