Doc_chelvyn/Easset Mac/Bug & Fixing/Easset — Print Barcode Marg...

7.8 KiB
Raw Blame History

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
easset
bug-fixing
barcode
print

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:

  1. Negative margin di blok @media print. .barcode-img pakai

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.

  1. 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 (bagian auto-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 → tetap 0


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)

  1. Buka menu Aset → pilih beberapa aset (minimal 2, biar kelihatan

pasangan kiri-kanan dalam satu lembar).

  1. Klik tombol Print Barcode. Tab baru terbuka berisi preview label.

  2. Hard refresh dulu: Cmd/Ctrl + Shift + R (CSS lama bisa ke-cache).

  3. Tekan Ctrl + P, lalu di dialog print set:

  • Printer: Zebra ZD230

  • Paper: 53mm × 33mm

  • Margin: None

  • Scale: 100%

  • Uncheck Headers and footers

  1. 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)

  1. Print satu lembar ke label asli, pastikan die-cut-nya pas.