Importer, analyser et restituer les données

Le socle distingue trois besoins : comprendre un fichier existant, laisser un utilisateur corriger ses données, puis intégrer les lignes validées dans un modèle métier. Cette séparation évite de faire passer un parser générique pour un importeur universel.

Analyser un classeur Excel avant de le migrer

Callimaque inspecte les fichiers .xlsx et produit un dump JSON ainsi qu'un rapport Markdown exploitable par les agents et les développeurs. L'analyse couvre notamment :

• feuilles visibles, masquées et veryHidden ;
• cellules, types, valeurs et formules ;
• validations et formats conditionnels ;
• plages fusionnées et noms définis ;
• blocs tabulaires et colonnes inférées ;
• dépendances entre feuilles.

Cette matière sert à comprendre un outil Excel métier, retrouver ses règles, concevoir le futur modèle de données et préparer le mapping. Elle ne charge pas automatiquement les données dans l'application.

Les fichiers .xlsm sont refusés : les macros doivent être retirées ou analysées séparément. Un classeur complexe peut aussi dépendre de calculs, connexions ou objets qu'un lecteur navigateur ne recalcule pas.

Étendre l'analyse aux autres formats

Le même outillage couvre plusieurs sources courantes :

• CSV : dialecte, encodage, colonnes et types inférés ;
• DOCX : texte, métadonnées, commentaires et modifications suivies ;
• PDF : texte et images ;
• PPTX : slides, notes et métadonnées.

Le rapport accélère la conception. L'équipe définit ensuite les règles métier, la déduplication, les droits, la gestion des erreurs et la stratégie de reprise.

Corriger dans une grille avant l'envoi

Le composant data-sheet accepte des cellules texte, nombre, date, heure, sélection et booléen. Il gère la navigation clavier, le collage rectangulaire depuis Excel, les erreurs en place et les cellules en lecture seule.

Une recette d'import typique suit ce flux :

1. lire un CSV ou un texte tabulé ;
2. détecter virgule, point-virgule ou tabulation ;
3. présenter les lignes dans la grille ;
4. signaler les valeurs invalides ;
5. laisser l'utilisateur corriger ;
6. envoyer uniquement le lot validé à l'API.

Lire et restituer les fichiers

Le lecteur de documents sait afficher texte, JSON, CSV, images, PDF et DOCX. Les renderers lourds sont chargés à la demande. Un slot de prévisualisation permet à une application d'ajouter un format spécifique, notamment XLSX.

Studio possède un lecteur XLSX propre à son écran Documents. Il ouvre CSV et XLSX avec SheetJS et convertit les feuilles en données tabulaires. Cette capacité réelle reste spécifique à Studio : elle n'est pas présentée comme un composant générique automatiquement installé dans chaque écran.

Exporter sans surprendre les utilisateurs

La primitive délimitée sait produire un export compatible avec les usages Excel français : point-virgule, fins de ligne CRLF et BOM UTF-8. L'application choisit les colonnes, les libellés, le format des dates et les valeurs autorisées.

Pour un export réglementaire ou contractuel, un test de fichier complète le test d'interface : encodage, ordre des colonnes, séparateur, quoting, nombre de lignes et réimport du résultat.

Stocker et transférer

Le socle inclut un client S3, des URLs présignées et des composants d'upload avec progression, annulation et reprise. L'application conserve la responsabilité des quotas, de l'antivirus, de la rétention, des permissions et de l'emplacement réel du stockage.