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 Experience Data Model (XDM). Ce didacticiel explique comment mapper un fichier CSV à un schéma XDM à l’aide de l’interface utilisateur Platform.

En outre, l’annexe du présent tutoriel fournit des informations supplémentaires sur l’utilisation des fonctions de mappage.

Prise en main

Ce didacticiel nécessite une compréhension pratique des composants suivants de Platform :

  • Experience Data Model (XDM System) : Cadre normalisé selon lequel Platform organise les données de l’expérience client.
  • Batch ingestion: Méthode par laquelle Platform ingère des données à partir de fichiers de données fournis par l’utilisateur.

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 Faire correspondre le fichier CSV au schéma XDM sous la section Importation de données, puis sélectionnez Lancer.

Le flux de travaux 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.

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 importer vos données CSV dans un nouveau jeu de données, sélectionnez Créer un nouveau jeu de données et entrez 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 saisir 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

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.

Platform fournit automatiquement 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 accepter toutes les valeurs de mappage générées automatiquement, cochez la case "Accepter tous les champs de cible".

Il arrive que plusieurs recommandations soient disponibles pour le schéma source. Dans ce cas, la carte de mappage affiche la recommandation la plus visible, suivie d’un cercle bleu contenant le nombre de recommandations supplémentaires disponibles. La sélection de l'icône représentant une ampoule affiche la liste des recommandations supplémentaires. Vous pouvez choisir l’une des autres recommandations en cochant la case en regard de la recommandation à laquelle vous souhaitez mapper.

Vous pouvez également choisir de mapper manuellement votre schéma source à votre schéma de cible. Passez la souris sur le schéma source à mapper, puis sélectionnez l’icône Plus.

La fenêtre contextuelle Associer la source au champ de cible s’affiche. A partir de là, vous pouvez sélectionner le champ à mapper, suivi de Enregistrer pour ajouter votre nouveau mappage.

Si vous souhaitez supprimer l’un des mappages, passez la souris sur ce mappage, puis sélectionnez l’icône Moins.

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é apparaît. 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. Pour en savoir plus sur les fonctions que vous pouvez utiliser dans les champs calculés, consultez le guide à l'aide des fonctions d'aperçu des données (Mapper).
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 correspondant approprié et sélectionnez Terminer pour terminer le mappage.

Surveillance de l’ingestion des 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 de l'assimilation des données, consultez le didacticiel surveillance de l'assimilation des données.

Étapes suivantes

En suivant ce tutoriel, vous avez mappé un fichier CSV plat à un schéma XDM et l’avez ingéré dans Platform. Ces données peuvent désormais être utilisées par des services Platform en aval tels que Real-time Customer Profile. Pour plus d'informations, consultez l'aperçu de Real-time Customer Profile.

Sur cette page

Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now