DocumentationExperience PlatformGuide de préparation des données

Fonctions de mappage de la préparation des données

Last update: Tue Mar 04 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Créé pour :

  • Développeur

Les fonctions de préparation de données peuvent être utilisées pour calculer des valeurs en fonction de ce qui est saisi dans les champs sources.

Champs

Un nom de champ peut être n’importe quel identifiant légal, une séquence de lettres et de chiffres Unicode d’une longueur illimitée commençant par une lettre, le signe dollar ($) ou le caractère de soulignement (_). Les noms de variables respectent également la casse.

Si un nom de champ ne suit pas cette convention, il doit être encapsulé avec des ${}. Ainsi, par exemple, si le nom du champ est « Prénom » ou « Prénom », le nom doit être encapsulé comme ${First Name} ou ${First\.Name}, respectivement.

TIP
Lors de l’interaction avec des hiérarchies, si un attribut enfant comporte un point (.), vous devez utiliser une barre oblique inverse (\) pour échapper les caractères spéciaux. Pour plus d’informations, consultez le guide sur l’échappement des caractères spéciaux.

Si le nom d’un champ est l’un des mots-clés réservés suivants, il doit être encapsulé avec ${}{} :

new, mod, or, break, var, lt, for, false, while, eq, gt, div, not, null, continue, else, and, ne, true, le, if, ge, return, _errors, do, function, empty, size

En outre, les mots-clés réservés incluent également l’une des fonctions de mappeur répertoriées sur cette page.

Les données des sous-champs sont accessibles à l’aide de la notation par points. Par exemple, s’il existait un objet name, pour accéder au champ firstName, utilisez name.firstName.

Liste des fonctions

Les tableaux suivants répertorient toutes les fonctions de mappage prises en charge, y compris des exemples d’expressions et les sorties qui en résultent.

Fonctions de chaîne string

NOTE
Veuillez faire défiler la page vers la gauche/droite pour consulter le contenu complet du tableau.
Fonction
Description
Paramètres
Syntaxe
Expression
Exemple de résultat
concat
Concatène les chaînes données.
  • STRING : les chaînes qui seront concaténées.
concat(STRING_1, STRING_2)
concat("Hi, ", "there", "!")
"Hi, there!"
explode
Divise la chaîne en fonction d’une expression régulière et renvoie un tableau de parties. Peut éventuellement inclure une expression régulière pour fractionner la chaîne. Par défaut, la division est résolue sur « , ». Les délimiteurs suivants doivent doivent être précédés d’un caractère d’échappement \ : +, ?, ^, |, ., [, (, {, ), *, $, \ Si vous incluez plusieurs caractères comme délimiteur, le délimiteur sera traité comme un délimiteur à plusieurs caractères.
  • STRING : obligatoire la chaîne qui doit être fractionnée.
  • REGEX : facultatif expression régulière qui peut être utilisée pour fractionner la chaîne.
explode(STRING, REGEX)
explode("Hi, there!", " ")
["Hi,", "there"]
instr
Renvoie l’emplacement/l’index d’une sous-chaîne.
  • INPUT : obligatoire chaîne faisant l’objet de la recherche.
  • SOUS-CHAÎNE : obligatoire sous-chaîne recherchée dans la chaîne.
  • POSITION_DÉBUT : facultatif emplacement où commencer à rechercher des éléments dans la chaîne.
  • OCCURRENCE : facultatif nième occurrence à rechercher à partir de la position de départ. Par défaut, il s’agit de 1.
instr(INPUT, SUBSTRING, START_POSITION, OCCURRENCE)
instr(« adobe.com », « com »)
6
replacestr
Remplace la chaîne de recherche si elle est présente dans la chaîne d’origine.
  • INPUT : obligatoire chaîne d’entrée.
  • TO_FIND : Obligatoire chaîne à rechercher dans l’entrée.
  • TO_REPLACE : Obligatoire chaîne qui remplacera la valeur dans « TO_FIND ».
replacestr(INPUT, TO_FIND, TO_REPLACE)
replacestr("This is a string re test", "re", "replace")
"This is a string replace test"
substr
Renvoie une sous-chaîne d’une longueur donnée.
  • INPUT : obligatoire chaîne d’entrée.
  • START_INDEX : obligatoire index de la chaîne d’entrée sur laquelle la sous-chaîne commence.
  • LONGUEUR : Obligatoire longueur de la sous-chaîne.
substr(INPUT, START_INDEX, LENGTH)
substr("This is a substring test", 7, 8)
" a subst"
lower /
lcase
Convertit une chaîne en minuscules.
  • INPUT : obligatoire chaîne qui sera convertie en minuscules.
lower(INPUT)
lower("HeLLo")
lcase("HeLLo")
"hello"
upper /
ucase
Convertit une chaîne en majuscules.
  • INPUT : obligatoire chaîne qui sera convertie en majuscules.
upper(INPUT)
upper("HeLLo")
ucase("HeLLo")
"HELLO"
split
Divise une chaîne d’entrée sur un séparateur. Le séparateur suivant doit doit être placé dans une séquence d’échappement avec \ : \. Si vous incluez plusieurs délimiteurs, la chaîne est fractionnée sur n’importe lequel des délimiteurs présents dans la chaîne. Remarque : cette fonction renvoie uniquement des index non nuls à partir de la chaîne, quelle que soit la présence du séparateur. Si tous les index, y compris les valeurs nulles, sont requis dans le tableau obtenu, utilisez plutôt la fonction « explode ».
  • INPUT : obligatoire chaîne d’entrée qui va être fractionnée.
  • SEPARATOR : obligatoire chaîne utilisée pour fractionner l’entrée.
split(INPUT, SEPARATOR)
split("Hello world", " ")
["Hello", "world"]
join
Joint une liste d’objets à l’aide du séparateur.
  • SEPARATOR : Obligatoire chaîne qui sera utilisée pour joindre les objets.
  • OBJETS : Obligatoire Tableau de chaînes qui seront jointes.
join(SEPARATOR, [OBJECTS])
join(" ", to_array(true, "Hello", "world"))
"Hello world"
lpad
Complète le côté gauche d’une chaîne avec l’autre chaîne donnée.
  • INPUT : obligatoire chaîne qui va être complétée. Cette chaîne peut être nulle.
  • COUNT : obligatoire taille de la chaîne à remplir.
  • MARGE INTÉRIEURE : obligatoire chaîne avec laquelle remplir l’entrée. Si nul ou vide, il sera traité comme un espace unique.
load(INPUT, COUNT, PADDING)
lpad(« bat », 8, « yz »)
« yzyzybat »
rpad
Complète le côté droit d’une chaîne avec l’autre chaîne donnée.
  • INPUT : obligatoire chaîne qui va être complétée. Cette chaîne peut être nulle.
  • COUNT : obligatoire taille de la chaîne à remplir.
  • MARGE INTÉRIEURE : obligatoire chaîne avec laquelle remplir l’entrée. Si nul ou vide, il sera traité comme un espace unique.
rpad(INPUT, COUNT, PADDING)
rpad(« bat », 8, « yz »)
« batyzyzy »
left
Obtient les premiers caractères « n » de la chaîne donnée.
  • STRING : Obligatoire chaîne pour laquelle vous obtenez les premiers caractères « n ».
  • COUNT : Obligatoire les caractères « n » que vous souhaitez obtenir à partir de la chaîne.
left(STRING, COUNT)
left(« abcde », 2)
« ab »
droite
Obtient les « n » derniers caractères de la chaîne donnée.
  • STRING : Obligatoire chaîne pour laquelle vous obtenez les « n » derniers caractères.
  • COUNT : Obligatoire les caractères « n » que vous souhaitez obtenir à partir de la chaîne.
right(STRING, COUNT)
right(« abcde », 2)
« de »
ltrim
Supprime l’espace au début de la chaîne.
  • STRING : Obligatoire chaîne dont vous souhaitez supprimer l’espace.
ltrim(STRING)
ltrim(« hello »)
"hello"
rtrim
Supprime l’espace à la fin de la chaîne.
  • STRING : Obligatoire chaîne dont vous souhaitez supprimer l’espace.
rtrim(STRING)
rtrim(« hello »)
"hello"
trim
Supprime les espaces blancs du début et de la fin de la chaîne.
  • STRING : Obligatoire chaîne dont vous souhaitez supprimer l’espace.
trim(STRING)
trim(« hello »)
"hello"
est égal à
Compare deux chaînes pour vérifier si elles sont égales. Cette fonction respecte la casse.
  • STRING1 : Obligatoire première chaîne à comparer.
  • STRING2 : Obligatoire deuxième chaîne à comparer.
STRING1. ​égal à(​STRING2)
« string1 ». ​equals​(« STRING1 »)
False
equalsIgnoreCase
Compare deux chaînes pour vérifier si elles sont égales. Cette fonction n’est pas sensible à la casse.
  • STRING1 : Obligatoire première chaîne à comparer.
  • STRING2 : Obligatoire deuxième chaîne à comparer.
STRING1. ​equalsIgnoreCase​(STRING2)
« string1 ». ​equalsIgnoreCase​(« STRING1)
vrai

Fonctions d’expressions régulières

Fonction
Description
Paramètres
Syntaxe
Expression
Exemple de résultat
extract_regex
Extrait les groupes de la chaîne d’entrée, en fonction d’une expression régulière.
  • STRING : obligatoire chaîne à partir de laquelle vous extrayez les groupes.
  • REGEX : obligatoire expression régulière à laquelle vous souhaitez que le groupe corresponde.
extract_regex(STRING, REGEX)
extract_regex​(« E259,E259B_009,1_1 »​, « ([,]+),[,]*,([^,]+) »)
[« E259,E259B_009,1_1 », « E259 », « 1_1 »]
matches_regex
Vérifie si la chaîne correspond à l’expression régulière saisie.
  • STRING : Obligatoire la chaîne que vous vérifiez correspond à l’expression régulière.
  • REGEX : obligatoire expression régulière à laquelle vous effectuez une comparaison.
matches_regex(STRING, REGEX)
matches_regex(« E259,E259B_009,1_1 », « ([,]+),[,]*,([^,]+) »)
vrai

Fonctions de hachage hashing

NOTE
Veuillez faire défiler la page vers la gauche/droite pour consulter le contenu complet du tableau.
Fonction
Description
Paramètres
Syntaxe
Expression
Exemple de résultat
sha1
Prend une entrée et génère une valeur de hachage à l’aide de l’algorithme de hachage sécurisé 1 (SHA-1).
  • INPUT : obligatoire texte brut à hacher.
  • CHARSET : facultatif nom du jeu de caractères. Les valeurs possibles sont UTF-8, UTF-16, ISO-8859-1 et US-ASCII.
sha1(INPUT, CHARSET)
sha1(« mon texte », « UTF-8 »)
c3599c11e47719df18a24​48690840c5dfcce3c80
sha256
Prend une entrée et génère une valeur de hachage à l’aide de l’algorithme de hachage sécurisé 256 (SHA-256).
  • INPUT : obligatoire texte brut à hacher.
  • CHARSET : facultatif nom du jeu de caractères. Les valeurs possibles sont UTF-8, UTF-16, ISO-8859-1 et US-ASCII.
sha256(INPUT, CHARSET)
sha256(« mon texte », « UTF-8 »)
7330d2b39ca35eaf4cb95fc846c21​ee6a39af698154a83a586ee270a0d372104
sha512
Prend une entrée et produit une valeur de hachage à l’aide de l’algorithme de hachage sécurisé 512 (SHA-512).
  • INPUT : obligatoire texte brut à hacher.
  • CHARSET : facultatif nom du jeu de caractères. Les valeurs possibles sont UTF-8, UTF-16, ISO-8859-1 et US-ASCII.
sha512(INPUT, CHARSET)
sha512(« mon texte », « UTF-8 »)
a3d7e45a0d9be5fd4e4b9a3b8c9c2163c21ef​708bf11b4232bb21d2a8704ada2cdcd7b367dd0788a89​a5c908cfe377aceb1072a7b388 b7d4fd2ff68a8fd24d16
md5
Prend une entrée et génère une valeur de hachage à l’aide de MD5.
  • INPUT : obligatoire texte brut à hacher.
  • CHARSET : facultatif nom du jeu de caractères. Les valeurs possibles sont UTF-8, UTF-16, ISO-8859-1 et US-ASCII.
md5(INPUT, CHARSET)
md5(« mon texte », « UTF-8 »)
d3b96ce8c9fb4​e9bd0198d03ba6852c7
crc32
Prend une entrée utilise un algorithme de contrôle de redondance cyclique (CRC) pour produire un code cyclique de 32 bits.
  • INPUT : obligatoire texte brut à hacher.
  • CHARSET : facultatif nom du jeu de caractères. Les valeurs possibles sont UTF-8, UTF-16, ISO-8859-1 et US-ASCII.
crc32(INPUT, CHARSET)
crc32(« mon texte », « UTF-8 »)
8df92e80

Fonctions d’URL url

NOTE
Veuillez faire défiler la page vers la gauche/droite pour consulter le contenu complet du tableau.
Fonction
Description
Paramètres
Syntaxe
Expression
Exemple de résultat
get_url_protocol
Retourne le protocole à partir de l’URL donnée. Si l’entrée n’est pas valide, elle renvoie la valeur null.
  • URL : Obligatoire URL à partir de laquelle le protocole doit être extrait.
get_url_protocol​(URL)
get_url_protocol(« https://platform​.adobe.com/home »)
https
get_url_host
Renvoie l’hôte de l’URL donnée. Si l’entrée n’est pas valide, elle renvoie la valeur null.
  • URL : Obligatoire URL à partir de laquelle l’hôte doit être extrait.
get_url_host​(URL)
get_url_host​(« https://platform​.adobe.com/home »)
platform.adobe.com
get_url_port
Renvoie le port de l’URL donnée. Si l’entrée n’est pas valide, elle renvoie la valeur null.
  • URL : Obligatoire URL à partir de laquelle le port doit être extrait.
get_url_port(URL)
get_url_port​(« sftp://example.com//home/​joe/employee.csv »)
22
get_url_path
Renvoie le chemin d’accès de l’URL donnée. Par défaut, le chemin d’accès complet est renvoyé.
  • URL : Obligatoire URL à partir de laquelle le chemin d’accès doit être extrait.
  • FULL_PATH : facultatif valeur booléenne qui détermine si le chemin d’accès complet est renvoyé. Si elle est définie sur false, seule la fin du chemin est renvoyée.
get_url_path​(URL, FULL_PATH)
get_url_path​(« sftp://example.com//​home/joe/employee.csv »)
« //home/joe/​employee.csv »
get_url_query_str
Renvoie la chaîne de requête d’une URL donnée sous la forme d’un mappage du nom de la chaîne de requête et de la valeur de la chaîne de requête.
  • URL : Obligatoire URL à partir de laquelle vous essayez d’obtenir la chaîne de requête.
  • ANCHOR : obligatoire détermine ce qui sera fait avec l’ancre dans la chaîne de requête. Il peut s’agir de l’une des trois valeurs suivantes : « conserver », « supprimer » ou « ajouter ».

    Si la valeur est « retain », l'ancre sera attachée à la valeur renvoyée.
    Si la valeur est « remove », l'ancre sera supprimée de la valeur renvoyée.
    Si la valeur est « append », l’ancre est renvoyée en tant que valeur distincte.
get_url_query_str​(URL, ANCHOR)
get_url_query_str​(« foo://example.com:8042​/over/There?name=​ferret#nose », « retain »)
get_url_query_str​(« foo://example.com:8042​/over/There?name=​ferret#nose », « remove »)
get_url_query_str​ ​ ​(« foo://example.com:8042/over/then?name=ferret#nose », « append »)
{"name": "ferret#nose"}
{"name": "ferret"}
{"name": "ferret", "_anchor_": "nose"}
get_url_encoded
Cette fonction prend une URL comme entrée et remplace ou encode les caractères spéciaux avec des caractères ASCII. Pour plus d'informations sur les caractères spéciaux, veuillez lire la liste des caractères spéciaux en annexe de ce document.
  • URL : Obligatoire URL d’entrée avec des caractères spéciaux que vous souhaitez remplacer ou coder avec des caractères ASCII.
get_url_encoded(URL)
get_url_encoded(« https://example.com/PARTNERalliance_asia-pacific_2022 »)
https%3A%2F%2Fexample.com%2Fpartners_asia-pacific_2022
get_url_decoded
Cette fonction prend une URL comme entrée et décode les caractères ASCII en caractères spéciaux. Pour plus d'informations sur les caractères spéciaux, veuillez lire la liste des caractères spéciaux en annexe de ce document.
  • URL : Obligatoire URL d’entrée contenant des caractères ASCII que vous souhaitez décoder en caractères spéciaux.
get_url_decoded(URL)
get_url_decoded(« https%3A%2F%2Fexample.com%2Fpartner_asia-pacific_2022 »)
https://example.com/PARTNERalliance_asia-pacific_2022

Fonctions de date et d’heure date-and-time

NOTE
Veuillez faire défiler la page vers la gauche/droite pour consulter le contenu complet du tableau. Vous trouverez plus d’informations sur la fonction date dans la section dates du guide de la gestion des formats de données.
Fonction
Description
Paramètres
Syntaxe
Expression
Exemple de résultat
now
Récupère l’heure actuelle.
now()
now()
2021-10-26T10:10:24Z
timestamp
Récupère l’heure Unix actuelle.
timestamp()
timestamp()
1571850624571
format
Formate la date d’entrée selon un format spécifié.
  • DATE : Obligatoire date d’entrée, sous la forme d’un objet ZonedDateTime, que vous souhaitez formater.
  • FORMAT : Obligatoire format dans lequel vous souhaitez que la date soit modifiée.
format(DATE, FORMAT)
format(2019-10-23T11:24:00+00:00, « yyyy-MM-dd HH:mm:ss »)
2019-10-23 11:24:35
dformat
Convertit une date et une heure en chaîne de date selon un format spécifié.
  • TIMESTAMP : obligatoire date et heure à formater. Il est écrit en millisecondes.
  • FORMAT : Obligatoire format dans lequel vous souhaitez que l’horodatage soit défini.
format(TIMESTAMP, FORMAT)
dformat(1571829875000, « yyyy-MM-dd'T'HH:mm:ss.SSSX »)
2019-10-23T11:24:35.000Z
date
Convertit une chaîne de date en objet ZonedDateTime (format ISO 8601).
  • DATE : Obligatoire chaîne qui représente la date.
  • FORMAT : Obligatoire chaîne représentant le format de la date source.Remarque : il ne s’agit pas du format dans lequel vous souhaitez convertir la chaîne de date.
  • DEFAULT_DATE : Obligatoire date par défaut renvoyée, si la date fournie est nulle.
date(DATE, FORMAT, DEFAULT_DATE)
date(« 2019-10-23 11:24 », « aaaa-MM-jj HH:mm », now())
2019-10-23T11:24:00Z
date
Convertit une chaîne de date en objet ZonedDateTime (format ISO 8601).
  • DATE : Obligatoire chaîne qui représente la date.
  • FORMAT : Obligatoire chaîne représentant le format de la date source.Remarque : il ne s’agit pas du format dans lequel vous souhaitez convertir la chaîne de date.
date(DATE, FORMAT)
date(« 2019-10-23 11:24 », « aaaa-MM-jj HH:mm »)
2019-10-23T11:24:00Z
date
Convertit une chaîne de date en objet ZonedDateTime (format ISO 8601).
  • DATE : Obligatoire chaîne qui représente la date.
date(DATE)
date(« 2019-10-23 11:24 »)
« 2019-10-23T11:24:00Z »
date_part
Récupère les parties de la date. Les valeurs de composant suivantes sont prises en charge :

« year »
« yyyy »
« yy »

« quarter »
« qq »
« q »

« month »
« mm »
« m »

« dayofyear »
« y »
« day »

»
»
« d »

« week »
»
« w »

»
« weekday »
« dw »

»
« hour »
« hh »
»

« hh24 »
»
« hh12 »

« minute »
»
»

« n »
« « second »« ss »« s »« milliseconde
  • COMPOSANT : Obligatoire Chaîne représentant la partie de la date.
  • DATE : Obligatoire date au format standard.
date_part​(COMPONENT, DATE)
date_part(« MM », date(« 2019-10-17 11:55:12 »))
10
set_date_part
Remplace un composant à une date donnée. Les composants suivants sont acceptés :

"year"
"yyyy"
"yy"

"month"
"mm"
"m"

"day"
"dd"
"d"

"hour"
"hh"

"minute"
"mi"
"n"

"second"
"ss"
"s"
  • COMPOSANT : Obligatoire Chaîne représentant la partie de la date.
  • VALEUR : Obligatoire valeur à définir pour le composant à une date donnée.
  • DATE : Obligatoire date au format standard.
set_date_part​(COMPONENT, VALUE, DATE)
set_date_part(« m », 4, date(« 2016-11-09T11:44:44.797 »)
« 2016-04-09T11:44:44Z »
make_date_time
Crée une date à partir de parties. Cette fonction peut également être induite à l’aide de make_timestamp.
  • YEAR : Obligatoire L'année, écrite dans 4 chiffres.
  • MOIS : obligatoire le mois. Les valeurs autorisées sont comprises entre 1 et 12.
  • JOUR : obligatoire le jour. Les valeurs autorisées sont comprises entre 1 et 31.
  • HEURE : obligatoire l’heure. Les valeurs autorisées sont comprises entre 0 et 23.
  • MINUTE : Obligatoire La minute. Les valeurs autorisées sont comprises entre 0 et 59.
  • NANOSECONDE : obligatoire valeurs de la nanoseconde. Les valeurs autorisées sont 0 à 999999999.
  • TIMEZONE : obligatoire fuseau horaire de la date et de l’heure.
make_date_time​(YEAR, MONTH, DAY, HOUR, MINUTE, SECOND, NANOSECOND, TIMEZONE)
make_date_time​(2019, 10, 17, 11, 55, 12, 999, « America/Los_Angeles »)
2019-10-17T11:55:12Z
zone_date_to_utc
Convertit une date de n’importe quel fuseau horaire en une date au format UTC.
  • DATE : Obligatoire date que vous tentez de convertir.
zone_date_to_utc​(DATE)
zone_date_to_utc​(2019-10-17T11:55:​12 PST
2019-10-17T19:55:12Z
zone_date_to_zone
Convertit une date d’un fuseau horaire à un autre.
  • DATE : Obligatoire date que vous tentez de convertir.
  • ZONE : Obligatoire fuseau horaire dans lequel vous essayez de convertir la date.
zone_date_to_zone​(DATE, ZONE)
zone_date_to_zone(now(), "Europe/Paris")
2021-10-26T15:43:59Z

Hiérarchies - Objets objects

NOTE
Veuillez faire défiler la page vers la gauche/droite pour consulter le contenu complet du tableau.
Fonction
Description
Paramètres
Syntaxe
Expression
Exemple de résultat
is_empty
Vérifie si un objet est vide ou non.
  • INPUT : obligatoire l’objet que vous essayez de vérifier est vide.
is_empty(INPUT)
is_empty([1, null, 2, 3])
False
arrays_to_object
Crée une liste d’objets.
  • INPUT : obligatoire regroupement de paires clé-tableau.
arrays_to_object(INPUT)
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])
[{ "sku": "id1", "price": 22.5 }, { "sku": "id2", "price": 14.35 }]
to_object
Crée un objet en fonction des paires clé/valeur aplaties données.
  • INPUT : obligatoire liste plate de paires clé/valeur.
to_object(INPUT)
to_object​(« firstName », « John », « lastName », « Doe »)
{"firstName": "John", "lastName": "Doe"}
str_to_object
Crée un objet à partir de la chaîne d’entrée.
  • STRING : obligatoire chaîne en cours d’analyse pour créer un objet.
  • VALUE_DELIMITER : facultatif délimiteur qui sépare un champ de la valeur. Le délimiteur par défaut est :.
  • FIELD_DELIMITER : facultatif délimiteur qui sépare les paires valeur de champ. Le délimiteur par défaut est ,.
str_to_object​(STRING, VALUE_DELIMITER, FIELD_DELIMITER) Remarque : vous pouvez utiliser la fonction get() avec str_to_object() pour récupérer les valeurs des clés de la chaîne.
  • Exemple #1 : str_to_object(« firstName - John ; lastName - ; - 123 345 7890 », « - », »; »)
  • Exemple #2 : str_to_object(« firstName - John ; lastName - ; phone - 123 456 7890 », « - », »; »).get(« firstName »)
  • Exemple #1:{"firstName": "John", "lastName": "Doe", "phone": "123 456 7890"}
  • Exemple de #2 : « John »
contains_key
Vérifie si l’objet existe dans les données source. Remarque : cette fonction remplace la fonction is_set() obsolète.
  • INPUT : obligatoire chemin d’accès à vérifier s’il existe dans les données source.
contains_key(INPUT)
contains_key(« evars.evar.field1 »)
vrai
annuler
Définit la valeur de l’attribut sur null. Utilisez-le lorsque vous ne souhaitez pas copier le champ dans le schéma cible.
nullify()
nullify()
null
get_keys
Analyse les paires clé/valeur et renvoie toutes les clés.
  • OBJET : Obligatoire objet à partir duquel les clés seront extraites.
get_keys(OBJECT)
get_keys({« livre1 »: « Fierté et préjugé », « livre2 »: « 1984 »})
["book1", "book2"]
get_values
Analyse les paires clé/valeur et renvoie la valeur de la chaîne, en fonction de la clé donnée.
  • STRING : obligatoire chaîne que vous souhaitez analyser.
  • KEY : Obligatoire clé pour laquelle la valeur doit être extraite.
  • VALUE_DELIMITER : obligatoire délimiteur qui sépare le champ et la valeur. Si une null ou une chaîne vide est fournie, cette valeur est :.
  • FIELD_DELIMITER : facultatif délimiteur qui sépare les paires champ/valeur. Si une null ou une chaîne vide est fournie, cette valeur est ,.
get_values(STRING, KEY, VALUE_DELIMITER, FIELD_DELIMITER)
get_values(\« firstName - John , lastName - Cena , phone - 555 420 8692\ », \« firstName\ », \« -\ », \ »,\ »)
John
map_get_values
Prend un mappage et une entrée de clé. Si l’entrée est une clé unique, la fonction renvoie la valeur associée à cette clé. Si l’entrée est un tableau de chaîne, la fonction renvoie toutes les valeurs correspondant aux clés fournies. Si le mappage entrant comporte des clés en double, la valeur renvoyée doit dédupliquer les clés et renvoyer des valeurs uniques.
  • MAP : obligatoire données de mappage d’entrée.
  • KEY : obligatoire la clé peut être une chaîne unique ou un tableau de chaînes. Si un autre type primitif (données/nombre) est fourni, il est traité comme une chaîne.
get_values(MAP, KEY)
Consultez l’annexe pour obtenir un exemple de code.
map_has_keys
Si une ou plusieurs clés d’entrée sont fournies, la fonction renvoie true. Si un tableau de chaînes est fourni comme entrée, la fonction renvoie true sur la première clé trouvée.
  • MAP : obligatoire données de mappage d’entrée
  • KEY : obligatoire la clé peut être une chaîne unique ou un tableau de chaînes. Si un autre type primitif (données/nombre) est fourni, il est traité comme une chaîne.
map_has_keys(MAP, KEY)
Consultez l’annexe pour obtenir un exemple de code.
add_to_map
Accepte au moins deux entrées. Un nombre illimité de mappages peut être fourni en tant qu’entrées. La préparation de données renvoie un mappage unique qui contient toutes les paires clé-valeur de toutes les entrées. Si une ou plusieurs clés sont répétées (dans le même mappage ou sur plusieurs mappages), la préparation de données déduplique les clés afin que la première paire clé-valeur persiste dans l’ordre dans lequel elles ont été transmises dans l’entrée.
MAP : obligatoire données de mappage d’entrée.
add_to_map(MAP 1, MAP 2, MAP 3, …)
Consultez l’annexe pour obtenir un exemple de code.
object_to_map (Syntaxe 1)
Utilisez cette fonction pour créer des types de données de mappage.
  • KEY : Obligatoire les clés doivent être une chaîne. Si d’autres valeurs primitives, telles que des entiers ou des dates, sont fournies, elles sont automatiquement converties en chaînes et traitées comme des chaînes.
  • ANY_TYPE : obligatoire fait référence à tout type de données XDM pris en charge, à l’exception des mappages.
object_to_map(KEY, ANY_TYPE, KEY, ANY_TYPE, … )
Consultez l’annexe pour obtenir un exemple de code.
object_to_map (Syntaxe 2)
Utilisez cette fonction pour créer des types de données de mappage.
  • OBJET : obligatoire vous pouvez fournir un objet ou un tableau d’objets entrant et pointer vers un attribut à l’intérieur de l’objet comme clé.
object_to_map(OBJECT)
Consultez l’annexe pour obtenir un exemple de code.
object_to_map (Syntaxe 3)
Utilisez cette fonction pour créer des types de données de mappage.
  • OBJET : obligatoire vous pouvez fournir un objet ou un tableau d’objets entrant et pointer vers un attribut à l’intérieur de l’objet comme clé.
object_to_map(OBJECT_ARRAY, ATTRIBUTE_IN_OBJECT_TO_BE_USED_AS_A_KEY)
Consultez l’annexe pour obtenir un exemple de code.

Pour plus d’informations sur la fonction de copie d’objet, consultez la section ci-dessous.

Hiérarchies - Tableaux arrays

NOTE
Veuillez faire défiler la page vers la gauche/droite pour consulter le contenu complet du tableau.
Fonction
Description
Paramètres
Syntaxe
Expression
Exemple de résultat
coalesce
Renvoie le premier objet non nul dans un tableau donné.
  • INPUT : Obligatoire tableau dont vous souhaitez rechercher le premier objet non nul.
coalesce(INPUT)
coalesce(null, null, null, "first", null, "second")
"first"
first
Récupère le premier élément du tableau donné.
  • INPUT : Obligatoire tableau dont vous souhaitez trouver le premier élément.
first(INPUT)
first("1", "2", "3")
"1"
last
Récupère le dernier élément du tableau donné.
  • INPUT : Obligatoire tableau dont vous souhaitez rechercher le dernier élément.
last(INPUT)
last("1", "2", "3")
"3"
add_to_array
Ajoute des éléments à la fin du tableau.
  • TABLEAU : obligatoire tableau auquel vous ajoutez des éléments.
  • VALEURS : éléments à ajouter au tableau.
add_to_array​(ARRAY, VALUES)
add_to_array​(['a', 'b'], 'c', 'd')
['a', 'b', 'c', 'd']
join_arrays
Combine les tableaux entre eux.
  • TABLEAU : obligatoire tableau auquel vous ajoutez des éléments.
  • VALEURS : le ou les tableaux que vous souhaitez ajouter au tableau parent.
join_arrays​(ARRAY, VALUES)
join_arrays​(['a', 'b'], ['c'], ['d', 'e'])
['a', 'b', 'c', 'd', 'e']
to_array
Prend une liste d’entrées et la convertit en tableau.
  • INCLUDE_NULLS : obligatoire valeur booléenne utilisée pour indiquer si les valeurs NULL doivent être incluses ou non dans le tableau de réponse.
  • VALEURS : Obligatoire éléments à convertir en tableau.
to_array​(INCLUDE_NULLS, VALUES)
to_array(false, 1, null, 2, 3)
[1, 2, 3]
size_of
Renvoie la taille de l’entrée.
  • INPUT : Obligatoire objet dont vous essayez de déterminer la taille.
size_of(INPUT)
size_of([1, 2, 3, 4])
4
upsert_array_append
Cette fonction est utilisée pour ajouter tous les éléments de l’ensemble du tableau d’entrée à la fin du tableau dans Profile. Cette fonction est uniquement applicable lors des mises à jour. Si elle est utilisée dans le contexte des insertions, cette fonction renvoie l'entrée telle quelle.
  • TABLEAU : obligatoire tableau servant à ajouter le tableau dans le profil.
upsert_array_append(ARRAY)
upsert_array_append([123, 456])
123 456 []
upsert_array_replace
Cette fonction est utilisée pour remplacer des éléments dans un tableau. Cette fonction est uniquement applicable lors des mises à jour. Si elle est utilisée dans le contexte des insertions, cette fonction renvoie l'entrée telle quelle.
  • TABLEAU : obligatoire tableau servant à remplacer le tableau dans le profil.
upsert_array_replace(ARRAY)
upsert_array_replace([123, 456], 1)
123 456 []
[Destinations uniquement]{class="badge informative"} array_to_string
Rejoint les représentations sous forme de chaînes des éléments d’un tableau à l’aide du séparateur spécifié. Si le tableau est multidimensionnel, il est aplati avant d’être joint. Remarque : cette fonction est utilisée dans les destinations. Pour plus d’informations, consultez la documentation .
  • SEPARATOR : obligatoire séparateur utilisé pour joindre les éléments du tableau.
  • TABLEAU : obligatoire tableau à joindre (après aplatissement).
array_to_string(SEPARATOR, ARRAY)
array_to_string(";", ["Hello", "world"])
« Bonjour, le monde »
[Destinations uniquement]{class="badge informative"} filterArray*
Filtre le tableau donné en fonction d’un prédicat. Remarque : cette fonction est utilisée dans les destinations. Pour plus d’informations, consultez la documentation .
  • TABLEAU : obligatoire tableau à filtrer
  • PREDICATE : Obligatoire prédicat à appliquer à chaque élément du tableau donné.
filterArray(ARRAY, PREDICATE)
filterArray([5, -6, 0, 7], x -> x > 0)
5 [ 7]
[Destinations uniquement]{class="badge informative"} transformArray*
Transforme le tableau donné en fonction d’un prédicat. Remarque : cette fonction est utilisée dans les destinations. Pour plus d’informations, consultez la documentation .
  • TABLEAU : obligatoire tableau à transformer.
  • PREDICATE : Obligatoire prédicat à appliquer à chaque élément du tableau donné.
transformArray(ARRAY, PREDICATE)
transformArray([5, 6, 7], x -> x + 1)
[6, 7, 8]
[Destinations uniquement]{class="badge informative"} flattenArray*
Aplatit le tableau donné (multidimensionnel) en un tableau unidimensionnel. Remarque : cette fonction est utilisée dans les destinations. Pour plus d’informations, consultez la documentation .
  • TABLEAU : obligatoire tableau à aplatir.
flattenArray(ARRAY)
flattenArray([[['a', 'b'], ['c', 'd']], [['e'], ['f']]])
['a', 'b', 'c', 'd', 'e', 'f']

Hiérarchies - Mappage map

NOTE
Veuillez faire défiler la page vers la gauche/droite pour consulter le contenu complet du tableau.
Fonction
Description
Paramètres
Syntaxe
Expression
Exemple de résultat
array_to_map
Cette fonction prend un tableau d’objets et une clé comme entrée et renvoie un mappage du champ de la clé avec la valeur comme clé et l’élément du tableau comme valeur.
  • INPUT : Obligatoire tableau d’objets dont vous souhaitez rechercher le premier objet non nul.
  • KEY : obligatoire la clé doit être un nom de champ dans le tableau d’objets et l’objet doit être une valeur.
array_to_map(OBJECT[] INPUTS, KEY)
Lisez la annexe pour obtenir un exemple de code.
object_to_map
Cette fonction prend un objet en tant qu’argument et renvoie un mappage de paires clé-valeur.
  • INPUT : Obligatoire tableau d’objets dont vous souhaitez rechercher le premier objet non nul.
object_to_map(OBJECT_INPUT)
« object_to_map(address) où l’entrée est « + « adresse : {line1 : \« 345 park ave\ »,ligne2 : \« bldg 2\ »,Ville : \« san jose
»,État : \« CA\ »,type : \« office\« } »
Renvoie un mappage avec des paires nom-valeur de champ données ou null si l’entrée est null. Par exemple : "{line1 : \"345 park ave\",line2: \"bldg 2\",City : \"san jose\",State : \"CA\",type: \"office\"}"
to_map
Cette fonction prend une liste de paires clé-valeur et renvoie un mappage de paires clé-valeur.
to_map(OBJECT_INPUT)
« to_map(\« prénom\ », \« Jean\ », \« nom\ », \« Doe\ ») »
Renvoie un mappage avec des paires nom-valeur de champ données ou null si l’entrée est null. Par exemple : "{\"firstName\" : \"John\", \"lastName\": \"Doe\"}"

Opérateurs logiques logical-operators

NOTE
Veuillez faire défiler la page vers la gauche/droite pour consulter le contenu complet du tableau.
Fonction
Description
Paramètres
Syntaxe
Expression
Exemple de résultat
decode
Étant donné qu’une clé et une liste de paires clé-valeur sont aplaties dans un tableau, la fonction renvoie la valeur si la clé est trouvée ou renvoie une valeur par défaut si elle est présente dans le tableau.
  • KEY : Obligatoire clé à faire correspondre.
  • OPTIONS : obligatoire tableau aplati de paires clé/valeur. Vous pouvez éventuellement placer une valeur par défaut à la fin.
decode(KEY, OPTIONS)
decode(stateCode, « ca », « California », « pa », « Pennsylvania », « N/A »)
Si le code d’état donné est « ca », « California ».
Si le code d’état donné est « pa », « Pennsylvania ».
Si le code d’état ne correspond pas à ce qui suit, « N/A ».
iif
Évalue une expression booléenne donnée et renvoie la valeur spécifiée en fonction du résultat.
  • EXPRESSION : obligatoire expression booléenne en cours d’évaluation.
  • TRUE_VALUE : obligatoire valeur renvoyée si l’expression est évaluée comme vraie.
  • FALSE_VALUE : obligatoire valeur renvoyée si l’expression est évaluée comme égale à false.
iif(EXPRESSION, TRUE_VALUE, FALSE_VALUE)
iif("s".equalsIgnoreCase("S"), "True", "False")
"True"

Agrégation aggregation

NOTE
Veuillez faire défiler la page vers la gauche/droite pour consulter le contenu complet du tableau.
Fonction
Description
Paramètres
Syntaxe
Expression
Exemple de résultat
min
Renvoie le minimum des arguments donnés. Utilise l’ordre naturel.
  • OPTIONS : obligatoire un ou plusieurs objets pouvant être comparés les uns aux autres.
min (OPTIONS)
min(3, 1, 4)
1
max
Renvoie le maximum des arguments donnés. Utilise l’ordre naturel.
  • OPTIONS : obligatoire un ou plusieurs objets pouvant être comparés les uns aux autres.
max(OPTIONS)
max(3, 1, 4)
4

Conversions de type type-conversions

NOTE
Veuillez faire défiler la page vers la gauche/droite pour consulter le contenu complet du tableau.
Fonction
Description
Paramètres
Syntaxe
Expression
Exemple de résultat
to_bigint
Convertit une chaîne en BigInteger.
  • STRING : Obligatoire la chaîne qui doit être convertie en BigInteger.
to_bigint(STRING)
to_bigint​(« 1000000.34 »)
1000000,34
to_decimal
Convertit une chaîne en doublon.
  • STRING : Obligatoire chaîne à convertir en doublon.
to_decimal(STRING)
to_decimal(« 20.5 »)
20,5
to_float
Convertit une chaîne en flottante.
  • STRING : Obligatoire chaîne à convertir en chaîne flottante.
to_float(STRING)
to_float(« 12.3456 »)
12,34566
to_integer
Convertit une chaîne en entier.
  • STRING : obligatoire chaîne à convertir en entier.
to_integer(STRING)
to_integer(« 12 »)
12

Fonctions JSON json

NOTE
Veuillez faire défiler la page vers la gauche/droite pour consulter le contenu complet du tableau.
Fonction
Description
Paramètres
Syntaxe
Expression
Exemple de résultat
json_to_object
Désérialisez le contenu JSON à partir de la chaîne donnée.
  • STRING : obligatoire la chaîne JSON à désérialiser.
json_to_object​(STRING)
json_to_object​({« info »:{« firstName »:« John »,« lastName »: « Doe »}})
Objet représentant le fichier JSON.

Opérations spéciales special-operations

NOTE
Veuillez faire défiler la page vers la gauche/droite pour consulter le contenu complet du tableau.
Fonction
Description
Paramètres
Syntaxe
Expression
Exemple de résultat
uuid /
guid
Génère un identifiant pseudo-aléatoire.
uuid()
guid()
uuid()
guid()
7c0267d2-bb74-4e1a-9275-3bf4fccda5f4
c7016dc7-3163-43f7-afc7-2e1c9c206333
fpid_to_ecid
Cette fonction prend une chaîne FPID et la convertit en un ECID à utiliser dans les applications Adobe Experience Platform et Adobe Experience Cloud.
  • STRING : obligatoire chaîne FPID à convertir en ECID.
fpid_to_ecid(STRING)
fpid_to_ecid("4ed70bee-b654-420a-a3fd-b58b6b65e991")
"28880788470263023831040523038280731744"

Fonctions de l’agent utilisateur user-agent

L’une des fonctions de l’agent utilisateur contenues dans le tableau ci-dessous peut renvoyer l’une des valeurs suivantes :

  • Téléphone : appareil mobile doté d’un petit écran (généralement < 7 pouces)
  • Mobile : appareil mobile qui n’a pas encore été identifié. Cet appareil mobile peut être un eReader, une tablette, un téléphone, une montre, etc.

Pour plus d’informations sur les valeurs de champ de l’appareil, veuillez lire la liste des valeurs de champ de l’appareil dans l’annexe de ce document.

NOTE
Veuillez faire défiler la page vers la gauche/droite pour consulter le contenu complet du tableau.
Fonction
Description
Paramètres
Syntaxe
Expression
Exemple de résultat
ua_os_name
Extrait le nom du système d’exploitation de la chaîne de l’agent utilisateur.
  • USER_AGENT : obligatoire chaîne de l’agent utilisateur.
ua_os_name​(USER_AGENT)
ua_os_name​(« Mozilla/5.0 (iPhone ; CPU iPhone OS 5_1_1 comme Mac OS X) AppleWebKit/534.46 (KHTML, comme Gecko) Version/5.1 Mobile/9B206 Safari/7534.48.3 »)
iOS
ua_os_version_major
Extrait la version majeure du système d’exploitation de la chaîne de l’agent utilisateur.
  • USER_AGENT : obligatoire chaîne de l’agent utilisateur.
ua_os_version_major​(USER_AGENT)
ua_os_version_major​s(« Mozilla/5.0 (iPhone ; CPU iPhone OS 5_1_1 comme Mac OS X) AppleWebKit/534.46 (KHTML, comme Gecko) Version/5.1 Mobile/9B206 Safari/7534.48.3 »)
IOS 5
ua_os_version
Extrait la version du système d’exploitation de la chaîne de l’agent utilisateur.
  • USER_AGENT : obligatoire chaîne de l’agent utilisateur.
ua_os_version​(USER_AGENT)
ua_os_version​(« Mozilla/5.0 (iPhone ; CPU iPhone OS 5_1_1 comme Mac OS X) AppleWebKit/534.46 (KHTML, comme Gecko) Version/5.1 Mobile/9B206 Safari/7534.48.3 »)
5.1.1
ua_os_name_version
Extrait le nom et la version du système d’exploitation de la chaîne de l’agent utilisateur.
  • USER_AGENT : obligatoire chaîne de l’agent utilisateur.
ua_os_name_version​(USER_AGENT)
ua_os_name_version​(« Mozilla/5.0 (iPhone ; CPU iPhone OS 5_1_1 comme Mac OS X) AppleWebKit/534.46 (KHTML, comme Gecko) Version/5.1 Mobile/9B206 Safari/7534.48.3 »)
iOS 5.1.1
ua_agent_version
Extrait la version de l’agent de la chaîne de l’agent utilisateur.
  • USER_AGENT : obligatoire chaîne de l’agent utilisateur.
ua_agent_version​(USER_AGENT)
ua_agent_version​(« Mozilla/5.0 (iPhone ; CPU iPhone OS 5_1_1 comme Mac OS X) AppleWebKit/534.46 (KHTML, comme Gecko) Version/5.1 Mobile/9B206 Safari/7534.48.3 »)
5,1
ua_agent_version_major
Extrait le nom de l’agent et la version majeure de la chaîne de l’agent utilisateur.
  • USER_AGENT : obligatoire chaîne de l’agent utilisateur.
ua_agent_version_major​(USER_AGENT)
ua_agent_version_major​(« Mozilla/5.0 (iPhone ; CPU iPhone OS 5_1_1 comme Mac OS X) AppleWebKit/534.46 (KHTML, comme Gecko) Version/5.1 Mobile/9B206 Safari/7534.48.3 »)
Safari 5
ua_agent_name
Extrait le nom de l’agent de la chaîne de l’agent utilisateur.
  • USER_AGENT : obligatoire chaîne de l’agent utilisateur.
ua_agent_name​(USER_AGENT)
ua_agent_name​(« Mozilla/5.0 (iPhone ; CPU iPhone OS 5_1_1 comme Mac OS X) AppleWebKit/534.46 (KHTML, comme Gecko) Version/5.1 Mobile/9B206 Safari/7534.48.3 »)
Safari
ua_device_class
Extrait la classe de périphérique de la chaîne de l'agent utilisateur.
  • USER_AGENT : obligatoire chaîne de l’agent utilisateur.
ua_device_class​(USER_AGENT)
ua_device_class​(« Mozilla/5.0 (iPhone ; CPU iPhone OS 5_1_1 comme Mac OS X) AppleWebKit/534.46 (KHTML, comme Gecko) Version/5.1 Mobile/9B206 Safari/7534.48.3 »)
Téléphone

Fonctions Analytics analytics

NOTE
Vous ne pouvez utiliser que les fonctions d’analyse suivantes pour les flux WebSDK et Adobe Analytics.
Fonction
Description
Paramètres
Syntaxe
Expression
Exemple de résultat
aa_get_event_id
Extrait l’identifiant d’événement d’une chaîne d’événement Analytics.
  • EVENT_STRING : obligatoire chaîne d’événement Analytics séparée par des virgules.
  • EVENT_NAME : Obligatoire nom de l’événement à extraire et identifiant de celui-ci.
aa_get_event_id(EVENT_STRING, EVENT_NAME)
aa_get_event_id(« event101=5:123456,scOpen », « event101 »)
123456
aa_get_event_value
Extrait la valeur de l’événement d’une chaîne d’événement Analytics. Si la valeur de l’événement n’est pas spécifiée, 1 est renvoyée.
  • EVENT_STRING : obligatoire chaîne d’événement Analytics séparée par des virgules.
  • EVENT_NAME : Obligatoire nom de l’événement duquel extraire une valeur.
aa_get_event_value(EVENT_STRING, EVENT_NAME)
aa_get_event_value(« event101=5:123456,scOpen », « event101 »)
5
aa_get_product_categories
Extrait la catégorie de produits d’une chaîne de produits Analytics.
  • PRODUCTS_STRING : obligatoire chaîne de produits Analytics.
aa_get_product_categories(PRODUCTS_STRING)
aa_get_product_categories( »;Exemple de produit 1;1;3.50,Exemple de catégorie 2;Exemple de produit 2;1;5.99 »)
[null,« Exemple catégorie 2 »]
aa_get_product_names
Extrait le nom du produit d’une chaîne de produits Analytics.
  • PRODUCTS_STRING : obligatoire chaîne de produits Analytics.
aa_get_product_names(PRODUCTS_STRING)
aa_get_product_names( »;Exemple de produit 1;1;3.50,Exemple de catégorie 2;Exemple de produit 2;1;5.99 »)
[« Exemple de produit 1 »,« Exemple de produit 2 »]
aa_get_product_quantity
Extrait les quantités d’une chaîne de produits Analytics.
  • PRODUCTS_STRING : obligatoire chaîne de produits Analytics.
aa_get_product_quantity(PRODUCTS_STRING)
aa_get_product_quantity( »;Exemple de produit 1;1;3.50,Exemple de catégorie 2;Exemple de produit 2 »)
[« 1 », nul]
aa_get_product_price
Extrait le prix d’une chaîne de produits Analytics.
  • PRODUCTS_STRING : obligatoire chaîne de produits Analytics.
aa_get_product_price(PRODUCTS_STRING)
aa_get_product_price( »;Exemple de produit 1;1;3.50,Exemple de catégorie 2;Exemple de produit 2 »)
[« 3.50 », nul]
aa_get_product_event_values
Extrait les valeurs de l’événement nommé de la chaîne products sous la forme d’un tableau de chaînes.
  • PRODUCTS_STRING : obligatoire chaîne de produits Analytics.
  • EVENT_NAME : Obligatoire nom de l’événement duquel extraire les valeurs.
aa_get_product_event_values(PRODUCTS_STRING, EVENT_NAME)
aa_get_product_event_values( »;Exemple de produit 1;1;4.20;event1=2.3|event2=5:1,;Exemple de produit 2;1;4.20;event1=3|event2=2:2 », « event1 »)
[« 2.3 », « 3 »]
aa_get_product_evars
Extrait les valeurs d’evar de l’événement nommé de la chaîne products sous la forme d’un tableau de chaînes.
  • PRODUCTS_STRING : obligatoire chaîne de produits Analytics.
  • EVAR_NAME : obligatoire nom d’eVar à extraire.
aa_get_product_evars(PRODUCTS_STRING, EVENT_NAME)
aa_get_product_evars( »;Exemple de produit;1;6.69;;eVar1=Valeur de marchandisage », « eVar1 »)
[ « Valeur de marchandisage »]

Copie d’objet object-copy

TIP
La fonction de copie d’objet est automatiquement appliquée lorsqu’un objet de la source est mappé à un objet du XDM. Aucune action supplémentaire n’est nécessaire de la part des utilisateurs.

Vous pouvez utiliser la fonction de copie d’objet pour copier automatiquement les attributs d’un objet sans apporter de modifications au mappage. Par exemple, si vos données source ont une structure de :

address{
        line1: 4191 Ridgebrook Way,
        city: San Jose,
        state: California
        }

et une structure XDM de :

addr{
    addrLine1: 4191 Ridgebrook Way,
    city: San Jose,
    state: California
    }

Le mappage devient alors :

address -> addr
address.line1 -> addr.addrLine1

Dans l’exemple ci-dessus, les attributs city et state sont également ingérés automatiquement au moment de l’exécution, car l’objet address est mappé à addr. Si vous deviez créer un attribut line2 dans la structure XDM et que vos données d’entrée contiennent également un line2 dans l’objet address , il sera également ingéré automatiquement sans avoir à modifier manuellement le mappage.

Pour que le mappage automatique fonctionne, les conditions préalables suivantes doivent être remplies :

  • Les objets au niveau du parent doivent être mappés ;
  • De nouveaux attributs doivent avoir été créés dans le schéma XDM ;
  • Les nouveaux attributs doivent avoir des noms correspondants dans le schéma source et le schéma XDM.

Si l’une des conditions préalables n’est pas remplie, vous devez mapper manuellement le schéma source au schéma XDM à l’aide de la préparation des données.

Annexe

Vous trouverez ci-dessous des informations supplémentaires sur l’utilisation des fonctions de mappage de la préparation des données

Caractères spéciaux special-characters

Le tableau ci-dessous présente une liste des caractères réservés et les caractères codés correspondants.

Caractère réservé
Caractère codé
space
%20
!
%21
«
%22
#
%23
$
%24
%
%25
&
%26
'
%27
(
%28
)
%29
*
%2A
+
%2B
,
%2C
/
%2F
:
%3A
%3B
<
%3C
=
%3D
>
%3E
?
%3F
@
%40
[
%5B
]
%5J
^
%5E
`
%60
~
%7E

Valeurs de champ de l’appareil device-field-values

Le tableau ci-dessous présente une liste des valeurs de champ d’appareil et leurs descriptions correspondantes.

Appareil
Description
Bureau
Un ordinateur de bureau ou un ordinateur portable.
Anonymisé
Un appareil anonyme. Dans certains cas, ces useragents ont été modifiées par un logiciel d’anonymisation.
Inconnu
Un appareil inconnu. Il s’agit généralement de useragents qui ne contiennent aucune information sur le périphérique.
Mobile
Appareil mobile qui n’a pas encore été identifié. Cet appareil mobile peut être un eReader, une tablette, un téléphone, une montre, etc.
Tablette
Appareil mobile avec un grand écran (généralement > 7 pouces).
Téléphone
Appareil mobile doté d’un petit écran (généralement < 7 pouces).
Regarder
Appareil mobile doté d’un petit écran (généralement < 2 pouces). Ces appareils fonctionnent normalement comme un écran supplémentaire pour un appareil de type téléphone/tablette.
Réalité Augmentée
Un appareil mobile avec des fonctionnalités de réalité augmentée.
Réalité Virtuelle
Un appareil mobile avec des fonctionnalités de réalité virtuelle.
Reader
Appareil similaire à une tablette, mais généralement doté d’un écran eInk.
Décodeur
Un appareil connecté qui permet une interaction via un écran de la taille d’un téléviseur.
TV
Un appareil similaire au décodeur, mais intégré au téléviseur.
Appareil Électroménager
Appareil ménager (généralement de grande taille), tel qu’un réfrigérateur.
Console de jeux
Un système de jeu fixe comme un Playstation ou un XBox.
Console de jeu portable
Un système de jeu mobile comme un Nintendo Switch.
Voix
Appareil à commande vocale tel qu’un Amazon Alexa ou un Google Home.
Voiture
Un navigateur basé sur un véhicule.
Robot
Des robots qui visitent un site web.
Robot Mobile
Robots qui visitent un site web, mais qui indiquent qu’ils souhaitent être considérés comme des visiteurs mobiles.
Imitateur Robot
Des robots qui visitent un site web, prétendant être des robots comme Google, mais ce n'est pas le cas. Note : Dans la plupart des cas, les imitateurs de robots sont en effet des robots.
Cloud
Une application cloud. Ce ne sont ni des robots ni des hackers, mais des applications qui doivent se connecter. Cela inclut les serveurs Mastodon.
Hacker
Cette valeur d’appareil est utilisée si un script est détecté dans la chaîne de useragent.

Exemples de code code-samples

map_get_values map-get-values

Sélectionner pour afficher l’exemple
code language-json 
 example = "map_get_values(book_details,\"author\") where input is : {\n" +
        "    \"book_details\":\n" +
        "    {\n" +
        "        \"author\": \"George R. R. Martin\",\n" +
        "        \"price\": 17.99,\n" +
        "        \"ISBN\": \"ISBN-978-0553801477\"\n" +
        "    }\n" +
        "}",
      result = "{\"author\": \"George R. R. Martin\"}"

map_has_keys map_has_keys

Sélectionner pour afficher l’exemple
code language-json 
 example = "map_has_keys(book_details,\"author\")where input is : {\n" +
        "    \"book_details\":\n" +
        "    {\n" +
        "        \"author\": \"George R. R. Martin\",\n" +
        "        \"price\": 17.99,\n" +
        "        \"ISBN\": \"ISBN-978-0553801477\"\n" +
        "    }\n" +
        "}",
      result = "true"

add_to_map add_to_map

Sélectionner pour afficher l’exemple
code language-json 
example = "add_to_map(book_details, book_details2) where input is {\n" +
        "    \"book_details\":\n" +
        "    {\n" +
        "        \"author\": \"George R. R. Martin\",\n" +
        "        \"price\": 17.99,\n" +
        "        \"ISBN\": \"ISBN-978-0553801477\"\n" +
        "    }\n" +
        "}" +
        "{\n" +
        "    \"book_details2\":\n" +
        "    {\n" +
        "        \"author\": \"Neil Gaiman\",\n" +
        "        \"price\": 17.99,\n" +
        "        \"ISBN\": \"ISBN-0-380-97365-0\"\n" +
        "        \"publisher\": \"William Morrow\"\n" +
        "    }\n" +
        "}",
      result = "{\n" +
        "    \"book_details\":\n" +
        "    {\n" +
        "        \"author\": \"George R. R. Martin\",\n" +
        "        \"price\": 17.99,\n" +
        "        \"ISBN\": \"ISBN-978-0553801477\"\n" +
        "        \"publisher\": \"William Morrow\"\n" +
        "    }\n" +
        "}",
      returns = "A new map with all elements from map and addends"

object_to_map object_to_map

Syntaxe 1

Sélectionner pour afficher l’exemple
code language-json 
example = "object_to_map(\"firstName\", \"John\", \"lastName\", \"Doe\")",
result = "{\"firstName\" : \"John\", \"lastName\": \"Doe\"}"

Syntaxe 2

Sélectionner pour afficher l’exemple
code language-json 
example = "object_to_map(address) where input is " +
  "address: {line1 : \"345 park ave\",line2: \"bldg 2\",City : \"san jose\",State : \"CA\",type: \"office\"}",
result = "{line1 : \"345 park ave\",line2: \"bldg 2\",City : \"san jose\",State : \"CA\",type: \"office\"}"

Syntaxe 3

Sélectionner pour afficher l’exemple
code language-json 
example = "object_to_map(addresses,type)" +
        "\n" +
        "[\n" +
        "    {\n" +
        "        \"line1\": \"345 park ave\",\n" +
        "        \"line2\": \"bldg 2\",\n" +
        "        \"City\": \"san jose\",\n" +
        "        \"State\": \"CA\",\n" +
        "        \"type\": \"home\"\n" +
        "    },\n" +
        "    {\n" +
        "        \"line1\": \"345 park ave\",\n" +
        "        \"line2\": \"bldg 2\",\n" +
        "        \"City \": \"san jose\",\n" +
        "        \"State\": \"CA\",\n" +
        "        \"type\": \"work\"\n" +
        "    },\n" +
        "    {\n" +
        "        \"line1\": \"345 park ave\",\n" +
        "        \"line2\": \"bldg 2\",\n" +
        "        \"City \": \"san jose\",\n" +
        "        \"State\": \"CA\",\n" +
        "        \"type\": \"office\"\n" +
        "    }\n" +
        "]" ,
result = "{\n" +
        "    \"home\":\n" +
        "    {\n" +
        "        \"line1\": \"345 park ave\",\n" +
        "        \"line2\": \"bldg 2\",\n" +
        "        \"City\": \"san jose\",\n" +
        "        \"State\": \"CA\",\n" +
        "        \"type\": \"home\"\n" +
        "    },\n" +
        "    \"work\":\n" +
        "    {\n" +
        "        \"line1\": \"345 park ave\",\n" +
        "        \"line2\": \"bldg 2\",\n" +
        "        \"City \": \"san jose\",\n" +
        "        \"State\": \"CA\",\n" +
        "        \"type\": \"work\"\n" +
        "    },\n" +
        "    \"office\":\n" +
        "    {\n" +
        "        \"line1\": \"345 park ave\",\n" +
        "        \"line2\": \"bldg 2\",\n" +
        "        \"City \": \"san jose\",\n" +
        "        \"State\": \"CA\",\n" +
        "        \"type\": \"office\"\n" +
        "    }\n" +
        "}"

array_to_map array_to_map

Sélectionner pour afficher l’exemple
code language-json 
example = "array_to_map(addresses, \"type\") where addresses is\n" +
  "\n" +
  "[\n" +
  "    {\n" +
  "        \"line1\": \"345 park ave\",\n" +
  "        \"line2\": \"bldg 2\",\n" +
  "        \"City\": \"san jose\",\n" +
  "        \"State\": \"CA\",\n" +
  "        \"type\": \"home\"\n" +
  "    },\n" +
  "    {\n" +
  "        \"line1\": \"345 park ave\",\n" +
  "        \"line2\": \"bldg 2\",\n" +
  "        \"City \": \"san jose\",\n" +
  "        \"State\": \"CA\",\n" +
  "        \"type\": \"work\"\n" +
  "    },\n" +
  "    {\n" +
  "        \"line1\": \"345 park ave\",\n" +
  "        \"line2\": \"bldg 2\",\n" +
  "        \"City \": \"san jose\",\n" +
  "        \"State\": \"CA\",\n" +
  "        \"type\": \"office\"\n" +
  "    }\n" +
  "]" ,
result = "{\n" +
  "    \"home\":\n" +
  "    {\n" +
  "        \"line1\": \"345 park ave\",\n" +
  "        \"line2\": \"bldg 2\",\n" +
  "        \"City\": \"san jose\",\n" +
  "        \"State\": \"CA\",\n" +
  "        \"type\": \"home\"\n" +
  "    },\n" +
  "    \"work\":\n" +
  "    {\n" +
  "        \"line1\": \"345 park ave\",\n" +
  "        \"line2\": \"bldg 2\",\n" +
  "        \"City \": \"san jose\",\n" +
  "        \"State\": \"CA\",\n" +
  "        \"type\": \"work\"\n" +
  "    },\n" +
  "    \"office\":\n" +
  "    {\n" +
  "        \"line1\": \"345 park ave\",\n" +
  "        \"line2\": \"bldg 2\",\n" +
  "        \"City \": \"san jose\",\n" +
  "        \"State\": \"CA\",\n" +
  "        \"type\": \"office\"\n" +
  "    }\n" +
  "}",
returns = "Returns a map with given field name and value pairs or null if input is null"
recommendation-more-help
461cc884-c234-4a0c-ac75-6efbaafc1394