Fonctions

Les expressions dynamiques gagnent en puissance grâce à l'utilisation de fonctions. Ces outils intégrés vous aident à effectuer des calculs, à transformer du texte et à mettre en forme des données, ce qui vous permet de créer un contenu plus dynamique et personnalisé.

Que sont les fonctions ?

Les fonctions des expressions dynamiques sont des commandes spéciales qui prennent des valeurs d'entrée (appelées arguments) et renvoient un résultat. Ils peuvent être utilisés 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 peut être combiné 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 chiffre 10, et arrondit le résultat au nombre entier le plus proche.

Fonctions de manipulation de texte

• MAJUSCULES (texte): convertit le texte en majuscules.
  • Exemple : {{UPPERCASE (« Bonjour tout le monde »)}} → « BONJOUR TOUT LE MONDE » (texte)
• MINUSCULE (texte): convertit le texte en minuscules.
  • Exemple : {{LOWERCASE (« BONJOUR »)}} → « bonjour » (texte)
• CAPITALISER (texte): met en majuscule la première lettre de la chaîne.
  • Exemple : {{CAPITALIZE (« idéanote »)}} → « Ideanote » (texte)
• TRIM (texte): Supprime les espaces de début et de fin de la chaîne.
  • Exemple : {{TRIM (» collection d'idées «)}} → « collection d'idées » (texte)
• REMPLACER (texte, recherche, remplacement): remplace une partie d'une chaîne par une autre chaîne.
  • Exemple : {{REPLACE (« Pôle d'innovation », « Pôle », « Centre »)}} → « Centre d'innovation » (texte)
• TRONQUER (texte, longueur): permet de raccourcir une chaîne à une longueur spécifique.
  • Exemple : {{TRUNCATE (« Bienvenue dans le programme d'innovation ! » , 10)}} → « Bienvenue chez... » (texte)
• CONCAT (... chaînes): combine plusieurs chaînes de texte en une seule.
  • Exemple : {{CONCAT (« Bonjour », « tout le monde »)}} → « Bonjour tout le monde » (texte)
• RÉPÉTER (texte, compter): Répète une chaîne un certain nombre de fois.
  • Exemple : {{REPEAT (« Bonjour ! «, 3)}} → « Bonjour ! Bonjour ! Bonjour ! » (texte)
• AJOUTER (texte, suffixe): ajoute un suffixe à la fin d'une chaîne.
  • Exemple : {{APPEND (« bonjour », «, tout le monde »)}} → « Bonjour tout le monde » (texte)
• PREPEND (texte, préfixe): ajoute un préfixe au début d'une chaîne.
  • Exemple : {{PREPEND (« monde », « bonjour »)}} → « Bonjour tout le monde » (texte)
• STARTS_WITH (texte, recherche): Indique si une chaîne commence par une autre chaîne.
  • Exemple : {{STARTS_WITH (« bonjour », « il »)}} → vrai (booléen)
• ENDS_WITH (texte, recherche): Indique si une chaîne se termine par une autre chaîne.
  • Exemple : {{ENDS_WITH (« bonjour », « lo »)}} → vrai (booléen)
• COMPREND (texte, recherche): Vérifie si une chaîne contient une autre chaîne.
  • Exemple : {{INCLUDES (« bonjour », « ell »)}} → vrai (booléen)
• LONGUEUR (texte): Renvoie la longueur du texte.
  • Exemple : {{LENGTH (« Idées »)}} → 5 (chiffre)

Fonctions mathématiques

• ABS (numéro): Renvoie la valeur absolue (non négative) d'un nombre.
  • Exemple : {{POUCES (-15)}} → 15 (numéro)
• AJOUTER (... chiffres): Renvoie la somme d'une liste de nombres.
  • Exemple : {{AJOUTER (1, 2, 3)}} → 6 (numéro)
• SOUSTRAIRE (nombre, sous-tranche): Renvoie le résultat de la soustraction de deux nombres.
  • Exemple : {{SOUSTRAIRE (10, 2)}} → 8 (chiffre)
• MULTIPLIER (nombre, multiplicateur): Renvoie le résultat de la multiplication de deux nombres.
  • Exemple : {{MULTIPLIER (2, 3)}} → 6 (numéro)
• DIVISER (nombre, diviseur): Divise un nombre par un autre.
  • Exemple : {{DIVISER (10, 2)}} → 5 (chiffre)
• MOD (nombre, diviseur): Renvoie le reste de la division de deux nombres.
  • Exemple : {{MOD (10 ET 3)}} → 1 (chiffre)
• ROND (chiffre): Arrondit un nombre au nombre entier le plus proche.
  • Exemple : {{ROUND (4.7)}} → 5 (chiffre)
• CEIL (numéro): Renvoie le plus petit entier supérieur ou égal à un nombre.
  • Exemple : {{PLAFOND (1.5)}} → 2 (numéro)
• ÉTAGE (numéro): Renvoie le plus grand entier inférieur ou égal à un nombre.
  • Exemple : {{ÉTAGE (1.5)}} → 1 (chiffre)
• MAX (... chiffres): Renvoie le plus grand nombre de la liste.
  • Exemple : {{MAXIMUM (10, 20, 5)}} → 20 (numéro)
• MIN (... chiffres): Renvoie le plus petit nombre de la liste.
  • Exemple : {{MINUTES (10, 20, 5)}} → 5 (chiffre)
• POW (nombre, exposant): Renvoie le résultat de l'augmentation d'un nombre à la puissance d'un autre nombre.
  • Exemple : {{POW (2, 3)}} → 8 (chiffre)
• MOYENNE (... chiffres): Renvoie la moyenne d'une liste de nombres.
  • Exemple : {{MOYENNE (1, 2, 3)}} → 2 (numéro)

Formatage et fonctions utilitaires

• FORMAT (valeur): met en forme une valeur (telle qu'un nombre ou une date) en fonction des préférences de l'utilisateur.
  • Exemple : {{FORMAT (10000)}} → « 10 000" (texte)
• PRÉFIXE (texte, préfixe): ajoute un préfixe au début d'une chaîne.
  • Exemple : {{PREFIX (« monde », « bonjour »)}} → « Bonjour tout le monde » (texte)
• SUFFIXE (texte, suffixe): ajoute un suffixe à la fin d'une chaîne.
  • Exemple : {{SUFFIX (« bonjour », «, tout le monde »)}} → « Bonjour tout le monde » (texte)

Conseils pour la gestion des erreurs

1. Vérifiez les valeurs nulles : Assurez-vous que les variables que vous utilisez existent.
2. Évitez de diviser par zéro : Utiliser MAX pour s'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 conditions ont des parenthèses correspondantes.
4. Consultez les messages d'erreur : Le fait de 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 des utilisateurs.