Import Excel Base64 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. Sağ kenardaki Properties panelini açın.

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

Parametre Tanımları

Zorunlu Parametreler

• Excel Base64 (String): Excel dosyasının Base64 kodlanmış halidir. Bu veri, doğrudan dosya yükleme sonrası elde edilen içeriktir. Genellikle Action Result, Current, Form Component, Screen Input ya da Fixed gibi veri kaynakları kullanılarak tanımlanır ve Symbol Picker aracılığıyla bağlanabilir.

Opsiyonel Parametreler

• Table Name (String): Oluşturulacak tablonun adını manuel olarak belirtmek için kullanılır. Belirtilmezse Excel worksheet adı kullanılır.
• Primary Key Name (String): Tabloda tanımlanacak birincil anahtar sütununun adıdır. Eğer tanımlanmazsa sistem tarafından otomatik olarak bir sütun oluşturulur (genellikle id).

1. Design Panel üzerinde sayfanıza bir Button elementi ekleyin.
   
   • Bu buton, dosya yükleme ve import işlemini başlatmak için kullanılacaktır.
   • Örneğin, buton etiketini “Import Excel Base64” olarak belirleyebilirsiniz.

2. Buton seçiliyken, Actions alanından bir Upload File aksiyonu ekleyin.

3. Ardından aynı butona bir Import Excel Base64 aksiyonu ekleyin.
4. Import Excel Base64 aksiyonu ayarlarında, Symbol Picker üzerinden şu yolu izleyin: ActionResults → UploadFile → Data
5. İşlemi Run (Çalıştır) butonuna tıklayarak başlatın.

Bu adımlar tamamlandığında, Upload File ve Import Excel Base64 aksiyonları birlikte çalışarak, seçtiğiniz Excel dosyasını Base64 formatına dönüştürür ve sisteme yükler.

İşlem sonunda, yüklediğiniz dosyanın Base64 formatındaki verisi, örnek Excel dosyasında ve Kuika datasource (örnek: KitapList) ekranında olduğu gibi görüntülenecektir.

• Dinamik Tablo İsmi Tanımlama: Table Name alanını, kullanıcıya bağlı olarak dinamik şekilde belirleyebilirsiniz. Örneğin, currentUser.username + "Import" şeklinde bir isimlendirme yapılabilir.
• Form Tabanlı Dosya Yükleme: File Upload komponenti ile kullanıcıdan Excel dosyası alıp, dosyanın Base64 çıktısını aksiyona bağlayarak anlık veri içe aktarımı yapılabilir.
• Aksiyon Zincirleme:
  Bu aksiyonu tamamladıktan sonra:
  
  • Navigate ile aktarılan tabloyu gösteren bir liste sayfasına yönlendirme yapılabilir.
  • Run SQL Query ile aktarılan veriler üzerinde anında işlem yapılabilir.

Teknik Riskler ve Kontroller

• Geçersiz Base64: Kodlamada hata varsa içe aktarma başarısız olur. Base64 çıktısı mutlaka geçerli bir Excel dosyasına ait olmalıdır.
• Tablo Adı Çakışması: Aynı isimde daha önce oluşturulmuş bir tablo varsa yeni tablo oluşturulamayabilir. Benzersiz isimlendirme yapılmalıdır.
• Büyük Boyutlu Dosyalar: Excel dosyası çok büyükse işlem süresi artabilir. Gerekirse Excel küçültülerek parçalı aktarım yapılmalıdır.
• Yetersiz Yetki: Aksiyonun çalıştığı kullanıcı, tablo oluşturma yetkisine sahip olmalıdır.

Import Excel Base64 aksiyonu, veri içe aktarma süreçlerini otomatize ederek kullanıcıdan alınan dosyaların doğrudan Kuika tabanlı sistemde kullanılmasını sağlar. Özellikle dış sistemlerden gelen liste, envanter, rapor gibi yapıların hızlıca uygulamaya entegre edilmesi için ideal bir çözümdür. Tablo oluşturma, veri kayıt işlemleri ve entegrasyon süreçlerinde büyük kolaylık sağlar.