Modèle d’article

À propos de la transformation des données dans Discover

Vous pouvez transformer vos informations entrantes avant qu’elles ne soient importées dans XM Discover. Ceci est utile si vous avez besoin de nettoyer vos données ou de modifier leur format.

Pour accéder aux transformations de données :

1. Lors de la configuration du travail d’importation, cliquez sur l’icône en forme de roue dentée dans la colonne Transformations, suivant le champ de données que vous souhaitez transformer.
   
   Astuce : si vous souhaitez mettre à jour les transformations de données pour un travail existant, sélectionnez Mappage des données dans le menu d’options des travaux.
   Attention : Si l’icône de l’engrenage est suivie d’un chiffre, cela signifie qu’une transformation a déjà été appliquée au champ. Si vous ajoutez une nouvelle transformation, elle remplacera l’ancienne.
2. Choisissez la transformation de vos données. Visitez les sections liées pour plus d’informations sur chaque transformation.
   
   • Pas de transformation: Ne pas transformer le champ importé.
   • Recherche dynamique: Cette option n’est disponible que pour les champs de consultation. Lorsqu’il est sélectionné, ce champ applique les dernières valeurs de consultation pour le champ à partir de la table de consultation.
   • Remplacer une valeur à partir d’un tableau de consultation: Définir des paires de valeurs sources et de valeurs de remplacement.
   • Remplacer une valeur par un RegEx: Définir des expressions régulières (regex) pour la recherche de motifs et les valeurs de remplacement.
   • Transformation sur mesure: Construisez votre propre transformation en utilisant différentes fonctions et expressions.

Recherche dynamique

Cette option n’est disponible que pour les champs de données qui font référence à un tableau de consultation 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 d’un tableau de consultation

Vous pouvez ajouter des références à n’importe quel champ source afin de mieux contrôler les valeurs exactes envoyées à votre projet XM Discover. Une table de recherche vous permet de définir les valeurs sources à remplacer lors de l’enregistrement dans XM Discover.

1. Assurez-vous que l’option Remplacer la valeur de la table de recherche est sélectionnée comme transformation.
   
2. Cliquez sur Exporter la consultation pour exporter un fichier de consultation au format .XLSX.
   Astuce : Nous recommandons d’ajouter des références via un fichier de références. Si vous souhaitez ajouter des références manuellement, passez à l’étape 8.
3. Ouvrez votre fichier dans un tableur et commencez à y ajouter vos valeurs de recherche.
4. Dans la colonne ” match”, ajoutez les valeurs entrantes de votre connecteur de données.
   
5. Dans la colonne recodées , ajoutez les valeurs correspondantes que vous souhaitez enregistrer dans XM Discover.
6. Enregistrez votre fichier en tant que fichier XLS ou XLSX.
7. Dans XM Discover, cliquez sur Import Lookup et sélectionnez le fichier de consultation enregistré sur votre ordinateur.
   
8. Si vous le souhaitez, vous pouvez modifier vos références. La colonne Valeur source contient la valeur provenant 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 paires de recherches supplémentaires en cliquant sur le signe plus ( + ), ou vous pouvez supprimer des paires en cliquant sur le signe moins ( – ) à côté de la paire.
10. Cliquez sur Enregistrer.

Remplacer une valeur par un RegEx

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

1. Assurez-vous que l’option Remplacer la valeur par RegEx est sélectionnée comme transformation.
   
2. Spécifiez le motif de recherche regex dans le champ Enter regular expression for pattern matching (Saisir une expression régulière pour la recherche de motifs).
3. Spécifiez la chaîne de remplacement regex dans le champ Enter regular expression for replacement value.
4. Pour tester la transformation, saisissez un exemple de votre jeu de données dans le champ Valeur source de l’échantillon et cliquez sur Test. Le résultat de la transformation s’affiche dans la case Échantillon de valeur transformée.
5. Cliquez sur Enregistrer.

Transformation sur mesure

Vous pouvez transformer les données entrantes à l’aide de vos propres expressions personnalisées. Les transformations personnalisées permettent de nombreux types de manipulations de données, notamment la modification des formats de date, la jonction de champs, la suppression des zéros non significatifs, etc.

1. Assurez-vous que l’option Transformation personnalisée est sélectionnée comme transformation de données.
   
2. Construisez votre expression de transformation des données. Votre expression variera en fonction de vos données entrantes et du résultat souhaité. Consultez la page d’aide sur la construction des expressions pour plus d’informations sur la façon de construire votre expression.
3. Si vous créez un nouveau champ, vous pouvez modifier son Type de données. 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 données de test dans le champ Valeur de test, puis cliquez sur Test. Le résultat s’affiche à côté du bouton “Test”.
5. Lorsque vous avez terminé de construire et de tester votre expression, cliquez sur Enregistrer.

Générer automatiquement des identifiants naturels

Lorsque vous téléchargez des données vers XM Discover, il se peut que les documents ne contiennent pas d’identifiant unique à utiliser comme identifiant naturel, qui est un champ important car il vous aide à identifier les documents dupliqués. Les données téléchargées doivent avoir un identifiant unique à utiliser comme identifiant naturel. Cette section explique comment définir un identifiant naturel lors du mappage de données à l’aide de transformations personnalisées.

1. Pendant le mappage des données, cliquez sur le signe plus ( + ) dans la section Mappage de la source pour ajouter un nouveau champ personnalisé.
   
2. Fournissez les informations suivantes pour le champ personnalisé :
   • Nom de champ: Indiquez le nom du champ.
   • Data Type: Sélectionnez Text Attribut dans le menu déroulant.
   • Nom de l’attribut: Laisser la même technologie que “Nom du champ”
   • Nom d’affichage de l’attribut: Si vous le souhaitez, saisissez un nom d’affichage plus convivial pour le champ.
   • Rapports: Activez cette case à cocher. Cette option doit être sélectionnée pour que vous puissiez utiliser l’identifiant naturel dans les rapports.
3. Dans la section Mappage de source par défaut, sélectionnez l’attribut que vous avez créé à l’étape 2 pour le mappage de l’ID naturel.
   
4. Cliquez sur l’icône en forme de roue dentée dans la colonne Transformations.
5. Sélectionnez Transformation personnalisée.
   
6. Recherchez la fonction GENERATE_ID() et faites-la glisser de la section Fonctions vers le champ Expression.
7. Cliquez sur Enregistrer.
   Astuce : Veillez à cliquer sur Appliquer pour enregistrer vos mappages.

Désormais, votre document aura un identifiant généré de manière randomisation lors de son téléchargement.

Fixer une date spécifique pour le document

Lorsque vous téléchargez des données vers XM Discover, les documents peuvent contenir plusieurs champs de date, voire aucun. Les données téléchargées doivent comporter un champ de données à utiliser comme date du document. Cette section explique comment définir une date de document lors de la mise en correspondance de données à l’aide de transformations personnalisées.

1. Pendant le mappage des données, cliquez sur le signe plus ( + ) dans la section Mappage de la source pour ajouter un nouveau champ personnalisé.
   
2. Fournissez les informations suivantes pour le champ personnalisé :
   • Nom de champ: Indiquez le nom du champ (par exemple, custom_date).
   • Data Type: Sélectionnez Attribut de la date dans le menu déroulant.
   • Nom de l’attribut: Laissez-le identique au “Nom du champ” (par exemple, custom_date).
   • Nom d’affichage de l’attribut: Si vous le souhaitez, ajoutez un nom d’affichage plus convivial pour le champ.
   • Rapports: Activez cette case à cocher. Cette option doit être sélectionnée pour documenter la date utilisée dans les rapports Discover.
3. Dans la section Mappage de la source par défaut, sélectionnez l’attribut que vous avez créé à l’étape 2 pour le mappage de la date du document.
   
4. Cliquez sur l’icône en forme de roue dentée dans la colonne Transformations.
5. Sélectionnez Transformation personnalisée.
   
6. Dans le générateur d’expression, vous disposez de plusieurs options pour fixer une date en fonction de vos besoins :
   • Utiliser le temps de chargement: Pour utiliser la date à laquelle les documents sont chargés dans XM Discover, faites glisser la fonction NOW() de la section Fonctions dans la zone d’expression.
     
   • Utiliser une valeur codée en dur: Pour utiliser une date spécifique, faites glisser la fonction TEXTTODATE() de la section Fonctions dans le champ Expression et indiquez la date et le format de la date entre les parenthèses.
     
     Astuce : Dans les deux cas, la date résultante utilisera le format AAAA-MM-DDTh:mm:ssZ.
7. Cliquez sur Test 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 textuelle personnalisée (“Enquêtes d’avril”) à l’attribut “Source”.

Comment ? Appliquez la transformation suivante au champ “Source” (mettez simplement la valeur du texte entre guillemets) :

Remplacer “Nom, Prénom” par “Prénom, Nom”

Objectif : changer le format du nom de “nom, prénom” à “prénom, nom” et mettre la première lettre de chaque mot en majuscule.

Comment ? Appliquer la transformation suivante au champ nom :

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

Convertir une date de UTC à CST

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

Comment ? Appliquez la transformation suivante au champ END_DATE :

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

Convertir hh:mm:ss en minutes

Chronomètre
: Convertit le temps du format hh:mm:ss en nombre de minutes.

Comment ? Appliquez la transformation suivante :

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

Convertir le temps d’époque Unix en secondes en ISO 8601

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

Comment : La transformation suivante fait deux choses : elle transforme les secondes en millisecondes, puis les millisecondes en une date ISO 8601 :

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

Déterminer une 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 attribuer une valeur “DMV Area” s’il correspond à l’un des États de la liste. Dans le cas contraire, il s’agit de “Autres États”

Comment procéder ? Ajoutez un champ personnalisé appelé AREA et appliquez la transformation suivante :

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

Extraire le nom d’un article à partir du titre d’une page

Objectif : Extraire le nom de l’article après le dernier séparateur “|” d’un titre de page.

Comment ? Appliquer la transformation suivante au champ titre de la page :

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

Regrouper le Nom et le Prénom en un seul champ

Objectif : Combiner les champs FIRST_NAME et LAST_NAME en un nouveau champ FULL_NAME et mettre la première lettre de chaque mot en majuscule.

Comment procéder ? Ajoutez un champ personnalisé appelé FULL_NAME et appliquez la transformation suivante :

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

Joindre deux verbatims et ne charger que le verbatim combiné

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

Comment procéder ? Procédez comme suit :

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

Rollup multi-variable

Objectif : Créer un rollup multi-variable pour les réponses à une question unique qui sont réparties sur plusieurs attributs. Supposons que l’ensemble de données contienne plusieurs attributs “oui ou non” pour indiquer les différents niveaux d’adhésion d’un client :

• QID2_1 pour l’argent
• QID2_2 pour l’or
• QID2_3 pour Platine

Vous pouvez regrouper toutes les réponses “oui” dans un nouvel attribut unique pour indiquer le niveau d’adhésion du client.

Comment ? Appliquer la transformation suivante :

TRIMRIGHT(CONCAT(IF(QID2_1==”Oui”, “Argent”, “”), IF(QID2_2==”Oui”, “Or”, “”), IF(QID2_3==”Oui”, “Platine”, “”))

Supprimer le premier caractère

Objectif : Supprimer le premier caractère d’une chaîne de caractères.

Comment ? Appliquer la transformation suivante :

REPLACEBYINDEX(MY_NUMBER, 1, 1, “”)

Découper les zéros initiaux

Objectif : Supprimer les zéros en tête d’un nombre.

Comment ? Pour une valeur textuelle, appliquer la transformation suivante :

CONCAT(TEXTTONUMBER(MY_NUMBER), “”)

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

TEXTTONUMBER(MY_NUMBER)

&nbsp ;