--- proyek: e-Asset Patra Jasa modul: pj_easset odoo: 18.0 Community kategori: Bug & Fixing branch: cj/easet ticket: Print Barcode — Perbaiki margin atas layout print barcode (P2 · CJ/Cila · 2026-08-02) status: Selesai — hanya controller, tanpa migration tags: - 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 `` (1 baris, 2 `
`), 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. 2. **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 `` 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 `` itu ekuivalennya `justify-content: center` pada flex column. Struktur `` 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**: ```bash 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). 2. Klik tombol **Print Barcode**. Tab baru terbuka berisi preview label. 3. **Hard refresh** dulu: `Cmd/Ctrl + Shift + R` (CSS lama bisa ke-cache). 4. Tekan `Ctrl + P`, lalu di dialog print set: - Printer: **Zebra ZD230** - Paper: **53mm × 33mm** - Margin: **None** - Scale: **100%** - **Uncheck** *Headers and footers* 5. 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) 6. Print satu lembar ke label asli, pastikan die-cut-nya pas.