XML Şablonları Rehberi: Placeholder ve Özel Şablon Oluşturma

Sotrano panelindeki XML Şablonları sayfası, ürünlerinizi XML olarak dışa aktarırken kullanılacak XML yapısını belirlediğiniz yerdir. Hazır Standart Şablon Varyantlı şablonunu görüntüleyebilir ya da kendi özel şablonlarınızı oluşturabilirsiniz. Şablon üç parçadan oluşur: XML Header, her ürün için tekrarlanan XML Body ve XML Footer. Body içine ürün bilgilerini temsil eden placeholder'lar (örneğin [name], [price2]) yazarsınız. Bu rehber şablon sayfasını, editörü ve tüm placeholder'ları anlatır.

Bu rehberde neler var?

• XML Şablonları sayfası nedir?
• Yeni şablon oluşturma
• Placeholder listesi
• Şablonu düzenleme ve silme
• Dikkat etmeniz gerekenler
• Sık sorulan sorular

XML Şablonları sayfası nedir?

Sol menüde İçe / Dışa Aktarım altındaki XML menüsünden XML Şablonları'nı açarsınız. Sayfanın açıklaması "Sistem şablonlarını görüntüleyin veya kendi özel şablonlarınızı oluşturun." şeklindedir. Sayfada iki bölüm vardır:

• Sistem Şablonları: Sotrano'nun hazır şablonları. Standart Şablon Varyantlı burada Sistem rozetiyle görünür; düzenlenemez ya da silinemez.
• Özel Şablonlar: Sizin oluşturduğunuz şablonlar. Her satırda şablonun adı, oluşturulma tarihi ve Düzenle ile Sil düğmeleri bulunur.

Sağ üstteki Yeni Şablon düğmesi yeni bir şablon editörü açar. Hazırladığınız şablonları XML Export görevlerinde seçersiniz.

Yeni şablon oluşturma

1. XML Şablonları sayfasında Yeni Şablon'a tıklayın.
2. XML İsmi alanına şablonu tanıyacağınız bir ad yazın.
3. XML Header alanına dosyanın başlangıcını yazın (örneğin <?xml version="1.0" encoding="UTF-8"?> ve ana etiket).
4. XML Body alanına her ürün için tekrarlanacak yapıyı yazın. Placeholder'ları elle yazabilir ya da sağdaki listeden tıklayarak ekleyebilirsiniz.
5. XML Footer alanına dosyanın bitişini yazın (örneğin ana etiketin kapanışı).
6. Kaydet'e tıklayın. Vazgeçmek için İptal'i kullanın.

Örnek bir şablon:

• XML Header: <?xml version="1.0" encoding="UTF-8"?> satırı ve ardından <Urunler>
• XML Body: <Urun> içinde <Kod>[product_code]</Kod>, <Ad>[name]</Ad>, <Fiyat>[price1]</Fiyat> ve <Stok>[stock]</Stok>
• XML Footer: </Urunler>

Bu şablonla oluşturulan XML dosyası önce Header'ı, sonra her ürün için Body'yi (placeholder'ların ürünün gerçek değerleriyle değiştirilmiş hâliyle), en sonda Footer'ı içerir.

Şablonu kaydettikten sonra Özel Şablonlar listesinde görünür.

Placeholder listesi

Editörün sağındaki Placeholder Listesi üç gruptan oluşur. Bir placeholder'a tıklamak onu Body alanına ekler. Metin değerleri XML'e güvenli biçimde (CDATA içinde) yazılır.

Ürün alanları

• [product_id]: Ürünün numarası.
• [product_code]: Ürünün (renk modelinin) model kodu.
• [barcode]: Ürünün ilk varyantının barkodu.
• [name]: Ürün adı.
• [brand]: Marka.
• [description]: Ürün açıklaması.
• [price1]: Ürünün en düşük alış fiyatı.
• [price2]: Ürünün en düşük satış fiyatı.
• [stock]: Ürünün tüm varyantlarının toplam kullanılabilir stoğu.
• [tax]: KDV oranı.
• [currency]: Para birimi.
• [kategori1], [kategori2], [kategori3] ve [kategoriid1], [kategoriid2], [kategoriid3]: Kategori yolunun basamaklarının adı ve numarası.
• [image1] - [image5]: İlk beş görselin adresi.

Varyant döngüsü

[variants_start] ve [variants_end] arasına yazdığınız yapı, ürünün her varyantı için tekrarlanır. Bu iki etiketi Body içinde birlikte kullanın.

Varyant alanları (döngü içinde)

• [variantId], [variantProductCode] (stok kodu), [variantBarcode], [variantGtin]
• [variantQuantity]: Varyantın stoğu.
• [variantPrice1]: Varyantın alış fiyatı, [variantPrice2]: satış fiyatı.
• [variantAgirlik], [variantDesi]: Varyantın desi bilgisi. [variantDepth], [variantHeight], [variantWidth]: Boyutlar.
• [specs]: Tüm renk ve beden özelliklerini otomatik ekler.

Şablonu düzenleme ve silme

• Düzenle: Özel şablonu aynı editörde açar. Değişikliklerinizi Kaydet ile kaydedersiniz.
• Sil: Şablonu siler. Sotrano "Bu şablonu silmek istediğinize emin misiniz?" diye onay ister. Sistem şablonları silinemez.

Dikkat etmeniz gerekenler

• Fiyat alanlarına dikkat edin: [price1] ve [variantPrice1] alış fiyatını verir. XML dosyasını üçüncü kişilerle paylaşacaksanız şablonda alış fiyatını kullanmak istediğinizden emin olun.
• Header ve Footer birbirini tamamlamalı: Header'da açtığınız ana etiketi Footer'da kapatın, aksi hâlde XML geçersiz olur.
• Varyant döngüsünü çifte yazın: [variants_start] ve [variants_end] her zaman birlikte olmalıdır.
• Önce bir deneme yapın: Yeni şablonu önce küçük bir filtreyle bir export görevinde deneyin ve oluşan dosyayı kontrol edin.

Sık sorulan sorular

Standart şablonu değiştirebilir miyim?

Hayır. Standart Şablon Varyantlı bir sistem şablonudur ve düzenlenemez. Bunun yerine kendi özel şablonunuzu oluşturun.

Placeholder'ı yanlış yazarsam ne olur?

Tanınmayan bir placeholder değiştirilmeden olduğu gibi dosyaya yazılır. Bu yüzden listedeki adlarla birebir aynı yazın ya da listeden tıklayarak ekleyin.

Şablonu nerede kullanırım?

XML Export sayfasında yeni bir export görevi oluştururken XML Şablonu listesinden seçersiniz.

İlgili rehberler

• XML Export Rehberi: Şablonla XML dosyası oluşturup adresini paylaşmak için.
• Excel Toplu Güncelleme Rehberi: Ürünleri Excel ile toplu güncellemek için.

Sonuç

XML Şablonları ile dışa aktardığınız XML'in yapısını kendiniz belirlersiniz: Header, her ürün için Body ve Footer yazın, placeholder'larla ürün bilgilerini yerleştirin ve Kaydet'e tıklayın. Şablonu bir XML Export görevinde kullanın. Takıldığınız bir adım olursa Sotrano destek ekibiyle iletişime geçebilirsiniz.