Fonctions de mappage de la préparation des données
Les fonctions de préparation de données peuvent être utilisées pour calculer les valeurs en fonction de ce qui est entré dans les champs sources.
Champs
Un nom de champ peut être n’importe quel identifiant légal, c’est-à-dire une séquence illimitée de lettres et de chiffres Unicode, commençant par une lettre, le symbole du dollar ($) ou le caractère de soulignement (_). Les noms de variables sont également sensibles à la casse.
Si un nom de champ ne respecte pas cette convention, il doit être encadré de ${}. 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.
CONSEIL
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 échappement de caractères spéciaux.
En outre, si un nom de champ est any 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
Les données des sous-champs sont accessibles à l’aide de la notation par points. Par exemple, si une variable name pour accéder à l’objet firstName champ, utiliser name.firstName.
Liste des fonctions
Les tableaux suivants répertorient toutes les fonctions de mappage prises en charge, y compris les exemples d’expressions et les sorties qui en résultent.
Fonctions de chaîne
REMARQUE
Faites défiler vers la gauche ou vers la droite pour consulter l’intégralité du tableau.
Fonction
Description
Paramètres
Syntaxe
Expression
Exemple de résultat
concat
Concatène les chaînes données.
STRING: Chaînes qui seront concaténées.
concat(STRING_1, STRING_2)
concat("Hi, ", "there", "!")
"Hi, there!"
explode
Divise la chaîne sur base d’un regex 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 need à échapper avec \: +, ?, ^, |, ., [, (, {, ), *, $, \ Si vous incluez plusieurs caractères comme délimiteur, le délimiteur est traité comme un délimiteur à plusieurs caractères.
STRING: Obligatoire Chaîne à fractionner.
REGEX : Facultatif Expression régulière pouvant ê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 en cours de recherche.
SUBSTRING : Obligatoire Sous-chaîne recherchée dans la chaîne.
START_POSITION : Facultatif Emplacement où commencer la recherche dans la chaîne.
OCCURRENCE : Facultatif La énième occurrence à rechercher à partir de la position de départ. Par défaut, elle est définie sur 1.
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".
replacester(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 où la sous-chaîne commence.
LONGUEUR : Obligatoire Durée 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 requests à échapper avec \: \. Si vous incluez plusieurs délimiteurs, la chaîne sera fractionnée sur any des délimiteurs présents dans la chaîne.
INPUT : Obligatoire Chaîne d’entrée qui va être fractionnée.
SEPAROR : Obligatoire Chaîne utilisée pour fractionner l’entrée.
split(INPUT, SEPAROR)
split("Hello world", " ")
["Hello", "world"]
join
Joint une liste d’objets à l’aide du séparateur.
SEPAROR : 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
Ajoute le côté gauche d’une chaîne à 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 à ajouter.
PADDING : Obligatoire Chaîne avec laquelle remplir l’entrée. S’il est nul ou vide, il est traité comme un espace unique.
lpad(INPUT, COUNT, PADDING)
lpad("bat", 8, "yz")
"yzyzyzybat"
rpad
Ajoute le côté droit d’une chaîne à 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 à ajouter.
PADDING : Obligatoire Chaîne avec laquelle remplir l’entrée. S’il est nul ou vide, il est 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 n caractères que vous souhaitez récupérer de la chaîne.
left(STRING, COUNT)
left("abcde", 2)
"ab"
right
Obtient les derniers caractères "n" de la chaîne donnée.
STRING: Obligatoire Chaîne pour laquelle vous obtenez les derniers caractères "n".
COUNT : Obligatoire Les n caractères que vous souhaitez récupérer de la chaîne.
right(STRING, COUNT)
right("abcde", 2)
"de"
ltrim
Supprime l’espace blanc du début de la chaîne.
STRING: Obligatoire Chaîne dont vous souhaitez supprimer l’espace blanc.
ltrim(STRING)
ltrim(" hello")
"hello"
rtrim
Supprime l’espace blanc de la fin de la chaîne.
STRING: Obligatoire Chaîne dont vous souhaitez supprimer l’espace blanc.
rtrim(STRING)
rtrim("hello")
"hello"
trim
Supprime l’espace blanc du début et de la fin de la chaîne.
STRING: Obligatoire Chaîne dont vous souhaitez supprimer l’espace blanc.
trim(STRING)
trim(" hello ")
"hello"
est égal à
Compare deux chaînes pour confirmer si elles sont égales. Cette fonction est sensible à la casse.
STRING1 : Obligatoire Première chaîne à comparer.
STRING2 : Obligatoire La deuxième chaîne que vous souhaitez comparer.
STRING1. equals( STRING2)
"string1". est égal à ("STRING1")
false
equalsIgnoreCase
Compare deux chaînes pour confirmer si elles sont égales. Cette fonction est not sensible à la casse.
STRING1 : Obligatoire Première chaîne à comparer.
STRING2 : Obligatoire La deuxième chaîne que vous souhaitez 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 L’expression régulière que vous souhaitez que le groupe corresponde.
Renvoie le chemin d’accès de l’URL donnée. Par défaut, le chemin complet est renvoyé.
URL : Obligatoire URL à partir de laquelle le chemin d’accès doit être extrait.
FULL_PATH : Facultatif Une valeur boolean qui détermine si le chemin complet est renvoyé. S’il est défini sur false, seule la fin du chemin est renvoyée.
Renvoie la chaîne de requête d’une URL donnée sous la forme d’un mappage de nom de chaîne de requête et de valeur de chaîne de requête.
URL : Obligatoire URL à partir de laquelle vous essayez d’obtenir la chaîne de requête.
ANCRAGE : Obligatoire Détermine ce qui sera fait avec l’ancre dans la chaîne de requête. Peut être l’une des trois valeurs suivantes : "keep" (conserver), "remove" (supprimer) ou "append" (ajouter).
Si la valeur est "preserve", l’ancre est associée à la valeur renvoyée. Si la valeur est "remove", l’ancre est supprimée de la valeur renvoyée. Si la valeur est "append", l’ancre est renvoyée sous la forme d’une valeur distincte.
Cette fonction utilise une URL comme entrée et remplace ou code les caractères spéciaux avec des caractères ASCII. Pour plus d’informations sur les caractères spéciaux, veuillez lire la section liste de caractères spéciaux dans l’annexe du présent document.
URL : Obligatoire L’URL d’entrée avec des caractères spéciaux que vous souhaitez remplacer ou coder avec des caractères ASCII.
Cette fonction utilise 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 section liste de caractères spéciaux dans l’annexe du présent document.
URL : Obligatoire URL d’entrée contenant des caractères ASCII que vous souhaitez décoder en caractères spéciaux.
Faites défiler vers la gauche ou vers la droite pour consulter l’intégralité du tableau. En savoir plus sur la variable date se trouve dans la section dates de la fonction guide de 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 La date d’entrée, en tant qu’objet ZonedDateTime, que vous souhaitez mettre en forme.
FORMAT : Obligatoire Le format vers lequel vous souhaitez que la date soit modifiée.
Convertit une chaîne de date en objet ZonedDateTime (format ISO 8601).
DATE : Obligatoire Chaîne représentant la date.
FORMAT : Obligatoire Chaîne représentant le format de la date source.Remarque : Cela signifie que not représentent le format dans lequel vous souhaitez convertir la chaîne de date.
DEFAULT_DATE : Obligatoire La date par défaut renvoyée, si la date fournie est nulle.
Convertit une chaîne de date en objet ZonedDateTime (format ISO 8601).
DATE : Obligatoire Chaîne représentant la date.
FORMAT : Obligatoire Chaîne représentant le format de la date source.Remarque : Cela signifie que not représentent le 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 représentant 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" "aaaa" "yy"
"quart" "qq" "q"
"month" "mm" "m"
"dayofyear" "dy" "y"
"day" "dd" "d"
"week" "ss" "w"
"weekday" "dw" "w"
"hour" "hh" "hh24" "hh12"
"minute" "mi" "n"
"second" "ss" "s"
"milliseconde" "SSS"
COMPOSANT : Obligatoire Chaîne représentant la partie de la date.
DATE : Obligatoire La date, dans un 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 La valeur à définir pour le composant pour une date donnée.
DATE : Obligatoire La date, dans un format standard.
STRING: Obligatoire Chaîne analysée 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-champ. Le délimiteur par défaut est ,.
str_to_object (STRING, VALUE_DELIMITER, FIELD_DELIMITER) Remarque: Vous pouvez utiliser la variable get() fonction avec str_to_object() pour récupérer les valeurs des clés dans 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 #2 : “John”
contains_key
Vérifie si l’objet existe dans les données source. Remarque : Cette fonction remplace le is_set() fonction .
INPUT : Obligatoire Chemin à vérifier s’il existe dans les données source.
contains_key(INPUT)
contains_key("evars.evar.field1")
vrai
nullify
Définit la valeur de l’attribut sur null. Vous devez l’utiliser 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.
OBJECT : Obligatoire Objet à partir duquel les clés seront extraites.
get_keys(OBJECT)
get_keys({"book1": "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 à analyser.
CLÉ : Obligatoire Clé pour laquelle la valeur doit être extraite.
VALUE_DELIMITER: Obligatoire Délimiteur qui sépare le champ de la valeur. Si l’une des variables null ou une chaîne vide est fournie, cette valeur est :.
FIELD_DELIMITER : Facultatif Délimiteur qui sépare les paires champ-valeur. Si l’une des variables null ou une chaîne vide est fournie, cette valeur est ,.
INPUT : Obligatoire Le 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 Le tableau dont vous souhaitez trouver le dernier élément.
last(INPUT)
last("1", "2", "3")
"3"
add_to_array
Ajoute des éléments à la fin du tableau.
ARRAY : Obligatoire Le tableau auquel vous ajoutez des éléments.
VALEURS : Éléments que vous souhaitez ajouter au tableau.
add_to_array (ARRAY, VALUES)
add_to_array (['a', 'b'], "c", "d")
['a', 'b', 'c', 'd']
join_arrays
Combine les tableaux les uns avec les autres.
ARRAY : Obligatoire Le tableau auquel vous ajoutez des éléments.
VALEURS : Les tableaux que vous souhaitez ajouter au tableau parent.
join_arrays (ARRAY, VALES)
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 boolean indiquant s’il faut inclure ou non les valeurs nulles dans le tableau de réponse.
VALEURS : Obligatoire Les é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 L'objet dont vous essayez de trouver 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 du tableau d’entrée entier à la fin du tableau dans Profile. Cette fonction est only applicable pendant les mises à jour. Si elle est utilisée dans le contexte d’insertions, cette fonction renvoie l’entrée telle quelle.
ARRAY : Obligatoire Tableau à ajouter au 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 d’un tableau. Cette fonction est only applicable pendant les mises à jour. Si elle est utilisée dans le contexte d’insertions, cette fonction renvoie l’entrée telle quelle.
ARRAY : Obligatoire Tableau à remplacer dans le profil.
upsert_array_replace(ARRAY)
upsert_array_replace([123, 456], 1)
[123, 456]
Opérateurs logiques
REMARQUE
Faites défiler vers la gauche ou vers la droite pour consulter l’intégralité 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.
CLÉ : Obligatoire Clé à mettre en correspondance.
OPTIONS : Obligatoire Tableau aplati de paires clé/valeur. Vous pouvez éventuellement placer une valeur par défaut à la fin.
Toutes les fonctions de l’agent utilisateur contenues dans le tableau ci-dessous peuvent renvoyer l’une des valeurs suivantes :
Phone : appareil mobile avec un petit écran (généralement < 7").
Mobile : périphérique mobile qui n’est pas encore identifié. Ce périphérique mobile peut être un lecteur électronique, une tablette, un téléphone, une montre, etc.
REMARQUE
Faites défiler vers la gauche ou vers la droite pour consulter l’intégralité 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); Processeur 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 principale 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); Processeur 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); Processeur 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); Processeur 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); Processeur 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; Processeur 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); Processeur 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 device de la chaîne user agent.
USER_AGENT : Obligatoire Chaîne de l’agent utilisateur.
ua_device_class (USER_AGENT)
ua_device_class ("Mozilla/5.0 (iPhone); Processeur 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
Copie d’objet
CONSEIL
La fonction de copie d’objet est automatiquement appliquée lorsqu’un objet de la source est mappé à un objet dans 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
}
Ensuite, le mappage devient :
address -> addr
address.line1 -> addr.addrLine1
Dans l’exemple ci-dessus, la variable city et state Les attributs sont également ingérés automatiquement au moment de l’exécution, car la variable address est mappé sur addr. Si vous deviez créer une line2 dans la structure XDM et vos données d’entrée contiennent également un line2 dans le 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 de niveau 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 aucune des conditions préalables n’est 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 de données
Caractères spéciaux
Le tableau ci-dessous présente une liste de caractères réservés et les caractères codés correspondants.
