JasperFillProcess

"JasperFillProcess" işlem elemanı; JasperReports işlemcisini kullanarak jrprint uzantılı bir dosya oluşturur. Bu dosya, jrxml uzantılı rapor dosyasının veriler ile doldurulmasıyla elde edilir. Oluşturulan dosya, daha sonra "JasperMergeProcess" tarafından birleştirme işleminde kullanılmak üzere veya "JasperPrintProcess" tarafından yazdırma işleminde kullanılmak üzere; süresi dolmuş dosyaların otomatik olarak silindiği özel MoreMotion dizinine ("WEB-INF/MM-INF/~tempfiles/") kayıt edilir.

İş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.

JasperFillProcess işlemi, gerekli verileri elde etmek için bu özellikte belirlenen bağlantıyı kullanır. Değer olarak proje sayfalarına yerleştirilmiş 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.

JasperFillProcess'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 JasperFillProcess'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. Parametreye değer olarak projede tanımlanmış bir "RelDBConnection" elemanın adı verilmelidir.

SUBREP_CONN_DERBY = 'Derby'

SUBREP_CONN_ORACLE = 'Oracle'

Birleştirilicek olan rapor dosyaları bu "Kimlik" ile gruplanır, bu kimliğin her grup için eşsiz olması gerekmektedir.

Alt rapor kullanan rapor dosyaları için anlamlıdır. Alt rapor dosyası , varsayılan dizin altında yer alıyorsa ({UYGULAMA_KÖK_DİZİNİ}/WEB-INF/MM-INF/jasper-reports) "Use_Default_Directory" seçilmelidir. Eğer; MoreMotion' a ait geçici dizinde yer alıyorsa "WEB-INF/MM-INF/~tempfiles" seçilmelidir.

Çalışacak olan tüm "JasperFillProcess" işlem elemanları bir kere "true", bir kere de "false" değeri ile çalışmalıdır. Böylece ilk çalışmada elde edilen değerler ikinci çalışmada üretilen dosyalarda kullanılabilir. Bu işlem ortak sayfa sayısını kullanmak istediğimizde anlamlıdır aksi halde "false" değeri ile çalıştırılmalıdır.

"Sayfa Sayısını Al" özelliği ile, ilk çağırımda üretilen "toplam sayfa sayısı değeri", adı verilen rapor parametresine atanır. Rapor parametresinin "Parameter Class" özelliği "java.lang.Integer" olarak tanımlanmalıdır.

"Sayfa Sayısını Al" özelliği ile, ilk çağırımda üretilen "başlangıç sayfa sayısı değeri", adı verilen rapor parametresine atanır. Rapor parametresinin "Parameter Class" özelliği "java.lang.Integer" olarak tanımlanmalıdır.

Bu değer raporda kullanılırken; geçerli sayfa numarasının üzerine eklenmelidir.