Importation en masse

Un guide complet sur l'utilisation de la fonctionnalité d'importation en masse dans Care

Aperçu

L'outil d'importation de cas dans CS Care est une fonctionnalité sophistiquée qui permet aux administrateurs d'importer en masse des données de cas depuis des fichiers CSV dans le système. Il utilise une interface d'assistant en plusieurs étapes pour guider les utilisateurs lors du téléchargement, du mappage, de la configuration et de l'importation des données de cas avec une validation et une gestion des erreurs étendues.

🎯 Objectif et cas d'utilisation

L'outil d'importation de cas est conçu pour :

• Migration initiale des données depuis des systèmes hérités vers CS Care

• Création en masse de cas à partir de sources de données externes

• Synchronisation périodique des données avec des systèmes partenaires

• Mise à jour des cas existants avec de nouvelles informations

📋 Flux de travail étape par étape

Le processus d'importation suit un assistant en 4 étapes:

Étape 1 : Télécharger le CSV 📤

Ce qui se passe :

• L'utilisateur sélectionne et télécharge un fichier CSV

• Le système analyse le CSV et extrait les en-têtes

• Les données CSV sont chargées en mémoire pour prévisualisation

Détails techniques :

• Le fichier est analysé en utilisant la csv-parse bibliothèque

• Le système supprime le BOM (Byte Order Mark) si présent

• Tous les en-têtes CSV deviennent disponibles pour le mappage

Bonnes pratiques :

• Assurez-vous que le CSV est correctement formaté avec des en-têtes sur la première ligne

• Utilisez l'encodage UTF-8

• Supprimez tout caractère spécial susceptible de provoquer des problèmes d'analyse

Étape 2 : Mapper les champs du questionnaire 🗺️

Besoin de savoir quels champs peuvent être importés ? Consultez Champs autorisés

Ceci est la étape la plus critique où vous mappez les colonnes CSV aux champs du formulaire de cas.

Fonctionnalités clés :

A. Interface à deux onglets :

• Onglet questionnaire démographique: Mapper les champs d'informations personnelles

• Onglet questionnaire d'admission: Mapper les champs d'admission spécifiques au cas

B. Mappage automatique des champs : Le système effectue un mappage intelligent des champs basé sur :

• Correspondances exactes de noms d'en-tête avec les chemins ou libellés des champs

• Reconnaissance de motifs de valeurs pour les champs de sélection/liste déroulante

• Utilise la normalisation pour faire correspondre des noms similaires (insensible à la casse, supprime les espaces/caractères spéciaux)

C. Options de mappage des champs :

Pour chaque colonne CSV, vous pouvez configurer :

1. Champs texte simples :

   • Mappage direct : csvField → formField

2. Champs de sélection/liste déroulante :

   • Mappages d'options: Mapper plusieurs valeurs CSV à une seule option déroulante

   • Option de repli: Choisir que faire des valeurs non mappées

     • __KEEP_ORIGINAL__: Conserver la valeur CSV d'origine

     • Ou sélectionner une option déroulante spécifique comme valeur par défaut

3. Champs de date :

   • Spécifier le format de date pour un parsing correct

   • Formats pris en charge : MM/JJ/AAAA, AAAA-MM-JJ, etc.

Fonction de recherche :

• Recherche en temps réel pour filtrer les en-têtes CSV

• Facilite la recherche de champs spécifiques dans de grands CSV

Étape 3 : Paramètres d'importation ⚙️

Configurer le comportement de l'importation :

A. Nom de la source

• Objectif: Étiquette pour ce travail d'importation (pour suivi/rapport)

• Par défaut: Généré automatiquement avec la date/heure

• Exemple: "Import 24/10/2025_1430"

B. Champ de code de cas

• Objectif: Colonne CSV contenant des identifiants uniques de cas

• Utilisation: Requis pour les mises à jour, aide à identifier les cas existants

C. Mode d'importation 🔄

Trois modes disponibles :

1. Création uniquement (CaseImportMode.Create)

   • Crée toujours de nouveaux cas

   • Ignore les vérifications des cas existants

   • Mode d'importation le plus rapide

2. Mise à jour uniquement (CaseImportMode.Update)

   • Met à jour uniquement les cas existants

   • Nécessite des attributs d'identification

   • Échoue si le cas n'est pas trouvé

3. Créer ou mettre à jour (CaseImportMode.CreateOrUpdate)

   • Vérifie d'abord si le cas existe

   • Crée si non trouvé, met à jour si trouvé

   • Le plus flexible mais légèrement plus lent

D. Attributs de cas

Définissez des métadonnées personnalisées à attacher aux cas :

interface ICaseAttributeMapping {
  csvField: string;        // Colonne dans le CSV
  attributeName: string;   // Nom de l'attribut
  isIdentifier: boolean;   // Utilisé pour trouver des cas existants ?
}

Exemple :

• Champ CSV : external_id

• Nom de l'attribut : legacy_system_id

• Est identifiant : true ✅

Identifiants :

• Utilisés pour localiser les cas existants lors des mises à jour

• Peuvent avoir plusieurs identifiants

• Vérifiés dans l'ordre jusqu'à ce qu'une correspondance soit trouvée

E. Champ de statut

• Colonne CSV contenant les informations de statut du cas

• Doit être mappé aux statuts valides du projet

---

Étape 4 : Révision 👀

Vérification finale avant le démarrage de l'importation :

Affichage du résumé :

Données CSV :

• Enregistrements totaux : Nombre de lignes à importer

• Champs totaux : Nombre de colonnes CSV

• Champs mappés : Colonnes mappées avec succès

• Champs non mappés : Colonnes qui seront ignorées

Paramètres d'importation :

• Nom de la source

• Champ de code de cas

• Mode d'importation

• Configuration du champ de statut

Attributs de cas :

• Liste de tous les attributs configurés

• Statut d'identifiant mis en évidence

Avertissements :

• ⚠️ Avertissement sur les champs non mappés: Liste des colonnes CSV qui ne seront pas importées

• Évite les pertes de données accidentelles

Soumission :

• Cliquez sur "Démarrer l'importation" pour mettre le travail en file d'attente

• Affiche un indicateur de chargement pendant la soumission

• Affiche une confirmation de succès lorsque la tâche est en file d'attente

📝 Résumé

L'outil d'importation de cas est une solution puissante et conviviale pour la gestion en masse des cas dans CS Care. Son interface basée sur un assistant, son mappage automatique intelligent, ses options de configuration flexibles et sa gestion robuste des erreurs le rendent adapté à tout, des chargements de données simples aux scénarios de migration complexes.

Forces clés :

• ✅ Assistant intuitif en 4 étapes

• ✅ Mappage automatique intelligent des champs

• ✅ Modes création/mise à jour flexibles

• ✅ Validation complète

• ✅ Traitement asynchrone pour les gros imports

• ✅ Surveillance de la progression en temps réel

• ✅ Suivi détaillé des erreurs par ligne

En suivant les bonnes pratiques et en comprenant chaque étape, les administrateurs peuvent importer efficacement des milliers de cas tout en maintenant l'intégrité des données et en minimisant les erreurs.

---