Connecteur entrant de chargement de fichier ad hoc

À propos du connecteur de chargement de fichier ad hoc

Vous pouvez utiliser le connecteur d’entrée de chargement de fichier ad hoc pour charger les données client à partir d’un seul fichier en utilisant un des formats pris en charge (feuille de calcul Excel, fichier plat, JSON ou WebVTT) dans XM Discover.

Chargement des données dans XM Discover

Avant de commencer

Avant de configurer un job à l’aide du connecteur d’entrée de chargement de fichier ad hoc, assurez-vous que les données client pertinentes sont préparées dans l’un des formats de fichier pris en charge suivants :

• Fichiers texte délimités (CSV)
• Fichiers Microsoft Excel (XLS, XLSX)
• Fichiers JavaScript Object Notation (JSON)
• Fichiers VTT (Web Video Text Track)

Pour en savoir plus sur les exigences de mise en forme des données pour les combinaisons de fichiers et de formats de données, voir Présentation des formats de données XM Discover.

Configuration de la connexion

1. Connectez-vous aux connecteurs.
2. Cliquez sur le bouton Nouvelle tâche dans le coin supérieur droit de la page Tâches.
   
3. Sur la page Connecteurs, accédez à la section SELECT A SOURCE.
   
4. Cliquez sur le bouton Chargement de fichier ad hoc.

Création d’une tâche de connecteur de chargement de fichier ad hoc

Après avoir configuré la connexion, suivez ces étapes pour créer une tâche de connecteur entrant de chargement de fichier ad hoc et configurer les données envoyées à XM Discover :

• Étape 1 : indiquez le nom du job
• Étape 2 : Spécifier le projet et la description
• Étape 3: Sélectionner un fichier
• Étape 4 : Mapper les champs de données souhaités dans XM Discover
• Étape 5 : Remplacement et reproduction des données (facultatif)
• Étape 6 : Spécifier le filtre et la limite d’enregistrements
• Étape 7 : notification et configuration (facultatif)
• Étape 8 : configurer des options supplémentaires pour le poste
• Étape 9 : 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, DROIT d’aller ensuite. Si vous souhaitez annuler la configuration, cliquez sur le bouton Annuler.

Étape 1 : indiquez le nom du job

Saisissez un nom de tâche reconnaissable dans la zone Nom du job en haut à gauche de la page.

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

1. Sur la page Spécifier le projet et la description, sélectionnez le projet dans lequel les données doivent être chargées dans le menu déroulant des projets.
   

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 chargée dans le cadre des données d’un job.

2. Cliquez sur Suivant.

Étape 3 : Sélectionner un fichier

1. Sur la page Sélectionner un fichier, cochez l’une des cases suivantes pour sélectionner le type de fichier contenant les données à charger :

• Fichiers texte délimités (CSV)
• Fichiers Microsoft Excel (XLS, XLSX)
• Fichiers JavaScript Object Notation (JSON)
• Fichiers VTT (Web Video Text Track)
  

2. Appliquez les options pour le type de fichier sélectionné :

• Fichiers texte délimité (CSV) : Pour plus d’informations, voir le Options des fichiers texte délimités (CSV) .
• Fichiers Microsoft Excel (XLS, XLSX) : Pour plus d’informations, voir le Options des fichiers Microsoft Excel .
• Fichiers JavaScript Object Notation (JSON) : Pour en savoir plus, voir le Options des fichiers JavaScript Object Notation (JSON) .
• Fichiers VTT (Web Video Text Track) : Pour plus d’informations, voir le Options des fichiers VTT (Web Video Text Track) .
  

3. Cliquez sur le bouton Cliquer pour sélectionner un fichier à charger et pointez vers le fichier de données ou déposez-le dans la zone de dessin grise.
   
4. Attendez que le système charge le fichier et affiche un aperçu.
   
   Astuce Qualtrics : si vous voyez un message d’erreur et le contenu des fichiers bruts au lieu de l’aperçu, il peut y avoir un problème avec les options de fichier que vous avez sélectionnées. Pour plus d’informations sur les messages d’erreur en cas d’échec de validation des fichiers échantillons chargés via le connecteur de chargement de fichiers ad hoc, voir Exemples d’erreurs de fichiers.
5. Assurez-vous que les données sont correctes.
6. Cliquez sur Suivant.
   

Étape 4 : Mapper les champs souhaités dans XM Discover

1. Sur la page Mapper les champs souhaités dans XM Discover, sélectionnez l’onglet MAPPAGE DE SOURCE pour connecter les champs de données source aux champs de données de votre projet XM Discover.
   
2. Dans la section Mappage source par défaut, configurez les champs de données par défaut que tous les documents de XM Discover partagent. Pour plus d’informations sur le mappage de source par défaut, voir le Mappage source par défaut .
   
3. Dans la section Mappage source, configurez les champs de données supplémentaires du fichier.  Pour plus d’informations sur la configuration des zones de données conversationnelles, voir le Champs de données conversationnelles .
   
   Astuce Qualtrics : pour plus d’informations sur le mappage des données, consultez la section Configurer le mappage des données.
4. Cliquez sur Suivant.

Étape 5 : substitution et édition des données (facultatif)

1. Sur la page Remplacement et édition des données, vous pouvez fournir des règles de remplacement et de rédaction pour masquer les données sensibles ou remplacer automatiquement certains mots et phrases types dans le feedback et les interactions des clients.
   
   Astuce Qualtrics : Pour en savoir plus sur la substitution et la rédaction des données, consultez Remplacement et rédaction des données.
2. Cliquez sur Suivant.

Étape 6 : Spécifier le filtre et la limite d’enregistrements

1. Sur la page Spécifier un filtre, vous pouvez définir une condition de filtre pour un job afin de charger uniquement les enregistrements qui le satisfont (facultatif).
   
   Astuce Qualtrics : pour en savoir plus sur l’application d’un filtre, consultez 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 renvoyé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 avoir extrait 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 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 7 : configuration des notifications (facultatif)

1. Sur la page Configuration des notifications, vous pouvez sélectionner les notifications que les observateurs d’un job doivent recevoir si l’un des événements répertoriés ci-dessous se produit.

• Envoyer une notification lorsque zéro enregistrement est chargé dans le projet.
• Envoyer une notification lorsque des valeurs consécutives manquantes ont été trouvées.
• Envoyer une notification en cas d’échec de l’exécution du job.
• Envoyer une notification lorsque l’exécution du job réussit partiellement.
• Envoyer une notification lorsque le job se termine avec un délai d’expiration.
• Contactez le support en cas d’échec de cette tâche.
  
  Astuce Qualtrics : vous pouvez sélectionner n’importe quelle combinaison de notifications ou décider de ne choisir aucune notification. Dans ce cas, les veilles d’un job ne reçoivent aucune notification.
  Astuce Qualtrics : pour plus d’informations sur les paramètres de configuration des notifications, voir Notifications de tâches.

2. Cliquez sur Suivant.

Étape 8 : configurer des options supplémentaires pour le poste

1. Sur la page Configurer des options supplémentaires pour le job, dans la section Gestion des documents nouveaux et existants, sélectionnez la manière dont le système doit gérer les documents en double en cochant l’une des cases suivantes dans la section Gestion des documents nouveaux et existants :

• Rejeter les doublons pour les documents existants et créer de nouveaux enregistrements pour les nouveaux documents.
• Mettre à jour les attributs structurés pour les documents existants et créer de nouveaux enregistrements pour les nouveaux documents.
• Mettre à jour les attributs structurés pour les documents existants et ne pas créer d’enregistrements pour les nouveaux documents.
  
  Attention : chaque document doit avoir un ID naturel unique afin que le système puisse traiter les documents en double ayant des ID naturels identiques.
  Astuce Qualtrics : Pour plus d’informations sur les modes de détection des doublons, consultez Détection des doublons.

2. Cliquez sur Suivant.

Étape 9 : 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 le chargement des données.
   
2. Pour exécuter le chargement des données, cliquez sur le bouton Terminer lorsque vous êtes prêt à exécuter le chargement des données. Un message de confirmation s’affiche pour confirmer que la tâche a été correctement envoyée. Lorsque vous cliquez sur Terminer, les événements suivants se produisent :

• Les tirages uniques sont exécutés immédiatement.
• À moins que vous n’ayez activé l’option “Créer un job mais ne pas extraire de données”, les extractions 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.
  Attention : les jobs de chargement de fichier ad hoc ne s’exécutent qu’une seule fois et ne peuvent pas être planifiés.

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

Options des fichiers texte délimités (CSV)

Vous pouvez appliquer les options de paramètres pour les fichiers texte délimités (CSV) sur la page Sélectionner un fichier.

1. Sélectionnez le système de codage utilisé dans le fichier dans le menu.
   
2. Saisissez le caractère utilisé pour délimiter les entrées de données dans le fichier dans la zone Caractère de délimitation.
   
   Astuce Qualtrics : saisissez 1 seul caractère.
   Astuce Qualtrics : le séparateur par défaut est une virgule qui peut être utilisée pour les fichiers CSV.
3. Saisissez le caractère utilisé pour encadrer chaque champ de données du fichier dans la zone Caractère d’emballage.
   Astuce Qualtrics : saisissez 2 caractères uniquement.
   Astuce Qualtrics : cochez la case Caractère d’emballage si les caractères d’emballage sont facultatifs.
4. Sélectionnez le format de données :

• Discussion en direct : sélectionnez cette option pour charger des interactions numériques avec plusieurs lignes de dialogue entre deux participants ou plus.
• Appel : sélectionnez cette option pour charger les transcriptions d’appel avec plusieurs lignes de dialogue entre deux participants ou plus.
• Feedback : sélectionnez cette option pour charger des documents présentés sous forme d’objets à une seule ligne ou “plats”.
  

5. Les interactions numériques et les transcriptions d’appels doivent respecter un format prédéfini. Selon le format de données sélectionné, vous pouvez cliquer sur le lien ici pour télécharger l’un des modèles suivants avec des exemples de données après avoir sélectionné le format de données :

• Modèle de discussion en direct pour les interactions numériques : il s’agit d’un exemple de modèle de fichier CSV avec le minimum de zones requises/conventions d’appellation pour l’intégration de données en tant qu’interaction numérique. Vous pouvez utiliser ce modèle pour identifier comment mapper vos types de zones de fichier délimités existants dans ces exigences. Si vous le souhaitez, vous pouvez ajouter des zones supplémentaires que vous souhaitez inclure dans le fichier chargé dans le cadre de votre analyse. Pour plus d’informations, voir Interactions numériques au format CSV.
• Modèle d’appel pour les transcriptions d’appel : il s’agit d’un exemple de modèle de fichier CSV avec le minimum de champs requis/conventions d’appellation pour ingérer des données en tant qu’appel audio. Vous pouvez utiliser ce modèle pour identifier comment mapper vos types de zones de fichier délimités existants dans ces exigences. Si vous le souhaitez, vous pouvez ajouter des zones supplémentaires que vous souhaitez inclure dans le fichier chargé dans le cadre de votre analyse. Pour plus d’informations, voir Transcriptions d’appel au format CSV.
• Modèle de feedback pour toutes les données non conversationnelles. Pour plus d’informations, voir Feedback individuel au format CSV.

Options des fichiers Microsoft Excel

Vous pouvez appliquer les options des paramètres pour les fichiers Microsoft Excel sur la page Sélectionner un fichier.

1. Sélectionnez le format de données :

• Discussion en direct : sélectionnez cette option pour charger des interactions numériques avec plusieurs lignes de dialogue entre 2 participants ou plus.
• Appel : sélectionnez cette option pour charger les transcriptions d’appel avec plusieurs lignes de dialogue entre 2 participants ou plus.
• Feedback : sélectionnez cette option pour charger des documents présentés sous forme d’objets à une seule ligne ou “plats”.
  

2. Les interactions numériques et les transcriptions d’appels doivent respecter un format prédéfini. Selon le format de données sélectionné, vous pouvez cliquer sur le lien ici pour télécharger l’un des modèles suivants avec des exemples de données après avoir sélectionné le format de données :

• Modèle de discussion en direct pour les interactions numériques : il s’agit d’un exemple de modèle de fichier Excel avec le minimum de zones requises et les conventions d’appellation pour l’intégration de données en tant qu’interaction numérique. Vous pouvez utiliser ce modèle pour identifier comment mapper vos types de champs de fichier Excel existants à ces exigences. Si vous le souhaitez, vous pouvez ajouter des zones supplémentaires que vous souhaitez inclure dans le fichier chargé dans le cadre de votre analyse. Pour plus d’informations, voir Interactions numériques au format Excel.
• Modèle d’appel pour les transcriptions d’appel : il s’agit d’un exemple de modèle de fichier Excel avec le minimum de champs requis et les conventions d’appellation pour l’ingestion de données en tant qu’appel audio. Vous pouvez utiliser ce modèle pour identifier comment mapper vos types de champs Excel existants à ces exigences. Si vous le souhaitez, vous pouvez ajouter des zones supplémentaires que vous souhaitez inclure dans le fichier chargé dans le cadre de votre analyse. Pour plus d’informations, voir Transcriptions d’appel au format Excel.
• Modèle de feedback pour toutes les données non conversationnelles. Pour plus d’informations, voir Feedback individuel au format Excel.

Options des fichiers JavaScript Object Notation (JSON)

Vous pouvez appliquer les paramètres pour les fichiers JavaScript Object Notation (JSON) sur la page Sélectionner un fichier.

1. Si votre fichier JSON contient les données de document XM Discover appropriées dans un tableau spécifique du fichier JSON, saisissez le nom du tableau dans lequel ces données sont contenues dans la zone Chemin d’accès JSON.
   
   Astuce Qualtrics : laissez cette zone vide si vos documents se trouvent au niveau du nœud racine.
2. Sélectionnez le format de données :

• Discussion en direct : sélectionnez cette option pour charger des interactions numériques avec plusieurs lignes de dialogue entre 2 participants ou plus.
• Appel : sélectionnez cette option pour charger les transcriptions d’appel avec plusieurs lignes de dialogue entre 2 participants ou plus.
• Feedback : sélectionnez cette option pour charger des documents présentés sous forme d’objets à une seule ligne ou “plats”.
  

3. Sélectionnez le type de modèle dans le menu Modèle.
   
4. Les interactions numériques et les transcriptions d’appels doivent respecter un format prédéfini. Selon le type de modèle sélectionné, vous pouvez cliquer sur le lien ici pour télécharger l’un des modèles suivants avec des exemples de données :

• Modèle de discussion en direct pour les interactions numériques : il s’agit d’un exemple de modèle de fichier JSON avec le minimum de zones requises et les conventions d’appellation pour l’intégration de données en tant qu’interaction numérique. Vous pouvez utiliser ce modèle pour identifier comment mapper vos types de champs de fichier JSON existants à ces exigences. Si vous le souhaitez, vous pouvez ajouter des zones supplémentaires que vous souhaitez inclure dans le fichier chargé dans le cadre de votre analyse. Pour plus d’informations, voir Interactions numériques au format JSON.
• Modèle de chat Amazon Connect : Vous pouvez utiliser ce modèle si vous prévoyez de charger un fichier JSON à partir de la plateforme de chat Amazon Connect.
• Modèle d’appel pour les transcriptions d’appel : il s’agit d’un exemple de modèle de fichier JSON avec le minimum de champs requis et les conventions d’appellation pour l’ingestion de données en tant qu’appel audio. Vous pouvez utiliser ce modèle pour identifier comment mapper vos types de champs JSON existants à ces exigences. Si vous le souhaitez, vous pouvez ajouter des zones supplémentaires que vous souhaitez inclure dans le fichier chargé dans le cadre de votre analyse. Pour plus d’informations, voir Transcriptions d’appel au format JSON.
• Modèle d’appel Verint : Vous pouvez sélectionner ce modèle si vous prévoyez de charger une transcription audio à partir de la plateforme Verint.
• Modèle d’appel VTT CB : vous pouvez sélectionner ce modèle si vous prévoyez de charger une transcription audio à partir de XM Discover.
• Modèle de feedback pour toutes les données non conversationnelles. Pour plus d’informations, voir Feedback individuel au format JSON.
• Modèle de feedback Dynamics 365 : Vous pouvez sélectionner ce modèle si vous prévoyez de télécharger un fichier à partir de la plateforme Microsoft Dynamics 365.
  

Options des fichiers VTT (Web Video Text Track)

L’appel est le seul format de données disponible pour les fichiers VTT (Web Video Text Track). Cliquez sur le lien ici sur la page Sélectionner un fichier pour télécharger un modèle WebVTT (Zoom) avec des exemples de données.

Il s’agit d’un modèle de fichier WebVTT avec le minimum de zones requises et les conventions d’appellation pour l’intégration de données. Vous pouvez utiliser ce modèle pour identifier comment mapper vos types de zones de fichier WebVTT existants dans ces besoins. Si vous le souhaitez, vous pouvez ajouter des zones supplémentaires que vous souhaitez inclure dans le fichier chargé dans le cadre de votre analyse. Pour plus d’informations, voir Appeler les transcriptions au format WebVTT.

Mappage source par défaut

Il s’agit des zones de données par défaut pour le connecteur d’entrée de fichiers ad hoc :

1. feedback-type vous aide à identifier les données en fonction de leur type. Cela est utile pour le reporting 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 pour appeler les transcriptions d’appel, la discussion en direct pour les interactions numériques ou le feedback pour un feedback individuel. Utilisez la transformation personnalisée pour définir une valeur personnalisée, définir une expression ou la mapper à un champ donné.
   
2. source vous aide à identifier 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 marketing mobile. Par défaut, la valeur de cet attribut est définie sur Chargement de fichier ad hoc. Utilisez la transformation personnalisée pour définir une valeur personnalisée, définir une expression ou la mapper à un champ donné.
3. document_date est le champ de date principal associé à un document. Cette date est utilisée dans les rapports XM Discover, les tendances, les alertes, etc. Pour Date du document, vous pouvez sélectionner n’importe quelle zone de date à partir de vos données dans la colonne Nom de zone.
   
   Vous pouvez également définir une date spécifique en ajoutant une zone personnalisée.
   
   Pour plus d’informations, voir Définition d’une date de document spécifique pour plus de détails.
4. natural_id sert d’identifiant unique d’un document. Il est fortement recommandé d’avoir un ID unique pour chaque document afin de traiter correctement les doublons. Pour ID naturel, vous pouvez sélectionner n’importe quelle zone de texte ou numérique dans vos données dans la colonne Nom de zone.
   
   Vous pouvez également générer automatiquement des ID en ajoutant une zone personnalisée. Pour plus d’informations, voir Génération automatique d’ID naturels.
5. feedback_provider vous aide à identifier les données obtenues auprès d’un fournisseur spécifique. Pour les chargements de fichiers, la valeur de cet attribut est définie sur Chargement de fichier ad hoc.
6. job_name vous aide à identifier les données en fonction du nom du job utilisé pour le charger. Vous pouvez modifier la valeur de cet attribut lors de la configuration via le champ Nom du job qui est affiché en haut de chaque page lors de la configuration.
7. loadDate indique quand un document a été téléchargé dans XM Discover. Cette zone est définie automatiquement.
   Astuce Qualtrics : pour plus d’informations sur le mappage des données, consultez la section Configurer le mappage des données.

Champs de données conversationnelles

Dans la section Mappage source, vous pouvez configurer les zones de données conversationnelles suivantes.

1. richVerbatim : Pour les données conversationnelles (telles que les interactions d’appel et de chat), XM Discover utilise un format verbatim conversationnel pour le champ richVerbatim. Ce format prend en charge l’ingestion des métadonnées spécifiques au dialogue requises pour débloquer la visualisation conversationnelle (tours de haut-parleur, silence, événements conversationnels, etc.) et les enrichissements (heure de début, durée, etc.). Ce champ verbatim inclut des champs « enfant » pour suivre le côté client et représentatif de la conversation :

• clientVerbatim
• agentVerbatim
• inconnu
  
  
  Astuce Qualtrics : les transformations ne sont pas prises en charge pour les champs verbatim conversationnels.
  Astuce Qualtrics : le même mot ne peut pas être utilisé pour différents types de données conversationnelles. Si vous souhaitez que votre projet héberge plusieurs types de conversation, utilisez des paires séparées de verbatims conversationnels par type de conversation.

2. clientVerbatim (pour les données conversationnelles) : Suit le côté client de la conversation dans les interactions d’appel et de chat. Par défaut, ce champ est mappé sur :

• clientVerbatimChat pour les interactions numériques
• clientVerbatimAppeler des interactions d’appel
  Astuce Qualtrics : vous pouvez mapper ce champ à un autre champ verbatim si nécessaire.

3. agentVerbatim (pour les données conversationnelles) : suit le côté du représentant (agent) de la conversation dans les interactions d’appel et de discussion en direct. Par défaut, ce champ est mappé sur :

• agentVerbatimChat pour les interactions numériques
• agentVerbatimAppeler des interactions d’appel
  Astuce Qualtrics : vous pouvez mapper ce champ à un autre champ verbatim si nécessaire.

4. inconnu (pour les données conversationnelles) : suit le côté inconnu de la conversation dans les interactions d’appel et de discussion en direct. Par défaut, ce champ est mappé sur :

• unknownVerbatimChat pour les interactions numériques
• unknownVerbatimCall for call interactions
  Astuce Qualtrics : vous pouvez mapper ce champ à un autre champ verbatim si nécessaire.