XML Formatter & Validator; web servisleri, veri yedekleri, sitemap XML yapıları veya yapılandırma dosyalarında kullanılan düzensiz, tek satır halinde sıkıştırılmış ya da girintisiz yazılmış XML (Extensible Markup Language) verilerini analiz ederek, bunları standart girintilerle okunabilir ve hiyerarşik bir ağaç yapısına dönüştüren ücretsiz bir online geliştirici aracıdır. Aracımız, girdiğiniz XML belgesinin W3C standartlarına uygunluğunu ve sözdizimi doğruluğunu denetler; olası hataları hata detaylarıyla birlikte ekranda listeler.
XML Nedir ve Neden Yapısal Düzenlemeye İhtiyaç Duyar?
XML (Extensible Markup Language - Genişletilebilir İşaretleme Dili), verileri hem insanlar hem de bilgisayarlar tarafından kolayca okunabilecek ortak bir şemada depolamak ve aktarmak amacıyla W3C tarafından geliştirilmiştir. XML, JSON formatının popülaritesine rağmen kurumsal yazılımlarda, bankacılık veri transferlerinde (SOAP tabanlı web servisleri), haber beslemelerinde (RSS/Atom), office belgelerinin arka planında (docx, xlsx) ve arama motorları için kritik olan sitemap.xml (site haritası) yapılarında etkin bir şekilde kullanılmaya devam etmektedir.
XML etiket tabanlı (tag-based) bir dil olduğu için girintiler (indentation) olmadan okunması ve anlaşılması oldukça zordur. Örneğin:
<root><kullanici id="1"><ad>Ahmet</ad><rol>Yönetici</rol></kullanici></root>
Dosya boyutu megabaytları bulan veri tabanı çıktılarında veya karmaşık SOAP yanıtlarında bu şekildeki tek satır veriyi incelemek, etiketlerin birbirleriyle olan ast-üst ilişkisini (parent-child relationship) takip etmek imkansızdır. Bir XML Formatter, kod etiketlerini derinlik seviyelerine göre otomatik olarak sağa kaydırarak kodun hiyerarşik haritasını çıkarır.
XML Belgesinin Geçerli (Well-Formed) Olması İçin Gereken Kurallar
XML standartları, JSON'a benzer şekilde son derece katıdır. Bir XML belgesinin tarayıcılar veya XML parser yazılımları tarafından hatasız işlenebilmesi için "well-formed" (düzgün yapılandırılmış) olması gerekir. İşte en temel XML yazım kuralları:
1. Tek Bir Kök Eleman (Root Element) Zorunluluğu
Her XML belgesi yalnızca bir adet kök etiketiyle başlamalı ve bitmelidir. Kök etiketinin dışında kalan hiçbir bağımsız etiket bulunamaz.
- Hatalı:
<kullanici><ad>Ahmet</ad></kullanici> <kullanici><ad>Mehmet</ad></kullanici> - Doğru:
<kullanicilar> <kullanici><ad>Ahmet</ad></kullanici> <kullanici><ad>Mehmet</ad></kullanici> </kullanicilar>
2. Kapanış Etiketlerinin Eksiksiz Olması
XML'de açılan her etiketin mutlaka bir kapanış etiketi bulunmalıdır. HTML'deki gibi <br> veya <img> gibi kendi kendine kapanmayan etiketler XML'de doğrudan kullanılamaz; bunların <br /> veya <img /> şeklinde kendi kendini kapatan etiket (self-closing tag) olarak yazılması şarttır.
3. Harf Duyarlılığı (Case Sensitivity)
XML etiket adlarında büyük ve küçük harfler tamamen farklı kabul edilir. <Veri> şeklinde açılan bir etiket mutlaka </Veri> olarak kapatılmalıdır; </veri> şeklinde kapatılması doğrulama hatasına sebep olur.
4. Doğru Yuvalama (Nesting)
Etiketler iç içe geçirilirken açılış sırasına göre ters sırayla kapatılmalıdır. Etiketlerin birbiriyle çakışması kesinlikle yasaktır.
- Hatalı:
<a><b></a></b> - Doğru:
<a><b></b></a>
5. Öznitelik Değerlerinin Tırnak İçinde Yazılması
Etiketlere eklenen tüm öznitelik (attribute) değerleri mutlaka tek veya çift tırnak işaretiyle çevrelenmelidir.
- Hatalı:
<kullanici id=1> - Doğru:
<kullanici id="1">
Vexpia XML Formatter & Validator Hata Ayıklama İşlemini Nasıl Kolaylaştırır?
Web sitenizin sitemap.xml dosyasında veya API isteklerinizde meydana gelen küçük bir yazım hatası, arama motorlarının sitenizi tarayamamasına veya web servislerinizin tamamen durmasına yol açabilir.
Aracımız sayesinde:
- Dağınık XML metinlerinizi saniyeler içinde tertemiz ve hiyerarşik bir formata getirebilirsiniz.
- Belgenin sözdizimini denetleyerek hatalı olan etiket eşleşmesini, eksik tırnağı veya kaçırılmış kök elemanı anında bulabilirsiniz.
- Hatalı yazılan alanların nerede olduğunu kolayca görerek hata ayıklama (debugging) sürecini kısaltırsınız.
Sıkça Sorulan Sorular (SSS)
XML dosyamda "Geçersiz XML" hatası alıyorum, nedeni ne olabilir?
En sık yapılan hatalar; açılan bir etiketin kapatılmaması, etiket isimlerinde büyük-küçük harf uyuşmazlığı olması, öznitelik değerlerinin tırnak içine alınmaması veya belgede birden fazla kök (root) eleman bulunmasıdır. Hata mesajını inceleyerek ilgili satırı kontrol edebilirsiniz.
XML Formatter kodumu değiştirir mi?
Hayır, XML Formatter aracımız belgenizin veri yapısını veya içeriğini kesinlikle değiştirmez. Sadece kodun okunabilirliğini artırmak amacıyla boşluklar ve satır sonları ekleyerek hiyerarşik olarak düzenler.
Sitemap (Site Haritası) XML neden doğrulanmalıdır?
Google ve diğer arama motorları web sitenizi taramak için sitemap.xml dosyasını okurlar. Eğer bu dosyada tek bir XML hatası bile bulunursa tarayıcı botlar dosyayı ayrıştıramaz (parse edemez) ve sitenizin yeni sayfaları dizine eklenmeyebilir. Bu nedenle site haritanızı yayına almadan önce mutlaka bu araçla doğrulamanız önerilir.