Import Excel Base64, bir Excel dosyasının Base64 formatında sisteme aktarılmasını ve bu verilerin veritabanı tabloları olarak oluşturulmasını sağlar. Excel dosyasındaki her bir çalışma sayfası, ayrı bir tablo olarak içe aktarılır. Sayfa adları, oluşturulacak tabloların adı olarak kullanılır.

Teknik Özellikler

Excel'den Tabloya Dönüşüm: Base64 formatındaki Excel dosyası doğrudan tablolar haline dönüştürülür.
Sayfa Adı = Tablo Adı: Excel'deki her sayfa, Kuika'daki yeni bir tabloya dönüştürülür. Sayfa isimleri, tablo adı olarak kullanılır.
Dinamik Tablo Oluşturma: Her aktarılan sayfa, veritabanında dinamik olarak yapılandırılır.
Birincil Anahtar Tanımı: İstenirse, tabloya özel Primary Key tanımlanabilir.
Web ve Mobil Uyumluluk: Yalnızca web uygulamalarda kullanılabilir.

Import Excel Base64 Aksiyonu Uygulama Adımları

Import Excel Base64 Aksiyonunu Ekleyin

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

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

Kullanım Senaryosu: Excel Dosyasını Uygulama Tablolarına Aktarma

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.

Import Excel Base64 Aksiyonu İleri Seviye Özelleştirmeler

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.