JasperProcess

JasperReports işlemcisini kullanan "JasperProcess" işlem elemanı; JasperReports işlemcisinin desteklediği düğümlerden oluşan jrxml veya xml uzantılı rapor dosyalarını, aldığı paramatreler doğrultusunda işler ve PDF, Text, Excel (xls), Excel (csv), RTF türlerinde sonuç dökümanları oluşturur.

İşlem Yönetim Çatısı altında kullanılmak için tasarlanmış olan bu elemanı bir işlem bloğu veya işlem formu içine yerleştirin ve özelliklerini belirleyin.

JasperProcess işlemi, gerekli verileri elde etmek için bu özellikte belirlenen bağlantıyı kullanır. Değer olarak proje sayfalarına yerleştirlmiş olan bir"mor > RelDB > RelDBConnection" elemanının adını verin. Genellikle RelDBConnection elemanı Veri Kaynakları sayfasına yerleştirilir.

Bu özelliğe "jasperreport.dtd" ye uygun, *.jrxml veya *.xml uzantılı, bir rapor dosyasının adı (uzantısı da dahil olmak üzere) verilmelidir. Rapor dosyası olarak jrxml'in derlenmiş hali olan *.jasper uzantılı bir döküman da verilebilir.

JasperReports dosyaları projelerin JasperReports Dosyaları adlı dizinin altına kopyalanmalı ve projeye eklenmelidir.

Özelliğe değer olarak, rapor dosyaları için gerekli olan verilerin elde edilmesini sağlayan SQL sorgusu verilir. Bu özellikte belirlenen SQL, iReport adlı aracı kullanarak rapor dosyasını düzenlerken belirtilmiş SQL sorgusuna baskındır.

JasperProcess'in diğer özelliklerinde olduğu gibi "Rapor Sorgusu" özelliğinin de MScript kabul etmesi dinamik sorguların oluşturulabilmesini olanaklı kılar. Örneğin, bir uygulama sayfasında kat_no isimli bir parametre var ise, bu parametre JasperProcess'in SQL sorgusunda aşağıdaki gibi kullanılabilir.

Rapor Sorgusu (SQL)

SELECT * FROM products

@doif(kat_no != '')

WHERE PCAT_ID = @vof(kat_no)

@doend()

MScript kullanan bu sorgu ile rapor dosyası için farklı veriler elde edilebilir. Eğer kat_no parametresi boş ise bütün ürünler listelenecek; kat_no bir değer taşıdığında ise raporda sadece ilgili kategoriye dahil olan ürünler listelenecektir.

MoreMotion tarafından desteklenen MScript sayesinde en karmaşık raporların bile üstesinden kolaylıkla gelinebilir.

Bir Jasper rapor dosyasında istenilen sayıda parametre belirlenebilir. "Rapor Parametreleri" özelliğinde rapor dosyasında (jrxml) tanımlanmış parametrelerin değerleri atanır veya belirlenir. Eşitliğin sol tarafında rapor dosyasında tanımlanan parametrenin ismi (küçük / büyük harf duyarlıdır), eşitliğin sağ tarafında ise ilgili parametrenin değeri belirlenir ve bu kısım MScript kabul eder. Altta örnek rapor parametreleri tanımları listelenmiştir.

BASLIK = 'Bütün Ürünler'

IMZA = '@vof(YETKILI)'

resim_kaynagi = filepath('WEB-INF\MM-INF\jasper-reports\jr_images\logo.gif')

ALT_FIYAT = @vof(ALT_FIYAT)

Kategori_No = @vof(v:Kat_No)

TARIH = fmtdate(now(),'dd.MM.yyyy')

"Rapor Parametreleri" özelliği ile aynı yapıdadır. Eğer alt-rapor dosyası ana-rapor dosyasından farklı bir bağlantı kullanıyorsa anlamlıdır. Parametre JasperReports tarafında tanımlı olmalı ve "Parameter Class" özelliği "java.sql.Connection" olarak tanımlanmalıdır. Parametre ye değer olarak projede tanımlanmış bir "RelDBConnection" elemanın adı verilmelidir.

SUBREP_CONN_DERBY = 'Derby'

SUBREP_CONN_ORACLE = 'Oracle'

"Çıktı Türü", oluşturulacak raporun formatını belirlemede kullanılır. Listeden seçilecek tür ile raporun hangi formatta oluşturulacağı belirlenir. Çıktı türleri: 1. PDF, 2. Text, 3. Excel (xls), 4. Excel (csv), 5. RTF.

Bu listedeki seçim, çıktı türlerinin baş tarafındaki rakam baz alınarak belirlenir. Eğer bu seçenek dinamik olarak belirlenecekse, değer olarak çıktı türüne sayı gönderilmelidir.

@vof(CIKTI_TURU) ifadesi çözümlenince değeri 1'den 5'e kadar olan rakamlardan biri olmalıdır. Aksi takdirde JasperProcess hata verir.

Oluşturulan rapor dokümanının kaydedileceği dosyayı belirler. Değer kalıcı bir dosya adı olabileceği gibi geçici bir dosya da olabilir. Geçici dosyalar, süresi dolmuş dosyaların otomatik olarak silindiği özel MoreMotion dizininde ("WEB-INF/MM-INF/~tempfiles/") oluşturulur ve adları havuz değişkenlerine veya işlem kaydı alanlarına atanır.

Tanımlama	Açıklaması
WEB-INF/raporlar/urun.pdf	Uygulama kök dizinine göreceli tanımlanmış olan dosya
c:\raporlar\urun.pdf	Adı mutlak olarak tanımlanmış olan dosya
v:urunler	Adı "urunler" adlı havuz değişkeninde saklı olan geçici dosya
f:siparis	Adı "siparis" adlı işlem kaydı alanında saklı olan geçici dosya

JasperReports, "Master/Detail" kavramına uygun raporlar elde edebilmek için alt rapor (subreport) yapısını desteklemektedir. Bir alt rapor (içteki tekrarlama), ana rapor tarafından (dıştaki tekrarlama) parametre alır ve bu parametre değerine göre listeleme yapar.

Dosya yapısı açısından bir alt raporun bir ana rapordan farkı yoktur. Projeye hem ana rapor hem de onun tarafından kullanılan alt rapor dosyasının derlenmiş hali (*.jasper uzantılı) dahil edilmelidir.

iReport adlı araç ile alt raporu olan bir ana rapor düzenlerken, raporda "SUBREPORT_DIR" isimli bir parametre tanımlanmalı, alt raporun adı ise $P{SUBREPORT_DIR} + "alt-rapor-adı.jasper" olarak verilmelidir. "JasperProcess" işlemi çalışma zamanında bu parametrenin değerini kendiliğinden "{UYGULAMA_KÖK_DİZİNİ}/WEB-INF/MM-INF/jasper-reports/" olarak belirler.

3.	İki rapor dosyası (ana rapor ve alt rapor) da projeye dahil edilmeli. Ana rapor jasper veya jrxml uzantılı olabilir ama alt rapor kesinlikle alt raporun derlenmiş hali olan jasper uzantılı olmalıdır.