Extraire les données des fichiers SFTP Tâche

Suite

Customer Experience Employee Experience Strategy & Research

Produit

Qualtrics

Contenus de cette page

A propos de la tâche Extraire les données des fichiers SFTP

La tâche « Extraire des données à partir de fichiers SFTP » vous permet d'importer des données depuis votre serveur SFTP afin de les 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 les données dans le répertoire XM, pour importer des données à d'autres endroits dans Qualtrics.

Astuce : Qualtrics propose ses propres serveurs SFTP à ses clients par l'intermédiaire de son équipe de services professionnels. Ce service est payant, mais nous garantissons que ces serveurs fonctionneront avec les automatismes. Pour plus d'informations, veuillez contacter notre équipe de services professionnels.

Attention : votre compte SFTP doit disposer des droits de lecture, d'écriture et de suppression pour que cette tâche aboutisse.

Attention : vous ne pouvez pas extraire les fichiers dont le nom contient le caractère «% » .

Connexion à un compte SFTP

Avant de pouvoir utiliser la tâche Extraire les données des fichiers SFTP, vous devez connecter un compte SFTP pour que Qualtrics puisse extraire les données. Les comptes peuvent être ajoutés par les administrateurs de l'Organisation pour être utilisés par d'autres utilisateurs de l'organisation, ou par des utilisateurs individuels pour leur usage personnel.

Il existe trois options d'authentificateur différentes :

Mot de passe: Authentificateur avec un nom d'utilisateur et un mot de passe.
Clé SSH: Authentificateur à l'aide d'une clé Secure Shell (SSH) que vous fournissez ou d'une clé fournie par Qualtrics.
Clé SSH cryptée: Authentificateur utilisant une clé SSH cryptée.

Astuce : Lors de l'établissement d'une connexion SFTP, nous recommandons à votre équipe de technologie de l'information d'autoriser les plages IP de Qualtrics.

Ajout d'un compte en tant qu'administrateur de l'organisation

Si vous êtes administrateur de l'organisation, suivez les étapes décrites dans cette section pour ajouter un compte SFTP que pourront utiliser certains ou tous les utilisateurs couverts par votre licence.

À l'aide du menu de navigation situé en haut à gauche, accédez à la rubrique « Admin ».

navigating to the extensions section of admin, and selecting the extract data from sftp files extension

Allez dans Extensions.

Cliquez sur l'extension Extraire les données des fichiers SFTP.

Cliquez sur Ajouter un compte.

Donnez un nom au compte. Ce nom est utilisé à des fins d'organisation et pour identifier le compte.

giving the account a name, entering the hostname and port, and choosing an authentication method

Saisissez le nom d'hôte du serveur SFTP associé.

Exemple : Ils se présentent généralement sous la forme suivante : sftp.example.com

Saisir le numéro de port. (Habituellement, c’est la question Q1.)

Choisissez votre méthode d'authentificateur. Vous avez le choix :

Mot de passe: fournir un nom d'utilisateur et un mot de passe pour l'authentificateur.
Clé SSH: Fournissez un nom d'utilisateur et une clé SSH pour l'authentificateur, ou utilisez une clé SSH générée par Qualtrics.
Clé SSH cryptée: Fournissez votre propre clé SSH cryptée avec une phrase de passe pour l'authentificateur.

Si vous avez choisi le mot de passe, entrez le nom d'utilisateur et le mot de passe du compte SFTP.

Si vous vous authentifiez à l'aide d'une clé SSH, procédez de l'une des manières suivantes :

Si vous utilisez une clé SSH générée par Qualtrics, entrez 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é publique SSH 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. Conservez ces deux documents dans un endroit sûr afin de pouvoir vous y référer 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 : Vous devez entrer une clé privée non protégée par un mot de passe dans cette case. La clé publique doit être autorisée sur votre serveur SFTP.
Cette clé doit être au format PEM-encodé. Les autres formats (comme la clé privée PuTTY) ne sont pas pris en charge.
Exemple : Les clés codées PEM sont généralement lisibles par l'homme. Voici à quoi ressemble généralement une clé (avec les lignes d'en-tête « begin » et « end » de la clé RSA) :
—–BEGIN RSA PRIVATE KEY—–
a1b2c3d4…
—–END RSA PRIVATE KEY—–

Si vous vous authentifiez avec une clé SSH cryptée, entrez le nom d'utilisateur, la clé SSH cryptée et la phrase de passe associée à votre clé.

entering the details to use an encrypted ssh key

Une fois l'opération terminée, cliquez sur Connecter le compte.

Ajouter un compte en tant qu'utilisateur individuel

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

Suivez les étapes de la section Paramètres d'une tâche d'extraction de données à partir de fichiers SFTP jusqu'à l'étape de sélection du compte à utiliser.

Cliquez sur Ajouter un compte d'utilisateur.

Suivez les instructions de la sous-section « Ajouter un compte en tant qu’administrateur de l’organisation » ci-dessus pour en savoir plus sur la manière de connecter votre compte. Les mêmes options et paramètres du compte sont disponibles lors de l'ajout d'un compte en tant qu'utilisateur individuel.

Test de la connexion

Une fois que vous avez ajouté un compte, vous pouvez tester la connexion depuis la tâche « Extraire les données des fichiers SFTP ». Au bas de la tâche, cliquez sur « Tester la connexion ». Cette technologie télécharge un petit fichier de test sur votre serveur, lit son contenu, puis le supprime.

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 de la connexion. Lors de l'affichage de la liste des comptes SFTP à utiliser, cliquez sur le menu à trois points situé à droite d'un compte, puis choisissez Télécharger la clé publique SSH. La clé est alors téléchargée sur votre ordinateur sous la forme d'un fichier .pem.

en cliquant sur un compte et en sélectionnant télécharger la clé publique Ssh

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 régénérer la clé si nécessaire. Cette fonction est utile si vous pensez que la clé a été compromise ou si votre entreprise exige que vous procédiez à une rotation des clés après un certain temps.

Attention : Cette action mettra automatiquement à jour la clé SSH de votre compte et ne pourra pas être rétablie. Assurez-vous de vouloir régénérer la clé avant de suivre les étapes de cette section.

Lors de l'affichage de la liste des comptes SFTP à utiliser, cliquez sur le menu à trois points situé à droite du compte et cliquez sur Modifier le compte.

Cliquez sur le lien hypertexte pour générer une nouvelle paire de clés.

clicking the "click here to generate new key pairs" link

Astuce : Veillez à cliquer sur Télécharger la clé SSH publique et sur Copier dans le presse-papiers pour enregistrer votre nouvelle clé SSH.

Dépannage de la tâche « Extraire les données des fichiers SFTP »

Voici les meilleures pratiques, les limites et les conseils de dépannage pour le traitement des fichiers à l'aide de cette tâche :

Limites de taille des fichiers : la tâche « Extraire les données des fichiers SFTP » est limitée à 200 fichiers par exécution, chaque fichier pouvant atteindre une taille maximale de 5 Go, la taille totale de l'ensemble des fichiers étant plafonnée à 10 Go. Si les fichiers dépassent ces limites, la tâche échoue, ce qui signifie qu'aucun des fichiers n'est traité.
En-têtes requis : Les fichiers ont besoin d'une ligne d'en-têtes pour être traités. S'il manque une ligne d'en-tête dans un fichier, celui-ci est considéré comme invalide.
Fichiers à l'origine de l'échec d'une tâche : si vous essayez d'extraire plusieurs fichiers et que l'un d'entre eux provoque l'échec de la tâche, vous devez modifier ce fichier afin d'empêcher le flux de travail de tenter de le traiter à nouveau, ce qui entraînerait un nouvel échec. Par exemple, vous pouvez déplacer le fichier dans un autre répertoire de votre SFTP, le supprimer ou changer le préfixe du fichier.
Guillemets échappés : les barres obliques inversées ( \ ) ne constituent pas des guillemets échappés valides pour les fichiers CSV. Veillez à utiliser des guillemets droits ( “” ). Ne pas utiliser de guillemets typographiques ( " ").
Fin de ligne : Si vous utilisez un fichier qui ne comporte que des fins de ligne avec retour de chariot, celles-ci seront remplacées par des fins de ligne avec retour à la ligne.
CSV encodés en UTF-8 : Si vous utilisez un CSV, le seul format d'encodage de fichier pris en charge pour cette tâche est l'UTF-8. Certains tableurs enregistrent en Unicode UTF-8, qui est différent de l'UTF-8, si vous obtenez des erreurs inattendues. Veuillez vous assurer que vous exportez au format UTF-8 et non Unicode UTF-8.

Astuce : Pour plus d'informations sur les limites générales qui s'appliquent aux flux ETL, voir Limites des flux de travail. Pour toute limite spécifique à une tâche, reportez-vous aux informations figurant sur cette page.

Pour le dépannage des connexions SFTP, consultez la section « Dépannage SFTP ».

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

Créer un flux de travail ETL.

Sélectionner la source de données (extracteur Etl).

adding an extractor task to the etl workflow

Choisissez la tâche Extraire les données des fichiers SFTP.

selecting the extract data from sftp files task

Choisissez le compte SFTP à partir duquel vous souhaitez extraire les fichiers. Tous les comptes ajoutés par les administrateurs de l'Organisation, ainsi que les comptes que vous avez vous-même ajoutés, seront listés ici.

Si vous souhaitez ajouter de nouvelles informations d'identification pour un compte SFTP, cliquez sur Ajouter un compte d'utilisateur et suivez les étapes de la section Connexion d'un compte SFTP.

Cliquez sur Suivant.

Saisissez le modèle de nom de fichier, qui est utilisé pour identifier les fichiers à traiter en examinant le préfixe du fichier. Tous les fichiers portant le préfixe spécifié seront traités. Saisissez le préfixe souhaité dans la case. Il n'est pas nécessaire d'ajouter un astérisque (*) à la fin du préfixe.

entering a file name, directory, and zip prefix

Exemple : Disons que j'ai un fichier appelé Qualtrics-DataImport.csv. Je peux saisir "Q" ou "Qualtrics" comme préfixe, selon qu'il existe ou non d'autres fichiers dans le serveur que je souhaite traiter.

Astuce : cochez la case « Utiliser une expression régulière » si vous souhaitez utiliser une expression régulière pour définir le modèle de nom de fichier.

Saisissez le répertoire Répertoire ou le chemin d'accès au répertoire pour trouver le fichier sur le serveur. Vous pouvez saisir un chemin relatif ou un chemin absolu.

Astuce : Le chemin d'accès au répertoire est sensible à la casse et doit pointer vers un dossier existant, faute de quoi le flux de travail é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 ramassage.

Exemple : en fonction du chemin d'accès que vous saisissez, les répertoires de récupération possibles pourraient être les suivants :
/home/username/myFolder (chemin absolu)
monDossier (chemin relatif)

Cochez la case « Utiliser une expression régulière » si vous souhaitez utiliser une expression régulière pour définir le modèle de nom de fichier.

Astuce : seuls les fichiers correspondant à l'expression régulière indiquée seront extraits. Veuillez utiliser la syntaxe des expressions régulières RE2.

Si votre fichier est compressé, cochez l'option « Vous extrayez-vous le contenu d'un fichier zip? ». Saisissez ensuite le préfixe du fichier dans le fichier zip, qui sera utilisé pour trouver le bon fichier à importer à partir du fichier zip.

Astuce : Seules les compressions .zip sont prises en charge. Les fichiers contenus dans le fichier .zip peuvent être cryptés, mais pas le fichier .zip lui-même (par exemple, filename.csv.pgp.zip est pris en charge, mais filename.csv.zip.pgp ne l'est pas).

Si vous le souhaitez, sélectionnez Fichier non schématisé.

setting up an SFTP task, particularly file import settings, file type, and delimiter

Astuce : un fichier est considéré comme "non schématisé" s'il ne respecte pas le formatage standard requis. Par exemple :
Le fichier est un type de fichier non pris en charge (voir l'étape 15 pour les types de fichiers pris en charge).
Il manque des en-têtes au fichier.
Le fichier présente d'autres erreurs de formatage.

Astuce : La sélection de "Is unschematized file" supprime les paramètres relatifs au type de fichier, au délimiteur et au fichier échantillon.

Si vous le souhaitez, sélectionnez Décrypter les fichiers avant de les importer à l'aide de PGP. Pour en savoir plus sur ce moyen supplémentaire de cryptage et de protection des données, voir le chiffrement PGP.

Astuce : Assurez-vous que les fichiers que vous souhaitez importer sont cryptés avec la clé publique de Qualtrics avant de les télécharger sur votre serveur SFTP. Pour ce faire, vous devrez peut-être vous adresser à votre équipe de technologie de l'information.

Si vous souhaitez ignorer les fichiers qui ne peuvent pas être traités, sélectionnez « Ignorer les fichiers corrompus ». Si cette option n'est pas sélectionnée, l'ensemble du flux de travail échouera lorsqu'il tentera de traiter le fichier corrompu.

Attention: les extensions de fichiers « F »sont sensibles à la casse. L'extension du fichier doit toujours être en minuscules, sinon le fichier ne sera pas traité correctement.

Astuce : l'option « Ignorer les fichiers incorrects » permet de ne pas traiter les fichiers dont la taille dépasse la limite maximale, ni ceux qui ne peuvent pas être ouverts, comme ceux qui sont endommagés d'une manière ou d'une autre. Bien que ce paramètre réduise les risques d'échec d'un flux de travail, il ne tient pas compte des problèmes susceptibles de survenir dans les fichiers qui peuvent être ouverts, tels que des en-têtes et un formatage incorrects.

Sélectionnez un type de fichier. Les options disponibles sont les suivantes : CSV, TSV, JSON ou Excel (.xlsx ou .xls).

Attention : lorsqu'un fichier Excel est sélectionné, la tâche ne lit que le premier onglet du document. En outre, les fichiers .xlsx doivent être inférieurs à 1 gigaoctet et les fichiers .xls doivent être inférieurs à 5 mégaoctets.

Astuce : le contenu des fichiers JSON doit être placé entre crochets, []. Par exemple :
[
{
"fruit" : "Pomme",
"taille" : "Grande",
"couleur" : "Rouge"
}
]

Attention : Seuls les fichiers UTF-8 sans nomenclature peuvent être utilisés. Utilisez des espaces réguliers (et non des espaces insécables) dans les en-têtes de colonne. Les espaces insécables ont un aspect identique mais entraînent des échecs de correspondance. Les exportations Excel créent souvent des espaces insécables ; remplacez-les par des espaces normaux.

Si vous traitez un CSV, choisissez le délimiteur pour le fichier. Vous avez le choix entre la virgule, le point-virgule, la tabulation et le tuyau.

Choisissez ce qui se passera après le traitement du fichier. Vous avez le choix :

post processing behavior, conversational data, and validation settings

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.
Astuce : Gardez à l'esprit que si plusieurs flux de travail accèdent aux mêmes fichiers, cela reste vrai. En d'autres termes, si un flux de travail supprime un fichier et qu'un autre flux de travail tente de s'exécuter sur la même logique, le fichier aura déjà été supprimé du SFTP et ne sera pas traité par d'autres flux de travail.
Déplacer le fichier traité dans un autre répertoire: Si vous choisissez cette option, un champ apparaît dans lequel vous pouvez indiquer le chemin URL du dossier dans lequel vous souhaitez enregistrer le fichier traité.
Conserver le fichier traité: Après avoir traité le fichier, Qualtrics le laisse sur votre serveur SFTP.

Attention : Si votre serveur SFTP est configuré pour supprimer ou déplacer automatiquement les fichiers après qu'ils ont été touchés, l'option de post-traitement que vous sélectionnez peut ne pas fonctionner comme prévu.

Définissez si vos données sont conversationnelles ou non, puis réglez-les sur le chat ou l'e-mail. Pour en savoir plus, voir Extraire des données conversationnelles d'un SFTP.

Astuce: la définition de la tâche en tant que données conversationnelles supprime les paramètres de type de fichier et de délimitation.

Choisissez si vous souhaitez activer la « validation stricte », qui rejettera automatiquement les fichiers extraits en cas de problèmes de mise en forme. Les en-têtes de votre fichier extrait seront comparées à celles d'un fichier d'échantillon que vous fournirez ; si des en-têtes manquent, le fichier extrait ne passera pas la validation.

Astuce : la validation échouera pour chaque ligne si des valeurs d'en-tête sont manquantes. Activez l'option « Ignorer les lignes mal formées » pour exclure toutes les lignes présentant des problèmes de mise en forme tout en poursuivant le téléchargement de votre fichier.

Activez l'option Ignorer les lignes malformées pour télécharger votre fichier et exclure toutes les lignes présentant des problèmes de formatage.

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 ultérieures que vous pouvez utiliser avec cette tâche. Le fichier que vous téléchargez doit contenir les champs que vous souhaitez importer dans le cadre de cette tâche.

Astuce : Téléchargez les fichiers échantillons dans la tâche, ou téléchargez les fichiers dans la section des fichiers exemples pour obtenir des modèles sur la façon de structurer vos données en fonction de votre cas d'utilisation.

Vérifiez que votre fichier importe correctement les données. Si vous devez modifier vos paramètres, cliquez sur Retour en haut de la tâche.

Astuce : Si toutes vos données sont importées sous la forme d'une seule colonne, vous n'utilisez pas le bon délimiteur. La capture d'écran ci-dessous montre à quoi cela ressemble dans la fenêtre de la tâche.

Si vos données semblent correctes, cliquez sur Enregistrer.

Terminez la construction de votre flux DEVAIL. Lorsque vous sélectionnez une tâche de chargement, vous déterminez la destination des données que vous avez extraites. Voir les tâches de chargement disponibles pour une liste de tâches.

Exemples de fichiers

image des échantillons de fichiers tels qu'ils apparaissent lors de la mise en place de la tâche de flux de travail

Vous trouverez ci-dessous des fichiers d'exemple sur la manière de structurer vos données pour l'importation, en fonction du type de données que vous souhaitez importer. Cliquez sur le nom d'un fichier pour télécharger le fichier d'exemple.

Extraction de données conversationnelles à partir de fichiers SFTP

Les données conversationnelles sont des données provenant de chats et de courriels. Par exemple, si vous avez des enregistrements d'interactions avec les clients et l'assistance, il s'agit de données conversationnelles. Ce type d'information peut contenir des commentaires ouverts enrichissants et fournir l'occasion de former vos représentants en contact avec la clientèle sur la manière de mieux servir vos clients. Vous pouvez effectuer ce type d'analyse conversationnelle une fois que vos données ont été transférées de votre serveur vers Qualtrics, grâce à notre multitude de fonctions d'écoute omnicanale.

Pour en savoir plus, consultez la section « Extraction de données conversationnelles à partir de fichiers ».

FAQs

Ai-je accès à toutes les extensions disponibles via les modèles de flux de travail ?

L'accès dépend de votre licence et de vos autorisations. Contactez votre administrateur de l'organisation et demandez-lui si votre licence donne accès à cette extension.

Existe-t-il un lien vers l'ensemble des évènements et des tâches des flux de travail ?

Consultez cette page d'aide pour découvrir les principes de base des flux de travail Qualtrics. Tous les évènements et toutes les tâches sont accessibles via les liens du menu du site d'assistance que vous verrez à gauche.

Que sont les modèles de flux de travail ?

Les modèles de flux de travail sont des ensembles de flux de travail automatisés préconfigurés qui évitent aux utilisateurs d'avoir à créer des flux de travail à partir de zéro. Ces modèles ont été créés par les experts de Qualtrics dans ce domaine.

Qu'est-ce qu'un flux de travail ? / Où se trouvent les actions ?

Les « actions » ont été rebaptisées « flux de travail » afin de mieux refléter l'expérience produit et de rendre compte de la manière dont les utilisateurs interagissent avec le produit. Pour plus d'informations sur l'utilisation des flux de travail, consultez la page « Présentation générale des flux de travail ».

Cette mise à jour n'apporte aucune modification aux fonctionnalités liées aux flux de travail.

Comment puis-je ajouter ou supprimer une extension de mon compte Qualtrics ?

Pour savoir comment ajouter des extensions, consultez la section « Installation d'extensions tierces ». Pour savoir comment supprimer des extensions, consultez la section « Désinstallation et suppression d'extensions tierces ».

De nombreuses pages de ce site ont été traduites de l'anglais en traduction automatique. Chez Qualtrics, nous avons accompli notre devoir de diligence pour trouver les meilleures traductions automatiques possibles. Toutefois, le résultat ne peut pas être constamment parfait. Le texte original en anglais est considéré comme la version officielle, et toute discordance entre l'original et les traductions automatiques ne pourra être considérée comme juridiquement contraignante.

Est-ce que cela vous a aidé?

Les commentaires que vous soumettez ici sont utilisés uniquement pour aider à améliorer cette page.

C'est génial! Merci pour votre avis!

Merci pour votre avis!