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ı JDBC bağlantı ayarlarının yapılandırılması.

2. Kütüphane ve Sürücülerin (JAR) Tanımlanması#

Jaspersoft Studio'nun veritabanı ile iletişim kurabilmesi ve raporlarda özel fonksiyonların (RTool vb.) kullanılabilmesi için gerekli JAR dosyalarının iki farklı seviyede tanımlanması gerekmektedir:

A. Veri Adaptörü İçin Sürücü (Driver) Ekleme#

Veritabanı bağlantısının sağlanması için JDBC sürücüsünün veri adaptörüne tanıtılması gerekir:

  1. Data Adapter düzenleme ekranında Driver Classpath sekmesine geçin.
  2. Add butonuna tıklayarak PostgreSQL JDBC sürücüsünü ve gerekliyse ilgili 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ı Driver jar dosyasının classpath'e eklenmesi ve bağlantı testi.

B. Projeye Harici (External) JAR Ekleme#

Raporlarınızda RTool özel fonksiyonlarını veya ek kütüphaneleri kullanıyorsanız, bu dosyaları proje bağımlılıklarına eklemelisiniz:

  1. Project Explorer sekmesinde projenize sağ tıklayın ve Properties seçeneğini seçin.
  2. Sol menüden Java Build Path sekmesine gelin.
  3. Libraries sekmesini seçin ve Add External JARs butonu ile RTool ve diğer gerekli JAR dosyalarını ekleyin.
  4. Apply and Close diyerek işlemi tamamlayın.

Java Build Path - External JARs Java Build Path ekranından projeye harici JAR dosyalarının eklenmesi.

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ı Rapor tasarlama ekranı.

4. Report Execution: Locale Ayarı#

Raporların doğru dil ve bölge formatlarında (tarih, para birimi vs.) çalışması için Jaspersoft Studio üzerinde Locale ayarı yapılmalıdır.

  1. Window > Preferences (macOS'ta Jaspersoft Studio > Settings) yolunu izleyin.
  2. Sol menüden Jaspersoft Studio > Report Execution sekmesine gidin.
  3. Locale açılır menüsünden raporlarınızın kullanacağı dili (örneğin Turkish (Turkey)) seçin.
  4. Apply and Close butonuna basarak ayarları kaydedin.

Locale Ayarları Locale ve zaman dilimi ayarlarının yapılandırılması.

5. 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. Locale ayarının 4. adımda yapılandırıldığı gibi doğru olduğundan emin olun.
  4. Eğer raporunuz parametre alıyorsa, sağ taraftaki parametre giriş alanlarını doldurun.
  5. Raporun derlenip verilerin çekilmesiyle oluşan önizlemeyi inceleyin.

Rapor Önizleme 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.