YAML, XML, JSON ve CSV'yi Tarayıcıda Güvenli Dönüştürme

Dönüşümden önce veri sözleşmesini belirleyin

YAML, XML, JSON ve CSV aynı bilgiyi farklı şekillerde ifade eder; ancak tür sistemleri eşit değildir. JSON null, boolean, sayı, dizi ve nesneyi açıkça taşırken CSV temelde satır ve metin hücrelerinden oluşur. XML'de öğe, öznitelik, namespace ve metin düğümü ayrımı; YAML'de girinti, alias ve örtük scalar türleri vardır.

Bu nedenle ilk adım hedef biçimi seçmek değil, korunması gereken anlamı yazmaktır. Alan türü, boş değer, sıra, yinelenen anahtar, tarih/saat ve hassas veri kuralları belgelenmeden yapılan dönüşüm görünürde başarılı olup veri kaybedebilir.

• Temsil gücü yüksek küçük bir fixture saklayın.
• Kaynak ve hedef şemayı sürümleyin.
• Null, boş metin ve eksik alanı birbirinden ayırın.
• Dönüşüm öncesi ve sonrası kayıt sayılarını karşılaştırın.

YAML ve XML ayrıştırmasını veri çalıştırmadan yapın

Güvenli YAML işlemi özel etiketi çalıştırmamalı, alias genişlemesini sınırlamalı ve yinelenen anahtarı hata olarak göstermelidir. ByteQuant'ın YAML aracı bu amaçla güvenli ayrıştırma seçenekleri kullanır; yine de hedef uygulamanın kendine özgü şemasını ve scalar yorumunu bilemez.

DOMParser XML sözdizimini doğrular fakat XSD, namespace sözleşmesi, dış varlık, imza veya iş kuralı doğrulamaz. Biçimlendirilmiş XML'in doğru görünmesi semantik olarak kabul edileceği anlamına gelmez. XSD gerekiyorsa ayrı, güvenilir ve güncel doğrulama zinciri kullanın.

• YAML alias sayısını ve dosya boyutunu sınırlayın.
• XML dış varlıklarını çözmeyin.
• Parser hatasını sessizce düz metne çevirmeyin.
• Üretim yapılandırmasını hedef uygulamada test edin.

JSON Pointer ile kayıpsız düzleştirme

Nokta ayrımlı yollar, anahtarın kendisinde nokta veya köşeli parantez bulunduğunda belirsizleşir. RFC 6901 JSON Pointer, `~` ve `/` karakterlerini tanımlı biçimde kaçırdığı için iç içe alan envanteri ve fark raporlarında daha güvenilir bir ara formdur.

Düzleştirmeden geri açarken sayısal yol parçalarının dizi mi yoksa sayısal nesne anahtarı mı olduğu her zaman kaynaktan çıkarılamaz. Bu nedenle boş nesne/dizi ve sıra bilgisi örneklerle test edilmeli, çakışan yollar kesin hata üretmelidir.

• Kök primitive ve boş container vakalarını test edin.
• Yol kaçışını elle değiştirmeyin.
• Dizi sırasını iş kuralı olarak belgeleyin.
• Geri açılan JSON'u şemayla doğrulayın.

CSV tekilleştirmede anahtar ve normalizasyon kararı

CSV yinelenen kaydı ancak hangi sütunların kimlik oluşturduğu tanımlanınca belirleyebilir. E-posta alanında çevre boşluğu ve harf farkını yok saymak yararlı olabilir; ürün kodunda aynı normalizasyon yanlış kayıtları birleştirebilir. İlk veya son kaydı koruma kararı da zaman sırasına ve veri kaynağına bağlıdır.

Temizleme sonrası yalnızca dosyayı değil; kaynak satır, benzersiz anahtar ve kaldırılan kayıt sayısını da saklayın. Kişisel veri içeren tabloları paylaşmadan önce maskeleme yapın ve otomatik tekilleştirmeyi geri alınabilir bir kopya üzerinde çalıştırın.