Show Menu
SUJETS×

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

In order to ingest CSV data into Adobe Experience Platform, the data must be mapped to an Experience Data Model (XDM) schema. This tutorial covers how to map a CSV file to an XDM schema using the Platform user interface.
En outre, l’annexe du présent tutoriel fournit des informations supplémentaires sur l’utilisation des fonctions de mappage .

Prise en main

This tutorial requires a working understanding of the following components of Platform:
Vous devez également avoir créé un jeu de données dans lequel ingérer vos données CSV pour suivre ce tutoriel. Pour connaître les étapes de création d’un jeu de données dans l’interface utilisateur, consultez le tutoriel sur l’ingestion de données .

Choix d’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.
The Map CSV to XDM schema workflow appears, starting on the Destination step. 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.
Utilisation d’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.

Ajout de données

L’étape Ajouter les données apparaît. Faites glisser votre fichier CSV dans l’espace prévu à cet effet ou sélectionnez Choisir les fichiers pour entrer manuellement votre fichier CSV.
The Sample data section appears once the file is uploaded, showing the first ten rows of data. Once you have confirmed that the data has uploaded as expected, select Next .

Mappage des champs CSV aux champs de schéma XDM

L’étape Mappage apparaît. Les colonnes du fichier CSV sont répertoriées sous Champ source , et les champs de schéma XDM correspondants sont répertoriés sous Champ cible . Les champs cibles 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.
Platform fournit des recommandations intelligentes pour les champs à mappage automatique en fonction du schéma de cible ou du jeu de données que vous avez sélectionné. Vous pouvez ajuster manuellement les règles de mappage en fonction de vos cas d’utilisation.
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 apparaît. 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 .
Une fois que vous avez terminé les étapes pour les champs source non mappés restants, l’écran Mappage s’affiche de nouveau avec le champ XDM sélectionné qui s’affiche désormais sous Champ de Cible.
Lors du mappage des champs, vous pouvez également inclure des fonctions pour calculer les valeurs en fonction des champs sources d’entrée. Pour plus d’informations, consultez la section relative aux fonctions de mappage de 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.

Utilisation des fonctions de mappage

Pour utiliser une fonction, saisissez-la sous Champ source avec la syntaxe et les entrées appropriées.
Par exemple, pour concaténer les champs CSV city et country et les attribuer au champ XDM city, définissez le champ source en tant que concat(city, ", ", county) .
Pour en savoir plus sur le mappage des colonnes aux champs XDM, consultez le guide sur l’ utilisation des fonctions d’aperçu des données (Mapper).

Étapes suivantes

En suivant ce tutoriel, vous avez mappé un fichier CSV plat à un schéma XDM et l’avez ingéré dans Platform. This data can now be used by downstream Platform services such as Real-time Customer Profile. Pour plus d’informations, consultez la présentation du Profil client en temps réel .