JRXML Local Verification - Revision history

Wikiadmin at 15:28, 16 September 2026

2026-09-16T15:28:11Z

Wikiadmin: Audit v4: validasi query --jdbc + cek encoding UTF-8

2026-09-16T11:35:17Z

Audit v4: validasi query --jdbc + cek encoding UTF-8

Wikiadmin: Audit v3: cek overlap teks & atribut PDF lawas

2026-09-16T11:17:09Z

Audit v3: cek overlap teks & atribut PDF lawas

Wikiadmin: Dokumentasi mode audit jrxmlcheck v2

2026-09-16T11:08:37Z

Dokumentasi mode audit jrxmlcheck v2

Wikiadmin: Tool jrxmlcheck: ganti referensi path lokal menjadi link unduh Media:Jrxmlcheck.zip + petunjuk pasang

2026-09-16T10:55:04Z

Tool jrxmlcheck: ganti referensi path lokal menjadi link unduh Media:Jrxmlcheck.zip + petunjuk pasang

Wikiadmin: Tambah dokumentasi tool CLI jrxmlcheck

2026-09-16T10:39:13Z

Tambah dokumentasi tool CLI jrxmlcheck

Wikiadmin: Dokumentasi

2026-09-16T10:15:26Z

Dokumentasi

New page

Halaman ini menjelaskan cara menguji file JRXML '''di laptop''' — compile dan render PDF tanpa men-deploy ke server InfiniteERP. Wajib dilakukan sebelum JRXML baru/diubah dipasang di server.

== Kenapa Verifikasi Lokal ==

* Kesalahan JRXML (ekspresi tidak valid, field tidak dideklarasikan, class salah) baru ketahuan saat compile — bukan dari membaca XML.
* Menguji di server berarti menyentuh sistem produksi; di laptop cukup 1 perintah Java.
* Klaim "compatible" harus dibuktikan dengan hasil compile terhadap '''versi library yang sama dengan server''' (6.0.0), bukan versi lain.

== Classpath (Terbukti Jalan) ==

Unduh dari Maven Central, taruh dalam satu folder (misal <code>lib6/</code>):

{| class="wikitable"
! Jar !! Fungsi
|-
| <code>jasperreports-6.0.0.jar</code> || Engine report — versi sama dengan server
|-
| <code>jasperreports-fonts-6.0.0.jar</code> || Font extension — sama dengan server
|-
| <code>commons-digester-2.1.jar</code>, <code>commons-collections-3.2.2.jar</code>, <code>commons-beanutils-1.9.4.jar</code>, <code>commons-logging-1.2.jar</code> || Dependensi parsing
|-
| <code>ecj-4.4.2.jar</code> || Compiler ekspresi (JDT)
|-
| <code>itextpdf-5.5.13.3.jar</code> || Export PDF (JR 6.x memakai package <code>com.itextpdf</code>)
|-
| <code>itext-pdfa-5.5.13.3.jar</code> || '''Wajib''' — <code>PdfAWriter</code> dipisah ke jar ini
|}

Jebakan versi yang sudah ditemukan:

* JR 6.x '''tidak''' memakai iText lawas <code>com.lowagie</code> (itu milik JR 5.x). Tanpa <code>itextpdf</code>, export gagal: <code>NoClassDefFoundError: com/itextpdf/text/DocumentException</code>.
* Tanpa <code>itext-pdfa</code>, export gagal: <code>NoClassDefFoundError: com/itextpdf/text/pdf/PdfAWriter</code>.
* Teruji jalan di '''Java 17'''.

== Langkah ==

=== 1. Compile ===

<syntaxhighlight lang="java">
JasperReport rep = JasperCompileManager.compileReport("report.jrxml");
</syntaxhighlight>

Compile sukses = JRXML valid dan kompatibel dengan JR 6.0.0.

=== 2. Fill dengan data dummy ===

Report ber-query SQL tidak butuh database untuk diuji — lewatkan datasource map:

<syntaxhighlight lang="java">
Map<String,Object> row = new HashMap<>();
row.put("bpnmae", "PT CONTOH PELANGGAN");
row.put("pricestd", new BigDecimal("5000000"));
// ... isi semua field sesuai deklarasi <field> di JRXML

Map<String,Object> params = new HashMap<>();
params.put("IMAGE_DIR", "/path/ke/folder/gambar");

JasperPrint print = JasperFillManager.fillReport(rep, params,
new JRMapCollectionDataSource(java.util.Collections.singletonList(row)));
</syntaxhighlight>

Catatan: ImageIO membaca gambar '''berdasarkan konten''', bukan ekstensi — file PNG bernama <code>.jpg</code> tetap ter-render (berguna untuk placeholder).

=== 3. Export PDF ===

<syntaxhighlight lang="java">
JRPdfExporter exporter = new JRPdfExporter();
exporter.setParameter(JRExporterParameter.JASPER_PRINT, print);
exporter.setParameter(JRExporterParameter.OUTPUT_FILE_NAME, "sample.pdf");
exporter.exportReport();
</syntaxhighlight>

Jalankan: <code>java -cp ".:lib6/*" NamaVerifier</code>

=== 4. Cek hasil ===

* Buka PDF dan periksa visual: overlap, teks terpotong, alignment angka.
* Untuk elemen grafis kritis (accent bar, latar blok), bisa dicek deterministik: konversi PDF ke PNG lalu baca warna piksel pada koordinat yang diharapkan. Cara ini terbukti menangkap bug outline hitam pada <code><rectangle></code> (lihat [[JRXML Best Practices]]).

== Hasil yang Pernah Diverifikasi ==

* <code>sales_invoice_SSD.jrxml</code> (asli, iReport 5.6): compile OK di JR 5.6.0 dan 6.0.0
* Versi perbaikan (parameter <code>IMAGE_DIR</code>, variable mati dihapus): compile + render OK
* Layout modern tanpa border penuh: compile + render OK, cek piksel lolos

[[Category:Development]]

← Older revision		Revision as of 15:28, 16 September 2026
Line 138:		Line 138:
	* Layout modern tanpa border penuh: compile + render OK, cek piksel lolos		* Layout modern tanpa border penuh: compile + render OK, cek piksel lolos

−	[[Category:Development]]	+	[[Category:Development ERP]]

@@ Line 105: / Line 105: @@
 ** '''Elemen teks bertumpuk''' — dua elemen teks yang kotaknya beririsan >50% dari kotak terkecil (irisan tipis antar kolom kiri/kanan diabaikan karena umum & aman; teks di dalam kotak latar dan stempel-di-atas-tanda-tangan juga diabaikan — gambar bertumpuk hanya dicatat sebagai info).
 ** '''Atribut PDF lawas''' (<code>pdfFontName</code>, <code>pdfEncoding</code>, <code>isPdfEmbedded</code>) — deprecated, migrasikan ke font extension.
 ** <code>--strict</code>: exit code 1 bila ada peringatan — cocok untuk gerbang CI sebelum deploy.
 * File data sendiri: teks biasa, satu <code>namafield=nilai</code> per baris, baris <code>#</code> untuk komentar.
 * Pesan error diringkas ke penyebab utama beserta daftar penyebab umum (field tidak dideklarasikan, salah ketik nama field, class field salah, ekspresi bukan Java valid).
 * PDF hasil terbuka otomatis di macOS (nonaktifkan dengan <code>--no-open</code>); nama file diatur dengan <code>--out</code>.
 * Petunjuk lengkap juga tersedia di <code>README.txt</code> dalam paket.
 == Hasil yang Pernah Diverifikasi ==

@@ Line 103: / Line 103: @@
 ** '''Variabel mati''' (variableExpression kosong) dan '''field/parameter tidak terpakai'''.
 ** '''Jejak Jaspersoft Studio''' (<code>splitType</code>, property <code>com.jaspersoft.studio.*</code>) — jadi peringatan bila diaudit dengan <code>--target ireport</code>.
 ** <code>--strict</code>: exit code 1 bila ada peringatan — cocok untuk gerbang CI sebelum deploy.
 * File data sendiri: teks biasa, satu <code>namafield=nilai</code> per baris, baris <code>#</code> untuk komentar.

@@ Line 97: / Line 97: @@
 * Mode <code>preview</code> membaca deklarasi <code>&lt;field&gt;</code> di JRXML lalu membuat data contoh otomatis — langsung jalan tanpa menyiapkan apa pun. Jumlah baris contoh diatur dengan <code>--rows N</code>.
 * File data sendiri: teks biasa, satu <code>namafield=nilai</code> per baris, baris <code>#</code> untuk komentar.
 * Pesan error diringkas ke penyebab utama beserta daftar penyebab umum (field tidak dideklarasikan, salah ketik nama field, class field salah, ekspresi bukan Java valid).

@@ Line 80: / Line 80: @@
 == Tool CLI: jrxmlcheck ==
-Untuk pengguna non-programmer tersedia tool CLI '''jrxmlcheck''' (folder <code>~/jrxml-work/cli/</code>) — satu perintah, tanpa menulis Java:
+Untuk pengguna non-programmer tersedia tool CLI '''jrxmlcheck''' — satu perintah, tanpa menulis Java.
-<pre>jrxmlcheck compile laporan.jrxml                     # cek valid & kompatibel JR 6.0.0
+=== Unduh & Pasang ===
 jrxmlcheck preview laporan.jrxml                     # buat PDF contoh, data otomatis
-jrxmlcheck preview laporan.jrxml --images ./images   # pakai folder gambar (logo/stempel/ttd)
+# Unduh '''[[Media:Jrxmlcheck.zip|Jrxmlcheck.zip]]''' (5 KB; halaman berkas: [[:File:Jrxmlcheck.zip]]).
-jrxmlcheck preview laporan.jrxml --data data.txt     # data sendiri, format: namafield=nilai</pre>
+# Ekstrak: <code>unzip Jrxmlcheck.zip</code> — terbentuk folder <code>cli/</code>.
 * Mode <code>preview</code> membaca deklarasi <code>&lt;field&gt;</code> di JRXML lalu membuat data contoh otomatis — langsung jalan tanpa menyiapkan apa pun. Jumlah baris contoh diatur dengan <code>--rows N</code>.
 * File data sendiri: teks biasa, satu <code>namafield=nilai</code> per baris, baris <code>#</code> untuk komentar.
 * Pesan error diringkas ke penyebab utama beserta daftar penyebab umum (field tidak dideklarasikan, salah ketik nama field, class field salah, ekspresi bukan Java valid).
 * PDF hasil terbuka otomatis di macOS (nonaktifkan dengan <code>--no-open</code>); nama file diatur dengan <code>--out</code>.
-* Prasyarat: Java/JDK terpasang (teruji di Java 17).
+* Petunjuk lengkap juga tersedia di <code>README.txt</code> dalam paket.
 == Hasil yang Pernah Diverifikasi ==

@@ Line 77: / Line 77: @@
 * Buka PDF dan periksa visual: overlap, teks terpotong, alignment angka.
 * Untuk elemen grafis kritis (accent bar, latar blok), bisa dicek deterministik: konversi PDF ke PNG lalu baca warna piksel pada koordinat yang diharapkan. Cara ini terbukti menangkap bug outline hitam pada <code>&lt;rectangle&gt;</code> (lihat [[JRXML Best Practices]]).
 == Hasil yang Pernah Diverifikasi ==