Excel-zu-JSON-Konverter

Grenzen der Arbeitsmappe und unterstützte Formate

Dieser Konverter liest XLSX-Arbeitsmappen und klassische binäre XLS-Dateien. XLSM, XLSB, ODS und CSV werden nicht akzeptiert. Der Browser prüft die Dateisignatur. Es genügt daher nicht, ein anderes Format in .xlsx oder .xls umzubenennen.

Eine Arbeitsmappe darf bis zu 20 MiB groß sein, bis zu 100 Arbeitsblätter enthalten und bis zu 2 Millionen Zellen verwenden. Der Konverter prüft vor dem Lesen außerdem die Struktur eines XLSX-Archivs und beendet die Ausgabeerzeugung oberhalb von 100 MiB. Diese Grenzen verhindern, dass eine beschädigte oder ungewöhnlich große Arbeitsmappe einen unkontrollierten Browser-Download erzeugt.

Eine JSON-Struktur für die ausgewählten Arbeitsblätter wählen

JSON kann Arrays und Objekte sowie Text, Zahlen, boolesche Werte und null darstellen. Welche Struktur passt, hängt vom System ab, das die Datei liest. RFC 8259 beschreibt das JSON-Datenmodell.

Die Objekt-Array-Form folgt dem von SheetJS dokumentierten Standardverhalten: Die erste Zeile liefert Überschriften. Die Matrix-Ausgabe behält diese Zeile, weil sie dort Daten und keine Metadaten sind.

Objekt-, Wörterbuch- und Gruppenausgaben benötigen eine nicht leere Überschriftenzeile ohne Duplikate. Ein Wörterbuch benötigt zusätzlich eindeutige Werte in der gewählten Schlüsselspalte. Der Konverter hält mit einer klaren Fehlermeldung an, wenn diese Regeln nicht erfüllt sind, statt einen Datensatz unbemerkt zu überschreiben. Sie können bereinigte Eigenschaftsschlüssel verwenden oder den exakten Überschriftentext beibehalten, wenn ein Zielsystem den Wortlaut der Arbeitsmappe verlangt.

Werte, Daten und Formeln

Bei aktivierter Typerkennung bleiben Tabellenzahlen und boolesche Werte JSON-Zahlen und JSON-Boolesche Werte. Sie können Werte auch als Text beibehalten, wenn das Zielsystem die Umwandlung selbst steuert. Leere Zellen werden zu null oder zu leeren Zeichenfolgen. Ganzzahlen außerhalb des sicheren JavaScript-Bereichs bleiben Text, damit ihre Ziffern nicht stillschweigend gerundet werden.

Datumszellen werden nur dann zu ISO-Werten, wenn der Tabellenleser sie als Datum erkennt. Der Konverter errät nicht, dass ein datumähnlicher Text ein Datum ist. Das ist bei Bestellnummern, Versionsbezeichnungen und lokal geschriebenen Datumsangaben wichtig.

Der Konverter führt Excel-Formeln niemals aus und berechnet sie nicht neu. Er verwendet den gespeicherten Wert einer Formel, wenn die Arbeitsmappe einen enthält. Eine Formel ohne gespeicherten Wert folgt der gewählten Regel für leere Werte.

Lokale Umwandlung und temporäre Entwürfe

Das Lesen der Arbeitsmappe, die JSON-Erzeugung, das Erstellen des ZIP und Downloads finden im Browser statt. Die Arbeitsmappe, ihre Blattdaten und das erzeugte JSON werden weder hochgeladen noch über unsere Server übertragen.

Im mehrstufigen Ablauf kann eine geprüfte Arbeitsmappe als hash-geprüfter temporärer Entwurf im IndexedDB-Speicher dieses Browsers bleiben. Die URL enthält nur eine undurchsichtige Auftragskennung, nie den Dateinamen oder Blattwerte. Der Entwurf ist nach 30 Minuten nicht mehr verfügbar. Wenn Sie neu beginnen oder einen Download anfordern, bittet das Werkzeug den Browser um seine Entfernung und warnt, falls diese nicht bestätigt werden kann. Ist Browser-Speicher nicht verfügbar, bleiben die Bedienelemente auf einer Seite, damit Sie ohne Navigation fertig werden können.