İçeriğe geç
← Journal'a dön
Rehberler
6 dk okuma

On bin satırı içe aktarmadan önce katalog CSV dosyanızı doğrulayın

On örnek katalog satırında yinelenen SKU, eksik varyant, hatalı fiyat biçimi ve bozuk metni bulun. İçe aktarmadan önce sonuçları kontrol edin.

Yazar Frihet Ekibi
On bin satırı içe aktarmadan önce katalog CSV dosyanızı doğrulayın

TL;DR: Bir CSV kataloğunu doğrulamak için, öncelikle hedefin onu nasıl yorumladığını kontrol edin; ardından sütunları, tanımlayıcıları, varyantları ve değerleri gözden geçirin. Bilinen hatalar içeren bir örnekle deneme yapın ve yüklemeden önce tüm dosyayı doğrulayın. On satırın geçmesi, diğerlerinin de doğru olduğunu veya bir güncellemenin tüm verileri koruyacağını kanıtlamaz.

İçindekiler

Bir CSV kataloğunu doğrulamak, içe aktarırken nelerin değişeceğini bilmekle başlar. Ardından sütunlar, tanımlayıcılar ve değerler gelir. Uyarı vermeden açılan bir sayfa, aynı SKU’ya sahip iki ürün veya değeri olmayan bir beden içerebilir. Kabul edilen bir dosya yanlış ürünü de güncelleyebilir.

Aşağıdaki test, bu hataları ayırt etmeyi öğrenmek içindir. On adet uydurma satır içerir ve sonuçları doğrulanabilir. Gerçek bir mağaza örneği veya Shopify ya da Frihet için hazırlanmış bir dosya değildir: bu, bu alıştırma için hazırlanmış bağımsız bir şemadır ve hedef sisteminizin şemasıyla değiştirmeniz gerekecektir.

Hedef sistemle başlayın, tedarikçi dosyasıyla değil

Verileri alacak araçtan güncel bir şablon indirin veya temsili bir ürünü dışa aktarın. Oluşturma, güncelleme veya her ikisini birden birleştirme işlemlerini yapıp yapmayacağınızı; bir kaydı neyin tanımladığını; hangi alanların zorunlu olduğunu; ve bir hücreyi boş bırakmanın ne anlama geldiğini not edin. Bu tanımı çalışma dosyasıyla birlikte saklayın.

Örneğin Shopify’da, üzerine yazma işlemi handle adı verilen URL tanımlayıcısına dayanır. Belgeleri ayrıca varyant ve seçenek alanları arasındaki bağımlılıkları gözden geçirmeyi gerektirir. SKU kuralımız, bu içe aktarıcının ürünleri nasıl tanımladığını açıklamaz. Shopify ürün formatı.

Sistemler arasında veri taşıyorsanız, bu incelemeyi mağaza ile işletme yönetimi arasındaki bağlantıdan (İngilizce) ayırın. Mevcut bir bağlayıcı, tedarikçinizin sütunlarını kabul ettiği anlamına gelmez.

Kontrol edebileceğiniz kurallar tanımlayın

Bu alıştırmada her satır, satılabilir bir ürün veya varyantı temsil eder. product_key varyantlarını gruplandırır; sku mevcut ve benzersiz olmalıdır. name zorunludur. Bir varyantın option_name ve option_value’a ihtiyacı vardır; her ikisinin de boş olması bir seçenek belirtmediğimiz anlamına gelir. Tamamlandıklarında, product_key ile kombinasyonları tekrarlanamaz.

Dosya UTF-8 kodlaması, alanlar arasında virgül ve gösterilen sırayla sekiz sütun kullanır. price alanı, binlik ayırıcı olmadan nokta ve iki ondalık ile negatif olmayan sayıları kabul eder. currency alanında bu test için EUR talep ediyoruz. Bunlar bu test için seçilmiş koşullardır, evrensel kurallar veya ticari fiyatlar değildir. Para birimi dönüşümü veya vergi hesaplaması yapılmaz.

SKU’lar metin olarak korunur: 001, 1’e dönüşmez. Microsoft, Excel’e tanımlayıcıları yüklerken otomatik dönüşümleri nasıl önleyeceğinizi açıklar. Verileri dönüştürmeden önce sütun türünü tanımlayın; görünümünü sonradan değiştirmek orijinali yeniden oluşturmaz. Excel’de baştaki sıfırları koruma.

Doğru görünen bir satır da dahil, on satır

İncelemek için bloğu metin olarak kopyalayın. Son satırda bilerek bir alan eksik bırakılmıştır. row_id testin tanımlayıcısıdır; R01 dosyanın ikinci satırındadır, çünkü ilki başlıkları içerir.

İspanyolca ürün adları, sonuçların tekrarlanabilmesi için tüm dil sürümlerinde aynı bırakılan sabit örnek değerlerdir.

row_id,product_key,sku,name,option_name,option_value,price,currency
R01,P01,001,Taza,Color,Natural,19.90,EUR
R02,P01,002,Taza,Color,Ink,19.90,EUR
R03,P02,001,Bolsa,,,29.00,EUR
R04,P03,,Cuaderno,,,8.50,EUR
R05,P04,005,Café,,,6.00,EUR
R06,P05,006,Vaso,,,"12,50",EUR
R07,P06,007,Camiseta,Size,,24.00,EUR
R08,P01,008,Taza,Color,Natural,19.90,EUR
R09,P07,009,,,,15.00,EUR
R10,P08,010,Bandeja,,,25.00
SatırBeklenen sonuçAraştırılacaklar
R01Engelle: SKU ve varyant tekrarıR03 ve R08 ile karşılaştırın; bu satır da onaylanmaz.
R02Egzersiz kurallarını geçerKontrol satırı olarak saklayın; hedef sistemle uyumluluğu kanıtlamaz.
R03Engelle: SKU tekrarı001 ayrıca R01’deki kupayı da tanımlar.
R04Engelle: SKU eksikÜrün kodunu isteyin; adından türetmeyin.
R05Metni gözden geçirCafé metnini tedarikçinin orijinaliyle karşılaştırın.
R06Engelle: fiyat formatıOndalık virgül, seçilen kurala aykırı.
R07Engelle: eksik varyantDeğeri olmayan Size mevcut.
R08Engelle: varyant tekrarıP01 + Color + Natural, SKU değişse bile R01’de zaten görünüyor.
R09Engelle: isim eksikDevam etmeden önce ürünü belirleyin.
R10Engelle: eksik yapıYedi alan var; para birimi sütunu da bekleniyordu.

Sonuç sekiz engellenen satır, bir gözden geçirme bekleyen ve bir geçen şeklindedir. Bunlar satır durumlarıdır, sekiz bağımsız hata değil: R01’in iki çakışması var. Her sonucu, satırlar arasındaki anahtarları ve alanları önceki kurallarla karşılaştırarak kontrol edebilirsiniz.

Yinelenen kayıt sorunu ilk satırı seçerek çözülmez

R01 tek başına okunduğunda tam gibi görünür. Çakışma, tüm küme taranırken ortaya çıkar: bir çanta ile SKU’yu ve başka bir kupa ile varyant kombinasyonunu paylaşır. Bu nedenle kontrol, grubun tüm üyelerini işaretlemeli, ilkini onaylayıp sonuncuyu reddetmemelidir.

Kataloğu yönetenden hatalı bir ürün kodu, yinelenen bir ürün veya kötü tanımlanmış bir varyant olup olmadığını onaylamasını isteyin. Kararı eski değer, yeni değer ve nedeni ile birlikte saklayın. R08’i sadece adı eşleştiği için silmeyin; gerçek bir katalog, bu basitleştirilmiş sayfada bulunmayan malzeme, boyut veya diğer seçenekleri ayırt edebilir.

Gerçek partiniz için, hedefte zaten mevcut olan ürün kodlarıyla da karşılaştırın. CSV içindeki benzersiz bir SKU, dosya dışındaki başka bir ürünle hala eşleşebilir. Ayrıca normalleştirmeden önce boşlukları ve büyük/küçük harf farklılıklarını nasıl ele alacağınızı tanımlayın: bir tanımlayıcıyı temizlemek, ayrı kalması gereken ürün kodlarını birleştirebilir.

Formatı, metni ve anlamı ayırın

R06 "12,50" içeriyor: tırnak işaretleri fiyatı tek bir hücrede tutar. Virgülleri elle saymak yanlış bir teşhis verir; bir CSV okuyucu kullanın. RFC 4180 bu tırnak işareti kuralını açıklar, ancak bir kataloğun hangi sütunlara ihtiyacı olduğunu veya bir fiyatı nasıl yorumlayacağını tanımlamaz. R06’nın CSV sözdizimi geçerlidir; ancak değer, alan için belirlediğimiz kurala uymaz.

Dosya genelindeki tüm virgülleri noktalarla değiştirmeyin: hem ayırıcıları hem de içeriği değiştirirsiniz. Öncelikle alanı tanımlayın, kaynak formatını onaylayın ve değerini kontrollü bir şekilde dönüştürün. Boş bir değer sıfıra eşit değildir; sıfır fiyat kaydetmek, kimsenin onaylamadığı ticari bir karar olurdu.

R05 başka bir kontrol gerektirir. Café metni geçerli UTF-8 baytları ile kaydedilmiştir; bu, ismin doğru olduğunu kanıtlamaz. Bu alıştırmadaki uyarı, bu belirli değer için hazırlanmıştır, evrensel bir kodlama dedektörü değildir. Adı kaynakla karşılaştırın ve hangi adımda bozulduğunu gözden geçirin. Zaten bozuk olan metni tekrar UTF-8 olarak kaydetmek, karakterlerini otomatik olarak geri getirmez.

Güncellemeden önce, nelerin korunacağını kontrol edin

Eksik bir sütun ve boş bir hücre farklı değişikliklere neden olabilir. Shopify, üzerine yazma sırasında boş bırakılan isteğe bağlı bir alanın mevcut alanı boşaltabileceğini; sütununu atlamanın ise onu koruyabileceğini belgelemektedir. Ayrıca başlatılan bir içe aktarmanın iptal edilemeyeceği konusunda uyarır ve önceden bir kopya alınmasını önerir. Shopify içe aktarma koşulları.

Bir varyantın kimliği de değişebilir: Shopify, seçenek değerlerini değiştirmenin önceki tanımlayıcılarını kaldırdığını ve yenilerini oluşturduğunu uyarır. Bir seçeneği CSV aracılığıyla düzeltmeden önce onlara bağlı bağlantıları gözden geçirin. Varyant seçenekleri ve tanımlayıcıları.

Önceki durum, beklenen değişiklik ve gözlemlenen sonuç arasında bir karşılaştırma hazırlayın. Aynı kalması gereken alanları dahil edin. Mevcut bir test ortamında deneme yapın ve bir ürünün ilgili satırlarını bir arada tutun; on ardışık satır her zaman on tam ürünü temsil etmez.

Gerçek bir işlemde, farklı durumlar seçersiniz: basit ürün, çeşitli seçenekler, aksanlı karakterler, boş fiyat ve mevcut bir ürün kodunun güncellenmesi. Bu örnek, süreci test eder. Ardından kuralları tüm dosyaya uygulayın: kopyalar binlerce satırla ayrılmış olabilir. Akışınızdaki araçları belirlemek için entegrasyonları kontrol edin ve her birinin veri gereksinimlerini doğrulayın.

Başka birinin gözden geçirebileceği bir karar bırakın

Yüklemeden önce, dosya sürümünü, hedefi, sorumluyu, uygulanan kuralları, çözülen sorunları ve deneme karşılaştırmasını not edin. Bir onay eksikse, partiyi beklemede tutun; bir «içe aktarıldı» mesajı bu incelemenin yerini tutmaz.

Frihet, yönetim özellikleri kapsamında ürünlerin CSV ile içe aktarılmasına izin verir. Bu makaledeki şema ve elle yapılan kontroller Frihet’ten bağımsızdır: Frihet’in hangi alanları kabul ettiğini veya hangi otomatik kontrolleri yaptığını kanıtlamaz. İçe aktarıcınızın şablonunu kullanın ve henüz açıklayamadığınız satırları çözerek başlayın.

Paylaş

Bu makale faydalı oldu mu?

Sıkça sorulan sorular

Bu kontroller içe aktarma aracının kurallarının yerini alır mı?

Hayır: şema ve elle yapılan kontroller bağımsız bir alıştırmadır. Hedef sistemin güncel şablonunu kullanın ve oluşturma, güncelleme ve boş alan kurallarını doğrulayın.

On satırı doğrulamak kataloğun geri kalanının doğru olduğunu garanti eder mi?

Hayır. Örnek, iş akışını denemek içindir; ardından kuralları tüm dosyaya uygulayın ve hedefteki mevcut referanslarla karşılaştırın, çünkü örneğin dışında da yinelenen kayıtlar bulunabilir.

Frihet — Dramasız yönetim

Ücretsiz Başla