Wikiadmin at 15:27, 16 September 2026

2026-09-16T15:27:46Z

Wikiadmin: Dokumentasi

2026-09-16T10:15:26Z

Dokumentasi

New page

Halaman ini merangkum aturan dan jebakan yang ditemukan saat menulis/memperbaiki JRXML untuk InfiniteERP (runtime JasperReports 6.0.0). Latar belakang versi ada di halaman [[JasperReports]].

== Aturan Kompatibilitas ==

* Namespace root: <code><nowiki>http://jasperreports.sourceforge.net/jasperreports</nowiki></code> (jangan ganti ke namespace <code>jaspersoft.com</code> — itu gaya file baru Studio, dan tidak konsisten dengan report existing).
* Ekspresi ditulis sebagai '''Java valid''', bukan gaya Groovy. Contoh: <code>new Integer($V{No_Urut}.intValue()+1)</code>.
* Deklarasikan '''semua''' field yang dipakai di <code><field></code> dengan class Java yang benar:
** Uang/numerik: <code>java.math.BigDecimal</code>
** Tanggal: <code>java.sql.Timestamp</code>
** String: <code>java.lang.String</code>
* Font: pakai logical font (<code>SansSerif</code>, <code>Serif</code>, <code>Monospaced</code>) kecuali ada font extension jar di server.

== Jebakan yang Sudah Ditemukan ==

=== 1. Path absolut untuk gambar ===

Report existing me-hardcode path seperti:
<pre><imageExpression><![CDATA["/home/zaien_aji/appl/sahila/modules/.../ssd_logo.png"]]></imageExpression></pre>
Ini gagal render di mesin/user lain. '''Solusi''': parameter direktori gambar:
<pre><parameter name="IMAGE_DIR" class="java.lang.String" isForPrompting="false">
<defaultValueExpression><![CDATA["."]]></defaultValueExpression>
</parameter>
...
<imageExpression><![CDATA[$P{IMAGE_DIR} + "/ssd_logo.png"]]></imageExpression></pre>

=== 2. Rectangle selalu ber-outline hitam ===

Elemen <code><rectangle></code> '''selalu digambar dengan garis tepi 1pt berwarna <code>forecolor</code>''' (default hitam), di samping fill <code>backcolor</code>. Untuk balok warna bersih (accent bar, latar blok total), samakan keduanya:
<pre><reportElement mode="Opaque" x="0" y="84" width="565" height="3"
forecolor="#224435" backcolor="#224435" .../></pre>
Jika hanya <code>backcolor</code> yang di-set, balok tipis (height 1–3) akan terlihat kehitaman karena tercampur border.

=== 3. Variable mati sisa template ===

Variable dengan <code>calculation="Sum"</code>/<code>Average</code> tetapi <code><variableExpression></code> kosong adalah sisa template iReport — tidak dipakai dan aman dihapus.

=== 4. Atribut versi baru di file lama ===

Atribut seperti <code>splitType</code> pada <code><band></code> (milik JR 6.x) bisa muncul di file lama karena pernah dibuka di Jaspersoft Studio. Compile tetap OK (parser mengabaikannya), tetapi iReport 5.6 dapat mengacaukannya saat edit-save. Untuk file yang masih dirawat di iReport, hapus atribut tersebut.

== Pola Kalkulasi ==

Report existing melakukan kalkulasi di '''SQL (PostgreSQL)''', bukan di ekspresi report:

* Pajak: <code>ci.grandtotal - ci.totallines as pajak</code>
* Terbilang: fungsi custom database <code>terbilang(grandtotal)</code>
* Format tanggal Indonesia: <code>CASE EXTRACT(MONTH FROM ...)</code> + <code>to_char</code>

Ikuti pola yang sama kecuali ada alasan memindahkannya ke report — query mengambil langsung dari skema Openbravo/ADempiere (<code>c_invoice</code>, <code>c_invoiceline</code>, <code>c_bpartner</code>, dst).

== Trik Layout ==

=== Satu sel, dua baris (nama produk + deskripsi) ===

Buat dua text field bertumpuk di kolom yang sama; hilangkan border yang bertemu agar terlihat seperti satu sel:

* Elemen atas: <code><bottomPen lineWidth="0.0"/></code>
* Elemen bawah: <code><topPen lineWidth="0.0"/></code>

=== Tabel tanpa border penuh (gaya modern) ===

* Header kolom: hanya <code><bottomPen lineWidth="1.0" lineColor="#224435"/></code>
* Baris detail: hanya <code><bottomPen lineWidth="0.5" lineColor="#E0E0E0"/></code> di setiap sel (menjadi separator tipis antar-baris)
* Penekanan total: balok <code><rectangle></code> berlatar warna muda, bukan kotak border

== Setelah Menulis: Verifikasi ==

Jangan menganggap JRXML benar hanya dari membaca XML. Compile (dan bila perlu render) secara lokal — lihat [[JRXML Local Verification]].

[[Category:Development]]

← Older revision		Revision as of 15:27, 16 September 2026
Line 68:		Line 68:
	Jangan menganggap JRXML benar hanya dari membaca XML. Compile (dan bila perlu render) secara lokal — lihat [[JRXML Local Verification]].		Jangan menganggap JRXML benar hanya dari membaca XML. Compile (dan bila perlu render) secara lokal — lihat [[JRXML Local Verification]].

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

JRXML Best Practices - Revision history

Wikiadmin at 15:27, 16 September 2026

Wikiadmin: Dokumentasi