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 uygulamalarda ç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 elementi 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.
- 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 Aksiyonunu Ekleme

Kuika platformuna giriş yapın.
Apps ekranından çalışacağınız projeyi açın.

UI Design modülüne geçin.
Sağ kenardaki Properties panelini açın.
Aksiyon eklemek istediğiniz bileşeni (örneğin “Excel’e Aktar” butonu) seçin.
+ ADD ACTION → Onclick → Export → Get Excel Base64 adımlarını takip edin.

Get Excel Base64 Aksiyon Parametrelerini Yapılandırma

Açılan aksiyon penceresinde aşağıdaki alanları doldurun:

Value: Excel’e dönüştürülmek istenen tablo verisini belirtir (genellikle bir SQL sorgusu sonucu elde edilen veri).
Header: "Satış Raporu" → Excel dosyasının baş kısmında görüntülenecek başlık.
Footer: "Bu belge sistem tarafından otomatik oluşturulmuştur." → Excel belgesinin alt kısmına eklenecek açıklama.

Ayarları yaptıktan sonra SAVE butonuna tıklayarak işlemi tamamlayın.

Aksiyon Sonrası Kullanım

Bu aksiyon çalıştıktan sonra, Get Excel Base64 size Base64 formatında bir Excel dosyası üretir.
Bu veriyi:
- Download File aksiyonuna göndererek kullanıcıya indirtebilir,
- Send Email aksiyonu ile mail olarak gönderebilir,
- Farklı uygulamalara servis edebilirsiniz.

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.