DocumentationJourney OptimizerGuide de Journey Optimizer

Fonctions de gestion des collections collection-management-functions

Last update: Thu Sep 04 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • S'applique à :
  • Journey Orchestration
  • Rubriques :

Créé pour :

  • Expérimenté
  • Développeur

À propos des fonctions d’interrogation de collections

Le langage d’expression s’accompagne également d’un ensemble de fonctions permettant d’interroger les collections. Ces fonctions sont expliquées ci-dessous.

Dans les exemples suivants, nous allons utiliser la payload d’événement contenant une collection :

                {
   "_experience":{
      "campaign":{
         "message":{
            "profile":{
               "pushNotificationTokens":[
                  {
                     "token":"token_1",
                     "application":{
                        "_id":"APP1",
                        "name":"MarltonMobileApp",
                        "version":"1.0"
                     }
                  },
                  {
                     "token":"token_2",
                     "application":{
                        "_id":"APP2",
                        "name":"MarketplaceApp",
                        "version":"1.0"
                     }
                  },
                  {
                     "token":"token_3",
                     "application":{
                        "_id":"APP3",
                        "name":"VendorApp",
                        "version":"2.0"
                     }
                  }
               ]
            }
         }
      }
   },
   "timestamp":"1536160728"
}

La fonction all(<condition>)

La fonction all permet de définir un filtre sur une collection donnée en utilisant une expression booléenne.

<listExpression>.all(<condition>)

Par exemple, parmi tous les personnes utilisant l’application, vous pouvez extraire celles qui utilisent IOS 13 (expression booléenne « app used == IOS 13 »). Le résultat de cette fonction est une liste filtrée contenant les éléments qui correspondent à l’expression booléenne (exemple : utilisateur 1 de l’application, utilisateur 34 de l’application, utilisateur 432 de l’application).

Dans une activité Condition de source de données, vous pouvez vérifier si le résultat de la fonction all est nul ou non. Vous pouvez également combiner cette fonction all à d’autres fonctions, telles que count. Pour plus d’informations, voir Activité Condition de source de données.

CAUTION
L’utilisation d’événements d’expérience dans des expressions/conditions de parcours n’est pas prise en charge. Si votre cas d’utilisation nécessite l’utilisation d’événements d’expérience, envisagez d’utiliser d’autres méthodes. En savoir plus

Exemple 1

Nous voulons vérifier si un utilisateur ou une utilisatrice a installé une version spécifique d’une application. Pour ce faire, nous récupérons tous les jetons de notification push associés aux applications mobiles dont la version est égale à 1.0. Ensuite, nous exécutons une condition avec la fonction count pour vérifier que la liste de jetons renvoyée contient au moins un élément.

count(@event{LobbyBeacon._experience.campaign.message.profile.pushNotificationTokens.all(currentEventField.application.version == "1.0").token}) > 0

Le résultat est true.

Exemple 2

Ici, nous utilisons la fonction count pour vérifier s’il existe des jetons de notification push dans la collection.

count(@event{LobbyBeacon._experience.campaign.message.profile.pushNotificationTokens.all().token}) > 0

Le résultat est true.

count(@event{LobbyBeacon._experience.campaign.message.profile.pushNotificationTokens.token})

Le résultat de l’expression est 3.

NOTE

  • Lorsque la condition de filtrage de la fonction all() est vide, le filtre renvoie tous les éléments de la liste. ** Cependant, pour comptabiliser le nombre d’éléments d’une collection, la fonction all n’est pas obligatoire.

  • currentEventField n’est disponible que lors de la manipulation de collections d’événements, currentDataPackField lors de la manipulation de collections de sources de données et currentActionField lors de la manipulation de collections de réponses d’actions personnalisées.

    Lors du traitement de collections avec all, first et last, une boucle est exécutée sur chaque élément de la collection, un par un. currentEventField, currentDataPackField et currentActionField correspondent à l’élément exécuté en boucle.

Fonctions first(<condition>) et last(<condition>)

Les fonctions first et last activent également la définition d’un filtre sur la collection, tout en renvoyant le premier/dernier élément de la liste qui correspond au filtre.

<listExpression>.first(<condition>)

<listExpression>.last(<condition>)

Exemple 1

Cette expression renvoie le premier jeton de notification push associé aux applications mobiles dont la version est égale à 1.0.

@event{LobbyBeacon._experience.campaign.message.profile.pushNotificationTokens.first(currentEventField.application.version == "1.0").token}

Le résultat est token_1.

Exemple 2

Cette expression renvoie le dernier jeton de notification push associé aux applications mobiles dont la version est égale à 1.0.

@event{LobbyBeacon._experience.campaign.message.profile.pushNotificationTokens.last(currentEventField.application.version == "1.0").token}

Le résultat est token_2.

La fonction at(<index>)

La fonction at vous permet de référencer un élément spécifique d’une collection conformément à un index.
L’index 0 est le premier de la collection.

<listExpression>.at(<index>)

Exemple

Cette expression renvoie le deuxième jeton de notification push de la liste.

@event{LobbyBeacon._experience.campaign.message.profile.pushNotificationTokens.at(1).token}`

Le résultat est token_2.

recommendation-more-help
b22c9c5d-9208-48f4-b874-1cefb8df4d76