CSV aktarma sütun eşleme UI desenleri: alan eşleme, varsayılanlar, önizleme ve veriler kaydedilmeden önce hata düzeltme adımlarıyla kullanıcıların hatalarını azaltın.
Çoğu kişi bir CSV aktarımına tek bir basit umutla başlar: “Tablom uygulamaya girsin yeter.” Sonra ilk ekran anlamadıkları kararlar ister ve aktarım sebepsizce başarısız olur gibi görünür.
CSV dosyaları genelde göründüğünden daha dağınıktır. Başlıklar eksik olabilir, uygulamanızdaki alan adlarından farklı yazılmış olabilir veya çoğaltılmış olabilir ("Email", "email", "Email Address"). Tarihler tuhaf formatlarda gelebilir, telefon numaralarındaki baştaki sıfırlar kaybolabilir ve adres içindeki virgüller sütunları bozabilir. Hatta "temiz" dışa aktarımlar notlar, dahili kimlikler veya boş sonda gelen sütunlar gibi ekstra sütunlar içerebilir.
Korku gerçektir: Yanlış tahmin ederseniz, iyi veriler üzerine yazılır mı, yüzlerce bozuk kayıt mı oluşur yoksa sistem genelinde çöp mü dağılır? İyi bir CSV aktarma sütun eşleme arayüzü bu kaygıyı ortadan kaldırır: hiçbir şey yazılmadan önce ne olacağını gösterir.
"Eşleme" sadece karşılaştırma demektir. Yani: CSV'deki bu sütun uygulamanızdaki şu alana gider. Örneğin CSV sütunu "Company" alanı "Account name" ile eşlenir ve "Start Date" ise "Customer since" ile. Kuramda basit, ama isimler uyuşmadığında kolayca karışır.
Daha güvenli bir aktarım net beklentiler koyar ve öngörülebilir bir sıra izler:
Kullanıcılar bu sırayı anladığında, aktarımlar tuzak gibi hissettirmeyi bırakır. Rehberli bir kontrol listesi olur: eşlemeleri yapın, boşlukları doldurun, gördüğünüz hataları düzeltin ve güvenle aktarın.
Bir CSV aktarma sütun eşleme arayüzünün tek işi: hiçbir şey kaydedilmeden önce ne olacağını açıkça göstermek. Kullanıcıların yeni kayıt mı oluşturduğunuzu, mevcut kayıtları mı güncellediğinizi veya satırları mı atladığınızı tahmin etmesi gerekmez.
Ekran şu soruları net cevaplamalı:
Gerekli alanların özel bir işleyişi olmalı. Onları üstte gösterin, gerekli olarak işaretleyin ve her gerekli alan eşlenene ya da açık bir varsayılan verilene kadar kullanıcıyı eşlemeyi bitirmekten alıkoyun. İsteğe bağlı alanlar eşlenmeden bırakılabilir, ama UI yine de kullanıcının hangi alanları görmezden geldiğini söylemeli.
İnsanlar ayrıca formül yazmadan temel temizlik bekler. Eşlemenin yapıldığı yerde basit dönüşümler sunun: ekstra boşlukları kırpma, sayı formatlarını dönüştürme ve tarih formatı seçme gibi. Örneğin CSV'de " New York " varsa, bir kırpma seçeneği önizlemede bunun "New York" olacağını göstermelidir.
Her sorun aktarmayı durdurmamalı. Sorunları bloklar ve uyarılar olarak ayırın ve farkı sade sözlerle açıklayın.
Bu temel doğru yapılırsa, aktarma akışı daha sakin olur: kullanıcılar kontrolün kendilerinde olduğunu hisseder ve "neden yanlış aktardı?" destek talepleri azalır.
İyi bir CSV aktarma sütun eşleme arayüzü yardımcı bir asistan gibi hissettirmeli, bir bulmaca gibi değil. İlk satırı başlık olarak okuyup hemen önerilen eşlemeleri sunarak başlayın. Basit sinyaller kullanın: isim benzerliği ("email" -> "Email") ve küçük bir eşanlamlılar listesi ("Phone" vs "Mobile", "Zip" vs "Postal code", "Company" vs "Organization").
Öneriler sakin ve net olduğunda en iyi işe yarar. Eşlemeleri kesin, muhtemel veya belirsiz olarak işaretleyin. İpucunu küçük tutun (küçük bir etiket veya ikon), böylece kullanıcılar hızlıca tarayabilir ve rahatsız edilmezler.
Kullanıcılara her şeyi kolayca geçersiz kılma yolu verin. Bir açılır liste yeterli, ama arama kutusu ekleyin ki kullanıcı "status" yazıp doğru alanı saniyeler içinde seçebilsin. Ürününüzde çok sayıda alan varsa, bunları gruplandırın (İletişim, Adres, Faturalama) böylece liste bunaltıcı olmaz.
Kasıtlı olmayan hatalı aktarımları önlemek için çatışmaların oluşmasını zorlaştırın:
Küçük bir örnek: kullanıcı bir tabloda "Mobile" ve "Phone" sütunlarını getirir. Eğer ikisi de aynı "Phone" alanına eşlenirse, UI bunu durdurmalı, birinin diğerini üzerine yazacağını açıklamalı ve alternatifler önermeli (birini "Mobile"e, diğerini "Phone" olarak eşle veya birini yok say).
AppMaster içinde bunu inşa ediyorsanız, eşleme adımını hızlı tutun: otomatik öner, kullanıcıların arama yapmasına izin ver ve çakışan seçimleri engelle. Çoğu aktarma sorunu tam olarak buradan başlar, bu yüzden ne kadar az sürpriz bırakırsanız o kadar temiz veri elde edersiniz.
Bir sütun eşleme ekranı yalnızca alanları eşlememeli. Bir CSV hücresi boşsa ne yapılacağını da belirlemeli. Bunu atlarsanız, yarım kalmış kayıtlar veya daha kötüsü geçerli görünen ama yanlış verilerle karşılaşırsınız.
Her eşlenen alan için net bir "Boşsa ne yapılsın" seçeneği sunun. Bunun tahmin edilebilir ve aynı satır içinde görünür olmasını sağlayın, böylece insanlar tararken kaçırmaz.
Ekiplerin genellikle ihtiyaç duyduğu üç davranış şunlardır:
Varsayılanlar ekstra ayar gerektirmeden basit, yaygın durumları desteklemeli. Örnekler: status = Active, country = US, owner = current user, source = "CSV import". CSV aktarma sütun eşleme UI'sında bu varsayılanlar temiz bir ilk aktarım ile saatlerce temizlik arasındaki farktır.
Bir noktayı insanları yanıltmamak için netleştirmek gerekir: oluşturma (create) vs güncelleme (update). Eğer aktarma mevcut kayıtları güncelleyebiliyorsa (ör. email veya ID ile), varsayılanların nasıl davranacağı şu şekilde açık olmalı:
Pratik bir kural: "CSV'de boş" ile "alan hiç dahil edilmemiş" durumunu farklı ele alın. Bir kullanıcı alanı eşledi ve "Boş bırak" seçtiyse bu "temizle" anlamına gelebilir. Eğer alan hiç eşlenmemişse, genellikle "dokunma" demektir.
Son olarak, varsayılan değeri eşlenen alanın hemen yanında gösterin, gizli bir ayar ikonunun arkasında değil. Küçük bir satır içi etiket (ör. "Varsayılan: Active") ve kısa bir ipucu ("Sadece boş olduğunda kullanılır") sürprizleri önler ve destek taleplerini azaltır.
Önizleme, bir CSV aktarma sütun eşleme arayüzünün güven kazanma anıdır. Kullanıcılar herhangi bir şey kaydedilmeden önce ne olacağını görmeli ve sorunların anlaşılır ve düzeltilebilir olduğuna inanmalıdır.
Küçük, hızlı bir örnek önizleme ile başlayın (örneğin ilk 20-50 satır) artı tam dosya için basit bir sayım özeti. Özet, insanların gerçekten merak ettiği soruları cevaplamalı: kaç satır oluşturulacak veya güncellenecek, kaçında sorun var ve kaç satır atlanacak.
Hataları görsel ve spesifik yapın. Hangi hücrelerin başarısız olacağını vurgulayın ve hücrenin yanında veya yan panelde kısa bir sebep gösterin. Bir satırın birden fazla sorunu varsa ilkini açıkça gösterin ve kalanları görmek için genişletmeye izin verin.
Düz ve anlaşılır dille açıklanması gereken yaygın nedenler şunlardır:
Filtreleme büyük bir kullanım kolaylığı özelliğidir. "Sadece hatalı satırlar" gibi bir açma/kapama ve önizleme içinde çalışan bir arama kutusu ekleyin. Bu, kullanıcıların yüzlerce TAMAM satırını kaydırmak yerine düzeltmesi gerekenlere odaklanmasını sağlar.
Teknik ifadelerden kaçının. Kullanıcılar hiçbir zaman "Parse exception" veya "Constraint violation" görmemeli. Neyin yanlış olduğunu, nerede olduğunu (satır ve sütun) ve bir sonraki adımın ne olduğunu söyleyin. AppMaster'da bu tür bir önizleme özellikle yardımcıdır çünkü insanlar genellikle düz bir tabloya değil gerçek iş mantığı ve doğrulamalarına veri aktarıyor.
İyi bir CSV aktarma sütun eşleme arayüzü sadece sorunları işaretlemekle kalmamalı. İnsanlara aynı akış içinde hızlı, güvenli düzeltmeler yapma imkanı da vermeli.
Başlangıç olarak başarısız sütunun yanına satır içi düzeltmeler koyun. Sistem tarihleri ayrıştıramıyorsa kullanıcıya beklenen tarih formatını seçme (ör. MM/DD/YYYY vs DD/MM/YYYY) ve hemen önizlemeyi yeniden çalıştırma imkanı verin. Bir sütun "Yes/No" içeriyorsa ama alanınız true/false bekliyorsa basit bir dönüştürme anahtarı sunun.
Sabit değer kümesine sahip alanlar (status, state, plan) için değer eşleştirme en büyük zaman tasarrufu sağlar. Aktarım "NY" görür ama uygulamanız "New York" saklıyorsa, kullanıcı bir kez eşleyip tüm satırlara uygulayabilmeli. Aynı fikir büyük/küçük harf farklılıklarını ("active", "Active", "ACTIVE") tek bir izin verilen değere dönüştürmede de işe yarar.
Hızlı eylemler sık karışıklıkları hızlı temizler:
Bu eylemleri geri alınabilir yapın. Ne değişeceğini, kaç satırı etkilediğini gösterin ve Geri Al'a izin verin. Seçili sütun için küçük bir "önce/sonra" önizlemesi sürprizleri önler.
Uygulamada düzeltilemeyenleri açıkça söyleyin. Eğer bir sütun tamamen eksikse, satırlar kaçık çünkü kaçışsız virgüller var veya dosya ortasında başlıklar değişiyorsa en iyi çözüm CSV'yi düzenlemektir. Bunu açıkça söyleyin ve neyi değiştirileceğini açıklayın.
Basit bir örnek: 600 satırda "CA " gibi sondaki bir boşluk varsa, bir tıklama bunu temizlemeli ve doğrulamanın geçmesini sağlamalı.
İyi bir CSV aktarma sütun eşleme arayüzü işi birkaç küçük karara bölerek sakin hissettirir. Kullanıcılar her zaman bir sonraki adımı ve verilerine ne olacağını bilmelidir.
Yüklemeyle başlayın. Dosya seçilir seçilmez ayırıcıyı ve kodlamayı tespit edin, sonra küçük bir önizleme (başlıklar ve ilk bir iki satır) gösterin. İnsanlar burada sık karşılaşılan sorunları erken fark eder: örneğin tek bir sütun görünmesi yanlış ayırıcıdan, veya garip karakterler kodlama problemlerinden kaynaklanır.
Sonra aktarmanın nasıl davranacağını sorun. Bazı kullanıcılar tamamen yeni kayıt oluşturuyor, bazıları mevcutları güncelliyor, birçok kişi upsert istiyor. Eğer güncelleme veya upsert seçildiyse bir tanımlayıcı (örneğin email, dış ID veya sipariş numarası) zorunlu kılın ve tanımlayıcı sütunda boşlar veya çoğaltmalar varsa uyarı gösterin.
Sonra eşleme ve varsayılanlara geçin, sonra doğrulamayı çalıştırın. Kullanıcıların hangi CSV sütununun her alanı doldurduğunu, hangi alanların varsayılan kullanacağını ve hangilerinin boş kalacağını onaylamasına izin verin. Doğrulama hızlı ve spesifik olmalı; türleri, gerekli alanları, çoğaltmaları ve referans kurallarını kontrol etmelidir.
Basit bir akış şu şekilde görünür:
Hata inceleme adımında kullanıcıyı hareket halinde tutun. Hata tipine göre sayıları gösterin, sadece hatalı satırlara filtrelemeye izin verin ve bir sonraki adımı bariz yapın: yerinde düzelt, bir satırı yok say veya problemli satırları indirip düzenleyip tekrar yükle.
Son olarak net bir özet gösterin: kaç kayıt oluşturuldu, güncellendi, atlandı ve başarısız oldu; ayrıca hangi anahtarın eşleme için kullanıldığını gösterin. AppMaster gibi bir araçta bu özet arka ucun gerçekten yazdığıyla uyumlu olmalı, UI'nın umut ettiğinden değil.
Bir sütun-eşleme ekranı, kullanıcılar alanları eşleyip İçeri Aktar'a tıklayabildiğinde "tamamlandı" gibi hissedebilir. Gerçek sorunlar veri sisteme düştükten sonra ortaya çıkar: çoğaltmalar, sessiz değişimler ve kimsenin düzeltemediği hatalar.
Klasik bir tuzak, kullanıcıların eşsiz bir tanımlayıcı olmadan güncelleme tarzı aktarmayı çalıştırmasına izin vermektir. Eğer kullanıcılar Müşteri ID, Email veya başka bir garantili-tek alan eşleyemiyorsa, mevcut kayıtları güvenilir biçimde güncelleyemezler. Sonuç genelde geçerli görünen ama tekrar eden çoğaltılmış kayıtlar olur. Bir tanımlayıcı eksikse UI bunu açıkça söylemeli ve bir seçenek sunmalı: "Yeni kayıt olarak aktar" veya "Durdur ve bir ID ekle".
Bir diğer ince sorun da sessiz tür dönüştürme (type coercion). "00123" gibi bir değer gerçek bir kod olabilir, sayı değil. Aktarım bunu 123'e çevirirse baştaki sıfırlar kaybolur ve eşleşmeler bozulur. "Sayı gibi görünen" stringlere dikkat edin; özellikle posta kodları, SKU'lar ve hesap kodları gibi alanlarda. Türleri dönüştürmek gerekiyorsa, önizlemede önce/sonra gösterin.
Doğrulama iki zıt yönde başarısız olabilir. Çok katı olursa zararsız satırları engellersiniz (örneğin isteğe bağlı bir telefon numarası eksik), çok gevşek olursa çöp veriler oluşur (boş isimler, geçersiz e-postalar veya mantıksız tarihler). Daha iyi bir yaklaşım ayırmaktır:
Hata mesajları genelde işe yaramaz hale gelir çünkü tam hücreyi göstermiyorlar. Geri bildirimi her zaman belirli bir satır ve sütuna bağlayın ve orijinal değeri ekleyin. "Satır 42, Email: 'bob@' geçerli bir e-posta değil" "Geçersiz veri bulundu" demekten daha iyidir.
Son olarak, son onayı belirsiz yapmayın. Kullanıcılar ne olacağını görmek ister: kaç kayıt oluşturulacak, kaç güncellenecek ve kaç atlanacak. Güncellemeler varsa, hangi tanımlayıcı alanla eşleyeceğinizi gösterin ki kötü bir eşlemeyi yakalayıp gerçek verilerin üzerine yazmayı önleyebilsinler.
Birisi İçeri Aktar'a tıklamadan hemen önce tek bir basit soru sorar: "Verilerimi mahvedecek miyim?" İyi bir CSV aktarma sütun eşleme arayüzü bunu net, sıkıcı ama güven verici bir kontrol listesiyle yanıtlar.
Küçük, gerçek bir önizleme göstererek başlayın. 10–20 satırlık bir örnek çoğu insanın kaymış sütunlar, tuhaf tarih formatları veya ekstra boşluklar gibi açık sorunları fark etmesi için yeterlidir. Önizleme mevcut eşlemeyi yansıtmalı, ham CSV'yi değil, böylece kullanıcı tam olarak neyin yazılacağını görür.
Sonra gerekli alanları görünmez kılmayın. Eğer bir gerekli alan eşlenmemişse, karar vermeyi zorunlu kılın: eşle, varsayılan koy veya dur. Kullanıcıların eksik gerekli değerleri yalnızca başarısız bir aktarım sonrası keşfetmesine izin vermeyin.
Boş hücreler için sade bir kural verin. Boşların boş mu kalacağı, güncellemede mevcut değer mi koruyacağı veya varsayılan mı tetikleyeceği kullanıcılara söylenmeli. Eşleme satırında küçük bir metin "Boş = mevcut değeri koru" gibi birçok kötü aktarmayı önler.
Son olarak, kullanıcıların mükemmelliğe değil problemlere odaklanmasına izin verin. Sorun varsa sadece hatalı satırlara filtreleyen bir görünüm ve satırın yanında neden gösterin. Bu düzeltmeyi yönetilebilir kılar.
İşte son düğmenin üzerinde yerleştirebileceğiniz kısa bir ön-aktarma kontrol listesi:
AppMaster içinde bunu inşa ediyorsanız, bu kontrolleri arka ucunuz herhangi bir şey yazmadan önceki "son güvenlik ekranı" olarak değerlendirin. Burada kötü bir aktarmayı durdurmak, binlerce kaydı sonradan temizlemekten daha ucuzdur.
Bir destek sorumlusu müşteri listesini bir elektronik tablodan dışa aktarır ve basit bir CRM'e yüklemek ister. CSV sütunları: Name, Email, Phone, Status ve Signup Date.
CSV aktarma sütun eşleme ekranında şu şekilde eşlerler:
Birkaç sorun hemen görünür. Bazı satırlarda Email yok. Status değerleri tutarsız (Active, ACTIVE, actv). Signup Date karışık: bazı satırlar 2025-01-03 kullanıyor, bazıları 01/03/2025, bazıları 3 Jan 2025.
Kullanıcıyı tüm dosyayı önce düzeltmeye zorlamak yerine, eşleme adımı güvenli varsayılanlar ve kurallar koymalarına izin verir. Boş Status için yalnızca "Active" varsayılanını seçerler, ancak bu sütunda değer varsa değiştirmeyecek şekilde ayarlarlar. Signup Date için beklenen formatı seçerler (ör. YYYY-MM-DD) ve diğer formatları hata sayar.
Önizleme artık karar noktası olur. Şöyle gösterebilir:
Önizlemeden, kullanıcı tahmin yapmak zorunda kalmadan hızlıca sorunları düzeltir. "actv" değerini topluca "Active" olarak eşler ve beş hatalı tarihi yerinde düzeltir. Eksik emaillere gelince, bu satırları atlayabilir veya aktarımı durdurup ekipten doldurmalarını isteyebilir.
AppMaster gibi araçlar bu deneyimi doğal hissettirir; eşleme ekranını net doğrulama ve yazılmadan önce yansıtılan bir önizlemeyle eşleştirerek kullanıcı aktarma işlemini güvenerek yapar.
İlk sürümünüzü kontrollü bir deney gibi düşünün. Küçük bir test dosyasıyla (10-50 satır) başlatın ve tam akışı uçtan uca çalıştırın: eşleme, varsayılanlar, önizleme ve nihai yazma. Sonuçlar doğruysa, kullanıcılara eşlemeyi kaydetme izni verin; böylece bir sonraki aktarma daha hızlı ve tutarlı olur. Kaydedilmiş bir eşleme aynı zamanda güvenlik sağlar çünkü tek seferlik "yaratıcı" eşlemeleri azaltır.
CSV aktarma sütun eşleme arayüzünü doğal olarak ait olduğu yere koyun: veriyi yöneten bir yönetici paneline veya dahili bir araca. Örneğin bir destek sorumlusu müşterileri eklemek için ekstra izinlere veya ayrı bir sisteme ihtiyaç duymamalı. Sonuçların hemen doğrulanacağı liste görünümüne yakın tutun.
Aktarma bittikten sonra kısa, sade bir rapor gösterin ve bunu sonradan inceleme için erişilebilir tutun. Kullanıcılar ne olduğunu tahmin etmek zorunda kalmamalı.
İnsanları bunaltmadan hata ayıklamak için yeterli ayrıntıyı kaydedin. İyi bir aktarma sonrası özet şunları içerir:
AppMaster içinde bunu yapıyorsanız, veriyi Data Designer'da modelleyebilir, eşleme ve önizleme ekranlarını görsel UI oluşturucularla kurabilir ve Business Process içinde doğrulamayı zorunlu kılabilirsiniz. Bu ayrım "önizleme"yi güvenli, "aktarma"yı ise katı tutmayı kolaylaştırır.
Son olarak, başlatmadan önce bir koruma daha ekleyin: her ortamda bir test aktarmasını zorunlu kılın (önce staging, sonra production) ve aktarmaları bir rol veya iznin arkasında tutun. Bu özellik kullanışlı kalırken riskli olmaktan çıkar.
21 Oca 2026
8 dk
20 Oca 20268 dk
20 Oca 20268 dkÜcretsiz planla AppMaster ile denemeler yapın.
Hazır olduğunuzda uygun aboneliği seçebilirsiniz.
