Konwerter Excel na JSON

Limity skoroszytu i obsługiwane formaty

Ten konwerter odczytuje skoroszyty XLSX i starsze binarne pliki XLS. Nie przyjmuje XLSM, XLSB, ODS ani CSV. Przeglądarka weryfikuje sygnaturę pliku, więc zmiana nazwy innego formatu na .xlsx lub .xls nie wystarczy.

Skoroszyt może mieć do 20 MiB, zawierać do 100 arkuszy i używać do 2 milionów komórek. Przed odczytem konwerter sprawdza też strukturę archiwum XLSX, a generowanie wyniku zatrzymuje powyżej 100 MiB. Te ograniczenia chronią przed niekontrolowanym pobieraniem z uszkodzonego lub wyjątkowo dużego skoroszytu.

Wybierz jedną strukturę JSON dla wybranych arkuszy

JSON może przedstawiać tablice i obiekty, a także tekst, liczby, wartości logiczne i null. Właściwa struktura zależy od systemu, który odczyta plik. RFC 8259 opisuje model danych JSON.

Forma tablicy obiektów stosuje domyślne zachowanie opisane przez SheetJS: pierwszy wiersz dostarcza nagłówków. Wyjście macierzowe zachowuje ten wiersz, ponieważ jest on danymi, a nie metadanymi.

Wyjścia obiektowe, słownikowe i grupowe wymagają niepustego wiersza nagłówków bez duplikatów. Słownik wymaga też unikalnych wartości w wybranej kolumnie klucza. Jeśli zasady nie są spełnione, konwerter zatrzymuje się z jasnym błędem zamiast po cichu nadpisywać rekord. Możesz użyć oczyszczonych kluczy właściwości albo zachować dokładny tekst nagłówków, gdy system docelowy wymaga sformułowania ze skoroszytu.

Wartości, daty i formuły

Przy włączonym rozpoznawaniu typów liczby i wartości logiczne z arkusza pozostają liczbami i wartościami logicznymi JSON. Wartości możesz też zachować jako tekst, gdy system odbierający sam kontroluje konwersję. Puste komórki mogą stać się null lub pustymi ciągami. Liczby całkowite poza bezpiecznym zakresem JavaScript pozostają tekstem, aby ich cyfry nie zostały cicho zaokrąglone.

Komórki daty stają się wartościami ISO tylko wtedy, gdy czytnik arkusza rozpozna je jako daty. Konwerter nie zgaduje, że tekst wyglądający jak data jest datą. To rozróżnienie ma znaczenie dla numerów zamówień, etykiet wersji i dat zapisanych zgodnie z lokalną konwencją.

Konwerter nigdy nie uruchamia ani nie przelicza formuł Excel. Gdy skoroszyt zawiera zapisaną wartość formuły, używa właśnie jej. Formuła bez zapisanej wartości podlega wybranej zasadzie dla pustych wartości.

Konwersja lokalna i tymczasowe szkice

Odczyt skoroszytu, generowanie JSON, tworzenie ZIP i pobieranie odbywają się w przeglądarce. Skoroszyt, dane arkuszy i wygenerowany JSON nie są wysyłane ani przekazywane przez nasze serwery.

W przepływie wieloetapowym zweryfikowany skoroszyt może być zachowany jako tymczasowy szkic sprawdzany hashem w pamięci IndexedDB tej przeglądarki. Adres URL zawiera wyłącznie niejawny identyfikator zadania, nigdy nazwę pliku ani wartości arkusza. Szkic staje się niedostępny po 30 minutach. Rozpoczęcie od nowa lub żądanie pobrania prosi przeglądarkę o jego usunięcie i wyświetla ostrzeżenie, jeśli usunięcia nie można potwierdzić. Jeśli pamięć przeglądarki jest niedostępna, narzędzie pozostawia kontrolki na jednej stronie, aby można było ukończyć pracę bez nawigacji.