JSON Araçları Kılavuzu: Belgeleri ve Verileri JSON'a Dönüştürün ve Geri Çevirin

Bu kılavuz, JSON araçlarının dosyaları nasıl işlediğini, ürettiği belge biçimini ve her iş için hangi aracı kullanacağınızı açıklar.

JSON Neden Kullanılır

JSON, programların, web hizmetlerinin ve yapay zeka modellerinin en kolay okuduğu veri biçimidir: adlandırılmış alanlara sahip nesneler, listeler, sayılar, metin, true, false ve null, başka hiçbir şey değil. Belgeler ve elektronik tablolar bu şekilde saklanmaz. Bu araç ailesi boşluğu her iki yönde de kapatır: PDF'leri, Word dosyalarını, elektronik tabloları, CSV'yi, YAML'ı ve XML'i JSON'a dönüştürür ve JSON'ı insanların okuduğu PDF, Word, Excel, CSV ve HTML gibi dosyalara geri çevirir.

Her araç sunucularımızda güvenli bir bağlantı üzerinden çalışır ve yüklenen dosyayı 60 dakika içinde siler. Metin girdisi, yüklemek yerine doğrudan yapıştırılabilir.

Hangi İş İçin Hangi Aracı Kullanmalısınız

Elinizde olan	İstediğiniz	Kullanın
Bir PDF	Veri olarak metin, tablolar ve meta veriler	PDF'den JSON'a
Bir Word belgesi	Veri olarak başlıklar, paragraflar, listeler ve tablolar	Word'den JSON'a
Bir Excel çalışma kitabı	Kayıtlar, satırlar veya sütunlar	Excel'den JSON'a
Bir CSV veya TSV dosyası	Türlendirilmiş değerlere sahip bir JSON dizisi	CSV'den JSON'a
Bir YAML dosyası	Aynı veri JSON olarak	YAML'dan JSON'a
Bir XML dosyası	Nesneler, öznitelikler ve diziler	XML'den JSON'a
JSON	Okumak veya yazdırmak için bir PDF	JSON'dan PDF'e
JSON	Bir Excel çalışma kitabı	JSON'dan Excel'e
JSON	Bir CSV dosyası	JSON'dan CSV'ye
JSON	Düzenlenebilir bir Word belgesi	JSON'dan Word'e
JSON	Bir web sayfası	JSON'dan HTML'e
JSON	Bir yapılandırma dosyası için YAML	JSON'dan YAML'a
JSON	Başka bir sistem için XML	JSON'dan XML'e
Düzensiz veya geçersiz bir JSON	Temiz, geçerli JSON	JSON Biçimlendirici
İki JSON dosyası	Nelerin değiştiğinin listesi	JSON Karşılaştır

Markdown'ın kendi çifti vardır: Markdown'dan JSON'a bir belge ağacı dışa aktarır ve JSON'dan Markdown'a JSON'ı bir Markdown taslağına veya tablosuna dönüştürür.

Belge Biçimi

PDF'den JSON'a ve Word'den JSON'a aynı şekli yazar, böylece tek bir kod parçası her ikisini de işleyebilir. En üst düzey her zaman şu alanlara sahiptir:

{
  "format": "acepdfmd-document",
  "version": 1,
  "source": {"type": "pdf", "filename": "report.pdf", "title": "Q3 Report", "pages": 12},
  "pages": [{"number": 1, "width": 612, "height": 792, "words": 380, "text": "..."}],
  "blocks": [
    {"type": "heading", "level": 1, "text": "Q3 Report"},
    {"type": "paragraph", "text": "Revenue grew..."},
    {"type": "list", "ordered": false, "items": [{"level": 0, "text": "Europe"}]},
    {"type": "table", "header": ["Region", "Q3"], "rows": [["Europe", 1200.5]]}
  ],
  "tables": [{"index": 1, "page": 3, "rows": [["Region", "Q3"], ["Europe", 1200.5]]}],
  "form_fields": [{"name": "email", "type": "text", "value": "[email protected]"}],
  "extraction": {"engine": "pdf_to_markdown/layout", "mode": "structure", "ocr": false, "warnings": []}
}

Alanların anlamı şu şekildedir:

source: dosyanın ne olduğunu, taşıdığı meta verilerle birlikte belirtir (başlık, yazar, konu, anahtar kelimeler, oluşturma ve değiştirme tarihleri, sayfa sayısı). Word dosyaları kelime, tablo ve görsel sayılarını da ekler.
pages: her PDF sayfası için puan cinsinden boyutunu, döndürmesini, kelime sayısını ve metnini içeren bir girdi sağlar. Word dosyalarının sayfası yoktur, çünkü Word sayfaları yalnızca yazdırırken düzenler.
blocks: belgeyi okuma sırasına göre verir. Türler şunlardır: heading (1 ile 6 arasında bir seviyeyle), paragraph (Word'den isteğe bağlı bir stil adıyla), list (sıralı veya değil, iç içelik seviyesine sahip öğelerle), table (başlık ve türlendirilmiş satırlarla), code, blockquote, rule ve image.
tables: PDF'ler için, bulunduğu sayfayla birlikte tespit edilen her tabloyu ve devam eden bir tablo için bittiği sayfayı içerir. Sayı gibi görünen hücreler sayıdır.
form_fields: yalnızca PDF'nin bir formu olduğunda bulunur. Her alan adını, türünü (text, choice, button veya signature) ve geçerli değerini taşır.
extraction: hangi dönüştürücünün çalıştığını, seçtiğiniz modu, OCR'ye gerek olup olmadığını ve tespit edilemeyen bir tablo gibi uyarıları belirtir.

Bu biçimin 1. sürümü zamanla yalnızca yeni alanlar kazanır; mevcut alanlar adlarını ve anlamlarını korur.

Tablo Verileri ve İç İçe Yapı

CSV ve Excel düzdür, JSON değildir. JSON, CSV'ye veya Excel'e giderken, iç içe nesneler noktalı sütun adlarına, diziler ise indeksli sütunlara düzleştirilir; böylece bir müşteri nesnesi ve bir öğeler dizisi içeren bir sipariş kaydı, customer.name, items[0].sku ve items[1].sku gibi sütunlara dönüşür. CSV veya Excel JSON'a geri döndüğünde, bu şekilde yazılmış başlıklar iç içe nesnelere ve dizilere yeniden kurulur. İçinde bir sürüm numarası veya bir kısaltma gibi sıradan bir nokta bulunan bir başlık olduğu gibi bırakılır.

Değerler girişte türlendirilir: sayılar sayıya, true ve false boole değerine, boş bir hücre null'a dönüşür ve diğer her şey dize olarak kalır. Excel'den çıkan tarihler, JSON'da tarih türü olmadığı için ISO 8601 dizeleri olarak yazılır. Baştaki sıfırlara sahip tanımlayıcıların tam olarak yazıldığı gibi kalması gerektiğinde değer türleri seçeneğini metin olarak değiştirin.

Doğrulama ve Onarım

Her JSON aracı girdisini aynı şekilde doğrular. Geçersiz bir dosya, ilk hatanın satır ve sütunuyla ve o satırın kısa bir alıntısıyla birlikte reddedilir. JSON Biçimlendirici, insanların en sık yapıştırdığı hataları da onarabilir: yorumlar, sondaki virgüller, tek tırnaklı dizeler, tırnaksız anahtarlar, büyük harfle yazılmış True, False ve None, NaN ve Infinity, ve metnin etrafındaki kod çitleri. Bir onarım uygulandığında sonuç bunu size bildirir, böylece hiçbir şey sessizce ve fark ettirmeden değişmez.

Gizlilik

Yüklenen dosyalar ve yapıştırılan metin sunucularımızda işlenir ve 60 dakika içinde silinir; ayrıntılar için gizlilik kılavuzuna bakın. Bu sürenin dışında hiçbir şey saklanmaz ve başka herhangi bir amaçla kullanılmaz.