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).

Bir yönetici, sistem dışında hazırladığı kullanıcı listesini içeren bir Excel dosyasını uygulama veritabanına aktarmak istiyor. Bu dosya Base64 formatında sisteme iletiliyor ve her sayfa bir tabloya dönüşüyor.

Yapılandırma:

• Element: “Import from Excel” butonu
• Tetikleyici: OnClick
• Aksiyon: Export → Import Excel Base64
• Parametreler:
  
  • Excel Base64: uploadFile.base64
  • Table Name: "UserList"
  • Primary Key Name: "userId"

Bu yapılandırma ile dış sistemden gelen Excel dosyasındaki veriler, uygulama içerisinde kullanılabilecek bir tabloya dönüştürülür.

• 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.