Transformation des données (connecteurs)

À propos de la transformation des données dans Discover

Vous pouvez transformer vos données entrantes avant qu’elles ne soient importées dans XM Discover. Cette option est utile si vous devez nettoyer vos données ou modifier leur format.

Pour accéder aux transformations de données :

1. Lors de la configuration de la tâche d’importation, cliquez sur l’icône en forme d’engrenage dans la colonne Transformations à côté du champ de données que vous souhaitez transformer.
   
   Astuce : si vous souhaitez mettre à jour les transformations de données d’une tâche existante, sélectionnez Mappage des données dans le menu des options de tâche.
   Attention : si un nombre est affiché à côté de l’icône en forme d’engrenage, cela signifie qu’une transformation est déjà appliquée au champ. Si vous ajoutez une nouvelle transformation, elle remplacera l’ancienne.
2. Choisissez votre transformation de données. Consultez les sections associées pour en savoir plus sur chaque transformation.
   
   • Aucune transformation : le champ importé n’est pas transformé.
   • Recherche dynamique : cette option est uniquement disponible pour les champs de recherche. Lorsqu’elle est sélectionnée, ce champ applique les dernières valeurs de recherche pour le champ à partir du tableau de recherche.
   • Remplacer une valeur à partir du tableau de recherche : définissez des paires de valeurs sources et de valeurs de remplacement.
   • Remplacer une valeur avec RegEx : définissez des expressions régulières (regex) pour le mappage de schémas et les valeurs de remplacement.
   • Transformation personnalisée : créez votre propre transformation à l’aide de différentes fonctions et expressions.

Recherche dynamique

Cette option est uniquement disponible pour les champs de données qui font référence à un tableau de recherche à partir de la source de données connectée. Vous pouvez spécifier une expression de recherche dynamique afin que les données correctes soient importées dans XM Discover.

Remplacer une valeur à partir du tableau de recherche

Vous pouvez ajouter des recherches à n’importe quel champ source pour avoir un meilleur contrôle sur les valeurs exactes envoyées à votre projet XM Discover. Un tableau de recherche vous permet de définir des valeurs sources à remplacer lors de l’enregistrement dans XM Discover.

1. Assurez-vous que la transformation Remplacer une valeur à partir du tableau de recherche est sélectionnée.
   
2. Cliquez sur Exporter un fichier de recherche pour exporter un fichier de recherche au format XLSX.
   Astuce : nous vous recommandons d’ajouter des recherches via un fichier de recherche. Si vous souhaitez ajouter des recherches manuellement, passez à l’étape 8.
3. Ouvrez votre fichier dans un éditeur de feuille de calcul et commencez à ajouter vos valeurs de recherche au fichier.
4. Dans la colonne match (correspondance), ajoutez les valeurs entrantes de votre connecteur de données.
   
5. Dans la colonne recoded (recodé), ajoutez les valeurs correspondantes que vous souhaitez enregistrer dans XM Discover.
6. Enregistrez votre fichier au format XLS ou XLSX.
7. Dans XM Discover, cliquez sur Importer le fichier de recherche et sélectionnez le fichier de recherche enregistré sur votre ordinateur.
   
8. Si vous le souhaitez, vous pouvez modifier vos recherches. La colonne Valeur source contient la valeur de votre connecteur de données tandis que la colonne Valeur transformée contient la valeur que vous souhaitez enregistrer dans XM Discover.
9. Vous pouvez ajouter des appariements de recherche en cliquant sur le signe plus ( + ) ou en supprimer en cliquant sur le signe moins ( – ) à côté de chaque appariement.
10. Cliquez sur Enregistrer.

Remplacer une valeur avec RegEx

Vous pouvez remplacer les valeurs de données entrantes à l’aide d’expressions régulières (regex), ce qui vous permet de nettoyer les données avant de les charger dans votre projet XM Discover.

1. Assurez-vous que la transformation Remplacer une valeur avec RegEx est sélectionnée.
   
2. Spécifiez l’expression régulière du motif de recherche dans le champ Saisir une expression régulière pour la correspondance de motifs.
3. Précisez l’expression régulière de la chaîne de remplacement dans le champ Saisir une expression régulière pour la valeur de remplacement.
4. Pour tester la transformation, entrez un exemple de votre ensemble de données dans le champ Exemple de valeur source et cliquez sur Tester. Le résultat de la transformation est affiché dans la zone Exemple de valeur transformée.
5. Cliquez sur Enregistrer.

Transformation personnalisée

Vous pouvez transformer les données entrantes à l’aide de vos propres expressions personnalisées. Les transformations personnalisées permettent de nombreux types de manipulation des données, notamment la modification des formats des dates, la fusion des champs, la suppression des zéros en début de valeur, etc.

1. Assurez-vous que la transformation de données Transformation personnalisée est sélectionnée.
   
2. Créez votre expression de transformation des données. Votre expression variera en fonction de vos données entrantes et du résultat souhaité. Pour en savoir plus sur la création de votre expression, consultez la page Construire des expressions.
3. Si vous créez un champ, vous pouvez modifier le Type de données du champ. Si vous transformez un champ existant, vous ne pouvez pas modifier le type de données.
4. Pour tester votre transformation, saisissez une valeur de test dans le champ Valeur de test, puis cliquez sur Tester. Le résultat apparaîtra à côté du bouton « Tester ».
5. Lorsque vous avez terminé de créer et de tester votre expression, cliquez sur Enregistrer.

Générer automatiquement des identifiants naturels

Lorsque vous importez des données dans XM Discover, les documents peuvent ne pas contenir d’identifiant unique à utiliser comme identifiant naturel. Ce champ est pourtant important, car il vous aide à identifier les documents en double. Vos données importées doivent avoir un identifiant unique à utiliser comme identifiant naturel. Cette section explique comment définir un identifiant naturel lors du mappage des données à l’aide de transformations personnalisées.

1. Lors du mappage des données, cliquez sur le signe plus ( + ) dans la section Mappage source pour ajouter un nouveau champ personnalisé.
   
2. Fournissez les informations suivantes pour le champ personnalisé :
   • Nom du champ : indiquez le nom du champ.
   • Type de données : sélectionnez Attribut de texte dans le menu déroulant.
   • Nom de l’attribut : laissez-le identique à « Nom du champ ».
   • Nom d’affichage de l’attribut : si vous le souhaitez, saisissez un nom d’affichage plus convivial pour le champ.
   • Inclusion possible dans un rapport : cochez cette case. Cette option doit être sélectionnée pour que vous puissiez utiliser l’ID naturel dans le reporting.
3. Dans la section Mappage source par défaut, sélectionnez l’attribut que vous avez créé à l’étape 2 pour le mappage d’identifiant naturel.
   
4. Cliquez sur l’icône en forme d’engrenage dans la colonne Transformations.
5. Sélectionnez Transformation personnalisée.
   
6. Recherchez la fonction GENERATE_ID() et faites-la glisser de la section Fonctions dans la zone Expression.
7. Cliquez sur Enregistrer.
   Astuce : n’oubliez pas de cliquer sur Appliquer pour enregistrer vos mappages.

Désormais, votre document aura un ID généré aléatoirement lors de son importation.

Définir une date spécifique pour un document

Lorsque vous importez des données dans XM Discover, les documents peuvent contenir plusieurs champs de date, ou aucune date du tout. Vos données importées doivent avoir un champ de date à utiliser comme date du document. Cette section explique comment définir une date de document lors du mappage de données à l’aide de transformations personnalisées.

1. Lors du mappage des données, cliquez sur le signe plus ( + ) dans la section Mappage source pour ajouter un nouveau champ personnalisé.
   
2. Fournissez les informations suivantes pour le champ personnalisé :
   • Nom du champ : fournissez le nom du champ (par exemple, date_perso).
   • Type de données : sélectionnez Attribut de date dans le menu déroulant.
   • Nom de l’attribut : laissez-le identique à « Nom du champ » (par exemple, date_perso).
   • Nom d’affichage de l’attribut : si vous le souhaitez, ajoutez un nom d’affichage plus convivial pour le champ.
   • Inclusion possible dans un rapport : cochez cette case. Cette option doit être sélectionnée pour que la date du document soit utilisée dans le reporting XM Discover.
3. Dans la section Mappage source par défaut, sélectionnez l’attribut que vous avez créé à l’étape 2 pour le mappage Date du document.
   
4. Cliquez sur l’icône en forme d’engrenage dans la colonne Transformations.
5. Sélectionnez Transformation personnalisée.
   
6. Dans le générateur d’expressions, vous disposez de plusieurs options pour définir une date en fonction de vos besoins :
   • Utiliser l’heure d’importation : pour utiliser la date à laquelle les documents sont importés dans XM Discover, faites glisser la fonction NOW() de la section Fonctions dans la zone Expression.
     
   • Utilisez une valeur codée en dur : pour utiliser une date spécifique, faites glisser la fonction TEXTTODATE() de la section Fonctions dans la zone Expression et indiquez la date et le format de la date dans les parenthèses.
     
     Astuce : dans les deux cas, la date résultante utilisera le format AAAA-MM-JJThh:mm:ssZ.
7. Cliquez sur Tester pour voir le résultat de la transformation. Si nécessaire, ajustez votre expression jusqu’à ce que le test vous donne le résultat souhaité.
8. Cliquez sur Enregistrer lorsque vous avez terminé.

Exemples de transformations personnalisées

Cette section présente quelques exemples de la manière dont vous pouvez manipuler vos données à l’aide de transformations personnalisées.

Attribuer une valeur source personnalisée

Objectif : attribuer une valeur de texte personnalisée (« Enquêtes d’avril ») à l’attribut « Source ».

Méthode : appliquez la transformation suivante au champ « Source » (mettez simplement la valeur du texte entre guillemets) :

Remplacer « Nom,Prénom » par « Prénom Nom »

Objectif : modifier le format du nom de « nom,prénom » en « prénom nom » et mettre la première lettre de chaque mot en majuscules.

Méthode : appliquez la transformation suivante au champ de nom :

PROPERCASE(REPLACEBYREGEXP(NAME, « (. ) *),(. *)”, “$2 $1”))

Convertir une date UTC en CST

Objectif : convertir un champ de date d’un fuseau horaire UTC en CST.

Méthode : appliquez la transformation suivante au champ END_DATE :

CONVERT_TO_TIMEZONE(END_DATE, “Etc/UTC”, “America/Chicago”)

Convertir hh:mm:ss en Minutes

Objectif : convertir une durée au format hh:mm:ss en nombre de minutes.

Méthode : appliquez la transformation suivante :

GETMINUTESBETWEEN(TEXTTODATE(“1970-01-01”, “YYYY-MM-DD”), CONCAT(“1970-01-01T”, MY_TIME))

Convertir une heure Unix en secondes au format ISO 8601

Objectif : convertir un horodatage Unix en secondes au format de date ISO 8601.

Méthode : la transformation suivante effectue deux opérations : elle transforme les secondes en millisecondes, puis les millisecondes en date ISO 8601 :

NUMBERTODATE(TEXTTONUMBER(CONCAT(MY_DATE, “000”)))

Dériver la valeur en fonction de la présence ou non d’un élément dans un tableau

Objectif : vérifier le nom de l’État et affecter une valeur « DMV Area » (Région DMV) s’il correspond à l’un des États répertoriés. Sinon, définir comme « Other States » (Autres États).

Méthode : ajoutez un champ de texte personnalisé appelé RÉGION et appliquez la transformation suivante :

IF(LOWER(STATE) in [“md”, “dc”, “va”], “DMV Area”, “Other States”)

Extraire le nom d’un article d’un titre de page

Objectif : extraire le nom de l’article après le dernier diviseur “|” dans le titre d’une page.

Méthode : appliquez la transformation suivante au champ de titre de la page :

TRIMRIGHT(MID(PAGE_TITLE,FINDLAST(PAGE_TITLE,”|”)+1,1000))

Joindre le prénom et le nom dans un seul champ

Objectif : combiner les champs FIRST_NAME (PRÉNOM) et LAST_NAME (NOM DE FAMILLE) en un nouveau champ FULL_NAME (NOM COMPLET) et mettre une majuscule à la première lettre de chaque mot.

Méthode : ajoutez un champ de texte personnalisé appelé FULL_NAME et appliquez la transformation suivante :

PROPERCASE(CONCAT(FIRST_NAME, ” “, LAST_NAME))

Joindre deux verbatims et charger uniquement le verbatim combiné

Objectif : joindre deux champs verbatim VERBATIM1 et VERBATIM2 en un nouveau champ VERBATIM3 et charger uniquement le verbatim combiné dans XM Discover.

Méthode : suivez ces étapes :

1. Créez un champ verbatim appelé VERBATIM3 et appliquez-lui la transformation suivante : CONCAT(VERBATIM1, ” “, VERBATIM2)
2. Pour les champs VERBATIM1 et VERBATIM2, définissez le Type de données sur Ne pas mapper.

Rollup à plusieurs variables

Objectif : créer un rollup à plusieurs variables pour les réponses à une seule question qui sont réparties sur plusieurs attributs. Supposons que l’ensemble de données contient plusieurs attributs « oui ou non » pour indiquer différents niveaux d’adhésion qu’un client peut avoir :

• QID2_1 pour Silver
• QID2_2 pour Gold
• QID2_3 pour Platinum

Vous pouvez cumuler toutes les réponses « oui » en un seul nouvel attribut pour indiquer le niveau d’adhésion du client.

Méthode : Appliquez la transformation suivante :

TRIMRIGHT(CONCAT(IF(QID2_1=”Yes”, “Silver”, “”), IF(QID2_2=”Yes”, “Gold”, “”), IF(QID2_3=”Yes”, “Platinum”, “”)))

Supprimer le premier caractère

Objectif : supprimer le premier caractère d’une chaîne.

Méthode : appliquez la transformation suivante :

REPLACEBYINDEX(MY_NUMBER, 1, 1, “”)

Supprimer les zéros initiaux

Objectif : supprimer les zéros au début d’un nombre.

Méthode : pour une valeur textuelle, appliquez la transformation suivante :

CONCAT(TEXTTONUMBER(MY_NUMBER), “”)

Pour une valeur numérique, appliquez la transformation suivante :

TEXTTONUMBER(MY_NUMBER)