Ana içeriğe geç

5.1.5. Jaspersoft Studio: Rapor Hazırlama ve Test Kılavuzu#

Bu doküman, Jaspersoft Studio üzerinde PostgreSQL veri adaptörü tanımlama, gerekli sürücülerin eklenmesi ve hazırlanan raporların verilerle test edilmesi süreçlerini kapsar.

1. Data Adapter Tanımlama#

Raporların veritabanı ile iletişim kurabilmesi için bir veri adaptörü tanımlanmalıdır.

  1. Repository Explorer panelinde Data Adapters üzerine sağ tıklayın ve Create Data Adapter seçeneğini seçin.
  2. Açılan listeden Database JDBC Connection seçeneğini işaretleyip Next butonuna basın.
  3. Adaptör bilgilerini aşağıdaki gibi doldurun:
    • Name: PostgreSQL Bağlantısı
    • Driver: org.postgresql.Driver
    • URL: jdbc:postgresql://<host>:<port>/<database_name>
    • Username: Veritabanı kullanıcı adınız.
    • Password: Veritabanı şifreniz.

Data Adapter Tanımlama Ekranı Görsel 1: JDBC bağlantı ayarlarının yapılandırılması.

2. Driver Classpath'e JAR Ekleme#

Rtool raporlama aracının Jaspersoft Studio tarafından tanınması için JDBC jar dosyalarının projeye eklenmesi gerekir.

  1. Data Adapter düzenleme ekranında Driver Classpath sekmesine geçin.
  2. Add butonuna tıklayarak aşağıdaki linkte bulunan jar dosyalarını seçin.
  3. Alt kısımdaki Test Connection butonuna basarak bağlantının başarılı olduğunu doğrulayın.

Driver Classpath Ayarları Görsel 2: Driver jar dosyasının classpath'e eklenmesi ve bağlantı testi.

Jar Dosyaları Erişim#

Rtool jar dosyalarına erişmek için lütfen Eksen ekibi ile iletişime geçiniz.

3. Rapor Dosyası (.jrxml) Ekleme#

Bağlantı ayarları tamamlandıktan sonra rapor tasarım dosyanızı oluşturabilir veya mevcut bir dosyayı açabilirsiniz.

  1. File > New > Jasper Report yolunu izleyerek yeni bir rapor şablonu oluşturun.
  2. Tasarım ekranında (Design) rapor alanlarını, parametrelerini ve SQL sorgunuzu belirleyin.
  3. Raporun SQL sorgusunu düzenlemek için sağ üstteki Dataset and Query butonunu kullanabilirsiniz.

Rapor Sorgu Ekranı Görsel 3: Rapor tasarlama ekranı.

4. Veri ile Preview (Önizleme)#

Rapor tasarımınızın veritabanındaki gerçek verilerle ve Rtool Raporlama aracı kullanılarak nasıl görüneceğini kontrol etmek için:

  1. Editörün alt kısmındaki Preview sekmesine tıklayın.
  2. Üstteki araç çubuğunda, 1. adımda oluşturduğunuz PostgreSQL Bağlantısı adaptörünün seçili olduğundan emin olun.
  3. Eğer raporunuz parametre alıyorsa, sağ taraftaki parametre giriş alanlarını doldurun.
  4. Raporun derlenip verilerin çekilmesiyle oluşan önizlemeyi inceleyin.

Rapor Önizleme Görsel 4: Raporun canlı verilerle önizlenmesi.

Önemli Notlar#

  • Bağlantı Hataları: Eğer "Driver not found" hatası alıyorsanız, Classpath'e eklediğiniz jar dosyasının yolunu kontrol edin.
  • SQL Uyumu: Yazdığınız sorguların tanımlı veritabanı sözdizimine (Postgresq, Mysql, vs.) uygun olduğundan emin olun.
  • Rapor Derleme: Preview aşamasında rapor otomatik olarak .jasper formatına derlenir. Sunucu tarafında bu derlenmiş dosya kullanılacaktır.