YAML, XML, JSON Pointer ve CSV dönüşümlerinde veri türlerini, kaçışları ve hata sınırlarını korumaya yönelik ayrıntılı yerel çalışma rehberi.
Okuduklarınızı güvenli bir denemeye dönüştürün
Gerçek veriye geçmeden önce sentetik bir örnekle adımları tamamlayın. İşaretler yalnızca bu sekmede tutulur.
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.
Rehberi tekrarlanabilir bir kontrole dönüştürün
“YAML, XML, JSON ve CSV'yi Tarayıcıda Güvenli Dönüştürme” için aşağıdaki 6 araçlık kontrol planını kullanın. Hedef: YAML, XML, JSON Pointer ve CSV dönüşümlerinde veri türlerini, kaçışları ve hata sınırlarını korumaya yönelik ayrıntılı yerel çalışma rehberi. Gerçek veri yerine güvenli bir örnekle başlayın; her adımın beklenen sonucunu ve kabul kararını kaydedin.
YAML ↔ JSON Dönüştürücü
- Hazırlık
- YAML veya JSON metnini yapıştırıp kaynak biçimini seçin. YAML ↔ JSON Dönüştürücü için beklenen biçim: YAML ↔ JSON Dönüştürücü için başlangıç girdisi: araç açıklamasında belirtilen nesne, dizi veya alanları içeren sözdizimi geçerli JSON. Araç bu girdiyi “YAML ve JSON yapılarını güvenli ayrıştırma ve açık hata mesajlarıyla dönüştürün” amacıyla kullanır..
- Uygulama
- Yerel dönüştürmeyi çalıştırın ve ayrıştırma uyarılarını inceleyin. YAML ↔ JSON Dönüştürücü, şu yöntemi uygular: YAML ↔ JSON Dönüştürücü, “YAML ve JSON yapılarını güvenli ayrıştırma ve açık hata mesajlarıyla dönüştürün” hedefi için şu açıklanabilir yöntemi uygular: ayrıştırma, alan ve tür sınırlarını koruyan deterministik kurallarla yapılır.
- Kabul kontrolü
- Çıktıyı hedef şema ve uygulama davranışıyla doğrulayın. YAML ↔ JSON Dönüştürücü kabul ölçütü: YAML ↔ JSON Dönüştürücü sonucunu kabul etmeden önce alan adları, veri türleri, kaçışlar ve boş/null değerlerin kaynakla birebir karşılaştırılması kontrolünü tamamlayın; beklenen amaç “YAML ve JSON yapılarını güvenli ayrıştırma ve açık hata mesajlarıyla dönüştürün” olmalıdır..
- Beklenen çıktı
- YAML ↔ JSON Dönüştürücü tamamlandığında ayrıştırılmış yapı, alan ölçümleri ve açık sözdizimi bulguları sunar; bu çıktı “YAML ve JSON yapılarını güvenli ayrıştırma ve açık hata mesajlarıyla dönüştürün” ihtiyacına göre düzenlenir.. YAML ve JSON yapılarını güvenli ayrıştırma ve açık hata mesajlarıyla dönüştürün.
XML Biçimlendirici ve Doğrulayıcı
- Hazırlık
- XML belgesini yapıştırın ve çıktı modunu seçin. XML Biçimlendirici ve Doğrulayıcı için beklenen biçim: XML Biçimlendirici ve Doğrulayıcı için başlangıç girdisi: tek köklü ve iyi biçimlendirilmiş XML. Araç bu girdiyi “XML sözdizimini doğrulayın, biçimlendirin veya küçültün” amacıyla kullanır..
- Uygulama
- Yerel ayrıştırmayı çalıştırıp hata konumunu inceleyin. XML Biçimlendirici ve Doğrulayıcı, şu yöntemi uygular: XML Biçimlendirici ve Doğrulayıcı, “XML sözdizimini doğrulayın, biçimlendirin veya küçültün” hedefi için şu açıklanabilir yöntemi uygular: ayrıştırma, alan ve tür sınırlarını koruyan deterministik kurallarla yapılır.
- Kabul kontrolü
- Biçimlendirilmiş sonucu hedef XSD veya uygulamayla ayrıca doğrulayın. XML Biçimlendirici ve Doğrulayıcı kabul ölçütü: XML Biçimlendirici ve Doğrulayıcı sonucunu kabul etmeden önce alan adları, veri türleri, kaçışlar ve boş/null değerlerin kaynakla birebir karşılaştırılması kontrolünü tamamlayın; beklenen amaç “XML sözdizimini doğrulayın, biçimlendirin veya küçültün” olmalıdır..
- Beklenen çıktı
- XML Biçimlendirici ve Doğrulayıcı tamamlandığında ayrıştırılmış yapı, alan ölçümleri ve açık sözdizimi bulguları sunar; bu çıktı “XML sözdizimini doğrulayın, biçimlendirin veya küçültün” ihtiyacına göre düzenlenir.. XML sözdizimini doğrulayın, biçimlendirin veya küçültün.
JSON Düzleştirici / Geri Açıcı
- Hazırlık
- Geçerli iç içe JSON veya düz JSON Pointer haritası girin. JSON Düzleştirici / Geri Açıcı için beklenen biçim: JSON Düzleştirici / Geri Açıcı için başlangıç girdisi: araç açıklamasında belirtilen nesne, dizi veya alanları içeren sözdizimi geçerli JSON. Araç bu girdiyi “İç içe JSON'u kayıpsız JSON Pointer yollarına düzleştirin ve geri kurun” amacıyla kullanır..
- Uygulama
- Düzleştir ya da geri aç modunu seçip işlemi çalıştırın. JSON Düzleştirici / Geri Açıcı, şu yöntemi uygular: JSON Düzleştirici / Geri Açıcı, “İç içe JSON'u kayıpsız JSON Pointer yollarına düzleştirin ve geri kurun” hedefi için şu açıklanabilir yöntemi uygular: ayrıştırma, alan ve tür sınırlarını koruyan deterministik kurallarla yapılır.
- Kabul kontrolü
- Dizi türleri ve boş nesneleri örneklerle doğrulayın. JSON Düzleştirici / Geri Açıcı kabul ölçütü: JSON Düzleştirici / Geri Açıcı sonucunu kabul etmeden önce alan adları, veri türleri, kaçışlar ve boş/null değerlerin kaynakla birebir karşılaştırılması kontrolünü tamamlayın; beklenen amaç “İç içe JSON'u kayıpsız JSON Pointer yollarına düzleştirin ve geri kurun” olmalıdır..
- Beklenen çıktı
- JSON Düzleştirici / Geri Açıcı tamamlandığında ayrıştırılmış yapı, alan ölçümleri ve açık sözdizimi bulguları sunar; bu çıktı “İç içe JSON'u kayıpsız JSON Pointer yollarına düzleştirin ve geri kurun” ihtiyacına göre düzenlenir.. İç içe JSON'u kayıpsız JSON Pointer yollarına düzleştirin ve geri kurun.
CSV Tekilleştirici ve Yinelenen Satır Bulucu
- Hazırlık
- Başlıklı CSV'yi yapıştırın ve anahtar sütunları yazın. CSV Tekilleştirici ve Yinelenen Satır Bulucu için beklenen biçim: CSV Tekilleştirici ve Yinelenen Satır Bulucu için başlangıç girdisi: başlık ve satır yapısı tutarlı CSV, TSV, tablo veya ayraçlı kayıtlar. Araç bu girdiyi “Seçili sütunlara göre yinelenen CSV satırlarını bulun ve tekilleştirin” amacıyla kullanır..
- Uygulama
- Eşleşme ve korunacak satır seçeneklerini belirleyin. CSV Tekilleştirici ve Yinelenen Satır Bulucu, şu yöntemi uygular: CSV Tekilleştirici ve Yinelenen Satır Bulucu, “Seçili sütunlara göre yinelenen CSV satırlarını bulun ve tekilleştirin” hedefi için şu açıklanabilir yöntemi uygular: ayraç, tırnak, satır ve sütun sınırları ayrı ayrı incelenir.
- Kabul kontrolü
- Yinelenen raporunu inceleyip temiz CSV'yi indirin. CSV Tekilleştirici ve Yinelenen Satır Bulucu kabul ölçütü: CSV Tekilleştirici ve Yinelenen Satır Bulucu sonucunu kabul etmeden önce başlık sayısı, satır uzunluğu, tırnak kaçışları ve örnek kayıtların hedef tabloda açılması kontrolünü tamamlayın; beklenen amaç “Seçili sütunlara göre yinelenen CSV satırlarını bulun ve tekilleştirin” olmalıdır..
- Beklenen çıktı
- CSV Tekilleştirici ve Yinelenen Satır Bulucu tamamlandığında satır/sütun özeti, normalize edilmiş kayıtlar ve sorunlu hücrelerin konumu sunar; bu çıktı “Seçili sütunlara göre yinelenen CSV satırlarını bulun ve tekilleştirin” ihtiyacına göre düzenlenir.. Seçili sütunlara göre yinelenen CSV satırlarını bulun ve tekilleştirin.
HTML Varlık Kodlayıcı / Çözücü
- Hazırlık
- Metni girip kodlama veya çözme modunu seçin. HTML Varlık Kodlayıcı / Çözücü için beklenen biçim: HTML Varlık Kodlayıcı / Çözücü için başlangıç girdisi: araçta istenen URL, HTTP başlığı, cURL komutu, API veya web yapılandırması. Araç bu girdiyi “HTML özel karakterlerini entity biçimine kodlayın veya güvenli metne çözün” amacıyla kullanır..
- Uygulama
- Dönüşümü çalıştırın ve karakter sayısını karşılaştırın. HTML Varlık Kodlayıcı / Çözücü, şu yöntemi uygular: HTML Varlık Kodlayıcı / Çözücü, “HTML özel karakterlerini entity biçimine kodlayın veya güvenli metne çözün” hedefi için şu açıklanabilir yöntemi uygular: girdi ağ isteği yapılmadan ayrıştırılır; bileşenler ve riskli varsayımlar ayrı gösterilir.
- Kabul kontrolü
- Üretim şablonunda bağlama uygun otomatik escaping kullanın. HTML Varlık Kodlayıcı / Çözücü kabul ölçütü: HTML Varlık Kodlayıcı / Çözücü sonucunu kabul etmeden önce çıktının yetkili test ortamında, güncel standart ve gerçek sunucu davranışıyla karşılaştırılması kontrolünü tamamlayın; beklenen amaç “HTML özel karakterlerini entity biçimine kodlayın veya güvenli metne çözün” olmalıdır..
- Beklenen çıktı
- HTML Varlık Kodlayıcı / Çözücü tamamlandığında normalize edilmiş web yapılandırması, bileşen envanteri ve uygulanabilir inceleme notları sunar; bu çıktı “HTML özel karakterlerini entity biçimine kodlayın veya güvenli metne çözün” ihtiyacına göre düzenlenir.. HTML özel karakterlerini entity biçimine kodlayın veya güvenli metne çözün.
Data URI Kodlayıcı / Çözücü
- Hazırlık
- Kodlama için metin/dosya seçin veya çözmek için Data URI yapıştırın. Data URI Kodlayıcı / Çözücü için beklenen biçim: Data URI Kodlayıcı / Çözücü için başlangıç girdisi: araçta istenen URL, HTTP başlığı, cURL komutu, API veya web yapılandırması. Araç bu girdiyi “Metin veya küçük dosyayı Data URI'ye dönüştürün; Data URI meta verisini ve içeriğini çözün” amacıyla kullanır..
- Uygulama
- 5 MB sınırı içinde yerel dönüşümü çalıştırıp MIME ve byte sayısını inceleyin. Data URI Kodlayıcı / Çözücü, şu yöntemi uygular: Data URI Kodlayıcı / Çözücü, “Metin veya küçük dosyayı Data URI'ye dönüştürün; Data URI meta verisini ve içeriğini çözün” hedefi için şu açıklanabilir yöntemi uygular: girdi ağ isteği yapılmadan ayrıştırılır; bileşenler ve riskli varsayımlar ayrı gösterilir.
- Kabul kontrolü
- Çözülen içeriği çalıştırmadan önce türünü ve kaynağını bağımsız doğrulayın. Data URI Kodlayıcı / Çözücü kabul ölçütü: Data URI Kodlayıcı / Çözücü sonucunu kabul etmeden önce çıktının yetkili test ortamında, güncel standart ve gerçek sunucu davranışıyla karşılaştırılması kontrolünü tamamlayın; beklenen amaç “Metin veya küçük dosyayı Data URI'ye dönüştürün; Data URI meta verisini ve içeriğini çözün” olmalıdır..
- Beklenen çıktı
- Data URI Kodlayıcı / Çözücü tamamlandığında normalize edilmiş web yapılandırması, bileşen envanteri ve uygulanabilir inceleme notları sunar; bu çıktı “Metin veya küçük dosyayı Data URI'ye dönüştürün; Data URI meta verisini ve içeriğini çözün” ihtiyacına göre düzenlenir.. Metin veya küçük dosyayı Data URI'ye dönüştürün; Data URI meta verisini ve içeriğini çözün.
YAML ↔ JSON Dönüştürücü için şu sınır geçerlidir: YAML ↔ JSON Dönüştürücü için kullanım sınırı: Şema, kodlama ve veri kaybı varsayımlarını hedef sistemde doğrulayın. Bu koşul karşılanmıyorsa çıktıyı zincirin sonraki adımına aktarmayın.
“YAML, XML, JSON ve CSV'yi Tarayıcıda Güvenli Dönüştürme” kaydında hassas içeriği değil; araç adını, seçilen ayarı, tarayıcı sürümünü ve “CI yapılandırması dönüştürme: YAML ↔ JSON Dönüştürücü ile yerel analiz” için kabul/red gerekçesini tutun. Böylece kontrol gerçek veriyi çoğaltmadan tekrarlanabilir.
İçerik, görünür ByteQuant ürün davranışı ve varsa listelenen birincil kaynaklarla karşılaştırılarak hazırlanır. Genel bilgilendirmedir; hukuki veya güvenlik danışmanlığı değildir.