Elysia Tools
Navigation mobile
Workflow Playbook
Un parcours ciblé pour un classeur ou une feuille : sélectionner une plage, mapper les en-têtes, convertir le tableau nettoyé en JSON et examiner la source, les types, les valeurs nulles et les doublons, sans passer à l'ingestion par lots ni à la livraison vers un entrepôt.
Dossiers
Ce parcours s'adresse aux analystes, aux équipes opérationnelles et aux développeurs qui préparent un seul classeur ou une seule feuille pour un consommateur JSON. Conservez une copie intacte et produisez un tableau JSON révisé ou un aperçu d'une plage délimitée. L'ingestion par lots, l'entrée API ou S3, la fusion de plusieurs classeurs et la livraison SQL, Parquet ou entrepôt ne font pas partie de ce parcours.
Notez le nom de la feuille, la plage A1 ou nommée, la ligne d'en-têtes et le nombre attendu de lignes de données. Utilisez xlsx-range-extractor en mode records quand chaque ligne doit devenir un objet, ou en mode cell_objects quand les adresses constituent une preuve. N'activez la suppression des blancs que si les cellules vides n'ont pas de sens pour la revue. La limite est importante : le mappeur et le transformateur lisent la feuille, et non une plage arbitraire.
Sur une copie de travail, utilisez xlsx-column-mapper avec la vraie ligne d'en-têtes. Placez les noms canoniques dans renameMapJson, les alias dans aliasMapJson, la séquence voulue dans reorderColumns et les suppressions intentionnelles dans removeColumns. Décidez de keepUnmapped avant l'exécution. Vérifiez la nouvelle ligne d'en-têtes et gardez l'original : la sortie du mappage est un nouveau XLSX.
Utilisez xlsx-json-transformer en mode xlsx_to_json lorsque la feuille mappée a ses en-têtes en première ligne. Gardez constants le nom de feuille et le séparateur de chemins. restoreTypes peut transformer un texte ressemblant à un nombre, un booléen, null, un tableau ou un objet en une autre valeur JSON, tandis que les cellules vides sont omises en mode XLSX vers JSON. Comparez des lignes représentatives, les champs, les types, les blancs et les clés dupliquées. Les outils ne décident pas des règles de doublons ni des types métier.
N'acceptez le résultat que lorsque chaque différence est expliquée et que les exigences de lots, d'entrées externes, de classeurs multiples, de SQL, de Parquet ou d'entrepôt n'ont pas envahi cette remise sur un seul classeur.
Guide de workflow
Créez une copie de travail, consignez la feuille et ses limites, puis lancez xlsx-range-extractor. Utilisez records pour un aperçu JSON organisé en lignes, ou cell_objects pour conserver les preuves de ligne, de colonne et d'adresse. Si la plage ne couvre qu'une partie d'une grande feuille, ne présentez pas les autres outils comme s'ils appliquaient automatiquement cette plage.
Lancez xlsx-column-mapper sur la copie avec le bon headerRow. Appliquez les règles explicites de renommage ou d'alias, fixez l'ordre canonique, ne supprimez que les colonnes documentées et décidez de conserver ou non les champs non mappés. Vérifiez la ligne d'en-têtes du XLSX produit avant de poursuivre.
Lancez xlsx-json-transformer avec mode xlsx_to_json sur la feuille mappée. Sélectionnez le nom de la feuille, gardez le séparateur de chemins des clés imbriquées cohérent et n'activez restoreTypes que si le consommateur doit interpréter ces textes. Attendez-vous à un tableau d'objets de lignes ; les cellules vides ne sont pas émises dans ce sens.
Utilisez xlsx-range-extractor avec une plage A1 ou une plage nommée. Choisissez records pour obtenir des objets par ligne fondés sur les en-têtes, ou cell_objects lorsque les adresses sont importantes. Le mappeur et le transformateur lisent une feuille plutôt qu'une plage arbitraire ; pour une section d'une grande feuille, utilisez donc le résultat de l'extraction comme voie d'inspection ou d'enregistrements finale.
Utilisez xlsx-column-mapper lorsque le tableau peut être traité comme une seule feuille. Renseignez headerRow, appliquez les noms canoniques avec renameMapJson ou aliasMapJson, imposez l'ordre avec reorderColumns, supprimez seulement les colonnes documentées avec removeColumns et choisissez keepUnmapped selon le contrat. Gardez l'original à part, car l'outil écrit un nouveau fichier XLSX.
Utilisez xlsx-json-transformer en mode xlsx_to_json lorsque la feuille mappée possède ses en-têtes en première ligne. Choisissez restoreTypes avec attention : l'outil peut interpréter un texte ressemblant à un nombre, un booléen, null, un tableau ou un objet. Dans ce sens, les cellules vides sont omises et la détection des doublons reste une vérification par rapport à la clé ou à la ligne attendue.
Calculateurs, outils numériques, logique de dates, statistiques et finance
Réexaminez les lignes sélectionnées et les en-têtes mappés avec les trois sorties. Comparez le nombre de lignes, les champs, les valeurs représentatives, le traitement des blancs et les clés dupliquées ; conservez la source et le XLSX intermédiaire et arrêtez ou documentez toute différence inexpliquée.