Syntaxe de l’éditeur d’expression avancé syntax
Les principes de base de la syntaxe lors de l’utilisation de l’éditeur d’expression avancé sont répertoriés ci-dessous.
Parenthèses et priorité des expressions parentheses-and-expression-priority
Il est possible d’utiliser des parenthèses pour améliorer la lisibilité d’une expression complexe. (<expression>) est l’équivalent de <expression>. Il est également possible d’utiliser des parenthèses pour définir l’ordre d’évaluation et l’associativité.
Les expressions sont évaluées de gauche à droite. L’associativité des opérateurs arithmétiques doit être appliquée : les multiplications et les divisions sont prioritaires sur les additions et les soustractions. Pour imposer un ordre spécifique, il est nécessaire d’ajouter des parenthèses afin de délimiter les opérations. Par exemple :
4 + 2 * 10- « * » a la priorité sur « + » : 2*10 est évalué → 20
- 4 + 20 → 24
(4 + 2) * 10- Les parenthèses modifient la priorité : (4 + 2) est évalué → 6
- 6 * 10 → 60
Sensible à la casse case-sensitivity
Les règles de respect de la casse sont les suivantes :
- Tous les opérateurs (et, ou, etc.) doivent être écrits en minuscules. Par exemple,
<expression1>and<expression2>est une expression valide, contrairement à l’expression<expression1>AND<expression2>. - Tous les noms de fonctions sont sensibles à la casse. Par exemple, inAudience() est valide, contrairement à la fonction INAUDIENCE().
- Les références aux champs et les valeurs constantes respectent la casse : ces éléments ne sont pas intégrés au langage (par opposition aux opérateurs et aux fonctions), mais créés par l’utilisateur.
Type d’expression renvoyé returned-expression-type
Selon le contexte d’utilisation, l’éditeur d’expression peut renvoyer différentes valeurs.
This section contains structured knowledge intended to support interpretation, retrieval, and question answering related to this topic.
For complete understanding, this information should be combined with the documentation on this page. Neither source is intended to stand alone; the page describes the feature, while this section provides additional context that helps disambiguate terminology, intent, applicability, and constraints.
- TL;DR: This page covers the core syntax rules of the Journey advanced expression editor — operator precedence with parentheses, case sensitivity for operators and functions, and the expected return type for each editor context.
Intents:
- Control expression evaluation order by wrapping sub-expressions in parentheses
- Write operators (
and,or,not) in lowercase to avoid syntax errors - Use correctly cased function names (e.g.
inAudience()notINAUDIENCE()) - Understand that conditions must return a boolean, custom timers must return
dateTimeOnly, and action parameter mappings can return any type
Glossary:
- Expression priority: The order in which operators are evaluated; multiplications and divisions take priority over additions and subtractions (product-specific)
- Case sensitivity: In the advanced editor, operators must be lowercase, function names are case-sensitive, and field references are case-sensitive as authored by the user (product-specific)
- dateTimeOnly: The return type required for custom timer (Wait activity) expressions; represents a date-time without a timezone (product-specific)
Guardrails:
- Operators (
and,or,not, etc.) must be written in lowercase — uppercase variants are invalid - All function names are case-sensitive —
inAudience()is valid butINAUDIENCE()is not - Arithmetic follows standard precedence:
*and/evaluate before+and-; use parentheses to override - Conditions always return a boolean; custom timers always return
dateTimeOnly
Terminology:
- Canonical name: Advanced Expression Editor Syntax — Acronym: none — variants: expression syntax, editor syntax
- Synonyms: “expression priority” = “operator precedence”; “parentheses” = “brackets” (in expression context)
- Do not confuse: operator case sensitivity (operators must be lowercase) ≠ field reference case sensitivity (field names are user-authored and case-sensitive as written)
FAQ:
- Q: Does
4 + 2 * 10evaluate to 60 or 24? — It evaluates to 24 because*takes priority over+; use(4 + 2) * 10to get 60. - Q: Can I write
ANDin uppercase in an expression? — No; all operators must be lowercase (and,or,not). - Q: Are function names case-sensitive? — Yes;
inAudience()is valid butINAUDIENCE()is not. - Q: What type must a condition expression return? — A boolean.
- Q: What return type is required for a custom Wait activity timer expression? —
dateTimeOnly.