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 s’écrivent 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 mentions J'aime de l'utilisateur et le nombre 10, puis arrondit le résultat à l'entier le plus proche.

Fonctions de Manipulation de Texte

• UPPERCASE(text) : Convertit le texte en majuscules.
  • Exemple : {{ UPPERCASE("hello world") }} → "HELLO WORLD" (texte)
• LOWERCASE(text) : Convertit le texte en minuscules.
  • Exemple : {{ LOWERCASE("HELLO") }} → "hello" (texte)
• CAPITALIZE(text) : Met en majuscule la première lettre de la chaîne.
  • Exemple : {{ CAPITALIZE("ideanote") }} → "Ideanote" (texte)
• TRIM(text) : Supprime les espaces au début et à la fin de la chaîne.
  • Exemple : {{ TRIM(" idea collection ") }} → "idea collection" (texte)
• REPLACE(text, search, replace) : Remplace une partie d’une chaîne par une autre chaîne.
  • Exemple : {{ REPLACE("Innovation Hub", "Hub", "Center") }} → "Innovation Center" (texte)
• TRUNCATE(text, length) : Raccourcit une chaîne à une longueur précise.
  • Exemple : {{ TRUNCATE("Welcome to the innovation program!", 10) }} → "Welcome to..." (texte)
• CONCAT(...strings) : Combine plusieurs chaînes de texte en une seule.
  • Exemple : {{ CONCAT("Hello, ", "world") }} → "Hello, world" (texte)
• REPEAT(text, count) : Répète une chaîne un nombre précis de fois.
  • Exemple : {{ REPEAT("Hi! ", 3) }} → "Hi! Hi! Hi!" (texte)
• APPEND(text, suffix) : Ajoute un suffixe à la fin d’une chaîne.
  • Exemple : {{ APPEND("hello", ", world") }} → "hello, world" (texte)
• PREPEND(text, prefix) : Ajoute un préfixe au début d’une chaîne.
  • Exemple : {{ PREPEND("world", "hello, ") }} → "hello, world" (texte)
• STARTS_WITH(text, search) : Renvoie une valeur indiquant si une chaîne commence par une autre chaîne.
  • Exemple : {{ STARTS_WITH("hello", "he") }} → true (booléen)
• ENDS_WITH(text, search) : Renvoie une valeur indiquant si une chaîne se termine par une autre chaîne.
  • Exemple : {{ ENDS_WITH("hello", "lo") }} → true (booléen)
• INCLUDES(text, search) : Vérifie si une chaîne contient une autre chaîne.
  • Exemple : {{ INCLUDES("hello", "ell") }} → true (booléen)
• LENGTH(text) : Renvoie la longueur du texte.
  • Exemple : {{ LENGTH("Ideas") }} → 5 (nombre)

Fonctions Mathématiques

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

Fonctions de Formatage et d'Utilitaire

• FORMAT(value) : Met en forme une valeur (telle qu’un nombre ou une date) selon les préférences de l’utilisateur.
  • Exemple : {{ FORMAT(10000) }} → "10,000" (texte)
• PREFIX(text, prefix) : Ajoute un préfixe au début d’une chaîne.
  • Exemple : {{ PREFIX("world", "hello, ") }} → "hello, world" (texte)
• SUFFIX(text, suffix) : 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. Évitez la division par zéro : utilisez MAX pour vous assurer que les diviseurs ne sont jamais égaux à 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'.