Utiliser l’éditeur d’expression avancé about-the-advanced-expression-editor
Utilisez l’éditeur d’expression avancé de Journey pour créer des expressions avancées dans divers écrans de l’interface. Par exemple, vous pouvez créer des expressions lors de la configuration et de l’utilisation de parcours, ainsi que lors de la définition d’une condition de source de données.
Il est également disponible chaque fois que vous devez définir des paramètres d’action qui nécessitent des manipulations de données spécifiques. Vous pouvez exploiter les données issues d’événements ou d’informations supplémentaires récupérées de la source de données. Dans un parcours, la liste des champs d’événements affichée est contextuelle et varie selon le ou les événements ajoutés dans le parcours.
L’éditeur d’expression avancé propose un ensemble de fonctions et d’opérateurs intégrés qui vous permettent de manipuler des valeurs et de définir une expression qui répond spécifiquement à vos besoins. L’éditeur d’expression avancé vous permet également de définir les valeurs du paramètre de source de données externe et de manipuler les champs de mappage et les collections.
Accéder à l’éditeur d’expression avancé accessing-the-advanced-expression-editor
L’éditeur d’expression avancé peut être utilisé pour effectuer ce qui suit :
- Créer des conditions avancées pour des sources de données et des informations d’événements.
- Définir des activités Attente personnalisées.
- Définir le mappage de paramètres d’actions.
Lorsque cela est possible, vous pouvez basculer entre les deux modes à l’aide du bouton Mode avancé/Mode simple. Le mode simple est décrit ici.
-
Les conditions peuvent être définies dans l’éditeur d’expression simple ou l’éditeur d’expression avancé. Elles renvoient toujours un type booléen.
-
Les paramètres d’actions peuvent être définis en sélectionnant des champs ou à l’aide de l’éditeur d’expression avancé. Ils renvoient un type de données spécifique en fonction de leur expression.
Vous pouvez accéder à l’éditeur d’expression avancé de différentes manières :
-
Lorsque vous créez une condition de source de données, vous pouvez accéder à l’éditeur avancé en cliquant sur Mode avancé.
-
Lorsque vous créez un retardateur personnalisé, l’éditeur avancé s’affiche automatiquement.
-
Lorsque vous mappez un paramètre d’action, cliquez sur Mode avancé.
Découvrir l’interface discovering-the-interface
Cet écran vous permet d’écrire manuellement votre expression.
Dans la partie gauche de l’écran, les champs et les fonctions disponibles sont affichés :
-
Événements : choisissez l’un des champs reçus à partir de l’événement entrant. La liste des champs d’événements affichée est contextuelle et varie selon le ou les événements ajoutés dans le parcours. En savoir plus
note caution CAUTION La création d’expressions à l’aide d’événements d’expérience n’est pas prise en charge. Les autres approches et bonnes pratiques pour créer des expressions et des logiques avec des événements d’expérience sont référencées ici. -
Audiences : si vous avez déposé un événement de qualification d’audience, choisissez l’audience à utiliser dans votre expression. En savoir plus
-
Sources de données : choisissez dans la liste des champs disponibles issue des groupes de champs de vos sources de données. En savoir plus
-
Propriétés du parcours : cette section regroupe les champs techniques liés au parcours pour un profil donné. En savoir plus
-
Fonctions : choisissez dans la liste des fonctions intégrées qui permettent d’effectuer un filtrage complexe. Les fonctions sont organisées par catégories. En savoir plus
Un mécanisme d’autocomplétion affiche des suggestions contextuelles.
Un mécanisme de validation de la syntaxe vérifie l’intégrité de votre code. Les erreurs s’affichent en haut de l’éditeur.
Des paramètres sont requis lors de la création de conditions avec l’éditeur d’expression avancé.
Si vous sélectionnez un champ d’une source de données externe qui nécessite l’appel d’un paramètre (voir cette page), un nouvel onglet s’affiche à droite pour vous permettre de spécifier ce paramètre. La valeur du paramètre peut provenir des événements situés dans le parcours ou de la source de données Experience Platform (et non d’autres sources de données externes). Par exemple, dans une source de données météorologique, un paramètre fréquemment utilisé est « ville ». Par conséquent, vous devez sélectionner l’emplacement où vous souhaitez avoir ce paramètre « ville ». Des fonctions peuvent également être appliquées aux paramètres pour effectuer des modifications de format ou des concaténations.
Dans les cas d’utilisation plus complexes, si vous souhaitez inclure les paramètres de la source de données dans l’expression principale, vous pouvez définir leurs valeurs à l’aide du mot-clé « params ». Consultez cette page.
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 introduces the Journey advanced expression editor — its access points, interface panels, and capabilities for building complex conditions, custom wait timers, and action parameter mappings using events, data sources, functions, and operators.
Intents:
- Access the advanced expression editor from a data source condition, custom wait activity, or action parameter mapping
- Build advanced boolean conditions using event fields, data source fields, audience membership, and journey properties
- Switch between simple mode and advanced mode when configuring conditions
- Reference external data source parameters directly within the main expression using the
paramskeyword - Use AI-powered expression generation to create expressions from natural language prompts
Glossary:
- Advanced expression editor: The Journey Optimizer code editor for writing complex expressions; distinct from the simpler point-and-click condition editor (product-specific)
- Simple mode: A point-and-click condition editor; less flexible than the advanced editor but easier for non-developers (product-specific)
- Journey properties: Technical fields about the journey instance (ID, version, errors, current node) accessible in the expression editor (product-specific)
- Generate expressions with AI: An AI-powered capability (public beta) inside the advanced editor that generates expressions from plain language prompts (product-specific)
Guardrails:
- Creating expressions using experience events directly is not supported — use alternative approaches such as computed attributes
- Conditions always return a boolean type regardless of editor mode
- Expressions must not contain hidden or non-printable characters, and should use single-line format to avoid parsing errors
- External data source parameter values can only come from journey events or the Experience Platform data source — not from other external data sources
- The advanced expression editor functions differ from those in the personalization editor
Terminology:
- Canonical name: Advanced Expression Editor — Acronym: none — variants: advanced editor, expression editor
- Synonyms: “Advanced mode” = “advanced expression editor”
- Do not confuse: advanced expression editor (journey conditions/actions) ≠ personalization editor (message content personalization)
FAQ:
- Q: When must I use the advanced expression editor instead of the simple mode? — Use the advanced editor when you need to query collections, use functions, reference journey properties, or build multi-condition logic that the simple editor cannot express.
- Q: How do I pass a parameter to an external data source in the expression? — Use the
paramskeyword in the expression syntax, e.g.#{DataSource.fieldGroup.field, params: {paramName: value}}. - Q: What does the autocompletion mechanism do? — It displays contextual field and function suggestions as you type, helping you build valid expressions faster.
- Q: Where is Generate expressions with AI accessed? — Via the AI control inside the advanced expression editor; it is currently in public beta.
- Q: Do conditions in the advanced editor return a different type than in simple mode? — No; conditions always return a boolean in both modes.