Report Designer modülünde oluşturulan raporlar, yalnızca tasarım aşamasıyla sınırlı değildir. Bu raporlar uygulama içerisinde:

• Parametre ile dinamik üretilebilir,
• Base64 formatında alınabilir,
• Kullanıcının cihazına indirilebilir,
• Dış sistemlere aktarılabilir.

Bu süreç iki temel aksiyon üzerinden yönetilir:

• Get Report Base64
• Download Report

Bu aksiyonlar genellikle birlikte kullanılır.

1. Get Report Base64 Aksiyonu

Get Report Base64 aksiyonu, Report Designer’da oluşturulmuş bir raporu Base64 formatında üretir.

Bu aksiyon:

• Raporu çalıştırır,
• Varsa Report Inputs parametrelerini alır,
• Raporu oluşturur,
• Sonucu Base64 string olarak döndürür.

Bu çıktı genellikle:

• Download Report aksiyonuna aktarılır,
• API çağrılarında kullanılır,
• E-posta ekinde gönderilir,

Teknik Özellikler

• Rapor çıktısı Base64 formatındadır.
• Web ve mobil uygulamalarda çalışır.
• Parametrik rapor üretimini destekler.
• Büyük raporlarda çıktı boyutu artabilir.

Get Report Base64:

• Raporun gerçek anlamda “çalıştırıldığı” noktadır.
• Data Source bağlantısı burada tetiklenir.
• Report Inputs burada değer alır.
• Dataset burada sorgulanır.
• PDF çıktısı burada üretilir.

Yani bu aksiyon, tasarım ile çıktı arasında köprüdür.

2. Download Report Aksiyonu

Download Report aksiyonu, Get Report Base64 tarafından üretilen Base64 çıktıyı kullanıcı cihazına indirilebilir dosya haline getirir.

Önemli:

• Base64 formatında doğrudan indirme yapılamaz.
• Önce Get Report Base64 çalıştırılmalıdır.

Teknik Özellikler

• Yalnızca web uygulamalarda çalışır.
• Base64 parametresi zorunludur.

• UI elementlerine kolayca bağlanabilir.
• Cihaz üzerinde yerel dosya olarak kaydedilir.

3. Report Designer İçinde Çalışma Zinciri

Bu iki aksiyon genellikle şu sırayla kullanılır:

Kullanıcı → Buton → Get Report Base64 → Download Report → Cihaz

Detaylı akış:

1. Kullanıcı “Raporu İndir” butonuna tıklar.
2. Get Report Base64 aksiyonu çalışır.
3. Rapor:
   
   • Data Source’a bağlanır.
   • Dataset sorgusunu çalıştırır.
   • Report Inputs parametrelerini kullanır.
4. PDF Base64 formatında üretilir.
5. Download Report aksiyonu bu Base64 veriyi alır.
6. Dosya kullanıcı cihazına indirilir.

4. Report Designer Bağlamında Mimari Önemi

Bu aksiyonlar sayesinde:

• Rapor tasarımı ile veri üretimi ayrışır.
• Raporlar tekrar kullanılabilir hale gelir.
• Parametrik rapor üretimi sağlanır.
• UI tarafı ile rapor motoru arasında net bir akış oluşur.

Report Designer mimarisi şu katmanlardan oluşur:

1. Tasarım (Layout)
2. Data Source (Veri)
3. Report Inputs (Parametre)
4. Get Report Base64 (Çalıştırma)
5. Download Report (Dağıtım)

5. En İyi Uygulama (Best Practice)

• Önce raporu tasarlayın.
• Data Source bağlantısını test edin.
• Report Inputs gerekiyorsa tanımlayın.
• Get Report Base64 ile çıktıyı doğrulayın.
• Son adımda Download Report ekleyin.

Aksiyonları aynı OnClick zincirinde sırayla konumlandırın.