Connecteur de sortie de fichiers

À propos du connecteur de sortie Fichiers

Vous pouvez utiliser le connecteur sortant de fichiers pour exporter des données enrichies depuis XM Discover vers le serveur SFTP de votre organisation.

Vous pouvez exporter des données au niveau des phrases et des documents, les limiter aux enregistrements nouveaux et mis à jour et sélectionner les champs, les enrichissements et les classifications à exporter. Les données exportées sont disponibles aux formats CSV et JSON.

Configuration d’un job de sortie de fichiers

1. Sur la page Tâches, cliquez sur Nouvelle tâche.
   
2. Sélectionnez Fichiers Sortie.
   
3. Donnez un nom à votre job pour pouvoir l’identifier.
   
4. Sélectionnez le projet dans lequel charger les données.
5. Donnez une description de votre travail pour connaître son objectif.
6. Cliquez sur Suivant.
7. Choisissez un compte SFTP à utiliser ou sélectionnez Ajouter nouveau pour en ajouter un nouveau.
   
8. Si vous ajoutez un nouveau compte, saisissez les informations suivantes pour votre compte SFTP :
   • Nom de la connexion : Donnez un nom à la connexion pour pouvoir la reconnaître ultérieurement.
   • Nom d’utilisateur SFTP : saisissez le nom d’utilisateur pour vous connecter à votre serveur SFTP.
   • Mot de passe SFTP : saisissez le mot de passe pour vous connecter à votre serveur SFTP.
   • Hôte SFTP : saisissez l’URL d’hôte de votre serveur SFTP.
   • Port SFTP : saisissez votre port SFTP. Il s’agit généralement de 22.
   • Envoyer des notifications d’expiration : si vous souhaitez que vos identifiants SFTP expirent au bout d’un certain temps, sélectionnez cette option.
   • Jours avant l’expiration : si vous activez les notifications d’expiration, saisissez le nombre de jours pendant lesquels vous souhaitez être notifié avant l’expiration. Vous pouvez saisir une valeur comprise entre 1 et 100 jours.
   • Date d’expiration : définissez la date à laquelle les identifiants expireront. Cliquez sur la case pour ouvrir un calendrier afin de choisir la date.
9. Cliquez sur Suivant.
10. Indiquez votre point de terminaison de l’API d’exportation XM Discover.
    
11. Cliquez sur Suivant.
12. Sélectionnez le niveau de données que vous souhaitez exporter :
    
    • Phrases : utilisez des données au niveau de la phrase.
    • Documents : utilisez les données au niveau du document.
      Astuce Qualtrics : les étapes restantes sur la page Configuration de la requête sont facultatives et vous aideront à affiner les données exportées.
13. Fournissez une requête de recherche pour filtrer les données sortantes. Utilisez la même syntaxe que celle utilisée pour rechercher des données dans Designer. Laissez cette zone vide pour inclure toutes les données.
    Exemple : vous pouvez spécifier un ou plusieurs ID d’enquête pour mettre à jour uniquement les enregistrements d’enquête sélectionnés à l’aide de la syntaxe suivante : surveyid:sv_01
14. Saisissez le nom du filtre de votre projet que vous souhaitez appliquer aux données sortantes. Ne renseignez pas cette zone si vous ne voulez pas filtrer vos données.
15. Sélectionnez les enregistrements que vous souhaitez importer :
    • Charger de nouveaux enregistrements : enregistrements créés depuis la dernière exécution du job de sortie.
    • Charger les enregistrements nouveaux et mis à jour : enregistrements créés ou mis à jour depuis la dernière exécution du job de sortie.
    • Charger les enregistrements mis à jour : enregistrements mis à jour depuis la dernière exécution du job de sortie.
16. Utilisez le menu déroulant pour sélectionner les modèles de classification que vous souhaitez inclure dans vos données. Cochez la case Tous les modèles pour inclure les données de classification pour tous les modèles disponibles dans le projet.
17. Sélectionnez la manière dont vous souhaitez que les classifications aient un impact sur le filtrage des données :
    • Ignorer : aucun filtrage n’est appliqué en fonction du ou des modèles sélectionnés.
    • Actuellement classifié : renvoie les enregistrements qui ont été classés par le(s) modèle(s) sélectionné(s) lors de l’exécution de classification la plus récente.
    • Toujours classifié : renvoie les enregistrements qui ont été classés par le(s) modèle(s) sélectionné(s) à tout moment.
18. Sélectionnez les options d’exportation supplémentaires que vous souhaitez utiliser :
    • Indique si les ID de catégorie (vrai) doivent être renvoyés au lieu des noms de catégorie (faux) : exportez les ID de catégories au lieu des noms de catégories.
    • Filtre les résultats en appliquant une requête de filtre avec tous les chemins de nœuds feuille : ajoute plusieurs modèles avec le paramètre “foli_only flag” à l’appel d’API d’exportation.
19. Cliquez sur Suivant.
20. Sélectionnez le type de fichier que vous souhaitez exporter :
    
    • “plat” séparé par des séparateurs : le format est un fichier texte délimité, tel que CSV ou TSV.
    • Fichiers JSON : le format est un fichier JSON.
21. Si vous exportez vers un fichier plat séparé par des délimiteurs, sélectionnez vos options de fichier :
    • Encodage de fichier : sélectionnez l’encodage du fichier, tel que UTF-8 ou ASCII.
    • Caractère de délimitation : caractère utilisé pour séparer les entrées, telles qu’une virgule ou une tabulation.
    • Caractère d’emballage : caractère utilisé pour encadrer les données. Ne renseignez pas cette zone si vous ne voulez pas d’emballage.
    • Pas d’emballage : si vous ne souhaitez pas que vos données soient incluses dans un caractère supplémentaire, activez cette option.
22. Cliquez sur Parcourir et choisissez votre dossier SFTP.
    
    Astuce Qualtrics : lorsque vous choisissez un chemin d’accès au dossier, vous pouvez cliquer sur une icône de dossier pour développer ce dossier. Cliquez sur le nom du dossier pour sélectionner ce dossier, puis cliquez sur OK lorsque vous avez terminé.
23. Si vous souhaitez qu’un préfixe soit joint aux fichiers exportés, activez l’option Fournir un nom de fichier pour le préfixe et saisissez le préfixe souhaité dans la zone.
    Astuce Qualtrics : le préfixe ne peut pas contenir [ ] \ / ni dépasser 100 caractères.
24. Si vous souhaitez qu’un suffixe soit joint aux fichiers exportés, activez Fournir un nom de fichier pour le suffixe et saisissez le suffixe souhaité dans la zone.
    Astuce Qualtrics : le suffixe ne peut pas contenir [ ] \ / et ne doit pas dépasser 100 caractères.
25. Si vous souhaitez crypter vos données, activez Chiffrer les fichiers fournis par XM Discover et saisissez votre clé PGP/GPG dans la zone.
    Astuce Qualtrics : les fichiers seront toujours chiffrés dans un fichier GPG. Vous pouvez saisir une clé PGP/GPG, mais elle ne chiffrera jamais dans un fichier PGP.
26. Cliquez sur Suivant.
27. Mappez les champs de XM Discover à Qualtrics. Cliquez sur la case vide et choisissez l’attribut XM Discover que vous souhaitez envoyer à Qualtrics.
    
28. Sélectionnez le type de données sous lequel le champ doit être exporté :
    • Ne pas mapper : aucun type de variable spécifié.
    • Attribut numérique : type de variable Nombre.
    • Attribut de texte : type de variable de set de texte.
    • Attribut de date : type de variable de date.
    • Verbatim : type de variable de texte.
29. Saisissez le nom de l’attribut pour cette zone. Il s’agit du nom du champ lors de son exportation.
30. Utilisez les signes plus (+ ) et moins ( – ) pour ajouter et supprimer des zones si nécessaire.
31. Cliquez sur Suivant.
32. Si vous le souhaitez, vous pouvez ajouter un filtre de connecteur pour filtrer les données entrantes afin de limiter les données importées.
    
33. Vous pouvez également limiter le nombre d’enregistrements importés dans un seul job en saisissant un nombre dans la zone Spécifier la limite d’enregistrement. Saisissez « Tout » si vous souhaitez importer tous les enregistrements.
    Astuce Qualtrics : pour les données conversationnelles, la limite est appliquée en fonction des conversations plutôt que des lignes.
34. Cliquez sur Suivant.
35. Choisissez quand vous souhaitez recevoir une notification. Pour plus d’informations, voir Notifications de jobs.
    
36. Cliquez sur Suivant.
37. Sélectionnez le moment d’exécution de votre job. Vous pouvez effectuer une extraction unique ou configurer une extraction de données récurrente. Pour plus d’informations, voir Planification des jobs.
    
38. Cliquez sur Suivant.
39. Vérifiez votre configuration. Si vous devez modifier un paramètre spécifique, cliquez sur le bouton Modifier pour accéder à cette étape dans la configuration du connecteur.
    
40. Cliquez sur Terminer pour sauvegarder le job.