361 lines
7.8 KiB
Markdown
361 lines
7.8 KiB
Markdown
---
|
||
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 `<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.
|
||
|
||
|
||
|
||
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 `<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**:
|
||
|
||
|
||
|
||
```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. |