Configurer, modifier ou tester les paramètres d'importation de données avec le gestionnaire de transfert de données
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 les informations RH de votre organisation ou votre système de gestion des 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 :
- Collectez les données que vous souhaitez importer et organisez-les dans des fichiers .csv, .txt ou .xlsx.
- Configurez les paramètres d'importation de données avec le gestionnaire de transfert de données, qui indique à Case IQ comment importer les données.
- Exécutez l'importation de données ou planifiez quand Case IQ doit l'exécuter.
Cet article couvre l'étape 2 de ce processus et explique comment configurer les paramètres d'importation de données pour tout type d'enregistrement, à l'exception des pièces jointes. Pour plus d'informations sur la configuration d'une importation de pièces jointes, consultez la section Importer des pièces jointes en masse. Assurez-vous que votre fichier de données est prêt avant de configurer les paramètres d'importation de données. Consultez la section Préparer un fichier de données pour l'importation pour connaître les exigences de Case IQ en matière de fichiers de données. Si vous avez déjà préparé votre fichier de données et configuré les paramètres d'importation de données, consultez la section Exécuter ou planifier une importation de données pour plus de détails sur l'étape 3 de ce processus.
Dans cet article, nous utilisons plusieurs termes techniques pour expliquer le fonctionnement d'une 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 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. |
Carte | Processus de mise en correspondance des données de votre système source avec votre application Case IQ. Cela indique à Case IQ les champs à renseigner. Par exemple, supposons que vous vous apprêtiez à importer des comptes utilisateurs dans Case IQ et que votre système source comporte un champ intitulé « E-mail de l'employé ». Vous pouvez associer ce champ au champ « E-mail » du profil utilisateur dans Case IQ. Lors de l'importation, le système ajoutera les données du champ « E-mail de l'employé » du système source au champ « E-mail » de 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 source, 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 source. |
Champ cible | Champ de l'entité d'importation vers lequel Case IQ peut migrer les données. Par exemple, si vous migrez des dossiers, vous pouvez sélectionner le champ « Date de soumission » de Case IQ comme champ cible. Cela vous permet de migrer la date et l'heure d'ajout initial du dossier dans votre système source vers Case IQ. |
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 de données (voir l'onglet « Mapper les champs » dans la section « Configurer une importation de données » de cet article). 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 source avec celles des enregistrements de Case IQ. Si une ligne du fichier source et un enregistrement de Case IQ ont le même identifiant unique, Case IQ les considère comme identiques. 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 source. Si un dossier Case IQ porte le même numéro qu'une ligne du fichier source, le système considérera qu'il s'agit du même dossier. |
Configurer une importation de données
Vous pouvez configurer les paramètres d'importation en ajoutant une importation de données dans votre application Case IQ à l'aide du Gestionnaire de transfert de données. Si vous prévoyez d'importer des données dans plusieurs types d'enregistrements, vous devrez ajouter une importation de données distincte pour chaque type d'enregistrement. Par exemple, si vous migrez des données vers des dossiers et des parties, vous devrez configurer une importation de données pour les parties et une autre pour les dossiers.
Dans les paramètres de votre application, accédez à la page Gestionnaire de transfert de données, sous l'onglet Système. Cliquez sur le bouton Ajouter une importation de données sur la page Gestionnaire de transfert de données, ce qui chargera le formulaire « Nouvelle importation de données ».
Le formulaire d'importation de nouvelles données comprend les sections suivantes : Configurer l'importation, Options avancées, Remplacements, Identifier la relation et Mapper les champs. L'option « Identifier la relation » s'applique uniquement à la configuration d'une importation d'e-mails, de notes, de parties, de tâches ou de tout autre type de formulaire personnalisé. Consultez les détails de chaque section dans les onglets ci-dessous.
1. Configurer l'importation
Dans la section « Configurer l'importation », vous pouvez saisir les informations de base concernant l'importation que vous configurez, comme le type d'enregistrement à importer et le format de vos fichiers de données sources. Renseignez les champs suivants :
- Nom : saisissez un nom pour faire référence à l'importation de données.
- Entité d'importation : choisissez l'entité Case IQ, ou le type d'enregistrement, dans lequel vous souhaitez importer des données. Par exemple, pour importer des enregistrements de votre système source vers des profils Case IQ, choisissez « Profil » comme « Entité d'importation ».
- Vous pouvez sélectionner les types d'enregistrement suivants dans lesquels migrer les données : cas, e-mails, fichiers, notes, parties, profils, tâches à effectuer, profils utilisateur et tous les formulaires de données ou formulaires personnalisés dans votre système Case IQ.
- Pour obtenir des informations spécifiques sur l'importation de pièces jointes, reportez-vous à Importer des pièces jointes en masse.
- Format de fichier : sélectionnez le format de votre fichier de données source. Vous pouvez choisir .csv, .txt ou .xlsx.
- Délimiteur : si vous sélectionnez .csv ou .txt comme format de fichier source, choisissez le délimiteur utilisé dans vos fichiers de données. Vous pouvez choisir un format délimité par des virgules ou des barres verticales pour les fichiers .csv ou .txt.
- Méthode de mise à jour : choisissez la méthode d'importation des données dans les enregistrements Case IQ. Le système peut déterminer si votre fichier de données source contient des enregistrements déjà existants dans Case IQ grâce à l'identifiant unique sélectionné dans la section « Mapper les champs » du formulaire « Nouvelle importation de données ». Sélectionnez l'une des options suivantes :
- Remplacer tous les enregistrements existants : le système supprime tous les enregistrements d'entités d'importation actuellement présents dans l'application, puis ajoute tous les enregistrements du fichier de données source à Case IQ. L'option « Remplacer tous les enregistrements existants » n'est disponible que si vous avez sélectionné des profils ou des formulaires de données comme entité d'importation.
- Mise à jour des enregistrements existants et insertion de nouveaux enregistrements : le système met à jour les enregistrements avec un identifiant unique correspondant dans le fichier de données. Il ajoute ensuite un enregistrement pour chaque ligne du fichier de données qui ne possède pas d'identifiant unique correspondant dans Case IQ. Vous pouvez utiliser cette méthode pour mettre à jour ou supprimer des enregistrements en masse. Consultez l'article « Mettre à jour ou supprimer des enregistrements en masse » pour plus de détails.
- Insérer uniquement les nouveaux enregistrements : le système ajoutera un enregistrement pour chaque ligne du fichier source qui ne possède pas d'identifiant unique correspondant dans Case IQ. Il ne mettra à jour aucun enregistrement existant dans Case IQ.
- Destinataires des notifications d'erreur : saisissez une adresse e-mail pour recevoir des notifications lorsque le système traite l'importation des données.
- Recherche d'utilisateur : choisissez comment le système recherchera les utilisateurs dans votre application pour renseigner les champs utilisateur ou multi- utilisateurs. Lors de l' importation de données dans un champ utilisateur ou multi- utilisateurs, le système recherchera un profil utilisateur correspondant dans Case IQ à associer au champ. Par exemple, si vous choisissez « E - mail », le système recherchera un profil utilisateur dans Case IQ ayant une adresse e - mail correspondante.
- Rôle utilisateur par défaut : lorsque vous sélectionnez « Profil utilisateur » comme « Entité d' importation », choisissez le rôle utilisateur que le système doit attribuer aux utilisateurs importés. Vous pouvez mapper le champ « Rôle utilisateur » à un champ source du fichier de données, afin que chaque profil utilisateur ait son rôle correct. Cependant, si un profil utilisateur de votre fichier de données ne possède pas de rôle utilisateur valide, le système lui attribuera le « Rôle utilisateur par défaut » sélectionné.
- Nous vous recommandons de définir le « Rôle utilisateur par défaut » sur un ensemble d' autorisations inférieur, afin de ne pas accorder plus d'autorisations aux utilisateurs que prévu.
Supprimer
2. Options avancées et remplacements
Dans les sections Options avancées et Remplacements, vous pouvez configurer des paramètres supplémentaires pour l'importation de vos données si nécessaire. Le gestionnaire de transfert de données est conçu pour détecter et gérer automatiquement divers formats de données standard. Cependant, s'il ne parvient pas à analyser certaines données, vous pouvez utiliser les options Remplacements pour lui indiquer le format exact à utiliser pour renseigner correctement les données sources dans Case IQ.
Pour afficher ces paramètres supplémentaires, cochez la case « Afficher les options avancées » dans la section « Options avancées ». Les options de remplacement suivantes s'afficheront :
- Remplacement du format de date : nous recommandons d'utiliser cette option uniquement si le format de date de vos données sources n'est pas ISO, c'est-à-dire que vos dates ne sont pas formatées comme : AAAA-MM-JJ. Si vos valeurs de date ne sont pas au format ISO, sélectionnez le format de date utilisé par vos données sources dans l'option « Date format override ». Les dates dans d'autres formats peuvent être ambiguës pour le gestionnaire de transfert de données, qui se référera donc à votre sélection « Format de date prioritaire » pour remplir les données avec précision.
- Si les dates de vos données sources sont au format ISO, le gestionnaire de transfert de données peut automatiquement traiter les dates de vos données sources, de sorte qu'il n'est pas nécessaire d'utiliser l'option « Format de date prioritaire ».
- Dans votre application, les dates seront affichées dans le format de date défini dans les options (voir « Mettre à jour les options de l'application), même si le format de date de vos données source est différent.
- Remplacement de l'encodage : sélectionnez le type d'encodage utilisé par votre fichier de données source. Nous vous recommandons d'utiliser cette option uniquement si le gestionnaire de transfert de données ne peut pas détecter le codage de votre fichier de données source.
- Remplacement du numéro de téléphone : nous vous recommandons d'utiliser cette option uniquement si le format du numéro de téléphone de vos données sources n'est pas pris en charge par le gestionnaire de transfert de données (voir « Préparer un fichier de données pour l'importation : Formats de numéros de téléphone pris en charge »). Pour activer le remplacement du numéro de téléphone, saisissez tous les chiffres de votre numéro de téléphone, y compris l'indicatif pays, en utilisant des caractères « X » comme espaces réservés. N'oubliez pas d'inclure les caractères spéciaux dans le format du numéro de téléphone.
- Par exemple, supposons que les données de votre système source contiennent des numéros de téléphone avec des dièses, des tirets et des crochets, comme « #11(325)-545-7333 ». Vous devez saisir « #XX(XXX)-XXX-XXXX » dans le champ « Remplacement du numéro de téléphone ».
- Remplacement du code pays : si vous utilisez l'option « Remplacement du numéro de téléphone », saisissez le code pays à utiliser pour tous les numéros de téléphone dans vos données sources.
- Par exemple, si vos numéros de téléphone incluent le 11 comme indicatif pays, saisissez « 11 » dans le champ « Indicatif pays de remplacement ». Si des numéros de téléphone de vos données ont un indicatif pays différent de celui défini ici, le système ne pourra pas importer les données de cette ligne et enregistrera une erreur.
Supprimer
3. Identifier la relation
Si vous sélectionnez des e-mails, des notes, des parties, des tâches ou des formulaires personnalisés comme « Entité d'importation », vous pouvez choisir comment le système recherchera le dossier de chaque enregistrement importé dans la section « Identifier la relation ». Cette section ne s'affichera pas si vous configurez une importation de dossiers, de profils ou de profils utilisateur. Si la section « Identifier la relation » est affichée, renseignez les champs suivants dans la grille :
- Source : saisissez un en-tête de colonne de votre fichier de données source que le système doit utiliser pour identifier le cas pour chaque enregistrement importé. Le champ source correspond généralement au numéro d'identification ou au nom du cas dans votre système source ou existant.
- Type d'enregistrement de référence : « Cas » sera le type d'enregistrement de référence par défaut pour les e-mails, les notes, les parties, les tâches à effectuer et les formulaires personnalisés.
- Cible de l'enregistrement de référence : sélectionnez un champ d'observation dans Case IQ correspondant au champ source sélectionné. Lors de l'importation, le système recherchera une correspondance entre le champ cible de l'enregistrement de référence dans Case IQ et le champ source de votre fichier de données source afin de déterminer la casse de chaque enregistrement.
- Nous vous recommandons de sélectionner « N° de dossier », « ID source » ou « ID » comme cible de l'enregistrement de référence, car chaque dossier de votre système possède un numéro de dossier, un ID source ou un ID unique. Ainsi, le système pourra toujours trouver le dossier correspondant aux enregistrements importés.
Supprimer
4. Champs de carte
Enfin, vous pouvez indiquer au système les données à renseigner dans les champs Case IQ. Dans la section « Mapper les champs », ajoutez une ligne pour chaque colonne de votre fichier de données source, puis sélectionnez le champ Case IQ dans lequel le système doit renseigner ces données.
Vous pouvez ajouter des champs dans la colonne source en les générant automatiquement en fonction de votre fichier de données source ou en les remplissant manuellement, les deux étant détaillés dans les sections ci - dessous.
Générer automatiquement les champs de la colonne source
- Cliquez sur le bouton Générer automatiquement la colonne source dans la section Champs de carte.
- Dans la fenêtre contextuelle « Générer automatiquement la colonne source », importez le fichier de données source que vous avez préparé pour cette importation. Assurez-vous qu'il contient tous les en-têtes de colonne des données à importer.
- Une fois votre fichier de données téléchargé, cliquez sur le bouton Générer automatiquement la colonne source dans la fenêtre contextuelle.
- Le système ajoutera une ligne de mappage de champ pour chaque colonne de votre fichier de données source et définira la première colonne du fichier de données comme identifiant unique.
- Dans la colonne Cible, sélectionnez l'un des champs de l'enregistrement dans Case IQ pour chaque ligne de mappage de champ. Vous pouvez sélectionner n'importe quel champ dynamique ou statique de l'enregistrement d'entité d'importation dans Case IQ comme champ cible, comme le champ « Date de soumission ». Vous ne pouvez mapper qu'une seule colonne du fichier de données source à un champ.
- Cochez la case « Obligatoire » pour définir les champs obligatoires d'un enregistrement. Si une ligne du fichier source ne contient pas de valeur pour un champ obligatoire, le système n'ajoutera pas d'enregistrement ni ne mettra à jour un enregistrement existant pour cette ligne lors de l'importation.
Supprimer
Mapper manuellement les champs
- Cliquez sur le bouton Ajouter un mappage de champ.
- Dans la fenêtre contextuelle « Ajouter un nouveau mappage », remplissez les champs suivants :
- Source : saisissez un en-tête de colonne qui se trouve dans votre fichier de données source.
- Cible : recherchez et sélectionnez un champ de l'enregistrement Case IQ dans lequel vous souhaitez importer des données. Vous pouvez sélectionner n'importe quel champ dynamique ou statique de l'enregistrement d'entité d'importation Case IQ comme champ cible, comme le champ « Date de soumission ». Vous ne pouvez associer qu'une seule colonne du fichier de données source à un champ.
- Obligatoire : indiquez si le champ est obligatoire pour un enregistrement. Si une ligne du fichier source ne contient pas de valeur pour un champ que vous avez défini comme obligatoire, le système n'ajoutera pas d'enregistrement ni ne mettra à jour un enregistrement existant pour cette ligne lors de l'importation.
- Une fois que vous avez terminé de remplir la fenêtre contextuelle « Ajouter un nouveau mappage », vous pouvez cliquer sur Enregistrer pour ajouter le mappage ou sur Enregistrer et ajouter un mappage pour mapper rapidement une autre colonne dans votre fichier de données source.
- Si vous configurez une importation de données pour un type d'enregistrement enfant (par exemple, des fêtes, des notes, des tâches à faire, etc.), vous n'avez pas besoin de mapper la colonne source que vous avez sélectionnée dans la section Identifier la relation.
- Une fois les mappages de champs ajoutés, sélectionnez un identifiant unique. Cliquez sur le bouton Options (
) dans la ligne de la grille de mappage de champs que vous souhaitez définir comme identifiant unique. Cliquez ensuite sur l'option « Définir comme identifiant unique ». Vous ne pouvez sélectionner qu'un seul identifiant unique par importation de données.
Supprimer
- Pour supprimer un mappage de champ, cliquez sur le bouton Options de la ligne (
) et sélectionnez l'option « Supprimer ».
- Pour sélectionner un autre champ comme identifiant unique, cliquez sur le bouton Options de la ligne (
) et sélectionnez l'option « Définir comme identifiant unique ». Vous ne pouvez sélectionner qu'un seul identifiant unique pour une importation de données.
- Si vous souhaitez démarrer la cartographie à partir de zéro, cliquez sur le bouton Options (
) pour la grille et sélectionnez l'option « Effacer les mappages de champs ». Cela supprimera toutes les lignes de la grille de mappage de champs.
Après avoir renseigné les sections « Configurer l'importation » et « Mappage des champs », ainsi que les sections « Remplacements » et « Identifier la relation » si nécessaire, cliquez sur le bouton « Enregistrer » du formulaire « Nouvelle importation de données ». Vous avez maintenant terminé la configuration de vos paramètres d'importation de données.
Modifier les paramètres d'une importation de données
Si vous devez mettre à jour les paramètres d'importation de vos données, vous pouvez les modifier à partir de la page d'importation des données :
- Cliquez sur le bouton Modifier.
- La page d'importation des données est désormais en mode édition. Vous pouvez alors mettre à jour les paramètres, les relations et le mappage des champs.
- Une fois vos modifications terminées, cliquez sur le bouton « Enregistrer ». Le système utilisera vos paramètres mis à jour lors de la prochaine importation.
Télécharger un exemple de fichier de données
Après avoir enregistré une importation de données, vous pouvez télécharger un fichier contenant tous les champs sources décrits dans la section « Mappage des champs ». Vous pouvez utiliser l' exemple de fichier d'en-tête comme modèle pour créer vos données ou pour les comparer à un fichier de données déjà préparé. Les fichiers de données que vous téléchargerez ultérieurement sur le serveur SFTP de Case IQ doivent inclure les en - têtes de colonnes de l' exemple de fichier d'en-tête. Pour télécharger des exemples d'en-tête :
- Cliquez sur Options (
) sur la page d'importation de données.
- Sélectionnez l'option « Télécharger des exemples d'en-têtes ».
- Votre navigateur téléchargera le fichier .csv des en-têtes de colonnes.
Valider un fichier de données source
Après avoir configuré les paramètres d'importation de données, vous pouvez vérifier si le fichier de données source préparé est conforme aux paramètres d'importation et si les données peuvent être importées correctement. Le système effectue d'abord une validation générale pour confirmer que le fichier de données source utilise le format et le délimiteur configurés pour l'importation. Une fois les tests initiaux réussis, le système valide les données au niveau des lignes. Pour valider un fichier de données source :
- Cliquez sur Options (
) sur la page d'importation des données.
- Sélectionnez l'option « Valider un fichier de données ».
- Téléchargez le fichier de données source que vous avez préparé pour cette importation dans la fenêtre contextuelle « Valider un fichier de données » de la boîte de dialogue « Télécharger un fichier ». Le système effectuera une validation complète pour confirmer que le fichier de données source :
- Utilise le format de fichier et les délimiteurs que vous avez sélectionnés pour les paramètres d'importation de données.
- Contient les en-têtes de colonnes.
- A un nombre cohérent de délimiteurs pour chaque ligne.
- En cas de problème avec le format du fichier source, le système affichera la première erreur détectée. Vous pouvez corriger l'erreur dans le fichier source et la réimporter dans la fenêtre contextuelle.
- Le système confirmera la validation de haut niveau du fichier source. Cliquez ensuite sur le bouton « Valider les lignes » dans la fenêtre contextuelle. Le système effectuera une validation supplémentaire en arrière-plan pour vérifier que chaque ligne possède un identifiant unique et le type de données correct pour chaque colonne. Vous pouvez quitter la page d'importation des données pendant cette validation.
- Une fois que le système a terminé de valider les données, vous recevrez une notification pour confirmer si le fichier de données source peut être utilisé pour importer des données.
- Si la validation a réussi, vous pouvez cliquer sur le bouton Accéder aux importations de données dans la notification « Validation du fichier de données réussie » pour commencer à importer les données que vous venez de tester.
- Si le système a détecté des erreurs dans le fichier de données source, vous pouvez cliquer sur le bouton Afficher le journal d'intégration dans la notification « Échec de la validation du fichier de données » pour voir les lignes dans lesquelles les erreurs se sont produites.
Supprimer les paramètres d'une importation de données
Si vous devez supprimer définitivement les paramètres d'une importation de données, cliquez sur le bouton Supprimer sur la page correspondante. Si vous avez programmé une importation ultérieure avec les paramètres de cette importation, le système ne pourra pas l'exécuter au moment prévu. Vous pouvez modifier la règle « Planifier le processus » pour modifier l'importation de données (voir les détails dans Exécuter ou planifier une importation de données).