Connecteur de sortie de fichiers

À propos du connecteur de sortie Fichiers

Vous pouvez utiliser le connecteur de sortie de fichiers pour extraire des données enrichies de XM Discover à des fins de conformité et de sauvegarde des données, ou pour agir dessus dans des applications externes.

Vous pouvez exporter des données au niveau des phrases et des documents, les limiter aux enregistrements nouveaux et mis à jour et sélectionner les champs, les enrichissements et les classifications à exporter. Le connecteur de sortie de fichiers enregistre les données sur un serveur SFTP (Secure File Transfer Protocol).

AVANT DE COMMENCER

Avant de configurer un job à l’aide du connecteur de sortie de fichiers, assurez-vous d’avoir :

• Nom d’utilisateur et mot de passe de votre compte SFTP.
• Une clé PGP/GPG si vous souhaitez chiffrer les fichiers fournis par XM Discover.

Les formats de fichier pris en charge sont les suivants :

• Fichiers texte délimités (CSV).
• Fichiers JavaScript Object Notation (JSON).

CONFIGURATION DE LA CONNEXION

1. Connectez-vous aux connecteurs.
2. Cliquez sur le bouton Nouvelle tâche dans le coin supérieur droit des Tâches.
   
3. Sur la page Connecteurs, accédez aux SOURCES SORTIES.
   
4. Cliquez sur Fichiers sortants.

Configuration d’une tâche de connecteur de sortie de fichiers

Après avoir configuré la connexion, suivez les étapes ci-dessous pour configurer un job :

• Étape 1 : indiquez le nom du job
• Étape 2 : Spécifier le projet et la description
• Étape 3 : Fournissez des identifiants pour un dossier SFTP Qualtrics
• Étape 4 : configurer les identifiants d’exportation XM Discover
• Étape 5 : configuration de requête
• Étape 6 : fournir la configuration des fichiers
• Étape 7 : mappez les champs souhaités à Qualtrics
• Étape 9 : Spécifier le filtre (facultatif) et la limite d’enregistrements
• Étape 10 : configuration des notifications (facultatif)
• Étape 11 : configurer des options supplémentaires pour le poste
• Étape 12 : confirmer tous les paramètres de la tâche

Astuce Qualtrics : cliquez sur les boutons Précédent et Suivant pour naviguer entre les pages, ou utilisez les touches fléchées : GAUCHE pour revenir en arrière, DROITE pour continuer. Si vous souhaitez annuler la configuration, cliquez sur le bouton Annuler.

Étape 1 : indiquez le nom du job

1. Saisissez un nom de tâche reconnaissable dans la zone Nom du job en haut à gauche de la page.
   
   Astuce Qualtrics : vous pouvez modifier le nom de la tâche lors de la configuration via le champ Nom de la tâche qui est affiché en haut de chaque page lors de la configuration.
2. Cliquez sur Suivant.

Étape 2 : Spécifier le projet et la description

1. Sur la page Spécifier un projet et une description, sélectionnez un projet à partir duquel extraire les données du menu déroulant des projets.
   
   Astuce Qualtrics : le projet doit correspondre à celui identifié par la clé de l’API d’exportation. En cas d’incohérence, le job utilisera le projet identifié par la clé API.
   Astuce Qualtrics : vous avez la possibilité de saisir une note sur le poste dans la zone Description du poste. La description du job que vous saisissez dans la zone Description du job est accessible uniquement dans la liste Connecteurs et n’est pas exportée dans le cadre des données d’un job.
2. Cliquez sur Suivant.

Étape 3 : Fournissez des identifiants pour un compte SFTP Qualtrics

1. Sur la page Fournir des identifiants pour un dossier SFTP Qualtrics, vous pouvez sélectionner un ensemble d’identifiants existant dans le menu déroulant ou ajouter un nouvel ensemble d’identifiants. Consultez la section Ajout de nouveaux identifiants SFTP pour plus d’informations sur l’ajout d’un nouvel ensemble d’identifiants.
   
2. Cliquez sur Suivant.

Étape 4 : configurer les identifiants d’exportation XM Discover

1. Sur la page Configurer les identifiants d’exportation Discover XM, indiquez l’URL de service XM Discover Export API pertinente pour votre région (sans le type de point de terminaison) dans la zone HOST.
   
   Astuce Qualtrics : pour plus d’informations, voir Points de terminaison de l’API d’exportation v2.
2. Cliquez sur Suivant.

Étape 5 : configuration de requête

Sur la page Configuration de la requête, vous pouvez spécifier le niveau d’exportation des données de XM Discover et sélectionner les enregistrements à extraire.

1. Sélectionnez l’une des options suivantes dans le menu déroulant Sélectionner le niveau de données pour sélectionner le niveau de granularité des données associé aux données sortantes :
   
   • Phrases : utilisez l’exportation au niveau des phrases pour obtenir des informations plus granulaires et des enrichissements au niveau des phrases tels que les sujets, le sentiment, les scores d’effort, etc.
   • Documents : utilisez l’exportation au niveau du document lorsque vous souhaitez exporter des valeurs pour des attributs structurés liés à un document entier.
     Attention : lors de l’utilisation d’enrichissements au niveau des phrases, définissez le niveau de données sur phrases.
   • Pour plus d’informations sur les enrichissements disponibles pour chaque niveau, voir Attributs prêts à l’emploi.
2. Indiquez une requête pour filtrer les données sortantes dans la zone Saisir la requête(facultatif).
   Astuce Qualtrics : utilisez la même syntaxe que celle utilisée pour rechercher des données dans Designer. Pour en savoir plus sur les requêtes de recherche prises en charge, voir Requêtes de recherche.
   Exemple : vous pouvez spécifier un ou plusieurs ID d’enquête pour mettre à jour uniquement les enregistrements d’enquête sélectionnés à l’aide de la syntaxe suivante : surveyid:sv_01.
3. Indiquez le nom du filtre de votre projet à appliquer aux données sortantes dans la zone Saisir le nom du filtre(facultatif).
4. Sous Choisir les enregistrements que vous souhaitez récupérer, sélectionnez les enregistrements à extraire :
   • Charger de nouveaux enregistrements (par défaut). Extrayez uniquement les enregistrements qui ont été créés depuis la dernière exécution du job sortant.
   • Charger les enregistrements nouveaux et mis à jour. Extrayez les enregistrements qui ont été créés ou mis à jour depuis la dernière exécution du job sortant.
   • Charger les enregistrements mis à jour. Extrayez uniquement les enregistrements qui ont été mis à jour depuis la dernière exécution du job sortant.
     Astuce Qualtrics : Les tâches de connecteur sortant de fichiers définies sur Charger les enregistrements nouveaux et mis à jour ou Charger les enregistrements mis à jour peuvent uniquement être planifiées pour s’exécuter à une fréquence hebdomadaire ou mensuelle.
     Attention : la catégorisation en cours d’exécution ou de nouvelle relance met à jour un enregistrement dans le système XM Discover.
5. Vous pouvez définir les données de classification à inclure dans les données sortantes (facultatif). Cochez la case Tous les modèles pour inclure les données de classification pour tous les modèles disponibles dans le projet. Ne cochez pas la case Tous les modèles si vous souhaitez uniquement inclure les modèles sélectionnés. Si l’option Tous les modèles n’est pas sélectionnée, vous pouvez sélectionner des modèles spécifiques à inclure dans les données sortantes dans le menu déroulant.
   
6. Sélectionnez l’une des options suivantes dans le menu déroulant Filtres résultats en appliquant des règles de modèle :
   • Ignorer : aucun filtrage n’est appliqué en fonction du ou des modèles sélectionnés.
   • Actuellement classifié : retourne les phrases/documents qui ont été classifiés par le(s) modèle(s) sélectionné(s) lors de l’exécution de classification la plus récente.
   • Ever Classified: Retourne les phrases/documents qui ont été classifiés par le(s) modèle(s) sélectionné(s) à tout moment.
7. Cochez la case Retourner les ID de catégorie (vrai) au lieu des noms de catégories (faux) pour utiliser les ID de catégorie au lieu des noms de catégories (facultatif).
8. Sélectionnez les résultats Filtres en appliquant une requête de filtre avec tous les chemins des nœuds feuille pour ajouter plusieurs modèles avec le paramètre “Indicateur de feuille uniquement” à l’appel de l’API d’exportation (facultatif).
9. Cliquez sur Suivant.

Étape 6 : fournir la configuration des fichiers

Sur la page Fournir la configuration des fichiers, sélectionnez le type de fichier à utiliser pour l’exportation de données, puis, en fonction du type de fichier sélectionné, pointez vers l’emplacement où les fichiers doivent être enregistrés et indiquez d’autres paramètres.

1. Dans la section Configuration de fichiers, sélectionnez le type de fichier parmi les deux options suivantes :
   
   • Fichiers texte délimités (CSV) : sélectionnez cette option pour exporter des données à l’aide de fichiers texte délimités (CSV).
   • Fichiers JavaScript Object Notation (JSON) : sélectionnez cette option pour exporter des données à l’aide de fichiers JavaScript Object Notation (JSON).
2. Si vous sélectionnez Fichiers texte délimités (CSV), appliquez les options pour ce type de fichier.
   • Codage de fichiers : Sélectionnez le système de codage à utiliser dans le fichier.
   • Caractère de délimitation : spécifiez le caractère pour délimiter les saisies de données dans le fichier. Un seul caractère. Si vous utilisez un fichier CSV, votre séparateur est une virgule.
   • Caractère d’emballage : Spécifiez le caractère à inclure dans chaque champ de données du fichier. Un seul caractère.
   • Aucun emballage : cochez cette case si les caractères d’emballage sont facultatifs.
3. Cliquez sur Parcourir dans la section Emplacement des fichiers pour pointer vers le dossier dans lequel les fichiers doivent être stockés sur le serveur SFTP.
4. Dans la fenêtre Choisir l’emplacement des fichiers, sélectionnez le dossier dans lequel les fichiers doivent être stockés.
   
   Astuce Qualtrics : cliquez sur le nom du dossier pour le sélectionner, puis cliquez sur l’icône du dossier pour l’ouvrir.
5. Une fois que le dossier dans lequel les fichiers sont stockés est sélectionné, cliquez sur OK.
6. Dans la section Conventions d’appellation, vous pouvez sélectionner les options suivantes :
   
   • Indiquez un nom de fichier pour le préfixe : sélectionnez cette option pour fournir un préfixe à ajouter au nom de fichier généré. Utilisez cette option pour appliquer des conventions d’appellation personnalisées afin de mieux comprendre quels fichiers correspondent à un job ou à une exécution de job particulier.
     Astuce Qualtrics : la valeur ne peut pas contenir [ ] \ / et ne doit pas comporter plus de 100 caractères.
   • Indiquez un nom de fichier pour le suffixe : sélectionnez cette option pour fournir un suffixe à ajouter au nom de fichier généré. Utilisez cette option pour appliquer des conventions d’appellation personnalisées afin de mieux comprendre quels fichiers correspondent à un job ou à une exécution de job particulier.
     Astuce Qualtrics : la valeur ne peut pas contenir [ ] \ / et ne doit pas comporter plus de 100 caractères.
7. Vous pouvez chiffrer les fichiers fournis par XM Discover et fournir une clé PGP/GPG pour le chiffrement dans la boîte à clés PGP/GPG(facultatif). Cochez la case Chiffrer les fichiers fournis par XM Discover pour vous assurer que les données seront transférées en toute sécurité à partir de XM Discover et fournissez une clé PGP/GPG pour le chiffrement. Vous pouvez également décocher la case Chiffrer les fichiers fournis par XM Discover si aucun chiffrement n’est nécessaire.
8. Cliquez sur Suivant.

Étape 7 : Mapper les champs souhaités dans les fichiers

Sur la page Mapper les champs souhaités dans les fichiers, vous pouvez sélectionner les attributs et les résultats de classification XM Discover à inclure dans l’exportation.

1. Cliquez dans la zone personnalisée vide et sélectionnez le champ XM Discover que vous souhaitez inclure dans l’exportation.
2. Sélectionnez le format dans lequel exporter les données dans le menu déroulant Type de données.
3. Saisissez le nom du champ à utiliser dans le fichier exporté dans la zone Nom d’attribut.
4. Cliquez sur l’icône plus (+ ) pour ajouter d’autres champs personnalisés et les mapper aux champs du fichier exporté, si nécessaire.
5. Cliquez sur Suivant.

Étape 8 : Spécifier le filtre (facultatif) et la limite d’enregistrements

1. Sur la page Spécifier un filtre, vous pouvez définir une condition de filtre pour qu’une tâche n’exporte que les enregistrements qui la satisfont (facultatif).
   
   Astuce Qualtrics : pour plus d’informations sur l’application d’un filtre, voir Filtre de connecteur.
2. Vous pouvez spécifier une limite d’enregistrements dans la zone Spécifier une limite d’enregistrements. Vous pouvez également laisser la limite d’enregistrements par défaut Tout si vous voulez que tous les enregistrements soient exportés en un seul push.
   Astuce Qualtrics : la limite d’enregistrements est une limite par exécution de la tâche. Si vous la définissez sur 1 000, le job s’exécutera selon la planification que vous avez définie et s’arrêtera après l’exportation de 1 000 enregistrements. Si vous la définissez sur quotidienne, cela signifie qu’elle s’exécutera une fois par jour et que vous obtiendrez jusqu’à 1 000 enregistrements exportés par jour.
   Astuce Qualtrics : pour les données conversationnelles, la limite est appliquée en fonction des conversations plutôt que des lignes.
3. Cliquez sur Suivant.

Étape 9 : configuration des notifications (facultatif)

1. Sur la page Configuration des notifications, vous pouvez sélectionner les notifications que les observateurs d’une tâche doivent recevoir si l’un des événements répertoriés ci-dessous se produit.
   • Aucun enregistrement n’est exporté.
   • Des valeurs manquantes consécutives ont été trouvées.
   • L’exécution d’un job échoue.
   • L’exécution d’un job est partiellement réussie.
   • Un job se termine par un délai d’expiration.
   • Un job échoue.
     Astuce Qualtrics : vous pouvez sélectionner n’importe quelle combinaison de notifications ou décider de ne pas sélectionner de notifications. Dans ce cas, les veilles d’un job ne reçoivent aucune notification. Pour plus d’informations sur les options de configuration des notifications, voir Notifications de jobs.
     Astuce Qualtrics : le délai d’expiration par défaut pour les tâches de connecteur de sortie de fichiers est de 48 heures.
2. Cliquez sur Suivant.

Étape 10 : Configurer des options supplémentaires pour le job

1. Sur la page Configurer des options supplémentaires pour la tâche, dans la section Planifier un travail historique/incrémentiel, sélectionnez l’une des options suivantes :
   • Planifier des exécutions incrémentielles pour configurer une planification pour les exportations de données incrémentielles.
     Astuce Qualtrics : Les tâches de connecteur sortant de fichiers définies sur Charger les enregistrements nouveaux et mis à jour ou Charger les enregistrements mis à jour peuvent uniquement être planifiées pour s’exécuter à une fréquence hebdomadaire ou mensuelle.
     Astuce Qualtrics : utilisez l’option Créer une tâche mais ne pas extraire de données si vous souhaitez valider la tâche et ses paramètres avant l’exportation des données. Pour plus d’informations sur la planification d’exécutions incrémentielles, voir Planification de jobs.
   • Configurez une extraction unique pour effectuer une exportation de données uniques.
     Astuce Qualtrics : vous pouvez modifier les paramètres de planification ultérieurement. Veuillez consulter Récupération des données pour les exécutions uniques et Planification des tâches pour les exécutions régulières.
2. Dans la section Données incrémentielles supplémentaires, vous pouvez indiquer la quantité de données supplémentaires (en jours ou en heures) à extraire lors d’une exécution incrémentielle pour vous assurer que toutes les données historiques pertinentes sont disponibles pour le transfert sortant (facultatif).
   Astuce Qualtrics : la valeur maximale de ce champ est de 30 jours.
3. Cliquez sur Suivant.

Étape 11 : confirmer tous les paramètres de la tâche

1. Sur la page Confirmer tous les paramètres de la tâche, vous pouvez afficher un récapitulatif de tous les paramètres d’une tâche et modifier les paramètres, si nécessaire, avant d’exécuter l’exportation de données. Pour exécuter l’exportation de données, cliquez sur le bouton Terminer lorsque vous êtes prêt à exécuter l’exportation de données. Un message de confirmation s’affiche pour confirmer que la tâche a été correctement envoyée.
2. Lorsque vous cliquez sur Terminer, les opérations suivantes se produisent : les exportations uniques sont exécutées immédiatement. À moins que vous n’ayez activé l’option “Créer un job mais ne pas extraire de données”, les exportations planifiées sont exécutées immédiatement, puis définies pour s’exécuter en fonction de la planification que vous avez définie.

Pour plus d’informations sur le suivi des jobs, voir Synthèse des pages de jobs.

Ajout de nouveaux identifiants SFTP

1. Sélectionnez Ajouter nouveau.
2. Saisissez le nom du nouvel ensemble d’identifiants dans la zone NOM DE LA CONNEXION.
   
3. Saisissez le nom d’utilisateur SFTP dans la zone SFTP USERNAME.
4. Saisissez le mot de passe SFTP dans la zone MOT DE PASSE SFTP.
5. Saisissez l’adresse du serveur SFTP dans la zone SFTP HOST.
6. Saisissez le port SFTP dans la zone PORT SFTP.
   Astuce Qualtrics : le port par défaut est 22.
7. Vous pouvez définir vos identifiants pour qu’ils expirent après un certain temps (facultatif). Pour définir une date d’expiration pour cet ensemble d’identifiants et définir un rappel pour tous les observateurs de tâches, cochez la case Envoyer des notifications d’expiration. Cela active la zone Jours avant expiration.
8. Saisissez une valeur dans la zone Jours avant l’expiration pour définir combien de jours avant l’expiration les notifications doivent commencer. Les valeurs possibles vont de 1 à 100 jours.
   Astuce Qualtrics : ce rappel se déclenche chaque fois que la tâche s’exécute une fois que la date d’expiration est inférieure au nombre de jours défini dans la zone Jours avant l’expiration.
9. Sélectionnez la date d’expiration dans le sélecteur de date du calendrier. La date d’expiration sera alors ajoutée à la zone Date d’expiration.

&nbsp ;