--- title: "Export / Import de Données — Documentation Fonctionnelle" module: platform type: functional status: active updated: 2026-07-06 --- # Export / Import de Données — Documentation Fonctionnelle > Permet d'exporter des données de l'application vers Excel, de les modifier hors ligne, puis de les réimporter en comparant les changements avant application. --- ## Vue d'ensemble Le module Export/Import offre un cycle complet de gestion des données en masse : export vers un fichier Excel, modification des données hors ligne, puis réimport avec comparaison intelligente des changements. Avant d'appliquer toute modification, l'utilisateur visualise une prévisualisation détaillée qui liste les créations, mises à jour et suppressions détectées. Il peut choisir lesquelles appliquer. Un historique complet des opérations est conservé à des fins d'audit. Le système détecte et signale les conflits lorsque les données en base ont été modifiées entre le moment de l'export et celui de l'import. L'utilisateur peut alors résoudre ces conflits manuellement. --- ## Accès - Menu : accessible via `/export-import` - Droits requis : accès restreint selon la politique d'autorisation (export, import, consultation, téléchargement) - Module : fonctionnalité en phase alpha (`feature:alpha`) --- ## Fonctionnalités principales - **Exporter des données** : choisir une table ou entité, lancer l'export. Le fichier Excel est généré en arrière-plan et disponible en téléchargement une fois prêt. - **Télécharger un template vide** : récupérer un fichier Excel vierge pré-formaté (colonnes, listes déroulantes) pour préparer un import sans export préalable. - **Importer un fichier Excel** : uploader le fichier modifié en associant l'export d'origine comme référence de comparaison. - **Prévisualiser les changements** : consulter la liste des lignes à créer, modifier ou supprimer avant toute application. - **Résoudre les conflits** : lorsque des données ont changé en base depuis l'export, les conflits sont signalés et l'utilisateur choisit quelle version conserver. - **Sélectionner les modifications à appliquer** : l'utilisateur peut appliquer tout ou partie des changements détectés. - **Consulter l'historique** : accéder à l'ensemble des opérations d'export et d'import passées via `/export-import/history` (deux tableaux filtrables : historique des exports et historique des imports). ### Fiabilité - **Hiérarchie importable en un seul fichier** : un utilisateur dont le manager est lui-même une nouvelle ligne du fichier est correctement rattaché (résolution différée, plus d'erreur technique). - **Un import à la fois** : impossible de lancer deux imports simultanés sur la même table pour le même client — un message clair l'indique. - **Protection contre les données périmées** : si les données ont changé en base entre la prévisualisation et l'application (ou si la prévisualisation a expiré), l'application est refusée avec un message invitant à relancer l'analyse. - **Messages d'erreur lisibles** : en cas d'échec, l'utilisateur voit un message en français indiquant la ligne concernée (plus de code SQL brut). - **Opérations interrompues** : une analyse ou application bloquée (incident serveur) est automatiquement marquée en échec après 15 minutes au lieu de rester bloquée indéfiniment. - **Télécharger un fichier** : récupérer un fichier export ou import précédent via l'historique. --- ## Champs personnalisés dans l'export/import Le système s'adapte automatiquement à la configuration propre à chaque client (tenant) pour les champs personnalisés. ### Comportement par client - **Colonnes masquées** : un champ configuré comme masqué pour un client est automatiquement absent du fichier Excel exporté et ignoré à l'import. - **Labels adaptés** : les en-têtes du fichier Excel utilisent les libellés définis par le client plutôt que les noms techniques de colonnes. - **Listes déroulantes dynamiques** : si un client a personnalisé les valeurs d'une liste (ex. types, statuts), les valeurs exportées et acceptées à l'import reflètent cette configuration. - **Champs multi-valeurs** : les champs pouvant contenir plusieurs valeurs (sélection multiple) sont correctement exportés et réimportés. - **Champs custom activés** : les champs `custom1`, `custom2` (masqués par défaut) peuvent devenir des colonnes actives avec leur propre liste de valeurs si le client les a configurés. ### Rétrocompatibilité Les fichiers Excel exportés avant la mise en place des labels dynamiques (anciens exports avec noms bruts de colonnes) restent importables sans modification. --- ## Tables supportées - Utilisateurs (`users`) - Entités / clients (`customer`) - Adresses clients (`customer_addr`) - Sujets de tickets (`_listdata`) ### Champs à liste déroulante Certaines colonnes exportées proposent une liste déroulante directement dans Excel (valeurs Oui/Non, statuts, assistants IA, références vers d'autres enregistrements…) afin de limiter les erreurs de saisie avant réimport. --- ## Voir aussi - Documentation technique : `.claude/technical-docs/platform/export-import.md` - Documentation technique (champs custom) : `.claude/technical-docs/platform/export-import-field-custom.md`