JSON Metnini CSV’ye Dönüştürme: Adım Adım Rehber

JSON’u CSV’ye dönüştürmeden önce bilinmesi gerekenler

JSON verisini CSV metnine çevirmek, tablo biçimi bekleyen bir uygulamaya veya çalışma sayfasına aktarım hazırlarken işe yarar. Bu araç, tek bir JSON nesnesini bir kayıt olarak işler; nesnelerden oluşan bir dizi verildiğinde ise her nesne için bir CSV satırı yazar. CSV başlıkları, işlenen kayıtlarda bulunan alan adlarının ilk görülme sırasına göre oluşturulur. Bir kayıtta başlıkta yer alan alan yoksa ilgili hücre boş bırakılır.

Girdi olarak JSON metni kullanılır. Boş veya yalnızca boşluklardan oluşan içerik ile hatalı JSON kabul edilmez. Varsayılan ayraç virgüldür; farklı bir ayraç sağlarsanız araç bunu metne çevirir ve birden fazla karakter varsa yalnızca ilk karakteri kullanır. Boş ayraç değeri yine virgül olarak ele alınır.

JSON metnini CSV çıktısına dönüştürme

1. JSON metnini hazırlayın. Tek bir nesne kullanacaksanız bu nesne bir CSV kaydı olarak işlenir. Birden fazla kayıt için üst düzeyde boş olmayan ve ilk öğesi nesne olan bir dizi kullanın. Üst düzeyde dizi yerine metin, sayı, doğru/yanlış değeri veya null vermeyin; bu değerler dönüştürme için uygun değildir.

2. JSON metnini giriş alanına yapıştırın. Başta ve sonda kalan boşluklar sorun değildir, ancak içerik tamamen boş olmamalıdır. Parantez, virgül, iki nokta ve tırnak işaretlerini kontrol ederek geçerli JSON kullandığınızdan emin olun.

3. Gerekirse ayraç değerini belirleyin. Özel bir ayraç seçerken tek karakter kullanmanız en açık sonucu verir. Birden fazla karakter girilirse yalnızca ilk karakter dikkate alınır. Değer boş bırakılırsa virgül kullanılır.

4. Dönüştürme kontrolünü çalıştırın ve oluşan CSV metnini inceleyin. Başlık satırı, işlenen kayıtlarda bulunan farklı alan adlarını ilk karşılaşılma sırasıyla içerir. Sonraki satırlarda her işlenen kayıt için bir satır bulunur. Bir kayıtta eksik alan varsa o konumdaki değer boş metin olur.

5. Sonucu hedef uygulamanıza aktarırken ayraç seçiminin uygulamadaki içe aktarma ayarıyla eşleştiğini kontrol edin. JSON içindeki değerler CSV satırına yazılmadan önce metne çevrilir; bu nedenle sayılar ve diğer desteklenen değerler çıktı içinde metin olarak görünür.

CSV sonucunu nasıl okumalı?

Çıktının ilk satırı başlıklardan oluşur. Bu başlıklar, tek nesnede bulunan alanlardan veya işlenen dizi kayıtlarında görülen alanların birleşiminden meydana gelir; sıralama, farklı bir alan adının ilk kez görüldüğü sırayı izler. Başlıktan sonra tek nesne için bir, işlenen her dizi kaydı için bir CSV satırı beklenir.

Bir üst düzey nesne beklenen tek kayıt biçimidir. Üst düzey dizi boşsa veya ilk öğesi nesne değilse başlangıç doğrulamasını geçmez. İlk öğe nesne olsa bile dizinin sonraki öğeleri ayrıca nesne olarak doğrulanmaz. Bu öğelerden biri sayı, null ya da dizi olduğunda işlem daha sonraki aşamada başarısız olabilir. Bu nedenle dizi içindeki her öğeyi nesne olarak düzenlemek gerekir.

İç içe nesne veya dizi değerlerinin ayrı CSV sütunlarına açıldığı varsayılmamalıdır. Doğrulanmış davranış, CSV satırına yazılan değerlerin metne çevrilmesini kapsar; iç içe verinin birden fazla sütuna düzleştirildiği sonucu çıkarılamaz.

Uygulamalı örnek

Bir kullanıcı, tek bir kişi kaydını virgülle ayrılmış iki sütunlu CSV metnine aktarmak istiyor.

Girdi olarak {"ad":"Ada","yas":30} metnini verin ve virgül ayraçla dönüştürmeyi çalıştırın.

Çıktıda önce ad ve yas başlıklarını içeren bir satır, ardından tek bir kayıt satırı bulunur; yas değeri CSV’ye metin olarak yazılır.

Sınırlamalar

• Boş diziler, ilk öğesi nesne olmayan diziler ve diğer üst düzey JSON değerleri kabul edilmez. Sonraki dizi öğeleri ayrıca doğrulanmadığından nesne olmayan bir öğe işlemi başarısız kılabilir; iç içe verinin ayrı sütunlara düzleştirildiği garanti edilmez.

Sık yapılan hatalar

• Hata nedeni genellikle JSON sözdiziminin bozuk olması veya dizinin boş, ilk öğesinin nesne dışında ya da sonraki öğelerinden birinin nesne olmamasıdır. Tüm JSON’u doğrulayın; dizi kullanıyorsanız boş olmayan dizinin ilk ve sonraki öğelerini nesne biçiminde düzenleyin.

Sık sorulan sorular

Tek bir JSON nesnesini CSV’ye çevirebilir miyim?

Evet, tek bir JSON nesnesi bir kayıt olarak işlenir ve başlık satırının ardından bir CSV satırı yazılır.

JSON dizisini doğrudan CSV’ye dönüştürebilir miyim?

Evet, ancak dizi boş olmamalı ve ilk öğesi nesne olmalıdır. Sonraki öğeler nesne değilse ayrıca temiz bir doğrulama sonucu vermek yerine işlem başarısız olabilir.

Bir kayıtta alan eksikse CSV hücresi ne olur?

Eksik alanın karşılığı boş metin olarak yazılır. Başlık ise işlenen kayıtlarda bulunan farklı alan adlarının ilk görülme sırasını korur.