Elysia Tools
Mobile Navigation
Workflow Playbook
Ein fokussierter Ablauf für eine Arbeitsmappe oder ein Arbeitsblatt: Bereich auswählen, Überschriften zuordnen, die bereinigte Tabelle in JSON umwandeln und Quelle, Typen, Nullwerte und Duplikate prüfen, ohne Batch-Aufnahme oder Übergabe an ein Data Warehouse.
Themen
Dieser Ablauf ist für Analysten, Betriebsteams und Entwickler gedacht, die eine einzelne Arbeitsmappe oder ein einzelnes Arbeitsblatt für einen JSON-Verbraucher vorbereiten. Bewahren Sie eine unveränderte Kopie auf und erzeugen Sie ein geprüftes JSON-Array oder eine Vorschau eines abgegrenzten Bereichs. Batch-Aufnahme, API- oder S3-Eingang, das Zusammenführen mehrerer Arbeitsmappen sowie SQL-, Parquet- und Warehouse-Übergabe sind nicht Teil dieses Weges.
Notieren Sie Arbeitsblattname, A1- oder benannten Bereich, Kopfzeile und erwartete Datenzeilen. Verwenden Sie xlsx-range-extractor im Modus records, wenn jede Zeile ein Objekt werden soll, oder cell_objects, wenn Adressen als Nachweis dienen. Leere Zellen sollten nur dann verworfen werden, wenn sie für die Prüfung keine Bedeutung haben. Die Grenze ist entscheidend: Mapper und Transformer lesen das Arbeitsblatt und keinen beliebigen Bereich.
Verwenden Sie xlsx-column-mapper auf einer Arbeitskopie mit der tatsächlichen Kopfzeile. Tragen Sie kanonische Namen in renameMapJson, Aliase in aliasMapJson, die gewünschte Reihenfolge in reorderColumns und beabsichtigte Löschungen in removeColumns ein. Entscheiden Sie keepUnmapped vor der Ausführung. Prüfen Sie die neue Kopfzeile und behalten Sie das Original; die Mapping-Ausgabe ist eine neue XLSX-Datei.
Verwenden Sie xlsx-json-transformer im Modus xlsx_to_json, wenn die gemappte Tabelle ihre Überschriften in der ersten Zeile hat. Blattname und Pfadtrenner sollten gleich bleiben. restoreTypes kann Text, der wie Zahl, Boolean, null, Array oder Objekt aussieht, in andere JSON-Werte umwandeln; leere Zellen werden bei XLSX zu JSON ausgelassen. Vergleichen Sie repräsentative Zeilen, Felder, Typen, Leerwerte und doppelte Schlüssel. Die Tools entscheiden weder über Duplikatregeln noch über fachliche Datentypen.
Akzeptieren Sie das Ergebnis erst, wenn jede Abweichung erklärt ist und keine Anforderungen an Batch-Verarbeitung, externe Eingänge, mehrere Arbeitsmappen, SQL, Parquet oder ein Warehouse in diese Übergabe einer einzelnen Arbeitsmappe gelangt sind.
Workflow-Leitfaden
Erstellen Sie eine Arbeitskopie, dokumentieren Sie Arbeitsblatt und Grenzen und führen Sie xlsx-range-extractor aus. Verwenden Sie records für eine zeilenförmige JSON-Vorschau oder cell_objects, um Zeilen-, Spalten- und Adressnachweise zu erhalten. Wenn der Bereich nur ein Abschnitt eines größeren Arbeitsblatts ist, stellen Sie die anderen Tools nicht als automatisch bereichsbewusst dar.
Führen Sie xlsx-column-mapper mit der richtigen headerRow auf der Kopie aus. Wenden Sie klare Umbenennungs- oder Aliasregeln an, legen Sie die kanonische Reihenfolge fest, entfernen Sie nur dokumentierte Spalten und entscheiden Sie über nicht zugeordnete Felder. Prüfen Sie vor dem nächsten Schritt die Überschriften der erzeugten XLSX-Datei.
Führen Sie xlsx-json-transformer mit mode xlsx_to_json für das gemappte Arbeitsblatt aus. Wählen Sie den Blattnamen, verwenden Sie für verschachtelte Schlüssel einen konsistenten Pfadtrenner und aktivieren Sie restoreTypes nur, wenn solche Texte interpretiert werden sollen. Das Ergebnis ist ein Array von Zeilenobjekten; leere Zellen werden in dieser Richtung nicht ausgegeben.
Verwenden Sie xlsx-range-extractor mit einem A1- oder benannten Bereich. Wählen Sie records für zeilenweise Objekte anhand der Überschriften oder cell_objects, wenn Zelladressen wichtig sind. Mapper und Transformer lesen ein Arbeitsblatt und keinen beliebigen Bereich; bei einem Abschnitt einer größeren Tabelle dient das Extraktionsergebnis daher als Prüf- oder endgültiger Datensatzpfad.
Verwenden Sie xlsx-column-mapper, wenn die Tabelle als ein Arbeitsblatt verarbeitet werden kann. Setzen Sie headerRow, verwenden Sie renameMapJson oder aliasMapJson für kanonische Namen, reorderColumns für die Reihenfolge, removeColumns für dokumentierte Löschungen und keepUnmapped gemäß dem Feldvertrag. Bewahren Sie das Original separat auf, da das Tool eine neue XLSX-Datei schreibt.
Verwenden Sie xlsx-json-transformer im Modus xlsx_to_json, wenn die gemappte Tabelle ihre Überschriften in Zeile eins hat. Wählen Sie restoreTypes bewusst: Text, der wie eine Zahl, ein Boolean, null, ein Array oder ein Objekt aussieht, kann interpretiert werden. In dieser Richtung werden leere Zellen ausgelassen; Duplikate müssen weiterhin gegen Schlüssel oder Zeilenregel geprüft werden.
Prüfen Sie ausgewählte Zeilen und gemappte Überschriften erneut anhand aller drei Ausgaben. Vergleichen Sie Zeilenanzahl, Felder, repräsentative Werte, Leerwertverhalten und doppelte Schlüssel; bewahren Sie Quelle und Zwischen-XLSX auf und stoppen oder dokumentieren Sie ungeklärte Abweichungen.