Fingerspot — Pengguna¶

Panduan operasional modul Fingerspot untuk pengguna harian. Modul ini mengintegrasikan mesin absensi Fingerspot dengan Odoo melalui Fingerspot Cloud API. Data scan dari mesin ditarik ke Odoo, diproses menjadi data kehadiran (attendance) yang valid, dan dapat dipantau langsung dari aplikasi.

Untuk membuka modul ini, klik ikon Fingerspot pada halaman utama aplikasi.

Alur Data Kehadiran¶

Mesin Fingerspot (scan karyawan)
        |
        | [Pull manual / otomatis atau Webhook real-time]
        v
  Raw Attlog — semua data scan mentah tersimpan di sini
        |
        | [Sync Attendance]
        v
  Attendance — 1 record per karyawan per hari
  - Check In  = scan paling AWAL hari itu
  - Check Out = scan paling AKHIR hari itu
  - Worked Hours dihitung otomatis

Data masuk ke Odoo melalui dua jalur:

Machines¶

Menu Fingerspot › Machines menampilkan daftar mesin absensi Fingerspot yang terhubung ke Odoo.

Melihat Detail Mesin¶

Klik salah satu mesin untuk membuka form detailnya.

Form mesin menampilkan informasi konfigurasi mesin serta tombol-tombol aksi untuk mengelola data kehadiran.

Tombol Aksi di Form Mesin¶

Smart Button pada Form Mesin¶

Pull Data Kehadiran¶

Pull adalah proses menarik data scan mentah dari Fingerspot Cloud API ke tabel Raw Attlog di Odoo.

Pull Manual¶

1. Masuk ke Fingerspot › Machines
2. Buka form mesin yang ingin di-pull
3. Klik tombol Pull Attlog
4. Sistem menarik data dari tanggal Last Pull Date sampai hari ini
5. Notifikasi muncul dengan jumlah record yang berhasil ditarik

Pull & Sync Sekaligus¶

Untuk menarik data sekaligus memprosesnya ke attendance dalam satu langkah:

1. Buka form mesin
2. Klik tombol Pull & Sync
3. Wizard muncul — isi Date From dan Date To
4. Klik Pull & Sync Now
5. Wizard menampilkan hasil: jumlah record yang ditarik (Pulled), berhasil di-sync (Synced), dan gagal (Errors)

Sync Attendance¶

Sync adalah proses mengolah data Raw Attlog menjadi data Attendance yang valid — satu record per karyawan per hari.

Logika Sync¶

Untuk setiap karyawan per hari:

• Check In = waktu scan paling awal (MIN) di hari tersebut
• Check Out = waktu scan paling akhir (MAX) di hari tersebut
• Jika hanya ada 1 scan → Check In = Check Out, Worked Hours = 0:00
• Total Hours dihitung otomatis dari selisih Check Out − Check In

Sync Manual via Wizard¶

1. Masuk Fingerspot › Machines, buka form mesin
2. Klik tombol Sync Attendance

3. Wizard muncul:

   • Date From — default: tanggal 1 bulan ini
   • Date To — default: hari ini

4. Ubah periode jika perlu, lalu klik Sync Now

5. Wizard menampilkan hasil:
   • Banner hijau jika sukses
   • Synced — jumlah record berhasil
   • Errors — jumlah record gagal
   • Error Details — detail error per PIN/tanggal (jika ada)

Sync Otomatis (Cron)¶

Sistem memiliki cron job yang otomatis menjalankan Pull & Sync setiap hari untuk semua mesin aktif. Cron default berjalan 1x per hari dan memproses data 2 hari terakhir (kemarin + hari ini).

Raw Attlog¶

Menu Fingerspot › Raw Attlog menampilkan semua data scan mentah yang sudah ditarik dari mesin.

Kolom yang Ditampilkan¶

Kegunaan¶

• Audit trail — melihat semua data scan asli dari mesin sebelum diproses
• Debugging — mengecek jika ada data yang tidak ter-sync dengan benar
• Verifikasi — membandingkan data raw dengan data attendance yang sudah diproses

Attendance¶

Menu Fingerspot › Attendance menampilkan data kehadiran yang sudah divalidasi — satu record per karyawan per hari.

Kolom Utama¶

Kolom Opsional¶

Klik ikon kolom di kanan atas tabel untuk menampilkan kolom tambahan:

Filter dan Pengelompokan¶

Filter bawaan:

Group By:

Data dapat dikelompokkan berdasarkan Employee, Department, Manager, Date, Machine, atau Status.

Tampilan Pivot dan Grafik¶

• Pivot View — analisis attendance dengan baris per departemen/karyawan, kolom per bulan, dan measure Total Hours
• Graph View — grafik batang perbandingan total jam kerja per departemen

Melihat Data Kehadiran Saya¶

Pengguna biasa (tanpa akses Administrator) hanya bisa melihat data attendance miliknya sendiri. Buka menu Fingerspot › Attendance untuk melihat riwayat check-in dan check-out Anda.

Webhook Logs¶

Menu Fingerspot › Webhook Logs mencatat semua data yang diterima secara real-time dari mesin Fingerspot melalui webhook.

Kolom yang Ditampilkan¶

Kegunaan¶

• Audit trail — bukti semua data yang masuk secara real-time via webhook
• Monitoring — memastikan mesin mengirim data secara rutin
• Debugging — mengecek jika data webhook tidak terproses dengan benar

Sync Logs¶

Menu Fingerspot › Sync Logs mencatat setiap eksekusi sync yang pernah dilakukan, baik secara manual maupun otomatis (cron).

Kolom yang Ditampilkan¶

Filter Berguna¶

Kegunaan¶

• Monitoring — pantau apakah sync berjalan lancar setiap hari
• Troubleshooting — identifikasi eksekusi sync yang gagal dan lihat detail error
• Audit — catat siapa dan kapan sync dijalankan

Koreksi Data Kehadiran¶

Jika data attendance tidak sesuai (misalnya hanya 1 scan sehingga Check In = Check Out), Admin dapat melakukan koreksi manual.

Cara Koreksi (oleh Admin)¶

1. Masuk Fingerspot › Attendance
2. Buka record yang ingin dikoreksi
3. Edit field Check In atau Check Out sesuai kondisi sebenarnya
4. Klik Save
5. Field Manually Corrected otomatis tercentang — record ini dilindungi dari overwrite oleh sync berikutnya

Contoh Kasus Koreksi¶

Troubleshooting¶

Data attendance tidak muncul setelah Pull¶

• Kemungkinan: Data sudah ditarik ke Raw Attlog tapi belum di-sync
• Solusi: Jalankan Sync Attendance dari form mesin

Karyawan tidak muncul di attendance¶

• Kemungkinan: Fingerspot PIN belum di-set di data karyawan
• Solusi: Minta Admin untuk membuka form Employee > tab Fingerspot > isi PIN > Save, lalu jalankan sync ulang

Check In = Check Out (Worked Hours 0:00)¶

• Kemungkinan: Hanya ada 1 scan di hari tersebut
• Solusi: Laporkan ke Admin untuk dilakukan koreksi manual

Data kehadiran saya tidak tampil¶

• Kemungkinan: Fingerspot PIN belum di-link ke akun karyawan Anda di Odoo
• Solusi: Hubungi Admin atau HR untuk verifikasi mapping PIN

Sync berjalan tapi ada error¶

• Solusi: Admin dapat melihat detail error di Fingerspot › Sync Logs — pilih eksekusi sync yang bersangkutan dan lihat kolom Error Details