Show Menu
SUJETS×

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

Pour importer des données CSV dans Adobe Experience Platformun schéma, les données doivent être mises en correspondance avec un Experience Data Model (XDM). Ce didacticiel explique comment mapper un fichier CSV à un schéma XDM à l’aide de l’interface Platform utilisateur.
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 de 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.

Choisir une destination

Connectez-vous à Adobe Experience Platform puis sélectionnez Workflows dans la barre de navigation de gauche pour accéder à l’espace de travail Workflows .
Dans l’écran Workflows , sélectionnez Mapper le fichier CSV au schéma XDM sous la section d’assimilation des données, puis sélectionnez Lancement.
Le flux de travail Faire correspondre le fichier CSV au schéma XDM s’affiche, en commençant par l’étape Destination . Choisissez un jeu de données dans lequel les données entrantes doivent être assimilées. Vous pouvez soit utiliser un jeu de données existant, soit en créer un nouveau.
Utiliser un jeu de données existant
Pour importer vos données CSV dans un jeu de données existant, sélectionnez Utiliser un jeu de données existant. Vous pouvez récupérer un jeu de données existant à l'aide de la fonction de recherche ou en faisant défiler la liste des jeux de données existants dans le panneau.
Pour intégrer vos données CSV dans un nouveau jeu de données, sélectionnez Créer un nouveau jeu de données et saisissez un nom et une description pour le jeu de données dans les champs fournis. Sélectionnez un schéma en utilisant la fonction de recherche ou en faisant défiler la liste des schémas fournis. Sélectionnez Suivant pour continuer.

Ajouter des données

L’étape Ajouter les données s’affiche. Faites glisser votre fichier CSV dans l’espace prévu à cet effet ou sélectionnez Choisir les fichiers pour entrer manuellement votre fichier CSV.
La 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, sélectionnez 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. Vous pouvez utiliser l’option de filtre de champs pour restreindre la liste des champs source disponibles.
Pour mapper une colonne CSV à un champ XDM, sélectionnez 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. Vous pouvez également supprimer tous les mappages en cliquant sur le bouton ​Effacer tous les mappages.
Si vous souhaitez ajouter un nouveau mappage, sélectionnez Ajouter un nouveau mappage en haut de la liste de champ ** source.
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.

Ajouter le champ calculé

Les champs calculés permettent de créer des valeurs en fonction des attributs du schéma d’entrée. Ces valeurs peuvent ensuite être attribuées à des attributs dans le schéma de cible et recevoir un nom et une description pour faciliter la référence.
Sélectionnez le bouton Ajouter le champ calculé pour continuer.
Le panneau Créer un champ calculé s’affiche. La boîte de dialogue de gauche contient les champs, fonctions et opérateurs pris en charge dans les champs calculés. Sélectionnez l’un des onglets à début pour ajouter des fonctions, des champs ou des opérateurs à l’éditeur d’expressions.
Tabulation
Description
Champs
L’onglet Champs liste les champs et les attributs disponibles dans le schéma source.
Fonctions
L'onglet Fonctions liste les fonctions disponibles pour transformer les données.
Opérateurs
L’onglet opérateurs liste les opérateurs disponibles pour transformer les données.
Vous pouvez ajouter manuellement des champs, des fonctions et des opérateurs à l’aide de l’éditeur d’expressions situé au centre. Sélectionnez l’éditeur à début de la création d’une expression.
Sélectionnez Enregistrer pour continuer.
L’écran de mappage s’affiche à nouveau avec votre nouveau champ source. Appliquez le champ de cible approprié et sélectionnez Terminer pour terminer le mappage.

Surveiller votre flux de données

Une fois votre fichier CSV mappé et créé, vous pouvez surveiller les données qui y sont ingérées. Pour plus d’informations sur la surveillance des flux de données, voir le didacticiel sur la surveillance des flux de données en flux continu.

Étapes suivantes

En suivant ce didacticiel, vous avez mappé un fichier CSV aplati à un schéma XDM et l’avez assimilé à Platformun fichier. Ces données peuvent désormais être utilisées par Platform les services en aval tels que Real-time Customer Profile. Consultez la présentation pour Real-time Customer Profile plus d’informations.

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"