|
|
| Nomor Dokumen |
IK-6a9d7c5e |
| Modul Odoo |
Attendance Machine |
| Menu |
Attendance → Import Data → Mesin Kehadiran |
| Versi |
1.2 |
| Tanggal Berlaku |
2026-07-13 |
- Dokumen Import Data Kehadiran sudah disetujui dalam workflow approval dan memasuki status queue_done.
- Sistem sedang atau telah memproses queue job untuk tiap baris pada tabel Import Data.
- Pengguna memiliki izin untuk membuka dan mengubah dokumen Import Data Kehadiran.
- Buka menu Attendance → Import Data → Mesin Kehadiran.
- Cari dan klik dokumen Import Data Kehadiran yang sedang dalam status queue_done.
- Klik tab Import Data, lalu periksa counter # Data, # Done, # Error, dan # Ignored untuk melihat ringkasan hasil pemrosesan.
- Periksa bagian "Queue Processing" untuk melihat progres queue job.
- Jika # Error bernilai 0: dokumen akan berpindah status ke done secara otomatis begitu seluruh queue job pada batch selesai diproses — tidak ada tombol yang perlu diklik pengguna.
- Jika # Error lebih dari 0: dokumen tidak akan berpindah ke status done sampai setiap baris berstatus Error diselesaikan melalui Retry, Edit Data lalu Retry, atau Ignore (lihat bagian di bawah).
Dokumen tidak memiliki tombol Done manual. Transisi dari queue_done ke done selalu terjadi otomatis oleh sistem setelah syarat pada langkah di atas terpenuhi.
- Pada tab Import Data, cari baris dengan Status bernilai Error (ditandai warna merah).
- Baca isi field Error Message untuk mengetahui penyebab kegagalan.
- (Opsional) Perbaiki penyebab kegagalan di luar dokumen ini bila perlu — misalnya mendaftarkan kode karyawan yang belum terdaftar pada Mesin Kehadiran, melengkapi CSV Mapping, atau memastikan timesheet karyawan sudah dibuka untuk tanggal terkait.
- Klik tombol Retry pada baris tersebut.
- Sistem memproses ulang baris tersebut secara langsung. Jika berhasil, Status berubah menjadi Done dan Error Message dikosongkan; jika masih gagal, Status tetap Error dengan Error Message yang diperbarui.
Tombol Retry memproses ulang baris tanpa mengubah data mentahnya. Jika penyebab kegagalan ada pada isi data itu sendiri (bukan kondisi di luar dokumen, mis. format tanggal salah atau kode karyawan salah ketik pada baris), koreksi dulu lewat tab Edit Data — Koreksi Lalu Retry di sebelah kanan.
Gunakan skenario ini jika penyebab kegagalan ada pada isi data mentah baris itu sendiri (mis. format tanggal pada file CSV tidak sesuai konfigurasi CSV Mapping, atau kode karyawan salah ketik pada baris tersebut) sehingga Retry biasa akan gagal lagi dengan pesan error yang sama.
- Pada tab Import Data, cari baris dengan Status bernilai Error (atau Draft) yang data mentahnya perlu dikoreksi.
- Klik tombol Edit Data pada baris tersebut.
- Pada dialog Edit Raw Data, ubah isi field Data (representasi JSON satu baris CSV) sesuai koreksi yang diperlukan.
- Klik tombol Confirm. Status baris kembali menjadi Draft dan Error Message dikosongkan. Baris belum diproses ulang secara otomatis pada langkah ini.
- Klik tombol Retry pada baris yang sama untuk memproses ulang dengan data yang sudah dikoreksi.
Setelah Edit Data dikonfirmasi, Status baris menjadi Draft, bukan Error — tombol Retry All Errors dan Ignore All Errors hanya menyasar baris berstatus Error, sehingga baris hasil Edit Data tidak ikut terproses oleh kedua tombol massal tersebut. Baris ini wajib di-Retry satu per satu setelah dikoreksi.
- Buka dokumen Import Data Kehadiran yang berstatus queue_done.
- Pada tab Import Data, klik tombol Retry All Errors.
- Sistem memproses ulang seluruh baris berstatus Error satu per satu, mengikuti hasil yang sama seperti Retry individu pada setiap barisnya.
- Pada tab Import Data, cari baris dengan Status bernilai Error.
- Isi field Ignore Reason dengan alasan mengapa baris ini dikecualikan dari import.
- Klik tombol Ignore pada baris tersebut.
- Status baris berubah menjadi Ignored. Baris ini tidak lagi dihitung sebagai Error dan tidak akan membuat/memperbarui record kehadiran.
- Buka dokumen Import Data Kehadiran yang berstatus queue_done.
- Pada tab Import Data, klik tombol Ignore All Errors.
- Pada dialog yang muncul, isi field Reason dengan alasan yang akan diterapkan ke seluruh baris berstatus Error.
- Klik tombol Confirm.
- Seluruh baris berstatus Error pada dokumen berubah menjadi Ignored dengan alasan yang sama.
Baris yang sudah berstatus Done tidak dapat di-Ignore. Tombol Retry, Edit Data, dan Ignore per baris hanya tampil untuk baris berstatus Draft atau Error.
Selama masih ada baris berstatus Error, dokumen tetap berada pada status queue_done. Setelah seluruh baris berstatus Error diselesaikan (melalui Retry hingga berhasil, Edit Data lalu Retry, atau di-Ignore) dan queue job batch selesai diproses, dokumen berpindah otomatis ke status done. Baris berstatus Done telah membuat/memperbarui record kehadiran karyawan; baris berstatus Ignored sengaja tidak menghasilkan record kehadiran. Data kehadiran yang terbentuk tersedia di menu Payroll → Attendance untuk proses payroll selanjutnya.
Proses import akan membuat atau memperbarui record pada model hr.timesheet.attendance untuk tiap baris Import Data berstatus Done, berdasarkan data CSV yang diimport:
Header Record Attendance:
| Field Attendance |
Sumber |
| Employee |
Dipadankan dari kode mesin yang ada di tabel Employees pada Mesin Kehadiran |
| Date |
Tanggal dari file CSV sesuai kolom dan format yang dikonfigurasi di CSV Mapping |
| Check-in |
Datetime check-in dari file CSV sesuai kolom dan format yang dikonfigurasi di CSV Mapping |
| Check-out |
Datetime check-out dari file CSV sesuai kolom dan format yang dikonfigurasi di CSV Mapping |
Baris Import Data yang berstatus Error atau Ignored tidak menghasilkan atau mengubah record hr.timesheet.attendance.