Modèle d’article

A propos des formats de données de feedback individuel

Dans XM Discover, le format de retour individuel est utilisé pour les documents qui présentent les données sous la forme d’une seule rangée, ou d’un objet “plat”. Chaque document peut contenir plusieurs champs verbatim, mais ceux-ci proviennent généralement d’un seul auteur (par exemple, lorsqu’une enquête contient plusieurs questions ouvertes).

En règle générale, un document de retour d’information individuel contient un certain nombre de champs de données structurés et non structurés qui représentent une réponse unique d’un client (par exemple, une réponse à une enquête ou un évaluateur en ligne). Les champs structurés peuvent contenir des dates, des nombres ou des données textuelles avec un haut degré d’organisation (comme des noms d’organisations, de villes ou d’hôtels). Les champs non structurés contiennent des notes, des commentaires ou des réponses à des questions ouvertes.

Vous pouvez télécharger des commentaires individuels dans les formats suivants :

• CSV
• XLS ou XLSX (Microsoft Excel)
• JSON

Formatage CSV et Excel pour un retour d’information individuel

Cette section couvre le formatage des commentaires individuels pour les fichiers CSV et Excel. Le formatage et les exigences pour les deux types de fichiers sont les mêmes.

• Configuration des lignes : Assurez-vous que la première ligne de votre feuille de calcul contient les noms des colonnes. Ces noms seront utilisés comme noms d’attributs et types verbatim. Chaque ligne suivante est traitée comme un document distinct. Vous pouvez avoir un maximum de 100 000 lignes dans un seul fichier.
  Attention : Ne pas inclure de lignes vides entre les entrées.
• Noms de colonnes: Lorsque XM Discover convertit des noms de colonnes en noms d’attributs, il les adapte automatiquement au format pris en charge en supprimant les caractères non pris en charge et en tronquant les noms de colonnes trop longs. Suivez les instructions ci-dessous :
  • Les noms de clés ne doivent contenir que des lettres anglaises (A-Z, a-z), des chiffres (0-9), des traits de soulignement (_), des tirets (-), des crochets [] et des espaces blancs.
  • La longueur idéale d’un nom de clé est de 21 caractères ou moins. Les noms des clés ne doivent pas dépasser 99 caractères, car les noms plus longs seront automatiquement tronqués.
• Limites de taille maximale des fichiers: Les limites suivantes ont été fixées pour la taille des fichiers :
  • Nombre maximum de lignes: 100 000 lignes.
  • Nombre maximal de colonnes: 100 colonnes avec les attributs et 20 colonnes avec les commentaires textuels.
    Astuce : Il s’agit d’une limite souple qui permet de tenir compte de la croissance du projet.
• Longueur maximale des champs: les limites suivantes s’appliquent aux valeurs des champs :
  • Attributs du texte: 900 caractères. Si la valeur dépasse cette limite, elle est automatiquement tronquée.
  • Attributs à valeurs multiples: 4 000 caractères. Si la valeur dépasse cette limite, elle est automatiquement tronquée.
  • Champs Verbatim : 512 000 caractères. Si la valeur dépasse cette limite, l’enregistrement est rejeté.
• Champs obligatoires: Les champs suivants sont recommandés dans votre fichier :
  • Champ de date: La présence d’un champ de date dans vos données est cruciale pour les rapports et les analyses. Le format de date recommandé est YYYY-MM-DDTh:mm:ssZ.
    Astuce : Si votre fichier ne comporte pas de colonne de date, vous pouvez générer des dates en suivant les instructions de la section Définition d’un nom de document spécifique.
  • ID unique: S’il existe une colonne avec des valeurs uniques pour chaque ligne, vous pouvez l’utiliser comme ID naturel pour vos documents. Ce champ est facultatif, mais fortement recommandé car il permet de manager les informations dupliquées.
    Astuce : si votre fichier ne comporte pas de colonne d’identifiants uniques, vous pouvez les générer automatiquement en suivant les instructions de la section Génération automatique d’identifiants naturels.

Formatage JSON pour le retour d’information individuel

Cette section couvre les exigences de formatage JSON pour le retour d’information individuel.

• Noms de clés: Lorsque XM Discover convertit des noms de clés en noms d’attributs et en types verbatim, il les ajuste automatiquement pour qu’ils correspondent au format pris en charge. Les noms des clés doivent respecter ces lignes directrices :
  • Les noms de clés ne doivent contenir que des lettres anglaises (A-Z, a-z), des chiffres (0-9), des traits de soulignement (_), des tirets (-), des crochets [] et des espaces blancs.
  • La longueur idéale d’un nom de clé est de 21 caractères ou moins. Les noms des clés ne doivent pas dépasser 99 caractères, car les noms plus longs seront tronqués.
• Objets: Votre fichier JSON peut contenir un seul ou plusieurs objets.
  Attention : Il y a une limite de 100 000 objets dans un seul fichier JSON.
• Longueur maximale du champ: Les limites de longueur des champs varient selon les attributs :
  • Attributs du texte: Maximum 900 caractères. Si la valeur dépasse la limite, elle est automatiquement tronquée.
  • Attributs à valeurs multiples: Maximum 4 000 caractères. Si la valeur dépasse la limite, elle est automatiquement tronquée.
  • Champs Verbatim: Maximum 512 000 caractères. Si la valeur dépasse la limite, l’enregistrement est rejeté.
• Champs obligatoires: Les champs suivants sont recommandés dans votre fichier :
  • Champ de date: La présence d’un champ de date dans vos données est cruciale pour les rapports et les analyses. Le format de date recommandé est YYYY-MM-DDTh:mm:ssZ.
    Astuce : Si votre fichier ne comporte pas de colonne de date, vous pouvez générer des dates en suivant les instructions de la section Définition d’un nom de document spécifique.
  • ID unique: S’il existe une colonne avec des valeurs uniques pour chaque ligne, vous pouvez l’utiliser comme ID naturel pour vos documents. Ce champ est facultatif, mais fortement recommandé car il permet de manager les informations dupliquées.
    Astuce : si votre fichier ne comporte pas de colonne d’identifiants uniques, vous pouvez les générer automatiquement en suivant les instructions de la section Génération automatique d’identifiants naturels.

Exemple

Vous trouverez ci-dessous un exemple de charge utile JSON pour un retour d’information individuel.

[
{
"ID" : "1001",
"SOURCE" : "HotelSurveys",
"CITY" : "New York City",
"HOTEL" : "Sheraton New York Hotel and Towers",
"AUTHOR" : "Richard",
"ÉVALUATEUR" : "J'ai organisé une réunion ici et j'ai eu une très bonne expérience. Je le recommande vivement.",
"GENDER" : "M",
"NIVEAU DE FIDÉLITÉ" : "Gold",
"AGE" : 51,
"CHECK-IN DATE" : "2019-01-01T12:00:00Z",
"NOTATION" : 9
}
]