Import Mapped Excel Aksiyonunu Ekleyin

1. Kuika platformuna giriş yapın.
2. Apps ekranından çalışacağınız projeyi seçin.
3. UI Design modülüne geçin.

4. Sol paneldeki Elements bölümünden bir Button ekleyin.

5. + ADD ACTION menüsünden istediğiniz tetikleyici olaya (Initial Actions, OnClick, OnBlur vb.) göre Export > Import Mapped Excel aksiyonunu ekleyin.

6. Aksiyonun sağında çıkan üç nokta butonuna tıklayın → Edit Import Action seçeneğini seçin.
   
   

Aksiyon Yapılandırma Adımları

1. Veritabanı Seçimi

• Managed DB alanından hedef tabloyu seçin.

2. Birincil Anahtar Tanımı

• Primary Key: Güncelleme yapılacaksa benzersiz bir sütun (örneğin: user_id) seçilmelidir.

3. Sütun Eşleme

• Tablo sütunlarının karşısında, Excel'deki hangi sütunun eşleşeceğini belirtin.
• Alias: Excel dosyasındaki karşılık gelen sütun adı (kolay okuma için takma ad).
• Required: Boş geçilememesi gereken sütunlar için bu kutu işaretlenir.
• Hide: Kullanıcının görmemesi veya güncellememesi gereken sütunlar devre dışı bırakılır.
• Foreign Key: Eğer sütun başka bir tabloyla ilişkiliyse, mantıksal eşleştirme yapılabilir.

4. Önizleme

• Sağ üstte yer alan Preview butonuna tıklayın → butona tıklayarak Excel yükleme modal ekranını başlatın.

 Excel Dosyasını Yükleme ve Eşleme

1. Upload Excel File seçeneğine tıklayın.
2. Excel dosyasını yükleyin.

3. Eğer dosya birden fazla sayfa içeriyorsa, uygun sayfayı seçin.
4. Excel sütunlarını sistem sütunlarıyla eşleştirin.
5. Boş bırakılan hücreler için varsayılan değer tanımlayın.

6. NEXT butonuna tıklayarak verilerin içe aktarılmasını başlatın.

Verilerin İçe Aktarılamaması Durumu

• Veriler kısmen eklenmiş/güncellenmiş ve bazıları başarısız olmuşsa, ekranda ilgili hata mesajları görüntülenir.

• Seçtiğiniz birincil anahtar ile satırların Unique olduğundan emin olun.
  
  • Benzersiz değilse, birden fazla satır güncellenecektir.

Önemli Notlar:

• Excel dosyasında birleşik hücreler veya formüller bulunmamalıdır.
• Yüklediğiniz Excel dosya formatı, Excel 2007 veya daha yeni bir sürüm olmalıdır.

Bu adımları takip ederek Kuika platformunda Import Mapped Excel aksiyonunu başarıyla yapılandırabilirsiniz.

Bir satış temsilcisi, Excel dosyasında tuttuğu müşteri listesini uygulamanın Customer tablosuna aktarmak istiyor.

Yapılandırma:

• Element: “Müşteri Listesini Aktar” butonu
• Tetikleyici: OnClick
• Aksiyon: Export → Import Mapped Excel
• Veritabanı Tablosu: Customer
• Primary Key: email
• Alias ve eşleşmeler:
  
  • Excel sütunu "Ad" → first_name
  • Excel sütunu "Soyad" → last_name
  • Excel sütunu "Mail" → email (Primary Key)
  • Excel sütunu "Telefon" → phone_number

• Koşullu Sütun Eşleme: Role göre farklı eşleme tabloları tanımlayarak her kullanıcıya özel aktarım senaryoları oluşturabilirsiniz.
• Dinamik Varsayılanlar: Excel’de boş bırakılan sütunlar için sistem tarihini veya giriş yapan kullanıcı adını varsayılan değer olarak tanımlayabilirsiniz.
• Loglama ve Hata Takibi: Başarısız aktarımlar loglanarak kullanıcıya neden aktarım yapılamadığı bildirilebilir.
• Kısıtlı İzin: Excel yükleme ekranı sadece Admin yetkisine sahip kullanıcılar tarafından erişilebilir olacak şekilde sınırlandırılabilir.

Teknik Riskler ve Kontroller

• Birincil Anahtar Çakışması: Aynı birincil anahtara sahip birden fazla satır varsa, sistem güncelleme yerine çoğaltma yapabilir.
• Boş Zorunlu Alanlar: Required olarak işaretlenen alanların boş bırakılması aktarımı engeller.
• Uygunsuz Dosya Formatı: .xls gibi eski formatlar yerine .xlsx dosya uzantısı kullanılmalıdır.
• Birleşik Hücre veya Formül Kullanımı: Excel’de birleştirilmiş hücreler veya formül içeren hücreler aktarımda sorun yaratabilir.
• Veri Uyuşmazlığı: Metin girilmesi gereken alana sayı girilmesi gibi durumlar hata oluşturur.

Import Mapped Excel, Kuika platformunda veritabanına Excel tabanlı veri aktarımını kullanıcı dostu arayüzle kolaylaştırır. Bu aksiyon sayesinde, dış sistemlerden gelen verileri hızlıca içeri alabilir, eşleme ayarlarını yapabilir ve veri uyumsuzluklarını kolayca tespit edebilirsiniz. Gelişmiş kontrol ve hata yönetimi özellikleriyle güçlü bir veri yönetimi çözümü sunar.