Opérateurs

Operators are essential building blocks in Dynamic Expressions, allowing you to perform calculations, comparisons, and logical evaluations. These symbols enable your workspace to process data, make decisions, and create interactive content.

Arithmetic Operators‍

Perform basic mathematical operations.

• + (Addition): Adds two numbers or concatenates text strings.
  • Example: {{ 2 + 3 }} → 5
  • Example: {{ "Hello, " + sessionUser.name }} → Hello, John
• - (Subtraction): Subtracts one number from another.
  • Example: {{ 10 - 4 }} → 6
• * (Multiplication): Multiplies two numbers.
  • Example: {{ 5 * 3 }} → 15
• / (Division): Divides one number by another.
  • Example: {{ 10 / 2 }} → 5
  • Note: Division by zero will return an error.
• % (Remainder): Returns the remainder of a division.
  • Example: {{ 10 % 3 }} → 1
• ** (Exponentiation): Raises a number to the power of another.
  • Example: {{ 2 ** 3 }} → 8

Comparison Operators‍

Used to compare values and return true or false.

• == (Equality): Checks if two values are equal.
  • Example: {{ 2 + 2 == 4 }} → true
• != (Inequality): Checks if two values are not equal.
  • Example: {{ sessionUser.stats.ideas != 0 }} → true
• > (Greater than): Checks if the left value is greater than the right.
  • Example: {{ sessionUser.stats.likes > 10 }} → true
• >= (Greater than or equal to): Checks if the left value is greater than or equal to the right.
  • Example: {{ 5 >= 5 }} → true
• < (Less than): Checks if the left value is less than the right.
  • Example: {{ 3 < 10 }} → true
• <= (Less than or equal to): Checks if the left value is less than or equal to the right.
  • Example: {{ sessionUser.stats.ideas <= 20 }} → true

Logical Operators

‍Used to combine multiple conditions.

• && (AND): Returns true if both conditions are true.
  • Example: {{ sessionUser.stats.likes > 10 && sessionUser.stats.ideas > 5 }} → true if both conditions are met.
• || (OR): Returns true if at least one condition is true.
  • Example: {{ sessionUser.rank == 3000 || sessionUser.rank == 5000 }} → true if the user is an Admin or Owner.
• ! (PAS): Inverse la valeur de vérité d'une condition.
  • Exemple : {{! (2 + 2 = 5)}} → vrai

‍Opérateur conditionnel

Il se peut que vous souhaitiez exécuter des branches conditionnelles de vos formules, en fonction des données contextuelles. Par exemple, vous souhaiterez peut-être :

• Utilisez différentes clés de traduction dans la description de votre collection d'idées en fonction du rang de l'utilisateur actuel.
• Définissez différentes valeurs pour une idée dans une action d'automatisation selon qu'elle contient ou non plus qu'un certain nombre de commentaires, par exemple.

Vous pouvez utiliser le conditionnel opérateur dans vos expressions dynamiques pour accomplir ces tâches. L'opérateur conditionnel a la particularité d'accepter trois opérandes.

Sa structure est la suivante : <condition>? <when-true>: <when-false>

Voici un exemple simple : {{SessionUser.stats.likes > 10 ? « Meilleur contributeur » : « Rookie »}}

Vous pouvez placer n'importe quoi dans les deux branches de l'opérateur conditionnel, y compris des variables de traduction personnalisées ou des formules imbriquées complexes.

Par exemple, vous souhaiterez peut-être utiliser différentes variables de traduction personnalisées, en fonction du rang de l'utilisateur actuel :

{{SessionUser.rank >= 3000 ? (SessionUser.Stats.Ideas > 20 ? « Super Admin » : « Admin ») : « Membre »}}

Opérateurs de regroupement

Permet de contrôler l'ordre des opérations en regroupant les expressions entre parenthèses ().

• Exemple : {{(2 + 3) * 4}} → 20
• Sans parenthèses : {{2 + 3 * 4}} → 14
• Remarque : la multiplication est prioritaire.

Conseils de gestion des erreurs pour les opérateurs

• Évitez la division par zéro : Pour éviter les erreurs lors de la division par une variable qui pourrait être nulle, utilisez une logique de repli avec des fonctions telles que MAXIMUM () ou conditionnels.
  • Exemple : au lieu de {{10/variable}}, utilisez :{{10/MAX (variable, 1)}} — garantit que le diviseur est au moins égal à 1.
  • Exemple utilisant un conditionnel : {{variable ! = 0 ? 10/variable : « Indéfini (Division par zéro) »}} — affiche un message de repli lorsque le diviseur est égal à zéro.‍
• Vérifiez vos parenthèses : Assurez-vous de fermer toutes les parenthèses qui s'ouvrent.

• Utilisez les opérateurs logiques avec précaution : Vérifiez les conditions pour éviter des résultats inattendus.

En maîtrisant les opérateurs, vous pouvez créer des expressions dynamiques plus complexes et plus attrayantes, permettant à votre espace de travail de réagir intelligemment aux données et aux interactions des utilisateurs.