Fonctions de liste list-functions

differenceLists(listString,listString) : listString

differenceLists(listInteger,listInteger) : listInteger

differenceLists(listDecimal,listDecimal) : listDecimal

differenceLists(listBoolean,listBoolean) : listBoolean

differenceLists(listDuration,listDuration) : listDuration

differenceLists(listDateTime,listDateTime) : listDateTime

differenceLists(listDateTimeOnly,listDateTimeOnly) : listDateTimeOnly

differenceLists(listDateOnly,listDateOnly) : listDateOnly

differenceLists(['a','b','c'], ['b'])

Renvoie ['a','c'].

differenceLists(['a','a','b'], [])

Renvoie ['a','b'].

differenceLists([], ['a'])

Renvoie [].

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).

mergeLists(listString,listString,boolean) : listString

mergeLists(listInteger,listInteger,boolean) : listInteger

mergeLists(listDecimal,listDecimal,boolean) : listDecimal

mergeLists(listBoolean,listBoolean,boolean) : listBoolean

mergeLists(listDuration,listDuration,boolean) : listDuration

mergeLists(listDateTime,listDateTime,boolean) : listDateTime

mergeLists(listDateTimeOnly,listDateTimeOnly,boolean) : listDateTimeOnly

mergeLists(listDateOnly,listDateOnly,boolean) : listDateOnly

mergeLists(['a','b'], ['b','c'], true)

Renvoie ['a','b','c'].

mergeLists(['a','b'], ['b','c'], false)

Renvoie ['a','b','b','c'].

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 en lien avec ce sujet.

Pour bien comprendre le sujet, consultez également la documentation de cette page. Ces sources sont complémentaires. La page décrit la fonctionnalité, tandis que cette section fournit un contexte supplémentaire qui permet de clarifier la terminologie, les objectifs, le champ d’application 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, fusionner, soustraire 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
• Combiner deux listes, avec ou sans déduplication, en utilisant mergeLists
• Soustraire une liste d’une autre (définir la différence) à l’aide de differenceLists
• 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
• mergeLists : une opération set renvoyant l’union (dédupliquée) ou la concaténation (avec doublons) de deux listes, selon le paramètre deduplicate (spécifique au produit)
• DifferenceLists : opération d’ensemble renvoyant les éléments de la première liste qui ne sont pas présents dans la deuxième liste (spécifique au produit)

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
• mergeLists et differenceLists ne prennent en charge que les types de listes scalaires (chaîne, entier, décimal, booléen, dateTime, dateTimeOnly, dateOnly, durée) ; listObject n’est pas pris en charge
• Le paramètre deduplicate de mergeLists doit être un true/false littéral, et non une expression booléenne dynamique
• differenceLists déduplique toujours son résultat ; il n’y a pas d’option pour conserver les doublons

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)
• Ne pas confondre : « mergeLists » (combine deux listes, union ou concaténation) ≠ « DifferenceLists » (soustrait une liste d’une autre) ≠ « intersect » (éléments communs uniquement)

Questions fréquentes :

• 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).
• Q : Comment combiner deux listes et supprimer les doublons ? — Utiliser mergeLists(list1, list2, true).
• Q : Comment combiner deux listes tout en conservant des valeurs en double ? — Utiliser mergeLists(list1, list2, false).
• Q : Comment puis-je trouver les éléments d’une liste qui ne se trouvent pas dans une autre ? — Utilisez differenceLists(list1, list2), qui renvoie les éléments de list1 non présents dans list2.
• Q : Quelle est la différence entre intersect et differenceLists ? — intersect renvoie les éléments communs aux deux listes ; differenceLists renvoie les éléments de la première liste qui sont absents de la deuxième liste.