7.8 KiB
| proyek | modul | odoo | kategori | branch | ticket | status | tags | ||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| e-Asset Patra Jasa | pj_easset | 18.0 Community | Bug & Fixing | cj/easet | Print Barcode — Perbaiki margin atas layout print barcode (P2 · CJ/Cila · 2026-08-02) | Selesai — hanya controller, tanpa migration |
|
Index: Easset — Index · Kategori: Bug & Fixing Entri ringkasnya di Easset — List Fixing (2026-08-03).
Modul: pj_easset · Odoo 18 Community · Branch kerja: cj/easet
Ticket: Print Barcode — Perbaiki margin atas layout print barcode (P2 · CJ/Cila · 02-Aug-2026)
Acceptance: hasil print memiliki margin atas konsisten dan tidak terpotong
1. Lokasi Kode
Label barcode bukan QWeb report / template XML. Dia HTML string yang di-generate
langsung di dalam controller Python.
File: pj_easset/controllers/maintenance/equipment_asset.py
Method: get_equipment_barcode_multi_html()
Endpoint: GET /api/equipment/barcode_multi.html?ids=1,2,3
Alur pemanggilannya:
Form / list Aset
└── tombol "Print Barcode"
→ action server di views/maintenance/snk_equipment_maintenance_view.xml
(baris ~518, buka url /api/equipment/barcode_multi.html?ids=…)
→ controller get_equipment_barcode_multi_html()
→ HTML + CSS inline → browser → Ctrl+P
Ada juga jalur ZPL langsung ke printer (/api/equipment/barcode_multi.zpl,
method get_equipment_barcode_multi_zpl). Jalur ZPL tidak ikut diubah —
perbaikan ini murni di jalur HTML/browser.
Struktur HTML yang di-generate: tiap 2 aset jadi satu <table class="page">
(1 baris, 2 <td class="page-cell">), satu page = satu lembar label
106mm × 33mm (2 label @ 53mm).
2. Masalah
Hasil print punya margin atas yang berubah-ubah antar label, dan bagian atas
barcode ikut terpotong.
Penyebab — dua hal, dua-duanya di CSS:
- Negative margin di blok
@media print..barcode-imgpakai
margin: -3mm auto 1mm dan .asset-number pakai margin: -3mm 0. Konten
ditarik 3mm ke atas sampai keluar dari area cell → bagian atas barcode
ter-clip saat dicetak.
- Angka posisi vertikal beda antara CSS layar dan CSS print.
.page-cell pakai vertical-align: top + padding-top, tapi nilainya
tidak sinkron (layar vs print). Akibatnya preview di browser tidak mewakili
hasil cetak, dan tiap kali angkanya diutak-atik manual hasilnya tidak
konsisten.
Ditambah tinggi barcode print 24mm + teks + padding membuat total konten
mepet ke batas label 33mm.
3. Perbaikan
Prinsipnya: posisi vertikal jangan dihitung manual — serahkan ke browser
lewat centering, lalu geser seperlunya pakai padding (bukan negative margin).
Perubahan yang dilakukan, 7 properti, semuanya vertikal:
| Blok | Properti | Sebelum | Sesudah |
|---|---|---|---|
| .page-cell (layar) | vertical-align | top | middle |
| .page-cell (layar) | posisi vertikal | padding-top: 2mm | padding: 0 0 2mm |
| .asset-number (layar) | padding / leading | padding-top: 0 | padding: 0 + line-height: 1.1 |
| .page-cell (print) | vertical-align | top !important | middle !important |
| .page-cell (print) | posisi vertikal | padding-top: 2mm !important | padding: 0 0 2mm !important |
| .barcode-img (print) | margin | -3mm auto 1mm !important | 0 auto 1mm !important |
| .asset-number (print) | margin | -3mm 0 !important | 0 !important + line-height: 1.1 |
Cara kerjanya
vertical-align: middle pada <td> membuat browser membagi sisa ruang
(33mm − tinggi konten) rata ke atas dan bawah. Karena dihitung otomatis dari
tinggi konten, margin atasnya konsisten di semua label tanpa angka manual.
padding-bottom: 2mm mengurangi ruang dari sisi bawah, sehingga titik tengahnya
naik 1mm — ini yang dipakai untuk permintaan "atasnya dinaikin sedikit".
Naiknya selalu setengah dari angka padding-bottom:
| padding | Konten naik | Jarak atas (print) | Jarak bawah |
|---|---|---|---|
| 0 0 0 | — | ~2.5mm | ~2.5mm |
| 0 0 2mm ← dipakai sekarang | 1mm | ~1.5mm | ~3.5mm |
| 0 0 3mm | 1.5mm | ~1.0mm | ~4.0mm |
| 0 0 4mm | 2mm | ~0.5mm | ~4.5mm |
Batas aman ± 5mm. Lebih dari itu konten mentok tepi atas label dan berisiko
terpotong lagi. Kalau mau ubah, ubah di DUA tempat (CSS layar dan CSS
@media print) supaya preview tetap sama dengan hasil cetak.
Yang sengaja TIDAK diubah
Semua properti yang berpengaruh ke layout horizontal dibiarkan apa adanya,
sesuai permintaan (kiri-kanan tidak boleh bergeser):
-
.page-cell→width: 53mm,text-align: center -
.barcode-img→margin: 0 auto(bagianauto-nya),width: auto -
tinggi barcode → tetap
22mm(layar) /24mm(print)
*(tinggi ikut menentukan lebar karena width: auto, jadi diubah pun akan
menggeser tampilan horizontal — makanya dibiarkan)*
-
.page→ tetap seperti semula -
padding kiri-kanan
.page-cell→ tetap0
4. Catatan: Versi Lama di File yang Sama
Di file ini ada dua versi lama method yang sama, masih dalam bentuk
comment. Berguna sebagai konteks, tapi jangan dipakai ulang mentah-mentah:
| Versi | Baris | Pendekatan | Status |
|---|---|---|---|
| V1 (paling lama) | ~2822–3009 | flexbox: .label-container display:flex + flex-direction:column + justify-content:center. Ukuran inch (4.3in × 1.2in), barcode 0.95in | Vertikalnya sudah benar — tanpa padding manual, tanpa negative margin |
| V2 (tengah) | ~2543–2820 | nested table, .barcode-row {height:85%} / .text-row {height:15%} | Cacat — di loop pages variabel barcode_src/asset_number bocor dari loop sebelumnya (semua label isinya sama) dan sel kanan diisi literal ... |
| V3 (aktif) | ~2286–2539 | table flat + vertical-align: top + padding/negative margin manual | Versi yang diperbaiki dokumen ini |
Perbaikan ini pada dasarnya mengembalikan prinsip V1 (centering otomatis,
tanpa angka manual) tapi memakai mekanisme table — vertical-align: middle
pada <td> itu ekuivalennya justify-content: center pada flex column.
Struktur <table> sengaja dipertahankan; kalau ikut V1 pakai CSS grid
1fr 1fr, layout horizontal ikut berubah.
Sisa dari eksperimen V3 yang belum dibereskan: di blok @media print,
.page masih width: 107mm !important padahal @page = 106mm
(di V1 dua-duanya konsisten 4.3in). Tidak berpengaruh ke margin atas karena
ini horizontal, tapi **kalau kolom kanan terlihat geser atau terpotong,
samakan jadi 106mm.**
5. Deploy
Hanya controller Python — tidak ada perubahan field/model/struktur DB.
Jadi tidak perlu naik version di __manifest__.py, tidak perlu migration
script, tidak perlu -u pj_easset.
Cukup restart service Odoo:
docker restart easet-web-1
Sudah diverifikasi setelah restart: pj_easset loaded, Registry loaded,
tanpa error di log.
6. Cara Tes (via UI)
- Buka menu Aset → pilih beberapa aset (minimal 2, biar kelihatan
pasangan kiri-kanan dalam satu lembar).
-
Klik tombol Print Barcode. Tab baru terbuka berisi preview label.
-
Hard refresh dulu:
Cmd/Ctrl + Shift + R(CSS lama bisa ke-cache). -
Tekan
Ctrl + P, lalu di dialog print set:
-
Printer: Zebra ZD230
-
Paper: 53mm × 33mm
-
Margin: None
-
Scale: 100%
-
Uncheck Headers and footers
- Yang dicek di preview:
-
Jarak dari tepi atas label ke barcode sama di semua label
-
Bagian atas barcode tidak terpotong
-
Nomor aset di bawah barcode tidak menempel/menabrak barcode
-
Posisi kiri-kanan sama seperti sebelum perbaikan (tidak bergeser)
- Print satu lembar ke label asli, pastikan die-cut-nya pas.