Modèle d’article

À propos du connecteur de fichiers entrants

Vous pouvez utiliser le connecteur de fichiers entrants pour charger les données des clients via un fichier. Ces tâches peuvent être programmées pour être répétées selon un calendrier que vous définissez, ou être configurées pour être une extraction de données unique.

Les travaux de réception de fichiers vous permettent de télécharger des données dans les formats suivants :

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

Mise en place d’un travail de réception de fichiers

1. Sur la page Emplois, cliquez sur Nouveau travail.
   
2. Sélectionnez Fichiers.
   
3. Donnez un nom à votre travail afin de pouvoir l’identifier.
   
4. Choisissez le projet dans lequel vous souhaitez charger les données.
5. Donnez une description de votre poste afin d’en connaître l’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 afin de 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 : Entrez l’URL de l’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 après un certain temps, sélectionnez cette option.
   • Jours avant l’expiration: Si vous activez les notifications d’expiration, indiquez le nombre de jours avant l’expiration. Vous pouvez saisir une valeur comprise entre 1 et 100 jours.
   • Date d’expiration: Définissez la date d’expiration des informations d’identification. Cliquez sur la case pour ouvrir un calendrier et choisir la date.
9. Cliquez sur Suivant.
10. Choisissez le type de fichier que vous souhaitez télécharger :
    
    • Fichiers “plats” séparés par des délimiteurs
    • Fichiers Excel (XLS, XLSX)
    • Fichiers JSON
    • Fichiers WebVTT
11. Selon le type de fichier sélectionné, vous pouvez choisir des paramètres supplémentaires :
    • Fichiers plats séparés par des délimiteurs: Pour les fichiers séparés par des délimiteurs, choisissez l’option suivante :
      
      • Encodage du 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 de clôture: Saisissez le caractère qui entoure la saisie des données. Laissez ce champ vide si l’option Pas d’enceinte est sélectionnée.
      • Pas de clôture: activez cette option si votre fichier ne contient pas de caractères de clôture.
    • JSON: Saisissez le chemin JSON qui contient les données du document que vous souhaitez télécharger vers XM Discover. Laissez ce champ vide si vos documents se trouvent au niveau racine.
      
    • Passez à l’étape suivante pour Excel et WebVTT.
12. Cliquez sur Parcourir et choisissez le chemin du dossier sur votre serveur SFTP qui contient le fichier que vous souhaitez télécharger.
    Astuce : Lorsque vous choisissez un chemin d’accès à un dossier, vous pouvez cliquer sur l’icône d’un dossier pour le développer. Cliquez sur le nom du dossier pour le sélectionner, puis cliquez sur Ok lorsque vous avez terminé.
13. Saisissez l’expression régulière du nom de fichier qui correspond aux fichiers que vous souhaitez télécharger.
14. Si vos fichiers sont compressés, activez l’option Décompresser le(s) fichier(s) et saisissez l’expression régulière Nom du fichier compressé qui correspond aux fichiers à décompresser.
    
15. Si vos fichiers sont décryptés, activez l’option Décrypter le(s) fichier(s) et entrez ce qui suit :
    • Expression régulière du nom de fichier crypté : Saisissez l’expression régulière du nom de fichier pour les fichiers qui doivent être décryptés.
    • Clé PGP/GPG : Entrez la clé PGP/GPG utilisée pour le cryptage.
    • Phrase de passe : Entrez la phrase d’authentification pour le décryptage.
16. Si vos fichiers sont à la fois compressés et cryptés, vous devez choisir ce qui doit se produire en premier :
    • Décompresser puis décrypter: Les fichiers sont décompressés puis décryptés.
    • Décryptage puis décompression: Les fichiers sont décryptés puis décompressés.
17. Choisissez le type de données que vous souhaitez importer :
    
    • Chat: Interactions numériques avec plusieurs lignes de dialogue entre 2 participants ou plus.
    • Appel: Transcriptions d’appels comportant plusieurs lignes de dialogue entre 2 participants ou plus.
    • Retour d’information: Les documents sont présentés sous forme d’objets à une seule rangée ou “plats”.
      Astuce : Selon le type de fichier, certains types de données ne sont pas compatibles. Par exemple, les fichiers WebVTT ne peuvent être utilisés que pour télécharger des transcriptions d’appels.
18. Vous devez fournir un échantillon de fichier, qui peut être enregistré sur votre ordinateur ou sur votre serveur SFTP :
    • Sélectionnez Télécharger l’échantillon à partir du stockage de fichiers si le fichier échantillon est enregistré sur votre serveur SFTP.
    • Sélectionnez Télécharger l’é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 suivant pour télécharger le modèle choisi. Utilisez ce fichier pour ajouter les données que vous souhaitez importer dans XM Discover. Consultez la page d’assistance sur les formats de données XM Discover pour obtenir des informations spécifiques sur le formatage de chaque fichier et type de données.
20. Cliquez sur le bouton Sélectionner un fichier échantillon 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 le contenu d’un fichier brut au lieu de l’aperçu, il se peut qu’il y ait un problème avec les options de format de données que vous avez sélectionnées. Consultez la page Erreurs dans les fichiers échantillonspour obtenir de l’aide sur le dépannage de votre fichier.
22. Cliquez sur Suivant.
23. Si nécessaire, ajustez vos correspondances de données. Consultez la page d’assistance sur le mappage des données pour obtenir des informations détaillées sur le mappage des champs dans XM Discover. La section Mappage des données par défaut contient des informations sur les champs spécifiques à ce connecteur et la section Mappage des champs conversationnels explique comment 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 de données et de rédaction pour masquer les données sensibles ou remplacer automatiquement certains mots et phrases dans les commentaires et interactions des clients. Pour plus d’informations, voir la page d’aide 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 une seule tâche en entrant un nombre dans la case Spécifier la limite d’enregistrements. Saisissez “Tous” si vous souhaitez importer tous les enregistrements.
    Astuce : pour les données conversationnelles, la limite est appliquée en fonction des conversations et non des lignes.
29. Cliquez sur Suivant.
30. Choisissez le moment où vous souhaitez être informé. Pour plus d’informations, voir Notifications d’emploi.
    
31. Cliquez sur Suivant.
32. Choisissez le mode de traitement des documents dupliqués. Pour plus d’informations, voir la rubrique Traitement des dupliqués.
    
33. Choisissez Planifier des exécutions incrémentielles si vous souhaitez que votre travail s’exécute périodiquement selon un calendrier, ou Configurer un tirage unique si vous souhaitez que le travail ne s’exécute qu’une seule fois. Pour plus d’informations, voir Planification des tâches.
34. Choisissez un délai de conservation pour les fichiers traités. Les fichiers sont supprimés après la période définie.
    
35. Cliquez sur Suivant.
36. Évaluateur. Si vous devez modifier un paramètre spécifique, cliquez sur le bouton Modifier pour accéder à cette étape de la configuration du connecteur.
    
37. Cliquez sur Terminer pour enregistrer le travail.

Mappage des données par défaut

Cette section contient des informations sur les champs par défaut des fichiers entrants.

• feedback_type: Identifie les informations en fonction de leur type. Cela est utile pour les rapports 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 “call” pour les transcriptions d’appels, “chat” pour les interactions numériques ou “feedback” pour les retours d’information individuels. Utilisez les transformations personnalisées pour définir une valeur personnalisée, une expression ou une correspondance avec un autre champ.
• valeur_source: 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 de marketing mobile. Par défaut, la valeur de cet attribut est “Fichiers” Utilisez les transformations personnalisées pour définir une valeur personnalisée, une expression ou une correspondance avec un autre champ.
• document_date: Champ de date primaire associé à un document. Cette date est utilisée dans les rapports XM Discover, les tendances, les alertes, etc. Vous pouvez utiliser n’importe quel champ de date de votre ensemble de données pour la date du document. Vous pouvez également fixer une date spécifique pour le document.
• natural_id: Identifiant unique d’un document. Il est fortement recommandé d’avoir un identifiant unique pour chaque document afin de traiter correctement les dupliqués. Pour Natural ID, vous pouvez sélectionner n’importe quel champ textuel ou numérique de vos données. Vous pouvez également générer automatiquement des identifiants en ajoutant un champ personnalisé.
• feedback_provider: Identifie les données obtenues auprès d’un fournisseur spécifique. Pour les téléchargements de fichiers, la valeur de cet attribut est fixée à “Fichiers” et ne peut pas être modifiée.
• job_name: identifie les informations en fonction du nom de la tâche utilisée pour les télécharger. Vous pouvez modifier la valeur de cet attribut pendant la configuration via le champ Nom de champ qui s’affiche en haut de chaque page pendant la configuration.
• loadDate: Indique quand un document a été téléchargé dans XM Discover. Ce champ est défini automatiquement et ne peut pas être modifié.

Mise à jour de la configuration de l’échantillon

Les connecteurs de fichiers entrants ont besoin d’un fichier échantillon pour générer des correspondances de données. Si vous souhaitez modifier les mappages de données après avoir créé un travail, procédez comme suit :

1. Démapper les champs qui ne sont pas présents dans le nouvel échantillon.
2. Mettre à jour la configuration de l’échantillon en téléchargeant un nouveau fichier d’échantillon avec un nouvel ensemble de champs. Les étapes de la mise à jour de la configuration de l’échantillon sont les suivantes.
3. Mettre à jour les mappages de données en fonction du nouveau fichier échantillon.

Mise à jour de l’échantillon de configuration

1. Dans le menu des options du travail, sélectionnez Mettre à jour la configuration de l’échantillon pour un travail sur les fichiers existant.
   
2. Sélectionnez Échantillon pour sélectionner le fichier à télécharger et choisissez votre fichier échantillon enregistré sur votre ordinateur.
   
   Astuce : Si votre fichier contient des champs qui ne figurent pas dans votre cartographie des données, vous recevrez une erreur. Pour résoudre ce problème, modifiez votre cartographie des données de manière à ce qu’elle contienne les mêmes champs que votre fichier échantillon.
3. Vérifiez à nouveau les paramètres de votre fichier. Voir la page Connecteur de fichiers entrants pour plus d’informations sur les paramètres des échantillons de fichiers.
4. Cliquez sur Ok.

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

Les connecteurs de fichiers entrants ont besoin d’un chemin d’accès et d’un masque de fichier (expression régulière de nom de fichier) pour trouver les bons fichiers à importer. Vous pouvez mettre à jour le chemin d’accès et le masque de fichier pour n’importe quel travail de fichier existant.

1. Dans le menu des options de la tâche, sélectionnez Mettre à jour le chemin d’accès et le masque de fichier pour une tâche de fichiers existante.
   
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) correspondant aux fichiers que vous souhaitez importer.
   
6. Cliquez sur Enregistrer.

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

La connexion à un serveur SFTP nécessite une série de handshakes SSH pour coordonner le chiffrement utilisé entre le serveur et l’automate. Pour établir une connexion, le serveur SFTP devra disposer d’au moins un algorithme de chiffrement pour chaque type de chiffrement correspondant à un algorithme de chiffrement pris en charge par les automatismes. Vous trouverez ci-dessous la liste des chiffrements pris en charge par les automates, regroupés par type de chiffrements.

Voici la Liste des codes d’échange de clés pris en charge par les serveurs SFTP de XM Discover :

• diffie-hellman-group14-sha256
• diffie-hellman-group18-sha512
• ecdh-sha2-nistp256
• ecdh-sha2-nistp384
• ecdh-sha2-nistp521
• courbe25519-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