Documentation Journey Optimizer Guide de Journey Optimizer

Références de champ field-references

Dernière mise à jour : 16 septembre 2026

S'applique à :
Journey Orchestration

Rubriques :
Parcours

Créé pour :

Experienced
Développeur

Il est possible d’associer une référence de champ à un événement ou à un groupe de champs. Les seules informations significatives sont le nom du champ et son chemin d’accès.

Si vous utilisez des caractères spéciaux dans un champ, vous devez avoir recours à des guillemets doubles ou à des guillemets simples. Voici les cas où les guillemets sont nécessaires :

Le champ commence par des caractères numériques.
Le champ commence par le caractère « - ».
Le champ contient d’autres caractères que : a-z, A-Z, 0-9, ,-_

Par exemple, si votre champ est 3h : #{OpenWeather.weatherData.rain.‘3h’} > 0

// event field
@event{<event name>.<XDM path to the field>}
@event{LobbyBeacon.endUserIDs._experience.emailid.id}

// field group
#{<data source name>.<field group name>.<path to the field>}
#{ExperiencePlatform.ProfileFieldGroup.profile.personalEmail.address}

Dans l’expression, les champs d’événement sont référencés par « @ » et les champs de source de données par « # ».

Une couleur de syntaxe permet de distinguer visuellement les champs d’événements (vert) des groupes de champs (bleu).

Valeurs par défaut des références de champ default-value

Il est possible d’associer une valeur par défaut à un nom de champ. La syntaxe se présente comme suit :

// event field
@event{<event name>.<XDM path to the field>, defaultValue: <default value expression>}
@event{LobbyBeacon.endUserIDs._experience.emailid.id, defaultValue: "example@adobe.com"}
// field group
#{<data source name>.<field group name>.<path to the field>, defaultValue: <default value expression>}
#{ExperiencePlatform.ProfileFieldGroup.profile.personalEmail.address, defaultValue: "example@adobe.com"}

NOTE

Le type du champ et la valeur par défaut doivent être identiques. Par exemple, @event{LobbyBeacon.endUserIDs._experience.emailid.id, defaultValue : 2} n’est pas valide, car la valeur par défaut est un entier alors que la valeur attendue doit être une chaîne.

Exemples :

// for an event 'OrderEvent' having the following payload:
{
    "orderId": "12345"
}

expression example:
- @event{OrderEvent.orderId}                                    -> "12345"
- @event{OrderEvent.productId, defaultValue : "not specified" } -> "not specified" // default value, productId is not a field present in the payload
- @event{OrderEvent.productId}                                  -> null


// for an entity 'Profile' on datasource 'ACP' having fields person/lastName, with fetched data such as:
{
    "person": {
        "lastName":"Snow"
    },
    "emails": [
        { "email":"john.snow@winterfell.westeros" },
        { "email":"snow@thewall.westeros" }
    ]
}

expression examples:
- #{ACP.Profile.person.lastName}                 -> "Snow"
- #{ACP.Profile.emails.at(1).email}              -> "snow@thewall.westeros"
- #{ACP.Profile.person.age, defaultValue : -1}   -> -1 // default value, age is not a field present in the payload
- #{ACP.Profile.person.age}                      -> null

Vous pouvez ajouter n’importe quel type d’expression comme valeur par défaut. La seule contrainte est que l’expression doit renvoyer le type de données attendu. Lors de l’utilisation d’une fonction, l’encapsulation de la fonction avec () est requise.

#{ExperiencePlatform.Subscriptions.profile.consents.marketing.any.time, defaultValue : (now())}
== date("2022-02-10T00:00:00Z")

Référence à un champ dans les collections

Les éléments définis dans les collections sont référencés à l’aide des fonctions spécifiques all, first et last. Pour plus d’informations, consultez cette page.

Exemple :

@event{LobbyBeacon._experience.campaign.message.profile.pushNotificationTokens.all()

Référence à un champ défini dans un mapping

Fonction `entry`

Pour récupérer un élément dans un mapping, il faut utiliser la fonction d’entrée avec une clé donnée. Elle est par exemple utilisée lors de la définition de la clé d’un événement, selon l’espace de noms sélectionné. Pour plus d’informations, consultez cette page.

@event{MyEvent.identityMap.entry('Email').first().id}

Dans cette expression, nous obtenons l’entrée correspondant à la clé « E-mail » du champ « IdentityMap » d’un événement. L’entrée « E-mail » est une collection, dans laquelle nous obtenons l’« id » dans le premier élément en utilisant « first() ». Pour plus d’informations, consultez cette page.

Fonction `firstEntryKey`

Pour récupérer la première clé d’entrée d’un mappage, utilisez la fonction firstEntryKey.

Cet exemple montre comment récupérer la première adresse e-mail des abonnés d’une liste spécifique :

#{ExperiencePlatform.Subscriptions.profile.consents.marketing.email.subscriptions.entry('daily-email').subscribers.firstEntryKey()}

Dans cet exemple, la liste d’abonnements est nommée daily-email. Les adresses e-mail sont définies comme des clés dans le mappage subscribers, qui est lié au mappage de la liste d’abonnements.

Fonction `keys`

Pour récupérer toutes les clés d’un mapping, utilisez la fonction keys.

Cet exemple montre comment récupérer, pour un profil spécifique, toutes les adresses e-mail associées aux abonnés d’une liste spécifique :

#{ExperiencePlatform.Subscriptions.profile.consents.marketing.email.subscriptions.entry('daily-mail').subscribers.keys()

Valeurs de paramètre d’une source de données (valeurs dynamiques de la source de données)

Si vous sélectionnez un champ d’une source de données externe qui nécessite l’appel d’un paramètre, un nouvel onglet s’affiche à droite pour vous permettre de spécifier ce paramètre. Consultez cette page.

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. Un paramètre peut être constitué de n’importe quelle expression valide, même provenant d’une autre source de données contenant également un autre paramètre.

NOTE

Lorsque vous définissez les valeurs de paramètre dans l’expression, l’onglet de droite disparaît.

Utilisez la syntaxe suivante :

#{<datasource>.<field group>.fieldName, params: {<params-1-name>: <params-1-value>, <params-2-name>: <params-2-value>}}

<params-1-name> : nom exact du premier paramètre de la source de données.
<params-1-value> : valeur du premier paramètre. Il peut s’agir de n’importe quelle expression valide.

Exemple:

#{Weather.main.temperature, params: {localisation: @event{Profile.address.localisation}}}
#{Weather.main.temperature, params: {localisation: #{GPSLocalisation.main.coordinates, params: {city: @event{Profile.address.city}}}}}

AI Knowledge Reference

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 explains how to reference event fields and data source field groups in journey expressions, including default value syntax, map access functions (entry, firstEntryKey, keys), and inline data source parameter passing with the params keyword.

Intents:

Reference an event field in an expression using the @event{eventName.fieldPath} syntax
Reference a data source field group using the #{dataSourceName.fieldGroupName.fieldPath} syntax
Assign a fallback default value to a field reference so expressions do not return null
Retrieve a specific entry from an identity map or subscription map using the entry() function
Retrieve all keys from a map field using the keys() function
Pass parameter values to an external data source inline using the params keyword

Glossary:

Field reference: An expression syntax that points to a named field within an event payload or data source field group (product-specific)
defaultValue: An optional fallback expression appended to a field reference that is returned when the field is absent or null (product-specific)
entry(key): A map function that retrieves the collection entry associated with the given key (product-specific)
firstEntryKey(): A map function that returns the first key of a map field (product-specific)
keys(): A map function that returns all keys of a map field (product-specific)
params keyword: Inline syntax for specifying parameter values for external data source fields within the main expression (product-specific)

Guardrails:

Field names containing special characters (starting with a digit, containing -, or characters outside a-z A-Z 0-9 _) must be wrapped in single or double quotes
The default value expression must return the same data type as the field — mismatched types are invalid
When the params keyword is used to define parameter values inline, the separate parameter tab on the right of the editor disappears
Functions used as default values must be encapsulated in parentheses

Terminology:

Canonical name: Field References — Acronym: none — variants: field path, field expression
Synonyms: @event{...} = “event field reference”; #{...} = “data source field reference”
Do not confuse: event fields (prefixed @) ≠ data source fields (prefixed #)

FAQ:

Q: How do I reference a field whose name starts with a number? — Wrap the field name in single or double quotes, e.g. #{OpenWeather.weatherData.rain.'3h'}.
Q: What happens when a referenced field is missing from the event payload and no default value is set? — The expression returns null.
Q: How do I set a dynamic default value using a function? — Wrap the function call in parentheses, e.g. defaultValue: (now()).
Q: How do I retrieve the email address stored as the first key in a subscriber map? — Use the firstEntryKey() function on the subscribers map field.
Q: How do I pass a parameter to an external data source without using the right-side tab? — Use the params keyword inline: #{DataSource.group.field, params: {paramName: value}}.

recommendation-more-help

journey-optimizer-help