Tâche d’extraction de données à partir de fichiers SFTP

À propos de la tâche d’extraction de données à partir de fichiers SFTP

La tâche Extraire les données des fichiers SFTP vous permet d’importer des données à partir de votre serveur SFTP à utiliser dans Qualtrics. Vous pouvez utiliser cette tâche pour traiter un ou plusieurs fichiers à la fois. Vous pouvez combiner cette tâche avec d’autres tâches, telles que la tâche Charger des données dans le répertoire XM, pour importer des données à d’autres endroits de Qualtrics.

Pour plus d’informations sur la configuration et la correction des erreurs SFTP, voir. Dépannage SFTP.

Connexion d’un compte SFTP

Avant de pouvoir utiliser la tâche Extraire les données à partir de fichiers SFTP, vous devez connecter un compte SFTP pour Qualtrics afin d’extraire les données de. Les comptes peuvent être ajoutés par les Administrateurs de la Marque pour d’autres utilisateurs de la marque à utiliser, ou par des utilisateurs individuels pour leur usage personnel.

Il existe trois options d’authentification différentes :

• Mot de passe : Authentifiez-vous avec un nom d’utilisateur et un mot de passe.
• Clé SSH : authentifiez-vous à l’aide d’une clé Secure Shell (SSH) que vous fournissez ou d’une clé fournie par Qualtrics.
• Clé SSH cryptée : authentification à l’aide d’une clé SSH cryptée.

Ajout d’un compte en tant qu’administrateur de la marque

Si vous êtes administrateur de la marque, suivez les étapes de cette section pour ajouter un compte SFTP pour certains ou tous les utilisateurs de votre licence à utiliser.

1. À l’aide du menu de navigation en haut à gauche, accédez à Admin.
   
2. Accédez à Extensions.
3. Cliquez sur l’extension Extraire les données des fichiers SFTP.
4. Cliquez sur Ajouter un compte.
   
5. Donnez un nom au compte. Ce nom est utilisé à des fins d’organisation et pour identifier le compte.
   
6. Saisissez le nom d’hôte du serveur SFTP associé.
   Exemple : généralement au format sftp.example.com
7. Saisissez le numéro de port. (Habituellement, c’est la question Q1.)
8. Sélectionnez votre méthode d’authentification. Vous avez le choix :
   • Mot de passe : indiquez un nom d’utilisateur et un mot de passe pour l’authentification.
   • Clé SSH : indiquez un nom d’utilisateur et une clé SSH pour l’authentification, ou utilisez une clé SSH générée par Qualtrics.
   • Clé SSH cryptée : fournissez votre propre clé SSH chiffrée avec une phrase secrète pour l’authentification.
9. Si vous avez choisi le mot de passe, saisissez le Nom d’utilisateur et le Mot de passe du compte SFTP.
   
10. Si vous vous authentifiez avec une clé SSH, effectuez l’une des actions suivantes :
    • Si vous utilisez une clé SSH générée par Qualtrics, saisissez un nom d’utilisateur, puis cliquez sur Générer une paire de clés SSH.
      Vous pouvez ensuite cliquer sur Télécharger la clé SSH publique pour télécharger la clé publique sous forme de fichier .pem sur votre ordinateur. La clé privée associée sera stockée par Qualtrics. Cliquez sur Copier dans le presse-papiers pour copier l’empreinte de la clé dans votre presse-papiers. Sauvegardez ces deux éléments dans un emplacement sécurisé afin de pouvoir les référencer si nécessaire.
    • Si vous utilisez votre propre clé SSH, cliquez sur Fournir une clé privée.
      Saisissez ensuite votre nom d’utilisateur et la clé SSH.
      Astuce Qualtrics : vous devez saisir une clé privée non protégée par mot de passe dans cette zone. En outre, la clé publique doit être autorisée sur votre serveur SFTP.
      Exemple:
      C’est ce à quoi ressemble généralement une clé SSH (y compris les lignes de clé RSA de début et de fin):
      —–BEGIN RSA PRIVATE KEY—–
      a1b2c3d4…
      —–END RSA PRIVATE KEY—–
11. Si vous vous authentifiez avec une clé SSH cryptée, saisissez le Nom d’utilisateur, la Clé SSH cryptée et la Phrase secrète associée à votre clé.
12. Une fois que vous avez terminé, cliquez sur Connecter un compte.

Ajout d’un compte en tant qu’utilisateur individuel

Suivez les étapes de cette section pour ajouter un compte SFTP à votre usage personnel. Vous seul pourrez utiliser le compte que vous connectez.

1. Suivez les étapes de la section Configuration d’une tâche d’extraction de données à partir de fichiers SFTP jusqu’à ce que vous arriviez à l’étape où vous sélectionnez un compte à utiliser.
2. Cliquez sur Ajouter un compte utilisateur.
   
3. Suivez les instructions de la sous-section « Ajouter un compte en tant qu’Administrateur de l’entreprise » ci-dessus pour plus d’informations sur la connexion de votre compte. Les mêmes options et paramètres d’authentification sont disponibles lors de l’ajout d’un compte en tant qu’utilisateur individuel.

Test de la connexion

Après avoir ajouté un compte, vous pouvez tester la connexion à partir de la tâche Extraire les données des fichiers SFTP. En bas de la tâche, cliquez sur Tester la connexion. Cela chargera un petit fichier test sur votre serveur, lira son contenu, puis supprimera le fichier. 

Téléchargement des clés SSH publiques

Si vous utilisez une clé SSH générée par Qualtrics, vous pouvez télécharger la clé publique pour la connexion. Lorsque vous affichez la liste des comptes SFTP à utiliser, cliquez sur le menu à trois points à droite d’un compte, puis sélectionnez Télécharger la clé publique SSH. Cela téléchargera la clé sur votre ordinateur sous forme de fichier .pem.

Mise à jour des clés SSH générées par Qualtrics

Si vous utilisez une clé SSH générée par Qualtrics, vous pouvez générer à nouveau la clé si nécessaire. Cela est utile si vous pensez que la clé a été compromise ou si votre société vous demande de faire pivoter les clés après un certain temps.

1. Lorsque vous affichez la liste des comptes SFTP à utiliser, cliquez sur le menu à trois points à droite du compte et cliquez sur Modifier le compte.
2. Cliquez sur le lien hypertexte pour générer une nouvelle paire de clés.
   

Configuration d’une tâche d’extraction de données à partir de fichiers SFTP

1. Créez un workflow ETL.
2. Sélectionnez Source de données (extracteur ETL).
   
3. Sélectionnez la tâche Extraire les données des fichiers SFTP.
   
4. Sélectionnez le compte SFTP à partir duquel extraire les fichiers. Tous les comptes ajoutés par les Administrateurs de la Marque, ainsi que les comptes que vous avez ajoutés vous-même, seront répertoriés ici.
   
5. Si vous souhaitez ajouter de nouveaux identifiants de compte SFTP, cliquez sur Ajouter un compte utilisateur et suivez les étapes de la section Connexion d’un compte SFTP.
6. Cliquez sur Suivant.
7. Saisissez le Modèle de nom de fichier, qui est utilisé pour identifier les fichiers à traiter en regardant le préfixe du fichier. Tous les fichiers avec le préfixe que vous avez indiqué seront traités. Saisissez le préfixe souhaité dans la zone.
   
   Exemple : disons que j’ai un fichier appelé Qualtrics-DataImport.csv. Je peux saisir « Q » ou « Qualtrics » comme préfixe, selon qu’il existe d’autres fichiers sur le serveur que je souhaite traiter.
   Astuce Qualtrics : cochez la case Utiliser une expression régulière si vous souhaitez utiliser l’expression régulière comme modèle de nom de fichier.
8. Saisissez le répertoire de récupération ou le chemin d’accès au répertoire pour rechercher le fichier sur le serveur. Vous pouvez saisir un chemin relatif ou un chemin absolu.
   Astuce Qualtrics : ce chemin d’accès au répertoire est sensible à la casse et doit pointer vers un dossier existant, sinon le workflow échouera. Qualtrics ne pourra pas accéder aux fichiers s’ils se trouvent dans un répertoire de niveau supérieur à celui spécifié dans le répertoire de récupération.

   Exemple : selon le chemin que vous saisissez, les répertoires de récupération potentiels peuvent être :

   • /home/username/myFolder (chemin absolu)
   • monDossier (chemin relatif)
9. Si votre fichier est compressé, activez l’option Effectuer une extraction à partir d’un fichier zip. Saisissez ensuite le préfixe du fichier dans le fichier zip qui sera utilisé pour trouver le fichier correct à importer à partir du fichier zip.
   Astuce Qualtrics : seules les compressions .zip sont prises en charge. Les fichiers du fichier .zip peuvent être chiffrés, mais le fichier .zip lui-même ne peut pas l’être (par exemple, nomfichier.csv.pgp.zip est pris en charge, mais nomfichier.csv.zip.pgp ne l’est pas).
10. Sélectionnez un type de fichier.
    
    Vous avez le choix :
    • CSV
    • TSV
    • JSON

      Astuce Qualtrics : les fichiers JSON doivent avoir leur contenu entre crochets, []. Par exemple :

      [
         {
             "fruit": "Pomme",
             "taille": "Grande",
             "couleur": "Rouge"
         }
       ]

    • Excel (.xslx ou .xls)
11. Si vous traitez un fichier CSV, sélectionnez le séparateur pour le fichier. Vos options incluent la virgule, le point-virgule, l’onglet et le canal.
12. Si vous le souhaitez, sélectionnez Décrypter les fichiers avant l’importation à l’aide de PGP. Pour en savoir plus sur ces moyens supplémentaires de chiffrement et de protection des données, voir Chiffrement PGP.
    Astuce Qualtrics : assurez-vous que les fichiers que vous souhaitez importer sont chiffrés avec la clé publique de Qualtrics avant de les télécharger sur votre serveur SFTP. Pour ce faire, vous devrez peut-être discuter avec votre équipe informatique.
13. Si vous souhaitez ignorer les fichiers qui ne peuvent pas être traités, sélectionnez Ignorer les fichiers incorrects. Si cette option n’est pas sélectionnée, l’ensemble du flux de travail échouera lorsqu’il tentera de traiter le fichier incorrect.
    Astuce Qualtrics : il existe un certain nombre de raisons pour lesquelles un fichier ne peut pas être traité. Le plus fréquent est qu’il est trop volumineux ou que ses données sont corrompues d’une manière ou d’une autre.
14. Sélectionnez ce que vous souhaitez faire après le traitement du fichier. Vous avez le choix :
    • Supprimer le fichier traité : après avoir traité le fichier, Qualtrics le supprime de votre serveur SFTP. Cette option est activée par défaut.
    • Conservez le fichier traité : après avoir traité le fichier, Qualtrics le laisse sur votre serveur SFTP.
15. Décidez si vous souhaitez utiliser une validation stricte, qui rejettera automatiquement les fichiers extraits s’ils présentent certains problèmes de mise en forme. Lisez le message dans la tâche pour plus d’informations sur les fichiers qui seront refusés.
    
    Astuce Qualtrics : activez Ignorer les lignes erronées pour télécharger votre fichier sur le serveur et exclure les lignes présentant des problèmes de mise en forme.
16. Cliquez sur Choisir un fichier et téléchargez un fichier échantillon, qui indiquera à Qualtrics les champs que vous souhaitez importer, et déterminera les tâches suivantes que vous pourrez utiliser avec cette tâche. Le fichier que vous chargez doit contenir les champs que vous souhaitez importer dans le cadre de cette tâche.
    Astuce Qualtrics : téléchargez les fichiers échantillons dans la tâche ou téléchargez les fichiers dans la section Exemples de fichiers pour des modèles sur la manière de structurer vos données en fonction de votre cas d’utilisation. Le seul format d’encodage de fichier pris en charge est UTF-8. Certains logiciels de feuilles de calcul enregistrent au format Unicode UTF-8, ce qui est différent de UTF-8 si vous recevez des erreurs inattendues. Assurez-vous que vous exportez au format UTF-8 et non au format Unicode UTF-8.
    
17. Vérifiez à nouveau que votre fichier importe les données correctement. Si vous devez modifier vos options, cliquez sur Retour en haut de la tâche.
    

    Astuce Qualtrics : si toutes vos données sont importées comme une seule colonne, vous utilisez le mauvais séparateur. La capture d’écran ci-dessous montre à quoi cela ressemble dans la fenêtre de tâche.

    

18. Si vos données semblent correctes, cliquez sur Sauvegarder.
19. Terminez la création de votre flux de travail ETL. Lorsque vous sélectionnez une tâche du chargeur, vous décidez de la destination des données que vous avez extraites. Consultez les tâches du chargeur disponibles pour obtenir une liste des options.
    

Exemples de fichiers

Vous trouverez ci-dessous des exemples de fichiers pour la structure de vos données à importer, en fonction du type de données que vous souhaitez importer. Cliquez sur un nom de fichier pour télécharger l’exemple de fichier.

• Données utilisateur
• Données de réponse à l’enquête
• Données de contact Salesforce
• Données de compte Salesforce
• Compte Salesforce – Données du membre de l’équipe
• Données du salarié

FAQ