JSON ve CSV arasında veri taşıma
JSON CSV dönüştürücü, nesne dizilerini elektronik tabloya uygun satırlara çevirir; başlıklı CSV dosyalarını da JSON nesnelerine dönüştürür. API örneklerini incelemek, küçük bir dışa aktarma dosyasını düzenlemek veya test verisi hazırlamak için kullanabilirsiniz. Yönü ve ayırıcıyı seçtikten sonra dönüştür düğmesine basın. Sonucu uygulamanıza aktarmadan önce birkaç kaydı kaynakla karşılaştırın. Dosya uzantısı veri biçimini tek başına doğrulamaz; örneğin JSON görünümlü bir dosya hatalı virgül içerebilir. Araç böyle durumlarda sonuç üretmek yerine açıklayıcı hata verir.
JSON satırları ve sütunların seçilmesi
JSON girdisi en az bir nesne içeren bir dizi olmalıdır. Tek nesne, yalın sayı dizisi ve boş dizi kabul edilmez. Sütunlar bütün kayıtlardaki anahtarların ilk görülme sırasıyla birleşiminden oluşturulur. Bir kayıtta bulunmayan alan ve null değeri boş CSV hücresi olur. Bu tercih okunabilir bir tablo oluşturur ancak bu iki durum geri dönüşte ayırt edilemez. İç içe nesneler ve diziler ayrı sütunlara açılmaz; hücreye JSON metni olarak yazılır. CSV yeniden JSON yapılırken bu metin kendiliğinden ayrıştırılmaz.
Ayırıcı, tırnak ve satır sonları
Virgül, noktalı virgül veya sekme ayırıcılarından birini seçebilirsiniz. İçinde ayırıcı, çift tırnak ya da satır sonu bulunan hücreler çift tırnak içine alınır. Hücre içindeki çift tırnak iki kez yazılır. Alıntılanmış hücredeki satır sonu yeni kayıt sayılmaz; metnin bir parçası olarak korunur. CSV çıktısı CRLF kayıt sonları kullanır. Girdide CRLF, LF ve CR kabul edilir. Başlangıçtaki UTF-8 BOM işareti kaldırılır. Bir tırnağın kapanmaması veya kapanıştan sonra beklenmeyen metin bulunması hata oluşturur.
Başlıklar ve veri türlerinin korunması
CSV ilk satırı sütun adlarını belirler. Boş başlıklar, aynı adı taşıyan sütunlar ve farklı sayıda hücre içeren kayıtlar reddedilir; böylece veriler sessizce kaybolmaz. CSV hücreleri her zaman JSON metni olarak döner. Örneğin 00123 kimliği baştaki sıfırlarıyla korunur; true yazısı mantıksal değere çevrilmez. Boş hücre boş metin olur. JSON sayılarında JavaScript hassasiyeti sınırlıdır: güvenli olmayan tam sayılar ve on beşten fazla anlamlı basamak içeren değerler reddedilir. Uzun kimlikleri kaynakta çift tırnak içinde tutun.
Elektronik tablo formüllerine karşı seçenek
Formül koruması varsayılan olarak açıktır. Eşittir, artı, eksi veya et işaretiyle başlayan hücrelere tek tırnak eklenir; baştaki boşluklar da dikkate alınır. Koruma sütun başlıklarına da uygulanır. Bu işlem bazı elektronik tabloların metni formül olarak yorumlama riskini azaltır, fakat özgün hücre metnini değiştirir. Negatif sayılar da bu kapsamda metinleşebilir. Makine tarafından okunacak ham CSV gerekiyorsa korumayı bilinçli biçimde kapatın. Alıcı uygulamanın içe aktarma ayarlarını kontrol edin; bu seçenek her tablo yazılımı için güvenlik garantisi değildir.
Örnek, indirme ve gizlilik
Örnek olarak [{"kod":"001","ad":"İpek"}] girdisi kod ve ad başlıklarını, ardından 001 ve İpek hücrelerini üretir. JSON yönünde indirilen dosya .json, CSV yönünde .csv uzantısı taşır. İsteğe bağlı BOM yalnız CSV indirmesine eklenir; kopyalanan metne eklenmez. Türkçe karakterlerin görünümü içe aktaran uygulamanın UTF-8 seçimine bağlıdır. Araç veriyi sunucuya göndermez. Paylaşım kutusu işaretlenirse küçük girdiler bağlantı parçasına eklenir ve bağlantıyı alan kişi bunları okuyabilir. Büyük dosyaları yerel bir betikle işleyin; burada her girdi 500.000 kod birimiyle sınırlıdır. Sütun ve kayıt sayısının çarpımı 100.000 hücreyi aşamaz; seyrek kayıtların aşırı büyük tabloya dönüşmesi engellenir. CSV başlıklarının JSON içinde toplam tekrar uzunluğu iki milyon karakterle sınırlıdır.
Sık sorulan sorular
CSV sayıları neden metin oluyor?
CSV hücrelerinin kendi tür bilgisi yoktur. Baştaki sıfırları, uzun kimlikleri ve tarih görünümlü metinleri değiştirmemek için bütün hücreler JSON metni olarak döner. Gereken tür dönüşümünü veriyi kullanan uygulamada açık bir şemayla yapın.
Dönüşüm kayıpsız mı?
Her durumda değil. JSON null ve eksik alan boş hücreye dönüşür. İç içe yapılar metinleşir. Formül koruması tek tırnak ekler. İki yönü art arda kullanmak özgün JSON türlerini otomatik geri getirmez.
Excel için BOM gerekli mi?
Bazı elektronik tablo sürümleri Türkçe karakterler için BOM ile UTF-8 dosyalarını daha kolay tanır. Seçenek yalnız CSV indirmesine uygulanır. Yine de dosyayı açarken ayırıcı ve karakter kodlamasını kontrol edin.
Veriler yükleniyor mu?
Hayır. Dönüşüm yerel tarayıcı işlevidir. Ancak girdileri bağlantıya eklerseniz bağlantıyı alan kişi veriyi görebilir. Paylaşım boyutu dönüşüm boyutundan daha küçüktür; büyük girdileri dosya olarak yerel saklayın.