Connecteur d’entrée de fichiers

À propos du connecteur d’entrée de fichiers

Vous pouvez utiliser le connecteur d’entrée de fichiers pour charger des données client via un chargement de fichier. Ces jobs peuvent être planifiés pour se répéter selon une planification que vous avez définie ou être configurés pour être une extraction de données unique.

Les jobs d’entrée de fichiers vous permettent de charger des données aux formats suivants :

• Fichiers texte délimités à plat (CSV, TSV, etc.)
• XLS ou XLSX
• JSON
• WebVTT

Configuration d’un job d’entrée de fichiers

1. Sur la page Tâches, cliquez sur Nouvelle tâche.
   
2. Sélectionnez Fichiers.
   
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. Sélectionnez le type de fichier que vous voulez charger :
    
    • Fichiers “plats” séparés par des séparateurs
    • Fichiers Excel (XLS, XLSX)
    • Fichiers JSON
    • Fichiers WebVTT
11. Selon le type de fichier que vous avez sélectionné, des options supplémentaires vous permettent de choisir :
    • Fichiers plats séparés par des séparateurs : Pour les fichiers séparés par des séparateurs, sélectionnez ce qui suit :
      
      • Encodage de fichier : Choisissez le système d’encodage du fichier (UTF-8, ASCII, etc.)
      • Caractère de délimitation : saisissez le caractère utilisé pour délimiter les entrées de données. Par défaut, il s’agit d’une virgule pour les fichiers CSV.
      • Caractère d’emballage : saisissez le caractère qui encadre la saisie de données. Ne renseignez pas cette zone si l’option Aucun emballage est sélectionnée.
      • Aucun cadre : activez cette option si votre fichier ne contient pas de caractères d’emballage.
    • JSON : saisissez le chemin d’accès JSON qui contient les données de document que vous voulez charger dans XM Discover. Ne renseignez pas cette zone si vos documents se trouvent au niveau racine.
      
    • Passez à l’étape suivante pour Excel et WebVTT.
12. Cliquez sur Parcourir et sélectionnez le chemin d’accès au dossier sur votre serveur SFTP qui contient le fichier que vous souhaitez télécharger.
    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é.
13. Saisissez l’expression régulière de nom de fichier qui correspond aux fichiers que vous voulez charger.
14. Si vos fichiers sont compressés, activez Décompresser fichier(s) et saisissez l’expression régulière Nom de fichier zippé qui correspond aux fichiers à décompresser.
    
15. Si vos fichiers sont déchiffrés, activez Déchiffrer fichier(s) et saisissez les données suivantes :
    • Expression régulière de nom de fichier crypté : saisissez l’expression régulière de nom de fichier pour les fichiers à décrypter.
    • Clé PGP/GPG : saisissez la clé PGP/GPG utilisée pour le chiffrement.
    • Phrase secrète : saisissez la phrase secrète pour le décryptage.
16. Si vos fichiers sont à la fois compressés et chiffrés, vous devez choisir celui qui doit se produire en premier :
    • Décompressez puis décryptez : les fichiers sont décompressés puis déchiffrés.
    • Décrypter puis Décompresser : les fichiers sont déchiffrés puis décompressés.
17. Sélectionnez le type de données que vous souhaitez importer :
    
    • Chat : interactions numériques avec plusieurs lignes de dialogue entre 2 participants ou plus.
    • Appel : Appeler des transcriptions avec plusieurs lignes de dialogue entre 2 participants ou plus.
    • Feedback : documents présentés sous forme d’objets à une seule ligne ou “plats”.
      Astuce Qualtrics : selon votre type de fichier, certains types de données ne sont pas compatibles. Par exemple, les fichiers WebVTT peuvent uniquement être utilisés pour télécharger des transcriptions d’appels.
18. Vous devez fournir un exemple de fichier, qui peut être enregistré sur votre ordinateur ou sur votre serveur SFTP :
    • Sélectionnez Télécharger un échantillon à partir du stockage de fichiers si le fichier échantillon est enregistré sur votre serveur SFTP.
    • Sélectionnez Télécharger un échantillon depuis mon ordinateur si l’échantillon est enregistré sur votre ordinateur.
19. Si nécessaire, vous pouvez sélectionner un fichier modèle à télécharger. Cliquez sur le lien ici pour télécharger le modèle que vous avez sélectionné. Utilisez ce fichier pour ajouter les données que vous souhaitez importer dans XM Discover. Consultez la page d’assistance XM Discover Data Formats pour obtenir des informations de mise en forme spécifiques sur chaque fichier et type de données.
20. Cliquez sur le bouton Sélectionner un exemple de fichier et choisissez le fichier échantillon sur votre ordinateur ou sur votre serveur SFTP.
21. Un aperçu du fichier s’affiche. Si vous voyez un message d’erreur ou des contenus bruts au lieu de l’aperçu, il peut y avoir un problème avec les options de format de données que vous avez sélectionnées. Consultez la page Exemples d’erreurs de fichier pour obtenir de l’aide sur le dépannage de votre fichier.
22. Cliquez sur Suivant.
23. Si nécessaire, ajustez vos mappages de données. Consultez la page d’assistance Mappage des données pour en savoir plus sur le mappage des champs dans XM Discover. La section Mappage de données par défaut contient des informations sur les champs spécifiques à ce connecteur et la section Mappage des champs conversationnels couvre la manière de mapper les données pour les données conversationnelles.
    
24. Cliquez sur Suivant.
25. Si vous le souhaitez, vous pouvez ajouter des règles de substitution et de rédaction des données pour masquer les données sensibles ou remplacer automatiquement certains mots et expressions dans les commentaires et interactions des clients. Pour en savoir plus, consultez la page d’assistance sur la substitution et la rédaction des données.
    
26. Cliquez sur Suivant.
27. 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.
    
28. 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.
29. Cliquez sur Suivant.
30. Choisissez quand vous souhaitez recevoir une notification. Pour plus d’informations, voir Notifications de jobs.
    
31. Cliquez sur Suivant.
32. Sélectionnez le mode de traitement des documents en double. Pour plus d’informations, voir Traitement des doublons.
    
33. Sélectionnez Planifier exécutions incrémentielles si vous souhaitez que votre job s’exécute périodiquement selon une planification ou Configurer exécution unique si vous souhaitez que le job soit exécuté une seule fois. Pour plus d’informations, voir Planification des jobs.
34. Sélectionnez une période de conservation pour les fichiers traités. Les fichiers sont supprimés après la période définie.
    
35. Cliquez sur Suivant.
36. 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.
    
37. Cliquez sur Terminer pour sauvegarder le job.

Mappage de données par défaut

Cette section contient des informations sur les zones par défaut pour les jobs d’entrée de fichiers.

• feedback_type : identifie les données en fonction de leur type. Cela est utile pour le reporting lorsque votre projet contient différents types de données (par exemple, des enquêtes et des commentaires sur les médias sociaux). Par défaut, la valeur de cet attribut est définie sur “appel” pour les transcriptions d’appel, “discussion en direct” pour les interactions numériques ou “feedback” pour les commentaires individuels. Utilisez les transformations personnalisées pour définir une valeur personnalisée, définir une expression ou la mapper à une autre zone.
• source_value : identifie les données obtenues à partir d’une source spécifique. Il peut s’agir de tout ce qui décrit l’origine des données, comme le nom d’une enquête ou d’une campagne marketing mobile. Par défaut, la valeur de cet attribut est définie sur “Fichiers”. Utilisez les transformations personnalisées pour définir une valeur personnalisée, définir une expression ou la mapper à une autre zone.
• document_date : champ de date principal associé à un document. Cette date est utilisée dans les rapports XM Discover, les tendances, les alertes, etc. Vous pouvez utiliser n’importe quelle zone de date dans votre ensemble de données pour la date du document. Vous pouvez également définir une date de document spécifique.
• natural_id : identifiant unique d’un document. Il est fortement recommandé d’avoir un ID unique pour chaque document afin de traiter correctement les doublons. Pour ID naturel, vous pouvez sélectionner n’importe quelle zone de texte ou zone numérique à partir de vos données. Vous pouvez également générer automatiquement des ID en ajoutant une zone personnalisée.
• feedback_provider : identifie les données obtenues auprès d’un fournisseur spécifique. Pour les chargements de fichiers, la valeur de cet attribut est définie sur “Fichiers” et ne peut pas être modifiée.
• job_name : identifie les données en fonction du nom du job utilisé pour le charger. Vous pouvez modifier la valeur de cet attribut lors de la configuration via le champ Nom de la tâche qui est affiché en haut de chaque page pendant la configuration.
• loadDate : indique quand un document a été chargé dans XM Discover. Cette zone est définie automatiquement et ne peut pas être modifiée.

Mise à jour de l’exemple de configuration

Les connecteurs d’entrée de fichiers nécessitent un exemple de fichier pour générer des mappages de données. Si vous voulez modifier les mappages de données après avoir créé un job, procédez comme suit :

1. Annulez le mappage des champs qui ne sont pas présents dans le nouvel exemple de fichier.
2. Mettez à jour la configuration d’échantillon en chargeant un nouveau fichier échantillon avec un nouvel ensemble de champs. Les étapes de mise à jour de l’exemple de configuration sont ci-dessous.
3. Mettez à jour les mappages de données en fonction du nouvel exemple de fichier.

Mise à jour de l’exemple de configuration

1. Dans le menu des options du job, sélectionnez Mettre à jour exemple de configuration pour un job de fichiers existant.
   
2. Sélectionnez Cliquer pour sélectionner le fichier à télécharger et choisissez votre exemple de fichier enregistré sur votre ordinateur.
   
   Astuce Qualtrics : si votre fichier contient des champs qui ne sont pas dans votre mappage de données, vous recevrez un message d’erreur. Pour résoudre ce problème, modifiez votre mappage de données afin qu’il contienne les mêmes champs que votre exemple de fichier.
3. Vérifiez à nouveau vos options de fichier. Consultez la page Connecteur d’entrée de fichiers pour plus d’informations sur les exemples de paramètres de fichier.
4. Cliquez sur OK.

Mise à jour du chemin d’accès et du masque de fichiers

Les connecteurs d’entrée de fichiers requièrent un chemin d’accès et un masque de fichier (expression régulière de nom de fichier) pour trouver les fichiers appropriés à importer. Vous pouvez mettre à jour le chemin d’accès et le masque de fichier pour n’importe quel job de fichier existant.

1. Dans le menu des options du job, sélectionnez Mettre à jour chemin d’accès et masque de fichier pour un job de fichiers existant.
   
2. Cliquez sur Parcourir.
   
3. Sélectionnez le dossier dans lequel les fichiers sont stockés.
   
   Attention : seuls les fichiers du dossier sélectionné sont traités ; les sous-dossiers doivent être traités séparément.
4. Cliquez sur OK.
5. Dans le champ Expression régulière de nom de fichier, saisissez le masque de fichier (expression régulière de nom de fichier) qui correspond aux fichiers que vous souhaitez importer.
   
6. Cliquez sur Enregistrer.

Chiffrements d’échange de clés pris en charge par XM Discover

La connexion à un serveur SFTP nécessite une série de poignées de main SSH pour coordonner le cryptage utilisé entre le serveur et l’automatisation. Pour établir une connexion, le serveur SFTP doit avoir au moins un chiffrement pour chaque type de chiffrement qui correspond à un chiffrement pris en charge par les automatisations. Vous trouverez ci-dessous la liste des chiffrements pris en charge par les automatisations regroupées par type de chiffrement.

Voici une liste des chiffrements d’échange de clés pris en charge par les serveurs SFTP :

• diffie-hellman-group14-sha256
• diffie-hellman-group18-sha512
• ecdh-sha2-nistp256
• ecdh-sha2-nistp384
• ecdh-sha2-nistp521
• curve25519-sha256
• curve25519-sha256@libssh.org
• diffie-hellman-group16-sha512
• ecdh-nistp256-kyber-512r3-sha256-d00@openquantumsafe.org
• ecdh-nistp384-kyber-768r3-sha384-d00@openquantumsafe.org
• ecdh-nistp521-kyber-1024r3-sha512-d00@openquantumsafe.org
• x25519-kyber-512r3-sha256-d00@amazon.com