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. Cela est utile si vous devez nettoyer vos données ou modifier le format de vos données.

Pour accéder aux transformations de données :

1. Lors de la configuration du job d’import, cliquez sur l’icône d’engrenage dans la colonne Transformations en regard du champ de données que vous souhaitez transformer.
   
   Astuce Qualtrics : si vous souhaitez mettre à jour les transformations de données pour une tâche existante, sélectionnez Mappage de données dans le menu des options des tâches.
   Attention : si l’icône d’engrenage a un numéro à côté, cela signifie qu’une transformation est déjà appliquée au champ. Si vous ajoutez une nouvelle transformation, elle remplacera l’ancienne.
2. Sélectionnez votre transformation de données. Consultez les sections liées pour plus d’informations sur chaque transformation.
   
   • Aucune transformation : ne transformez pas le champ importé.
   • Recherche dynamique: cette option est disponible uniquement pour les champs de recherche. Lorsque cette option est sélectionnée, ce champ applique les valeurs de recherche les plus récentes pour le champ de la table de recherche.
   • Remplacer la valeur de la table de recherche: définissez des paires de valeurs source et de valeurs de remplacement.
   • Remplacer la valeur par RegEx: définissez des expressions régulières (expression régulière) pour la correspondance de modèles 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 disponible uniquement pour les champs de données qui font référence à une table de recherche 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 la valeur de la table 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. Une table de recherche vous permet de définir les valeurs source à remplacer lors de l’enregistrement dans XM Discover.

1. Assurez-vous que Remplacer la valeur de la table de recherche est sélectionné comme transformation.
   
2. Cliquez sur Exporter la recherche pour exporter un fichier de correspondance au format .XLSX.
   Astuce Qualtrics : nous 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 de correspondance, ajoutez les valeurs entrantes de votre connecteur de données.
   
5. Dans la colonne recodée, 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 Importer une recherche et sélectionnez le fichier de correspondance 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 paires de recherche supplémentaires en cliquant sur le signe plus ( + ), ou vous pouvez supprimer des paires en cliquant sur le signe moins ( – ) en regard de l’appariement.
10. Cliquez sur Enregistrer.

Remplacer la valeur par RegEx

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

1. Assurez-vous que Remplacer la valeur par RegEx est sélectionné comme transformation.
   
2. Indiquez l’expression régulière du modèle de recherche dans la zone Saisir expression régulière pour correspondance de modèles.
3. Indiquez l’expression régulière de la chaîne de remplacement dans la zone Saisir expression régulière pour valeur de remplacement.
4. Pour tester la transformation, saisissez un exemple de votre jeu de données dans la zone 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 de données, notamment la modification des formats de date, la jointure de zones, la suppression de zéros non significatifs, etc.

1. Assurez-vous que Transformation personnalisée est sélectionné comme votre transformation de données.
   
2. Créez votre expression de transformation de données. Votre expression variera en fonction de vos données entrantes et de la sortie souhaitée. Consultez la page d’assistance sur la création d’expressions pour en savoir plus sur la manière de créer votre expression.
3. Si vous créez un nouveau 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 données de test dans la zone Valeur de test, puis cliquez sur Tester. Le résultat apparaîtra à côté du bouton « Test ».
5. Lorsque vous avez terminé de créer et de tester votre expression, cliquez sur Enregistrer.

Génération automatique d’ID naturels

Lorsque vous chargez des données dans XM Discover, les documents peuvent ne pas contenir d’ID unique à utiliser comme ID naturel, ce qui est un champ important car il vous aide à identifier les documents en double. Vos données chargées doivent avoir un identifiant unique à utiliser comme ID naturel. Cette section explique comment définir un ID naturel 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. Indiquez les informations suivantes pour la zone personnalisée :
   • Nom du champ : indiquez le nom du champ.
   • Type de données : sélectionnez Attribut de texte dans le menu déroulant.
   • Nom d’attribut : laissez la même chose que “Nom de zone”.
   • Nom d’affichage de l’attribut : si vous le souhaitez, saisissez un nom d’affichage plus convivial pour le champ.
   • Peut faire l’objet d’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’ID naturel.
   
4. Cliquez sur l’icône 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 vers la zone Expression.
7. Cliquez sur Enregistrer.
   Astuce Qualtrics : assurez-vous de cliquer sur Appliquer pour enregistrer vos mappages.

Désormais, votre document aura un ID généré de manière aléatoire lorsqu’il sera téléchargé sur le serveur.

Définition d’une date de document spécifique

Lorsque vous chargez des données dans XM Discover, les documents peuvent contenir plusieurs champs de date, ou aucun. Vos données chargées doivent comporter 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. Indiquez les informations suivantes pour la zone personnalisée :
   • Nom du champ : indiquez le nom du champ (par exemple custom_date).
   • Type de données : sélectionnez Attribut de date dans le menu déroulant.
   • Nom d’attribut : laissez la valeur identique à “Nom de zone” (par exemple custom_date).
   • Nom d’affichage de l’attribut : si vous le souhaitez, ajoutez un nom d’affichage plus convivial pour le champ.
   • Peut faire l’objet d’un rapport : cochez cette case. Elle doit être sélectionnée pour que la date de la pièce soit utilisée dans le reporting 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 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 le temps de chargement : Pour utiliser la date à laquelle les documents sont téléchargés dans XM Discover, faites glisser la fonction NOW() de la section Fonctions vers la zone Expression.
     
   • Utiliser une valeur codée en dur : Pour utiliser une date spécifique, faites glisser la fonction TEXTTODATE() de la section Fonctions vers la zone Expression et indiquez la date et le format de date entre parenthèses.
     
     Astuce Qualtrics : dans les deux cas, la date obtenue utilisera le format AAAA-MM-JJThh:mm:ssZ.
7. Cliquez sur Tester pour afficher 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 Sauvegarder lorsque vous avez terminé.

Exemples de transformation personnalisée

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

Affecter une valeur source personnalisée

Objectif : Affecter une valeur de texte personnalisé (“Enquêtes d’avril”) à l’attribut “Source”.

Comment : appliquez la transformation suivante au champ « Source » (placez simplement la valeur du texte entre guillemets) :

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

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

Comment : appliquer la transformation suivante à la zone de nom :

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

Convertir une date UTC en CST

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

Comment : appliquer la transformation suivante à la zone END_DATE:

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

Convertir hh:mm:ss en minutes

Objectif : Convertir l’heure du format hh:mm:ss au nombre de minutes.

Comment : appliquer la transformation suivante :

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

Convertir temps d’époques Unix en secondes en ISO 8601

Objectif : Convertissez un horodatage d’époque Unix en secondes au format de date ISO 8601.

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

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

Dériver la valeur en fonction du fait que quelque chose se trouve dans un tableau

Objectif : Vérifiez le nom de l’état et affectez une valeur “Zone DMV” si elle correspond à l’un des états répertoriés. Sinon, définissez sur “Autres États”.

Comment : ajouter un champ de texte personnalisé appelé AREA et appliquer la transformation suivante :

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

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

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

Comment : appliquer la transformation suivante au champ de titre de page :

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

Joindre le prénom et le nom dans une zone individuelle

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

Comment : ajouter une zone de texte personnalisé appelée FULL_NAME et appliquer la transformation suivante :

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

Rejoignez deux verbatims et chargez uniquement le Verbatim combiné

Objectif : Rejoignez deux champs verbatim VERBATIM1 et VERBATIM2 dans un nouveau champ VERBATIM3 et chargez uniquement le texto combiné dans XM Discover.

Comment : exécuter ces étapes :

1. Créez une zone textuelle nommée VERBATIM3 et appliquez-lui la transformation suivante : CONCAT(VERBATIM1, ” “, VERBATIM2)
2. Pour les zones VERBATIM1 et VERBATIM2, définissez Type de données sur Ne pas mapper.

Rollup multi-variables

Objectif : Créer un cumul multi-variables pour les réponses à une question unique qui sont divisées en plusieurs attributs. Supposons que le jeu de données contienne plusieurs attributs “oui ou non” pour indiquer les différents niveaux d’appartenance d’un client :

• QID2_1 pour Argent
• QID2_2 pour l’or
• QID2_3 pour Platinum

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

Comment : appliquer la transformation suivante :

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

Supprimer caractère principal

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

Comment : appliquer la transformation suivante :

REPLACEBYINDEX(MY_NUMBER, 1, 1, “”)

Supprimer les zéros non significatifs

Objectif : Supprimer les zéros non significatifs dans un nombre.

Comment : Pour une valeur de texte, appliquez la transformation suivante :

CONCAT(TEXTTONUMBER(MY_NUMBER), “”)

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

TEXTTONUMBER(MY_NUMBER)

&nbsp ;