Présentation des formats de découverte des données XM
À propos de XM Discover Data Formats
XM Discover prend en charge 3 formats de données distincts que vous pouvez charger à l’aide de différents types de fichiers.
Les connecteurs suivants prennent en charge le chargement de données via des fichiers :
- Connecteur entrant de chargement de fichier ad hoc
- Connecteur d’entrée de fichiers
- Connecteur d’entrée du lien de découverte XM
Astuce Qualtrics : le connecteur entrant XM Discover Link gère les chargements de données via des appels d’API où les données sont présentées au format JSON.
Feedback individuel
Le format de feedback individuel est utilisé pour les documents qui présentent des données sous la forme d’un objet à une seule ligne ou “plat”. Chaque document peut contenir plusieurs champs textuels, mais ils proviennent généralement d’un seul auteur (par exemple, lorsqu’une enquête contient plusieurs questions ouvertes).
Vous pouvez charger des documents de feedback individuels via :
Interactions numériques
Le format Interactions numériques est utilisé pour les documents qui contiennent des données conversationnelles telles que les discussions en direct.
Les interactions numériques doivent suivre le format conversationnel Qualtrics qui aide le système à comprendre les détails clés tels que les intervenants, les séquences et les événements conversationnels. Un format conversationnel similaire est utilisé pour les transcriptions d’appel.
Vous pouvez télécharger des interactions numériques via :
Transcriptions d’appel
Le format des transcriptions d’appel est utilisé pour les documents qui contiennent des données conversationnelles telles que les appels de support.
Les transcriptions d’appels doivent suivre le format conversationnel Qualtrics qui aide le système à comprendre les détails clés tels que les intervenants, les séquences et les événements conversationnels. Un format conversationnel similaire est utilisé pour les interactions numériques.
Vous pouvez charger des journaux d’appels via :
Erreurs de l’exemple de fichier
Différentes tâches de connecteur vous permettent de charger des fichiers échantillons (tels que les chargements de fichiers ad hoc, les fichiers ou les tâches de lien XM Discover). Si votre exemple de fichier est mal configuré, un message d’erreur s’affiche vous invitant à corriger les éventuels problèmes. Cette section traite des différentes erreurs possibles et de la manière de les corriger.
Erreurs CSV et Excel
Les erreurs suivantes sont possibles pour les fichiers échantillons CSV et Excel (XLS, XLSX) :
- Le fichier doit avoir la propriété obligatoire « REQUIRED_FIELD » : un champ obligatoire est manquant. Consultez la documentation de ce connecteur spécifique pour en savoir plus sur les champs requis pour cette connexion et assurez-vous que le champ répertorié est inclus dans votre fichier échantillon.
- Valeurs de type de participant incohérentes pour l’ID de participant : chaque participant à une conversation ne peut avoir qu’une seule valeur de type de participant définie. Vérifiez votre fichier échantillon pour tous les participants qui ont plusieurs types de participants.
- Le nombre de colonnes ne correspond pas aux en-têtes : chaque colonne doit avoir un en-tête et le nombre de colonnes de chaque ligne doit être égal.
- La ligne ROW_NUMBER de la colonne COLUMN_NAME doit correspondre au format date-heure ISO 8601 AAAA-MM-JJThh:mm:ss.sZ : Pour les dates, utilisez le format ISO 8601 avec une précision de secondes.
Erreurs JSON
Les erreurs suivantes sont possibles pour les fichiers JSON :
- Erreur au niveau de JSON_DATA_PATH : doit être une chaîne au format date-heure ISO 8601 AAAA-MM-JJThh:mm:ss.sZ : Pour les dates, utilisez le format ISO 8601 avec une précision de secondes.
- Erreur au niveau de JSON_DATA_PATH : doit être une chaîne de valeurs AGENT, CLIENT ou TYPE_UNKNOWN : le type de participant au chemin indiqué n’est pas valide. Seules les valeurs suivantes doivent être utilisées :
- AGENT indique un représentant de l’entreprise ou un chatbot.
- CLIENT indique un client.
- TYPE_UNKNOWN indique un participant non identifié.
- Erreur au niveau de JSON_DATA_PATH : doit être DATA_TYPE : le type de données de la valeur du champ est incorrect. Assurez-vous que le type de données correspond à ce qui se trouve dans le mappage de données de votre connecteur.
- Erreur au niveau de JSON_DATA_PATH : doit avoir la propriété REQUIRED_FIELD : un champ obligatoire est manquant. Consultez la documentation de ce connecteur spécifique pour en savoir plus sur les champs requis pour cette connexion et assurez-vous que le champ répertorié est inclus dans votre fichier échantillon.
- Erreur au niveau de JSON_DATA_PATH : le participant avec l’ID de participant est introuvable dans les participants : les ID de participant doivent correspondre à l’un des ID fournis dans la liste de participants. Assurez-vous que l’ID répertorié est inclus dans votre fichier échantillon.