Adım Adım Rapor Oluşturma

Yeni Rapor Açma ve İsimlendirme

Vispeahen ana sayfasında sol üst köşedeki "Yeni Rapor" butonuna tıklanır.

Report Designer ekranı açılır.

Ekranın üst kısmında rapora başlık verilir. Başlık alanına tıklanarak anlamlı bir isim yazılır (örneğin "Satış Performans Custom Report"). Başlık kalem ikonu (ikon 1) ile sonradan da değiştirilebilir. Kaydet butonuna (ikon 2) tıklandığında rapora özgün bir kimlik atanır ve tarayıcı URL'si güncellenir.

Veri Kaynağı Seçimi

Sol panelde mevcut bağlantılardan ilgili veri kaynağı seçilir. Seçili bağlantı yeşil renkle vurgulanır.

Yeni bağlantı eklemek için: "Yeni Bağlantı" butonuna tıklanır. Bağlantı türü seçilir (PostgreSQL, Oracle, SQL Server, MySQL ve platforma entegre diğer veritabanı motorları desteklenmektedir). Bağlantıya bir isim verilir; sunucu adresi, port, veritabanı adı, kullanıcı adı ve şifre girilir. "Test Bağlantısı" ile doğrulandıktan sonra kaydedilir.

Sorgu Adı ve SQL Yazma

Sekme adı şablonla eşleşmelidir: Orta paneldeki sekme adı (varsayılan "ornek_sorgu"), şablonda kullanılacak ana değişken adıyla birebir aynı olmalıdır. Satış örneğinde sekme adı "sale" olarak ayarlanmıştır; şablonda {{ sale|groupby(...) }}, {{ sale|sum(...) }} gibi ifadeler bu ismi kullanır. Sekme adı kalem ikonu ile değiştirilir.

Artı (+) butonu ile aynı rapora birden fazla sorgu sekmesi eklenebilir. Her sekme bağımsız bir değişken adı taşır ve şablonda ayrı ayrı erişilebilir. Bu, tek çıktıda farklı veri kümelerini birleştirmeye olanak tanır.

Parametre referansı: Sorguda parametreler :parametre_adi biçiminde yazılır. Tekli parametreler WHERE koşulunda = ile, çoklu parametreler IN ile kullanılır. Örneğin,

WHERE year = :yil AND month IN :ay AND product_category IN :urun_kategorisi

SQL tamamlandıktan sonra sağ üstteki kaydet ikonuna tıklanır.

Parametre Tanımlama

Sağ panelde "Yeni Parametre" butonuna tıklanarak yeni parametre formu açılır.

• Parametre İsmi: Küçük harfle başlamalı, yalnızca harf, rakam ve alt çizgi içerebilir (A-Z, 0-9, _). Türkçe karakter kullanılamaz. İsim, sorgudaki :parametre_adi ile birebir eşleşmelidir.

• Veri Tipi: Sayı (sayısal kolonlar) veya Metin (metin kolonlar). Yanlış veri tipi seçilirse dropdown listesi boş gelir.

• Giriş Tipi — Tekli seçim: Yalnızca bir değer seçilebilir. SQL sorgusunda = operatörü ile kullanılır. Örnek: WHERE year = :yil — yıl parametresi tekli seçim olduğundan = uygundur.

• Giriş Tipi — Çoklu seçim: Birden fazla değer seçilebilir. SQL sorgusunda IN operatörü ile kullanılır. Örnek: AND month IN :ay — ay parametresi çoklu seçim olduğundan IN uygundur. Çoklu parametreler Liste + Dinamik kombinasyonuyla tanımlanır.

• Parametre Değerleri: Dinamik modda, dropdown listesini doldurmak için bir SQL sorgusu yazılır. Örnek: select year from perakende_eticaret_data ORDER BY year desc

Kaydet tıklandıktan sonra parametre sağ panelde listelenir. Kalem ikonu ile düzenlenir, kırmızı çöp kutusu ikonu ile silinir. Çok sayıda parametre olduğunda "Ara" alanı hızlı filtreleme sağlar.

Şablon Yükleme

Üst araç çubuğunda dosya ikonuna tıklanır; "Rapor Şablonu" paneli açılır.

Şablon için bir isim girilir (örn. "Satış Performans Şablon").

Şablon formatı: Hazırlanan şablon Jinja (.xlsx) ya da JXLS (.xlsx) formatında olabilir. Her iki format da sisteme aynı yolla yüklenir.

"Dosya Seç" ile şablon dosyası seçilip yüklenir. Mevcut şablon varsa "Dosyayı Değiştir" ile güncellenir, "Şablonu İndir" ile yerel kopya alınır.

"Şablonu Kaydet" ile değişiklikler kaydedilir.,

Etiket Atama

Üst araç çubuğunda etiketler ikonuna tıklanır; Etiketler paneli açılır.

Mevcut etiketlerden biri seçilir (örn. "Perakende E-Ticaret", "Finans", "Eğitim"). Seçili etiket mavi etiket olarak görünür.

"Etiket Oluştur" bağlantısı ile yeni bir kategori tanımlanabilir.

Etiket, raporun ana sayfada hangi bölümde listeleneceğini belirler. Bu adım zorunlu değildir; ancak raporun kolay bulunabilmesi için önerilir.

Raporu Oluşturma ve İndirme

Üst araç çubuğunda indirme ikonuna tıklanır; "Raporu Oluştur" popup'u açılır.

Her parametre için değer seçilir. Dropdown listesi dolmuyorsa yanındaki yenile (↺) butonuna tıklanır.

Format Ayarları: Dosya tipi (Excel / PDF), dil (Türkçe / İngilizce) ve oryantasyon (Dikey / Yatay) seçilir. "Gelişmiş Format Ayarları" butonu ek seçenekler sunar.

"Raporu Oluştur" butonuna tıklandığında render başlar. Sağ taraftaki "İşlem Geçmişi" panelinde ilerleme takip edilebilir. Tamamlandığında "Bitti" ibaresi görünür ve dosya tarayıcıya otomatik indirilir.

"Yinele" ile aynı parametre seçimleri kullanılarak rapor tekrar indirilebilir. "Geçmişi Temizle" ile geçmiş liste boşaltılır.