Fonctions de liste list-functions

distinct(<listInteger>)

Renvoie une liste de nombres entiers.

distinct(<listDecimal>)

Renvoie une liste de nombres décimaux.

distinct(<listString>)

Renvoie une liste de chaînes.

distinct(<listDateTimeOnly>)

Renvoie une liste de dates et heures sans tenir compte du fuseau horaire.

distinct(<listDateTime>)

Renvoie une liste de dates et heures.

distinct(<listDateOnly>)

Renvoie une liste de dates.

distinct(<listBoolean>)

Renvoie une liste de valeurs booléennes.

distinct(<listDuration>)

Renvoie une liste de durées.

distinct(<listObject>)

distinct(<listObject>,<string>)

Renvoie une liste d’objets.

distinct([10,2,10,null])

Renvoie [10, 2].

distinctWithNull(<listInteger>)

Renvoie une liste de nombres entiers.

distinctWithNull(<listDecimal>)

Renvoie une liste de nombres décimaux.

distinctWithNull(<listString>)

Renvoie une liste de chaînes.

distinctWithNull(<listDateTimeOnly>)

Renvoie une liste de dates et heures sans tenir compte du fuseau horaire.

distinctWithNull(<listDateTime>)

Renvoie une liste de dates et heures.

distinctWithNull(<listDateOnly>)

Renvoie une liste de dates.

distinctWithNull(<listBoolean>)

Renvoie une liste de valeurs booléennes.

distinctWithNull(<listDuration>)

Renvoie une liste de durées.

distinctWithNull([10,2,10,null])

Renvoie [10, 2, null]

filter(listObject, string, listString)

filter(listObject, string, listInteger)

filter(listObject, string, listDecimal)

filter(listObject, string, listDateTime)

filter(listObject, string, listDateTimeOnly)

filter(listObject, string, listDateOnly)

filter(listObject, string, listDuration)

filter(listObject, string, listBoolean)

Renvoie une valeur listObject.

Voici un exemple dʼune payload transmise dans un événement entrant « myevent » :

"productListItems": [{
   "id": "product1",
   "name": "the product 1",
   "price": 20
},{
   "id": "product2",
   "name": "the product 2",
   "price": 30
},{
   "id": "product3",
   "name": "the product 3",
   "price": 50
}]

Vous pouvez utiliser lʼexpression suivante :

filter(
 @event{myevent.productListItems},
 "id",
 ["product2", "product3", "product4"]
)

Renvoie une valeur listObject contenant les deux objets avec « product2 » et « product3 » comme id.

getListItem(<listInteger>,<index>)

Renvoie un entier.

getListItem(<listDecimal>,<index>)

Renvoie une valeur décimale.

getListItem(<listString>,<index>)

Renvoie une chaîne.

getListItem(<listDateTimeOnly>,<index>)

Renvoie une date et une heure sans prendre en compte le fuseau horaire.

getListItem(<listDateTime>,<index>)

Renvoie une date et une heure.

getListItem(<listDateOnly>,<index>)

Renvoie une liste de dates.

getListItem(<listBoolean>,<index>)

Renvoie une valeur booléenne.

getListItem(<listDuration>,<index>)

Renvoie une durée.

getListItem([10, 2, 3], 1)

Renvoie « 2 »

getListItem(["A", "B", "C"], 2)

Renvoie « C »

Exemples avec un champ d’événement ‘event.appVersion’ avec la valeur : « 20.45.2.3434 »

split(@event{event.appVersion}, "\\.")

Renvoie ["20", "45", "2", "3434"]

getListItem(split(@event{event.appVersion}, "\\."), 0)

Renvoie « 20 »

in(<integer>,<listInteger>)

in(<decimal>,<listDecimal>)

in(<string>,<listString>)

in(<boolean>,<listBoolean>)

in(<dateTimeOnly>,<listDateTimeOnly>)

in(<dateTime>,<listDateTime>)

in(<dateOnly>,<listDateOnly>)

in(<duration>,<listDuration>)

Renvoie une valeur booléenne.

in(4,[4,5,3,4])

Renvoie true.

in(8,[4,5,3,4])

Renvoie false.

in(#{ExperiencePlatform.ProfileFieldGroup.profile.person.gender}, ["male"])

intersect(listString,listString) : listString

intersect(listDecimal,listDecimal) : listDecimal

intersect(listInteger,listInteger) : listInteger

intersect(listDateTime,listDateTime) : listDateTime

intersect(listDateTimeOnly,listDateTimeOnly) : listDateTimeOnly

intersect(listDateOnly,listDateOnly) : listDateOnly

intersect(listDuration,listDuration) : listDuration

intersect(listBoolean,listBoolean) : listBoolean

Renvoie une liste.

intersect(
    ["sports", "news", "documentary"],
    ["sports", "movies", "documentary"]
)

Renvoie [« sports », « news »]

intersect(
    #{ExperienceDataPlatform.profile.interests},
    ["sports", "documentary"]
)

Renvoie les éléments communs entre les attributs du profil et la liste de catégories donnée.

intersect(
    #{ExperienceDataPlatform.profile.interests},
        @event{myEvent.sport_interests}
)

Renvoie les éléments communs entre les attributs du profil et le champ dʼévénement donné.

limit(<listString>,<integer>)

limit(<listString>,<integer>,<boolean>)

Renvoie une liste de chaînes.

limit(<listInteger>,<integer>)

limit(<listInteger>,<integer>,<boolean>)

Renvoie une liste de nombres entiers.

limit(<listDecimal>,<integer>)

limit(<listDecimal>,<integer>,<boolean>)

Renvoie une liste de nombres décimaux.

limit(<listBoolean>,<integer>)

limit(<listBoolean>,<integer>,<boolean>)

Renvoie une liste de valeurs booléennes.

limit(<listDateOnly>,<integer>)

limit(<listDateOnly>,<integer>,<boolean>)

Renvoie une liste de dates.

limit(<listDateTimeOnly>,<integer>)

limit(<listDateTimeOnly>,<integer>,<boolean>)

Renvoie une liste de dates et heures sans tenir compte du fuseau horaire.

limit(<listDateTime>,integer>)

limit(<listDateTime>,<integer>,<boolean>)

Renvoie une liste de dates et heures.

limit(<listDuration>,<integer>)

limit(<listDuration>,<integer>,<boolean>)

Renvoie une liste de durées.

limit(<listObject>,<integer>)

limit(<listObject>,<integer>,<boolean>)

Renvoie une liste d’objets.

limit(["A", "B", "C", "D", "E"], 3)

Renvoie ["A","B","C"].

limit(["A", "B", "C", "D", "E"], 3, false)

Renvoie ["C","D","E"].

listSize(<listInteger>)

listSize(<listDecimal>)

listSize(<listString>)

listSize(<listBoolean>)

listSize(<listDateTimeOnly>)

listSize(<listDateTime>)

listSize(<listDateOnly>)

listSize(<listDuration>)

Renvoie un nombre entier.

listSize(<listObject>)

listSize([10,2,3])

Renvoie 3.

listSize(@event{my_event.productListItems})

Renvoie le nombre d’objets dans le tableau d’objets donné (type listObject).

serializeList(<listInteger>,<string>,<boolean>)

serializeList(<listDecimal>,<string>,<boolean>)

serializeList(<listString>,<string>,<boolean>)

serializeList(<listBoolean>,<string>,<boolean>)

serializeList(<listDateTimeOnly>,<string>,<boolean>)

serializeList(<listDateTime>,<string>,<boolean>)

serializeList(<listDateOnly>,<string>,<boolean>)

serializeList(<listDuration>,<string>,<boolean>)

Renvoie une chaîne.

serializeList(["Hello","World"], " ", false)

Renvoie « Hello World ».

serializeList(["Hello", "World"], ",", true)

Renvoie « Hello », « World ».

sort(<listInteger>,<boolean>)

Renvoie une liste de nombres entiers.

sort(<listDecimal>,<boolean>)

Renvoie une liste de nombres décimaux.

sort(<listString>,<boolean>)

Renvoie une liste de chaînes.

sort(<listDateTimeOnly>,<boolean>)

Renvoie une liste de dates et heures sans tenir compte du fuseau horaire.

sort(<listDateTime>,<boolean>)

Renvoie une liste de dates et heures.

sort(<listDateOnly>,<boolean>)

Renvoie une liste de dates.

sort(<listBoolean>,<boolean>)

Renvoie une liste de valeurs booléennes.

sort(<listObject>,<string>,<boolean>)

Renvoie une liste d’objets.

sort(["A", "C", "B"], true)

Renvoie ["A","B","C"].

sort([1, 3, 2], false)

Renvoie [3, 2, 1].

sort(@event{my_event.productListItems}, "SKU", true)

Renvoie une valeur listObject classée par attribut SKU (ordre ascendant).

Cette section contient des connaissances structurées destinées à soutenir l’interprétation, la récupération et la réponse aux questions liées à ce sujet.

Pour une compréhension totale, ces informations doivent être combinées avec la documentation de cette page. Aucune des sources n’est conçue pour être autonome. La page décrit la fonctionnalité, tandis que cette section fournit un contexte supplémentaire qui permet de clarifier la terminologie, l’intention, l’applicabilité et les contraintes.

• TL;DR: Cette page documente toutes les fonctions de liste disponibles dans les expressions de parcours AJO, couvrant la manière de filtrer, trier, dédupliquer, vérifier l’appartenance, limiter, sérialiser et rechercher les intersections des listes et des tableaux.

Intentions:

• Supprimer les valeurs en double d’une liste à l’aide de distinct (en ignorant les nulls) ou distinctWithNull (en conservant les nulls)
• Filtrez un listObject pour renvoyer uniquement les objets correspondant à des valeurs de clé spécifiques à l’aide de filter
• Récupérer un élément à un index spécifique d’une liste à l’aide de getListItem
• Vérifier si une valeur existe dans une liste à l’aide de in
• Recherche d’éléments communs à deux listes à l’aide de intersect
• Renvoyer les N premiers ou derniers éléments d’une liste à l’aide de limit
• Compter le nombre total d’éléments dans une liste à l’aide de listSize
• Convertir une liste en chaîne délimitée à l’aide de serializeList
• Trier une liste par ordre croissant ou décroissant à l’aide de sort

Glossaire:

• listObject : liste d’objets complexes qui doivent être une référence de champ ; ne peut pas contenir d’objets nuls (spécifiques au produit)
• keyAttributeName : paramètre de chaîne facultatif utilisé avec distinct, filter et sort pour identifier l’attribut d’objet à utiliser pour la déduplication, le filtrage ou le tri des (spécifique au produit)
• intersect : opération set renvoyant uniquement les éléments présents dans les deux listes d’entrée

Mécanismes de sécurisation :

• distinctWithNull ne prend pas en charge le type de paramètre <listObject>
• filter nécessite que le paramètre listObject soit une référence de champ, et non un littéral intégré
• listSize sur un listObject nécessite que la liste soit une référence de champ ; un listObject ne peut pas contenir d’objets null
• serializeList ne prend pas en charge le type de listObject

Terminologie:

• Nom canonique : Fonctions de liste — Acronyme : none — variantes : fonctions de collection, fonctions de tableau
• Synonymes : « listSize » = « count list elements » ; « serializeList » = « join list to string »
• Ne pas confondre : « distinct » (ignore les nulls) ≠ « distinctWithNull » (conserve la valeur null comme valeur distincte)
• Ne les confondez pas : « limit » avec le troisième paramètre true (renvoie les N premiers éléments) ≠ « limit » avec false (renvoie les N derniers éléments).
• Ne pas confondre : « intersect » (éléments communs entre deux listes) ≠ « filter » (éléments correspondant à des valeurs de clé spécifiques)

FAQ:

• Q : Comment puis-je obtenir les 3 premiers éléments d’une liste ? — Utilisez limit(myList, 3) ou limit(myList, 3, true) ; par défaut, les premiers éléments sont renvoyés.
• Q : Comment puis-je obtenir les 3 derniers éléments d’une liste ? — Utiliser limit(myList, 3, false).
• Q : Quelle est la différence entre distinct et distinctWithNull ? — distinct ignore les valeurs nulles et les exclut du résultat ; distinctWithNull traite les valeurs nulles comme une valeur distincte et inclut une entrée nulle si des valeurs nulles sont présentes.
• Q : Puis-je filtrer une liste de chaînes avec des filter ? — Non, filter fonctionne uniquement sur listObject ; pour les listes scalaires, utilisez in ou distinct pour la déduplication.
• Q : Comment puis-je vérifier si une valeur se trouve dans une liste ? — Utilisez in(value, myList), qui renvoie true si la valeur figure dans la liste.
• Q : Puis-je trier un listObject en fonction d’un attribut spécifique ? — Oui, utilisez sort(@event{...}, "attributeName", true) où le deuxième paramètre est le nom de l’attribut et le troisième est le sens du tri (true = croissant).