Show Menu
SUJETS×

Mappage d’un fichier CSV à un schéma XDM

Pour importer des données CSV dans Adobe Experience Platform, les données doivent être mises en correspondance avec un schéma de modèle de données d’expérience (XDM). Ce didacticiel explique comment mapper un fichier CSV à un schéma XDM à l’aide de l’interface utilisateur de la plateforme d’expérience.
En outre, l'annexe du présent didacticiel fournit de plus amples informations sur l'utilisation des fonctions de cartographie.

Prise en main

Ce didacticiel nécessite une compréhension pratique des composants suivants d’Adobe Experience Platform :
Ce didacticiel nécessite également que vous ayez déjà créé un jeu de données dans lequel intégrer vos données CSV. Pour connaître les étapes de création d’un jeu de données dans l’interface utilisateur, consultez le didacticiel sur l’assimilation des données.

Données Ajouter

Dans l’interface utilisateur de la plateforme d’expérience, cliquez sur Workflows dans le volet de navigation de gauche, puis cliquez sur Mapper le fichier CSV au schéma XDM. Dans le rail de droite qui s’affiche, cliquez sur Lancer .
Le flux de travail Faire correspondre le fichier CSV au schéma XDM s’affiche, en commençant par l’étape des données __ Ajouter.
Faites glisser votre fichier CSV dans l’espace prévu à cet effet ou cliquez sur Parcourir pour sélectionner directement un fichier. Une section Exemple de données s’affiche une fois le fichier téléchargé et affiche les dix premières lignes de données. Une fois que vous avez confirmé que les données ont été téléchargées comme prévu, cliquez sur Suivant .

Choisir une destination

The Destination step appears. Dans la liste fournie, sélectionnez le jeu de données dans lequel les données CSV seront assimilées, puis cliquez sur Suivant .

Mappage des champs CSV aux champs de schéma XDM

The Mapping step appears. Les colonnes du fichier CSV sont répertoriées sous Champ __ source, et leurs champs de schéma XDM correspondants sont répertoriés sous Champ de Cible. Les champs de cible non sélectionnés sont indiqués en rouge.
Pour mapper une colonne CSV à un champ XDM, cliquez sur l’icône de schéma en regard du champ de cible correspondant à la colonne.
La fenêtre Sélectionner un champ de schéma s'affiche. Ici, vous pouvez parcourir la structure du schéma XDM et localiser le champ vers lequel vous souhaitez mapper la colonne CSV. Cliquez sur un champ XDM pour le sélectionner, puis sur Sélectionner .
L’écran Mappage réapparaît, le champ XDM sélectionné s’affichant désormais sous Champ de Cible.
Si vous ne souhaitez pas mapper une colonne CSV particulière, vous pouvez supprimer le mappage en cliquant sur l’icône Supprimer située en regard du champ de cible. Si vous souhaitez ajouter un nouveau mappage, cliquez sur Ajouter nouveau mappage au bas de la liste.
Lors du mappage de champs, vous pouvez également inclure des fonctions pour calculer les valeurs en fonction des champs de source d’entrée. Pour plus d’informations, voir la section relative aux fonctions de mappage dans l’annexe.
Répétez les étapes ci-dessus pour continuer à mapper les colonnes CSV aux champs XDM. Une fois que vous avez terminé, cliquez sur Suivant .

Données d’entrée

L’étape d’envoi s’affiche, vous permettant de vérifier les détails de votre fichier source et de votre jeu de données de cible. Cliquez sur Inviter au début d’assimilation des données CSV. Selon la taille du fichier CSV, ce processus peut prendre plusieurs minutes. L’écran se met à jour une fois l’assimilation terminée, ce qui indique la réussite ou l’échec. Click Finish to complete the workflow.

Étapes suivantes

En suivant ce didacticiel, vous avez mappé avec succès un fichier CSV aplati à un schéma XDM et l’avez ingéré dans Platform. Ces données peuvent désormais être utilisées par les services de plateforme en aval tels que le Profil client en temps réel. Pour plus d’informations, consultez la présentation du Profil client en temps réel.

Annexe

La section suivante fournit des informations supplémentaires sur le mappage des colonnes CSV aux champs XDM.

Fonctions de mappage

Certaines fonctions de mappage peuvent être utilisées pour calculer et calculer des valeurs en fonction de ce qui est entré dans les champs source. Pour utiliser une fonction, tapez-la sous Champ __ source avec la syntaxe et les entrées appropriées.
Par exemple, pour concaténer des champs CSV de ville et de pays et les affecter au champ XDM de ville , définissez le champ source comme concat(city, ", ", county) .
Le tableau ci-dessous liste toutes les fonctions de mappage prises en charge, y compris les exemples d’expressions et leurs résultats.
Fonction
Description
Exemple d’expression
Exemple de sortie
concat
Concatène les chaînes données.
concat("Bonjour, ", "là", "!")
"Hi, there!"
exploser
Scinde la chaîne en fonction d’un regex et renvoie un tableau de parties.
explode("Salut, voilà !", " ")
["Hi,", "there"]
order
Renvoie l’emplacement/l’index d’une sous-chaîne.
("adobe .com", "com")
6
remplacer
Remplace la chaîne de recherche si elle est présente dans la chaîne d’origine.
replacestr("This is a string re test", "re", "replace")
"Test de remplacement de chaîne"
substr
Renvoie une sous-chaîne d’une longueur donnée.
translate("Ceci est un test de sous-chaîne", 7, 8)
"a subst"
lower /
lcase
Convertit une chaîne en minuscules.
lower("HeLLo")
lcase("HeLLo")
"hello"
upper /
ucase
Convertit une chaîne en majuscules.
upper("HeLLo")
ucase("HeLLo")
"BONJOUR"
scinder
Scinde une chaîne d’entrée sur un séparateur.
split("Hello world", " ")
["Hello", "world"]
join
Rejoint une liste d’objets à l’aide du séparateur.
join(" ", ["Hello", "world"] )
"Bonjour le monde"
coalesce
Renvoie le premier objet non nul dans une liste donnée.
coalesce(null, null, null, "first", null, "second")
"first"
décoder
Compte tenu d'une clé et d'une liste de paires clé-valeur aplaties en tant que tableau, la fonction renvoie la valeur si clé est trouvée ou renvoie une valeur par défaut si elle est présente dans le tableau.
decode("k2", "k1", "v1", "k2", "v2", "default")
"v2"
iif
Evalue une expression booléenne donnée et renvoie la valeur spécifiée en fonction du résultat.
iif("s".equalsIgnoreCase("S"), "True", "False")
"True"
min
Renvoie le minimum d'arguments donnés. Utilise l’ordre naturel.
min(3, 1, 4)
1
max
Renvoie le maximum des arguments donnés. Utilise l’ordre naturel.
max(3, 1, 4)
4
first
Récupère le premier argument donné.
first("1", "2", "3")
"1"
last
Récupère le dernier argument donné.
last("1", "2", "3")
"3"
uuid /
guid
Génère un ID pseudo-aléatoire.
uuid()
guid()
now
Récupère l’heure actuelle.
now()
2019-10-23T10:10:24.556-07:00[America/Los_Angeles]
timestamp
Récupère l'heure Unix actuelle.
timestamp()
1571850624571
format
Formate la date d’entrée selon un format spécifié.
format(, "aaaa-MM-jj HH:mm:ss")
"2019-10-23 11:24:35"
dformat
Convertit un horodatage en chaîne de date selon un format spécifié.
dformat(1571829875, "jj-MMM-aaaa hh:mm")
"23-Oct-2019 11:24"
date
Convertit une chaîne de date en objet ZonedDateTime (format ISO 8601).
date("23-Oct-2019 11:24")
"2019-10-23T11:24:00+00:00"
date_part
Récupère les parties de la date. Les valeurs de composant suivantes sont prises en charge :
"année"
"aaaa"
"yy"
"trimestre"
"qq"
"q"
"month"
"mm""m""dayof year""le"jour"y""jour"de""de""semaine""w""jour de la semaine""w"jour de la semaine""w"w"h"h"h"wj"wj"h"h"h""h"h"semaine"h"h"semaine""h"h"h"h"h"h"h"h"h" h""hh24""hh12""minute"mi""n"second""s""milliseconde""ms"
date_part(date("2019-10-17 11:55:12"), "MM")
10
set_date_part
Remplace un composant à une date donnée. Les composants suivants sont acceptés :
"année"
"aaaa"
"yy"
"month"
"mm"
"m"
day"
"dd"""hour""hh""minute"mi""n""second""s"""
set_date_part("m", 4, date("2016-11-09T11:44.797")
"2016-04-09T11:44:44.797"
make_date_time /
make_timestamp
Crée une date à partir de pièces.
make_date_time(2019, 10, 17, 11, 55, 12, 999, "America/Los_Angeles")
2019-10-17T11:55:12.0​00000999-07:00[America/Los_Angeles]
current_timestamp
Renvoie l’horodatage actuel.
current_timestamp()
1571850624571
current_date
Renvoie la date actuelle sans composant d’heure.
current_date()
"18-nov.-2019"