Import Mapped Excel aksiyonu, kullanıcıların bir Excel dosyasını doğrudan mevcut bir veritabanı tablosuna aktarmasını sağlar. Bu işlem sırasında Excel sütunları, uygulamanızdaki tablo sütunlarıyla eşleştirilerek veri uyumu sağlanır. Böylece tabloların yapısını önceden bilmeden veya manuel müdahale olmadan kolayca veri aktarımı yapılabilir.

Teknik Özellikler

Veri Eşleme: Excel sütunları ile veritabanı sütunları manuel olarak eşleştirilebilir.
Dinamik Yönlendirme: Hangi veritabanı tablosuna aktarım yapılacağı sistem üzerinden seçilebilir.
Güncelleme ve Ekleme: Birincil anahtarlar üzerinden veriler güncellenebilir ya da eklenebilir.
Boşluk ve Varsayılan Kontroller: Boş geçilemeyen alanlar ve varsayılan değerler tanımlanabilir.
Yabancı Anahtar Destekleri: Foreign key tanımları üzerinden bağlantılı veri kontrolü yapılabilir.

Import Excel Excel Aksiyonu Uygulama Adımları

Import Mapped Excel Aksiyonunu Ekleyin

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

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

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

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

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

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

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.

Kullanım Senaryosu: Müşteri Listesi Aktarımı

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

Import Mapped Excel Aksiyonu İleri Seviye Özelleştirmeler

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.