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 total des 'aimer' 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("hello world") }} → "HELLO WORLD" ('texte')
• LOWERCASE(texte) : Convertit le 'texte' en minuscules.
  • Exemple : {{ LOWERCASE("HELLO") }} → "hello" ('texte')
• CAPITALIZE(texte) : Met la première lettre de la chaîne en majuscule.
  • Exemple : {{ CAPITALIZE("ideanote") }} → "Ideanote" ('texte')
• TRIM(texte) : Supprime les espaces de début et de fin de la chaîne.
  • Exemple : {{ TRIM(" idea collection ") }} → "collecte d'idées" ('texte')
• REPLACE(texte, recherche, remplacement) : Remplace une partie d'une chaîne par une autre chaîne.
  • Exemple : {{ REPLACE("Innovation Hub", "Hub", "Center") }} → "Innovation Center" ('texte')
• TRUNCATE(texte, longueur) : Raccourcit une chaîne à une longueur spécifique.
  • Exemple : {{ TRUNCATE("Welcome to the innovation program!", 10) }} → "Welcome to..." ('texte')
• CONCAT(...chaînes) : Combine plusieurs chaînes de 'texte' en une seule.
  • Exemple : {{ CONCAT("Hello, ", "world") }} → "Hello, world" ('texte')
• REPEAT(texte, compte) : Répète une chaîne un 'nombre' spécifique de fois.
  • Exemple : {{ REPEAT("Hi! ", 3) }} → "Hi! Hi! Hi!" ('texte')
• APPEND(texte, suffixe) : Ajoute un suffixe à la fin d'une chaîne.
  • Exemple : {{ APPEND("hello", ", world") }} → "hello, world" ('texte')
• PREPEND(texte, préfixe) : Ajoute un préfixe au début d'une chaîne.
  • Exemple : {{ PREPEND("world", "hello, ") }} → "hello, world" ('texte')
• STARTS_WITH(texte, recherche) : Indique si une chaîne commence par une autre chaîne.
  • Exemple : {{ STARTS_WITH("hello", "he") }} → true ('booléen')
• ENDS_WITH(texte, recherche) : Indique si une chaîne se termine par une autre chaîne.
  • Exemple : {{ ENDS_WITH("hello", "lo") }} → true ('booléen')
• INCLUDES(texte, recherche) : Vérifie si une chaîne contient une autre chaîne.
  • Exemple : {{ INCLUDES("hello", "ell") }} → true ('booléen')
• LENGTH(texte) : Renvoie la longueur du 'texte'.
  • Exemple : {{ LENGTH("Ideas") }} → 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, diminuende) : 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 d'Utilitaire

• 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("world", "hello, ") }} → "hello, world" ('texte')
• SUFFIX(texte, suffixe) : Ajoute un suffixe à la fin d'une chaîne.
  • Exemple : {{ SUFFIX("hello", ", world") }} → "hello, world" ('texte')

Conseils de Gestion des Erreurs

1. Vérifier les valeurs nulles : Assurez-vous que les variables que vous utilisez existent.
2. Éviter la division par zéro : Utilisez MAX pour vous assurer que les diviseurs ne sont jamais zéro, par exemple en écrivant {{ DIVIDE(10, MAX(value, 1)) }}.
3. Faire correspondre les parenthèses : Assurez-vous que toutes les fonctions et conditions ont des parenthèses correspondantes.
4. Examiner les messages d'erreur : Survoler 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'.