Get Excel Base64 aksiyonu, Kuika platformunda belirli tablo verilerini Excel dosyasına dönüştürüp bu dosyayı Base64 formatında elde etmek için kullanılır. Özellikle SQL SELECT sorgusu ile elde edilen verilerin dışa aktarım süreçlerinde önemli rol oynar. Bu aksiyon yalnızca web uygulamaları için geçerlidir.
Teknik Özellikler
Excel Dönüştürme: SQL veya tablo kaynaklı verileri Excel dosyasına dönüştürür.
Base64 Kodlama: Oluşturulan Excel dosyasını Base64 formatına çevirir.
Başlık ve Altbilgi Özelleştirme: Excel dosyasının üst ve alt kısımlarına dinamik bilgi eklenebilir.
Web Uygulama Desteği: Aksiyon yalnızca web ortamında çalışır.
Get Excel Base64 Aksiyonu Uygulama Adımları
Get Excel Base64 Aksiyonunun Projeye Eklenmesi
Kuika’da projenizi açın.
UI Design modülünde ilgili ekranı açın.
Aksiyon eklenecek bileşeni seçin (örneğin bir buton).
Sağ panelde + ADD ACTION menüsünden bir tetikleyici (OnClick, Initial Actions vb.) seçin.
Export > Get Excel Base64 aksiyonunu ekleyin.
Get Excel Base64 Parametrelerini Yapılandırma
Value (String, zorunlu):
Excel’e dönüştürülecek veri setini belirtir (örneğin: data.tableData).
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.
Header (String, opsiyonel):
Dosyanın üst kısmına eklenecek başlık metni (örneğin: "Satış Raporu").
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.
Footer (String, opsiyonel):
Alt kısımda gösterilecek açıklama veya bilgi (örneğin: "Bu belge sistem tarafından otomatik oluşturulmuştur.").
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.
Kayıt İşlemini Tamamlama
Parametrelerinizi yapılandırdıktan sonra, değişikliklerinizi kaydetmek için SAVE butonuna tıklayın. Bu adım, Get Excel Base64 aksiyonunun başarıyla eklenmesini sağlar.
Kullanım Senaryosu: Tablo Verilerinin Excel Formatında İndirilmesi
Bir yönetici, uygulama içerisinde belirli bir SQL sorgusu sonucunda oluşan tabloyu Excel formatında dışa aktarmak ister. Ancak bu işlem doğrudan bir indirme değil; önce veriler Base64 formatına dönüştürülüp daha sonra başka bir işlemde (örneğin indirme, e-posta ile gönderme, sunucuya kaydetme) kullanılacaktır. Bu dönüşüm için Get Excel Base64 aksiyonu devreye girer.
Get Excel Base64 Aksiyonu İleri Seviye Özelleştirmeler
Dinamik Başlık & Altbilgi: Tarih, kullanıcı adı, rapor numarası gibi bilgilerle başlık ve açıklamaları dinamik hale getirin.
Veri Formatlama: Tarih ve sayısal değerler için özel biçimlendirme uygulayarak daha okunabilir raporlar oluşturun.
Veri Sıkıştırma: Büyük veri setlerini Base64 formatına çevirmeden önce filtreleyin veya bölün.
Entegrasyon Potansiyeli: Oluşan Base64 veriyi:
Download File aksiyonu ile indirin,
Send Email aksiyonu ile e-posta gönderimine ekleyin,
API aracılığıyla başka sistemlere gönderin.
Teknik Riskler ve Kontroller
Veri Boyutu: Büyük dosyalar Base64 formatında şişebilir. Gerekirse sıkıştırma uygulanmalıdır.
Geçersiz Tablo: Value parametresi geçerli veri formatı içermelidir. Eksik veri sorun yaratabilir.
Formatlama Sorunları: Header ve Footer metinleri kısa, temiz ve özel karakter içermeyen biçimde yapılandırılmalıdır.
Get Excel Base64 aksiyonu, verilerinizi Excel formatına dönüştürüp kodlanmış halde elde etmenizi sağlar. Bu sayede indirme, paylaşma, e-posta gönderimi veya sunucuya veri aktarımı gibi işlemler güvenli ve kontrollü şekilde gerçekleştirilebilir. Özellikle büyük raporlamalarda ve entegrasyon senaryolarında güçlü bir aksiyondur.
