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 combiner cette tâche avec d’autres tâches, telles que la tâche Charger les données dans le répertoire XM, pour importer des données dans le Centre de commandes de gestion des comptes et d’autres emplacements dans Qualtrics.

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.

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. Cliquez sur le menu de navigation en haut à gauche.
   
2. Sélectionnez Workflows.
3. Cliquez sur Créer un workflow.
4. Sélectionnez Lancé à une heure spécifique.
5. Si vous le souhaitez, renommez votre workflow en cliquant sur le nom du workflow en haut.
   
6. Déterminer à quel moment le workflow planifié se déclenche. Pour plus d’informations sur la configuration des workflows planifiés, voir Workflows planifiés.
7. Cliquez sur le signe plus ( + ) et sélectionnez Tâche.
8. Sélectionnez la tâche Extraire les données des fichiers SFTP.
   
9. 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.
   
10. Si vous souhaitez ajouter de nouvelles références de connexion au compte SFTP, cliquez sur Ajouter un nouveau compte et suivez les étapes de la section de connexion d’un compte SFTP.
11. Cliquez sur Suivant.
12. 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.
13. 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)
14. Sélectionnez le séparateur pour les fichiers SFTP à traiter. Vos options incluent la virgule, le point-virgule, l’onglet et le canal.
15. 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.
16. 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.
17. 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.
    
18. Cliquez sur Charger.
19. 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.

    

20. Si vos données semblent correctes, cliquez sur Sauvegarder.
21. Cliquez sur le signe plus (+ ), sélectionnez Tâche et configurez la tâche qui doit suivre votre extraction de données SFTP. Il doit s’agir d’une tâche du chargeur de données. 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