Base de connaissances de Case IQ

Comment pouvons-nous aider ?

Préparer un fichier de données pour l'importation

Fonctionnalité Premium de Data Transfer Manager
Contactez votre responsable de la réussite client ou votre responsable de compte pour en savoir plus sur cette fonctionnalité.

Vous pouvez utiliser le Gestionnaire de transfert de données pour importer des données d'un autre système dans votre application Case IQ via une intégration SFTP (Secure File Transfer Protocol). Cela vous permet d'alimenter efficacement les enregistrements Case IQ avec des données provenant d'un système externe, comme le système d'information des ressources humaines de votre organisation ou un système de gestion de dossiers existant. Vous pouvez migrer des données vers des dossiers, des e-mails, des fichiers, des notes, des parties, des profils, des tâches à effectuer, des profils utilisateur et tout formulaire de données ou formulaire personnalisé de votre application Case IQ.

Le transfert de données vers Case IQ implique les étapes suivantes :

  1. Collectez les données que vous souhaitez importer et organisez-les dans des fichiers .csv, .txt ou .xlsx.
  2. Configuration des paramètres d'importation de données avec le gestionnaire de transfert de données, qui indique Case IQ comment importer les données.
  3. Exécution de l'importation de données ou planification du moment où Case IQ doit l'exécuter.

Cet article couvre l'étape 1 de ce processus en expliquant comment formater et structurer vos données sources et vos fichiers de données. Si vous vous préparez à importer des pièces jointes, consultez plutôt l'article « Importer des pièces jointes en masse », car le processus est légèrement différent. Si vous avez déjà préparé vos fichiers de données, consultez les sections « Configurer, modifier ou tester les paramètres d'importation de données avec le Gestionnaire de transfert de données » et « Exécuter ou planifier une importation de données » pour les étapes 2 et 3 respectivement.

1) Un exemple de fichier de données. 2) Une importation de données dans Case IQ. 3) La fenêtre contextuelle Importer des données dans Case IQ.

Dans cet article, nous utilisons plusieurs termes techniques pour expliquer le fonctionnement de l'importation de données. Consultez le glossaire des termes importants ci-dessous :

Terme Définition
Fichier de données source Un fichier .csv, .txt ou .xlsx contenant les données que vous souhaitez importer dans Case IQ. En général, votre organisation exporte ces données sous forme de fichier depuis votre système source.
Paramètres d'importation de données Les paramètres que vous configurez dans le gestionnaire de transfert de données de Case IQ pour indiquer Case IQ comment importer des données à partir de votre système source.
Importer une entité ou un type d'enregistrement Un type d'enregistrement dans votre application Case IQ, par exemple des cas, des e-mails, des fichiers, des notes, des parties, des profils, des tâches à effectuer, des utilisateurs et tous les formulaires de données ou formulaires personnalisés configurés dans votre système Case IQ.
Protocole de transfert de fichiers sécurisé (SFTP) Une méthode sécurisée de transfert de fichiers d’un système à un autre.
Système source L'application contenant les données que vous souhaitez intégrer à votre système Case IQ. Par exemple, les informations relatives aux ressources humaines, la gestion des tickets, la gestion de la relation client ou le système de gestion des dossiers de votre organisation.
Champ source Une colonne de votre fichier de données, qui reflète un champ de votre système source. Par exemple, si votre système source possède un champ « Service », vous pouvez migrer les données qu'il contient en ajoutant une colonne « Service » à votre fichier de données.
Identifiant unique Un champ source qui identifie chaque enregistrement dans votre système source et dans Case IQ, comme une adresse e-mail ou un numéro d'identification. Vous choisissez l'identifiant unique lors de la configuration des paramètres d'importation des données. Chaque enregistrement doit avoir une valeur différente dans le champ d'identifiant unique.
Lors de l'importation de données, le système compare les valeurs d'identifiant unique de chaque ligne du fichier de données avec celles des enregistrements de Case IQ. Si une ligne du fichier de données et un enregistrement de Case IQ ont le même identifiant unique, Case IQ les considère comme un seul et même enregistrement.
Par exemple, si vous choisissez « Numéro de dossier » comme identifiant unique pour l'importation de données de dossier, le système examinera tous les numéros de dossier Case IQ afin de déterminer si certains correspondent à ceux du fichier de données. Si un dossier Case IQ porte le même numéro qu'une ligne du fichier de données, le système considérera qu'il s'agit du même dossier.

Liste de contrôle des exigences relatives aux fichiers de données

Bien que cet article détaille toutes nos exigences en matière de fichiers de données, nous avons également créé cette liste de contrôle rapide à titre de référence. Cette liste est également disponible au format .xlsx, ce qui vous permet de vérifier les exigences au fur et à mesure. À l'étape 2 du transfert de données, vous pouvez également valider votre fichier de données dans Case IQ lors de la configuration de vos paramètres d'importation afin de vérifier si le gestionnaire de transfert de données peut importer vos données sources.

Liste de contrôle des fichiers de données.xlsx

Liste de contrôle des exigences relatives aux fichiers de données Section pour les détails et les exemples
Format .csv, .txt ou .xlsx. Format du fichier de données
Le nom du fichier commence par un préfixe unique en minuscules. Aucun espace ni caractère spécial.
Maximum 500 000 lignes.
Maximum 200 Mo.
1 ligne/enregistrement. Structure du fichier de données
1 colonne/champ.
Pour .csv ou .txt : 1 type d'enregistrement/fichier de données.
Pour .xlsx : 1 type d'enregistrement/feuille de calcul.
Pour le fichier de données de cas : 1 colonne/champ de flux de travail.
Pour le fichier de données de profil utilisateur : colonne utilisateur SSO, le cas échéant.
Aucune rangée vide dispersée.
Guillemets doubles (") autour des valeurs de texte avec des virgules (,). Format de chaîne de texte
Guillemets doubles (") autour des données du tableau.
Virgules (,), nouvelles lignes (\n) ou tabulations (\t) séparant les éléments dans les tableaux.
Recommandé pour les fichiers de données de courrier électronique : pas de code HTML complexe dans le corps du courrier électronique.
Les dates sont présentées dans un format cohérent et en texte brut. Format de date
Toutes les données correspondent au format et aux exigences des données de terrain Case IQ. Faire correspondre les données au type de champ

Format du fichier de données source

Assurez-vous que les fichiers de données sources que vous souhaitez importer dans Case IQ répondent aux exigences de format suivantes :

Exigences relatives au format du fichier de données source
Format de fichier .csv, .txt ou .xlsx
Nom de fichier

[préfixe de nom de fichier unique]_{arbitraryId}, par exemple employees_Jan2025.csv

  • Le « préfixe de nom de fichier unique » doit être unique pour l'importation de données. Autrement dit, les autres importations de données que vous avez configurées ne peuvent pas avoir le même préfixe. Par exemple, si vous avez configuré des paramètres pour deux importations de données de profil différentes, utilisez un préfixe différent pour leurs fichiers de données respectifs.
  • N'incluez pas d'espaces ni de caractères spéciaux et assurez-vous que tous les caractères sont en minuscules.
  • Le texte suivant le trait de soulignement (_) ne sera pas utilisé pour identifier les fichiers de données, vous pouvez donc y saisir n'importe quel caractère de texte.
  • Lorsque vous planifiez l'exécution de l'importation de données, vous entrez le préfixe de nom de fichier unique pour votre fichier de données, afin que Case IQ puisse trouver le fichier correct sur notre serveur SFTP pour l'importation (voir l'article Exécuter ou planifier une importation de données : Planifier une importation de données récurrente).
Nombre maximal d'enregistrements par importation 500 000. Cela signifie que votre fichier de données peut contenir un maximum de 500 000 lignes.
Taille maximale du fichier 200 Mo

Structure du fichier de données source

Case IQ peut lire des données structurées de manière spécifique dans des fichiers .csv, .txt ou .xlsx. Organisez les données de vos fichiers selon la structure suivante :

Exigences relatives à la structure du fichier de données source
1 fichier de données source/importation Incluez toutes les données d'une importation dans un seul fichier. Pour une importation récurrente, vous pouvez télécharger un nouveau fichier de données sur le serveur SFTP de Case IQ pour chaque importation planifiée.
1 ligne/enregistrement Assurez-vous que les données de chaque enregistrement sont contenues sur une seule ligne du fichier de données. Par exemple, les images ci-dessous présentent un exemple de fichier de données pour les parties. Les données de chaque partie sont contenues sur une seule ligne de ce fichier.
1 colonne/champ Assurez-vous que chaque champ possède sa propre colonne. Dans les images ci-dessous, la colonne « Prénom » contient le prénom de chaque enregistrement.
Pour le fichier de données de cas :
1 colonne/champ de flux de travail
Si vous préparez un fichier de données pour des dossiers, créez une colonne distincte pour chaque champ de workflow à définir. Par exemple, supposons que votre application comporte trois workflows, appelés « Enquête RH », « Enquête de sécurité » et « Enquête sur fraude », et que vous souhaitiez définir un statut pour chacun d'eux via l'importation. Votre fichier de données doit contenir les trois colonnes suivantes : « État de l'enquête RH », « État de l'enquête de sécurité » et « État de l'enquête sur fraude ».
Colonne d'identifiant unique Inclure une colonne pour un identifiant unique, tel qu'une adresse e-mail ou un numéro d'identification. Chaque enregistrement doit avoir une valeur différente dans le champ d'identifiant unique, afin que Case IQ puisse utiliser chaque valeur d'identifiant unique pour retrouver les enregistrements déjà ajoutés au système. Si une ligne du fichier de données et un enregistrement Case IQ ont le même identifiant unique, Case IQ les considérera comme un seul et même enregistrement.
Pour les fichiers de données de courrier électronique, de notes, de fêtes, de tâches ou de formulaires personnalisés :
Colonne cible de l'enregistrement de référence
Si vous préparez un fichier de données pour des e-mails, des notes, des réunions, des tâches ou des formulaires personnalisés, assurez-vous qu'il contient une colonne indiquant Case IQ à quel dossier le système doit ajouter chaque enregistrement. Lors de la configuration des paramètres d'importation de données, vous pouvez associer cette colonne à un champ Case IQ. Nous recommandons généralement d'utiliser le numéro d'identification ou le nom du dossier dans votre système source. Dans les images ci-dessous, il s'agit de la colonne « Legacy Case Number ».
Pour le fichier de données de profil utilisateur :
Colonne utilisateur SSO
Si vous vous préparez à importer des utilisateurs dans Case IQ et que votre application intègre l'authentification unique (SSO), le système peut les définir automatiquement comme utilisateurs SSO lors de l'importation. Dans votre fichier de données source, vous pouvez ajouter une colonne intitulée « Utilisateur SSO ». Pour chaque utilisateur que vous souhaitez définir comme utilisateur SSO, saisissez « vrai », « oui » ou « 1 » dans la ligne correspondante de la colonne « Utilisateur SSO ».
Pour configurer SSO pour votre application, consultez Configurer l'authentification unique (SSO).
Pour .csv ou .txt :
1 type d'enregistrement/fichier de données.
Si vous utilisez des fichiers de données au format .csv ou .txt, assurez-vous que chaque fichier ne contienne que les données d'un seul type d'enregistrement. Si vous prévoyez de migrer plusieurs types d'enregistrements vers Case IQ, créez un fichier de données pour chaque type d'enregistrement. Par exemple, si vous migrez des données vers des dossiers et des parties, vous aurez besoin d'un fichier de données pour les parties et d'un autre fichier de données distinct pour les dossiers.
Exemple de fichier de données au format CSV.
Pour .xlsx :
1 type d'enregistrement/feuille de calcul.

Si vous utilisez le format .xlsx pour votre fichier de données, assurez-vous que chaque feuille de calcul du fichier .xlsx ne contient que les données d'un seul type d'enregistrement. Nommez chaque feuille de calcul par type d'enregistrement. Par exemple, si vous migrez des données vers des dossiers et des parties, organisez toutes les données des dossiers dans une feuille de calcul et celles des parties dans une autre.

Le système ne peut importer les données que d'une seule feuille de calcul à la fois dans le fichier. Lors d'une importation, le système recherche une feuille de calcul dont le nom inclut l'entité d'importation des données. Par exemple, si vous importez des cas, il recherchera une feuille de calcul nommée « cas ». Si Case IQ ne trouve pas une telle feuille de calcul, il importera la première feuille du fichier .xlsx.

Exemple de fichier de données au format XLSX.

Aucune rangée vide dispersée. Supprimez les lignes vides dispersées dans votre fichier de données, car elles peuvent entraîner des erreurs lors de l'importation. En revanche, les lignes vides à la fin d'un ensemble de données ne provoquent pas d'erreurs.
Comparaison d'un fichier de données avec des lignes dispersées et sans.

Format de chaîne de texte

Vos données de chaîne de texte, telles que les descriptions ou le contenu du corps des e-mails, peuvent contenir des caractères ambigus pour Case IQ. En ajoutant des guillemets doubles (") autour du texte contenant ces caractères, le système peut renseigner correctement vos données dans les champs Case IQ.

Format de chaîne de texte
Guillemets doubles (") autour des valeurs de texte avec des virgules (,). Ajoutez des guillemets doubles (") autour des valeurs de texte avec des virgules (,), par exemple « John, un témoin, a parlé au sujet de l'incident ».
Guillemets doubles (") autour des données du tableau. Ajoutez des guillemets doubles (") autour des données du tableau. Pour séparer chaque élément, utilisez l'un des délimiteurs suivants : virgule (,), retour à la ligne (\n) ou tabulation (\t). Par exemple, une liste d'adresses e-mail avec retour à la ligne ressemblerait à ceci :
"maria@email.com
rashid@email.com
john@email.com"
Virgules (,), nouvelles lignes (\n) ou tabulations (\t) séparant les éléments dans les tableaux. Aucun autre caractère spécial ne nécessite de guillemets doubles, tels que les apostrophes (' et "), les esperluettes (&), les tirets (-), les signes dièse (#) et les barres obliques (/ et \).
Recommandé pour le fichier de données de courrier électronique :
Pas de code HTML complexe dans le corps de l'e-mail.
Vous pouvez inclure une mise en forme HTML de base pour le contenu des e-mails que vous souhaitez migrer vers Case IQ. Cela inclut les en-têtes, les tableaux de base, les caractères gras, l'italique et les listes à puces. Un code HTML plus complexe peut ne pas s'afficher correctement lors de la visualisation des e-mails migrés dans Case IQ.

Format de date

Les dates des fichiers .csv sont stockées au format texte brut. Cependant, les tableurs comme Microsoft Excel ou Google Sheets peuvent reformater automatiquement les valeurs de date en fonction de vos paramètres régionaux. Si vous ouvrez vos fichiers de données sources dans ces applications avant de les importer, les dates risquent de ne pas s'afficher au bon format. Vous pouvez suivre les étapes ci-dessous pour empêcher ce reformatage automatique.

Decision Tree
Quelle application utilisez-vous pour modifier votre fichier de données source ?
  • Microsoft Excel
  • Google Sheets
  • Text Editor (Notepad++ etc.)
  • Add Button
  1. Ouvrez le fichier de données .csv dans Microsoft Excel.
  2. Sélectionnez une colonne de date dans votre fichier de données.
  3. Faites un clic droit (sur le système d'exploitation Windows) ou cliquez en maintenant la touche Commande enfoncée (sur Mac OS), puis sélectionnez « Formater les cellules ».
  4. Dans Catégorie, cliquez sur « Personnalisé ».
  5. Sélectionnez le format de date souhaité dans la liste. Nous recommandons « aaaa-jj-mm ».
  6. Cliquez sur OK .
  7. Répétez les étapes 2 à 6 pour toutes les autres colonnes de date de votre fichier de données.
  8. Enregistrez le fichier de données au format .csv.

Ne rouvrez pas votre fichier dans Excel avant de l'importer, car Excel risque de reformater vos dates.

Fenêtre contextuelle Format de cellule dans Microsoft Excel.

  1. Téléchargez votre fichier de données .csv dans votre Google Drive.
  2. Ouvrez le fichier de données dans Google Sheets.
  3. Sélectionnez une colonne de date dans votre fichier de données.
  4. Dans la barre supérieure, cliquez sur « Format » > « Nombre » > « Format de date et d'heure personnalisé ».
  5. Sélectionnez le format de date souhaité dans la liste ou le menu déroulant. Nous recommandons « aaaa-jj-mm ».
  6. Cliquez sur Appliquer .
  7. Répétez les étapes 3 à 6 pour toutes les autres colonnes de date de votre fichier de données.
  8. Dans la barre supérieure, cliquez sur « Fichier » > « Télécharger » > « Valeurs séparées par des virgules (.csv) ».

Ne rouvrez pas votre fichier dans Sheets avant de l'importer, car Sheets peut reformater vos dates.

Formats de date et d'heure personnalisés dans Google Sheets.

  1. Ouvrez votre fichier de données .csv dans Notepad++ ou tout autre éditeur de texte.
  2. Vérifiez et ajustez manuellement les dates au format AAAA-JJ-MM.
  3. Enregistrez le fichier sous « UTF-8 CSV ».

Format du numéro de téléphone

Le gestionnaire de transfert de données prend en charge divers formats de numéros de téléphone standard, qu'il détecte automatiquement dans votre fichier de données source et importe dans Case IQ. Consultez le tableau des formats de numéros de téléphone pris en charge par Case IQ pour connaître tous les formats de numéros de téléphone acceptés. Les numéros de téléphone de votre fichier de données source doivent inclure un indicatif pays.

Si vos données sources utilisent un format de numéro de téléphone non pris en charge, vous pouvez toujours les migrer vers Case IQ. Lors de la configuration de vos paramètres d'importation de données, vous pouvez définir manuellement le format de numéro de téléphone utilisé par vos données dans la section « Remplacements ».

Formats de numéros de téléphone pris en charge

Format du numéro de téléphone Exemples
[indicatif pays] XXXXXXXXXX +11234567890
11234567890
1 1234567890
[code pays] XXX-XXX-XXXX +1 123-456-7890
1123-456-7890
1 123-456-7890
[code pays] XXX XXX XXXX +1 123 456 7890
1123 456 7890
1 123 456 7890
[code pays] (XXX) XXX-XXXX +1 (123) 456-7890
1(123) 456-7890
1 (123) 456-7890

Faire correspondre les données au type de champ

Dans Case IQ chaque type de champ n'accepte que certains types de données. Par exemple, les zones de texte, les zones de texte et les listes déroulantes peuvent contenir des chaînes de texte, comme des noms et des descriptions. Si vous importez du texte dans un champ de type entier, nombre ou devise, il risque de ne pas s'afficher correctement dans Case IQ. De même, si vous importez des données numériques dans une zone de texte, une zone de texte ou une liste déroulante, Case IQ les traitera comme du texte ; vous ne pourrez donc pas les utiliser pour effectuer des calculs dans l'application.

Lors de la préparation de votre fichier de données sources, réfléchissez à l'utilisation que votre organisation compte faire des données que vous souhaitez importer. Pour ce faire :

  1. Planifiez les champs Case IQ dans lesquels vous souhaitez importer des données. Vous pouvez ajouter des champs aux types d'enregistrement si nécessaire. Consultez les sections « Modifier un type d'enregistrement standard » et « Ajouter et modifier un type de formulaire personnalisé » pour plus de détails.
  2. Vérifiez le type de chaque champ. Vous pouvez vérifier le type d'un champ dans le dictionnaire de données, sous l'onglet Système des Paramètres. Consultez la procédure détaillée dans l'article « Générer un fichier de dictionnaire de données ». Nous avons également répertorié les types de champs pour les champs de profil standard dans la section « Types de champs de profil statique » de cet article.
  3. Recherchez chaque type de champ dans le tableau ci-dessous, Formats et exigences des types de champs.
  4. Confirmez que les données de votre système source répondent aux exigences détaillées dans le tableau Formats et exigences des types de champs.

Formats et exigences des types de champs

Type de champ Format et exigences des données Exemple
Case à cocher Booléen. Vrai
FAUX
Date Format AAAA-MM-JJ. Doit être conforme à la norme ISO 8601 (voir Format de date et d'heure ISO 8601). 31/12/2023
E-mail Utilisez le format suivant : partie-locale@domaine. Conforme aux normes RFC 6854 (voir la mise à jour du format des messages Internet pour autoriser la syntaxe de groupe dans les champs d'en-tête « De : » et « Expéditeur : »). Tous les caractères seront convertis en minuscules lors de l'importation. jane.doe@exemple.com
Entier 15 chiffres maximum. 123456789123456
Argent Maximum de 9 chiffres initiaux et 2 chiffres décimaux. 123456789.12
Nombre Maximum de 9 chiffres initiaux et 6 chiffres décimaux. 123456789.123456
Liste de sélection Chaque option peut contenir 255 caractères UTF-8 maximum. Discrimination (âge, handicap, sexe, état civil, statut militaire, origine nationale, grossesse, race, religion, orientation sexuelle), harcèlement, abus de drogues/d'alcool, environnement de travail hostile, risques environnementaux ou conditions/processus de travail dangereux
Code Postal Format de code postal américain ou canadien, selon la configuration de votre application.

États-Unis : 12345

Canada : A1A 1A1

Zone de texte 10 000 caractères UTF-8 maximum.
Éditeur de texte 10 000 caractères UTF-8 maximum, compatible avec le formatage HTML5. HTML exclu de la limite de caractères. <ol><li>Examinez les détails pertinents de l'affaire.</li><li>Confirmez le rôle du témoin et son importance pour l'affaire.</li><li>Obtenez toutes les informations contextuelles disponibles sur le témoin.</li><li>Examinez les déclarations ou témoignages antérieurs qu'il a pu donner.</li><li>Rédigez une liste de questions ouvertes pour obtenir des réponses détaillées.</li><li>Incluez des questions qui clarifient les incohérences ou les points obscurs.</li><li>Anticipez le point de vue du témoin et ses éventuels préjugés.</li><li>Préparez des questions susceptibles de révéler des préjugés personnels ou situationnels.</li><li>...</li></ol>
Zone de texte 255 caractères UTF-8 maximum. Voir l'exemple de liste de sélection.
Temps Affichage 24 heures. Conforme à la norme ISO 8601. 23:59:59
Basculer Booléen.

Vrai

FAUX

URL 255 caractères UTF-8 maximum. https://caseiq.app/note/d3ea373c-1968-40f4-…a369-517b48d5cbba/edit
Numéro de téléphone 15 chiffres maximum au format E.164.

+447911123456, où :

  • Indicatif du pays : +44
  • Code national de destination : 7911
  • Numéro d'abonné : 123456

Types de champs de profil statique

Champ Type de champ
Prénom Zone de texte
Nom de famille Zone de texte
Initiale du milieu Zone de texte
Date de naissance Date
Adresse Zone de texte
Ville Zone de texte
État / Province Liste de sélection
Pays Liste de sélection
Code postal Zone de texte
Numéro de téléphone à domicile Numéro de téléphone
Numéro de téléphone professionnel Numéro de téléphone
Adresse email E-mail
Date de soumission Date