Cara Menangani Event Absensi Ganda dan Tidak Berurutan
Absensi biometrik real-time terdengar sederhana: seseorang memindai, sistem Anda menerima event, dan Anda menyimpannya. Dalam praktiknya, data kehadiran lebih berantakan. Event yang sama bisa datang dua kali. Karyawan bisa menempelkan jarinya ke pemindai dua kali berturut-turut. Perangkat yang kehilangan koneksi bisa mengirim check-out pagi hari pada sore hari. Seseorang bisa menekan tombol check-in yang salah. Jika sistem Anda menyimpan setiap event persis seperti saat diterima, masalah kecil ini akan berubah menjadi jam kerja yang salah, sengketa penggajian, dan laporan yang tidak dipercaya siapa pun. Panduan ini menjelaskan berbagai jenis event absensi ganda dan tidak berurutan, penyebabnya, serta serangkaian aturan yang jelas, yang dibangun berdasarkan OperationID dan LogTime, untuk menjaga catatan kehadiran Anda tetap bersih.
01 · Masalahnya
Mengapa Data Kehadiran yang Bersih Lebih Sulit dari Kelihatannya
Event absensi berasal dari perangkat fisik, tersebar di berbagai lokasi, digunakan oleh orang sungguhan, dan terhubung melalui jaringan yang terkadang terputus. Setiap fakta tersebut membuka celah bagi data untuk tiba dengan tidak sempurna. Tidak ada satu pun yang merupakan kesalahan sistem biometrik. Ini hanyalah hal yang terjadi ketika dunia fisik bertemu dengan perangkat lunak.
Kabar baiknya, setiap event pemindaian dari Cams Biometrics Gateway membawa informasi yang Anda butuhkan untuk membersihkannya. Dua field melakukan sebagian besar pekerjaan:
| Field | Apa itu | Yang bisa Anda lakukan |
|---|---|---|
| OperationID | Referensi unik untuk setiap event yang dikirim Gateway | Mengenali event yang sama persis jika datang lebih dari sekali |
| LogTime | Waktu saat orang tersebut benar-benar memindai, dengan offset zona waktu perangkat | Menempatkan event sesuai urutan waktu kejadian sebenarnya, kapan pun event tersebut tiba |
Tiga field tambahan membantu untuk kasus yang lebih sulit: UserId mengidentifikasi orangnya, SerialNumber mengidentifikasi perangkatnya, dan Type menunjukkan apakah orang tersebut menekan check-in atau check-out.
|
Event pemindaian dari Callback API {
"RealTime": {
"OperationID": "9nu1wak5616p",
"LabelName": "Burj Khalifa",
"SerialNumber": "ZHM11xxxxxxxx",
"PunchLog": {
"Type": "CheckOut",
"Temperature": "36.8",
"FaceMask": false,
"InputType": "Fingerprint",
"UserId": "2",
"LogTime": "2020-09-17 07:48:22 GMT +0530"
},
"AuthToken": "COJJ7eiIPBGUfmIQPvh2PJWWDLX7OuKs",
"Time": "2020-09-17 04:19:03 GMT +0000"
}
}
|
02 · Tidak Semua Duplikat Sama
Empat Jenis Event Absensi Ganda
Kesalahan yang paling umum adalah memperlakukan setiap duplikat dengan cara yang sama. Ada empat jenis yang berbeda, dan masing-masing memerlukan perbaikan yang berbeda. Sebagian bersifat teknis, dan sebagian lain berasal dari cara orang menggunakan perangkat.
| Jenis duplikat | Tampilannya | Cara mengenalinya | Yang harus dilakukan |
|---|---|---|---|
| Event yang dikirim ulang | Event yang sama persis tiba dua kali | OperationID yang sama | Abaikan salinan kedua, tetapi tetap balas dengan done |
| Impor yang tumpang tindih | Event yang diterima melalui callback diimpor lagi selama rekonsiliasi | UserId, LogTime, dan SerialNumber yang sama, dari sumber yang berbeda | Abaikan salinan kedua |
| Pemindaian ganda | Seseorang menekan pemindai dua kali dalam hitungan detik | OperationID berbeda, orang yang sama, LogTime sangat berdekatan | Perlakukan sebagai satu absensi, menggunakan aturan jeda minimum |
| Absensi dengan label salah | Seseorang menekan check-in padahal yang dimaksud adalah check-out | Dua check-in berturut-turut tanpa check-out di antaranya | Terapkan aturan pemasangan saat menghitung jam kerja |
|
Duplikat teknis versus duplikat manusia Dua jenis pertama bersifat teknis: itu adalah pemindaian yang sama yang terlihat dua kali oleh sistem Anda, dan seharusnya cukup diabaikan. Dua jenis terakhir bersifat manusiawi: itu adalah pemindaian yang nyata dan terpisah, dan menentukan maknanya adalah aturan bisnis. Pisahkan kedua jenis penanganan ini. Penerima callback Anda hanya boleh menghapus duplikat teknis. Logika absensi Anda yang harus memutuskan makna duplikat manusia. |
Mengapa pengiriman ulang terjadi
Callback adalah sebuah percakapan: Gateway mengirim sebuah event, dan server Anda membalas dengan konfirmasi done. Jika balasan tersebut tidak pernah sampai, karena server Anda lambat, dimulai ulang, atau sempat tidak dapat dijangkau, event itu mungkin dikirim lagi. Server Anda mungkin sudah menyimpan salinan pertama. Itulah sebabnya aturannya selalu sama: jika Anda sudah pernah melihat sebuah OperationID, jangan simpan lagi, tetapi tetap balas dengan done agar Gateway mengetahui event tersebut sudah diterima. Pastikan perilaku pengiriman ulang yang tepat untuk pengaturan Anda di dokumentasi Cams Web API.
|
Balasan yang dikirim receiver Anda untuk setiap event, termasuk duplikat { "status": "done" }
|
03 · Urutan Kedatangan Bukan Urutan Sebenarnya
Mengapa Event Absensi Tiba Tidak Berurutan
Server Anda menerima event sesuai urutan kedatangan. Absensi harus dihitung sesuai urutan pemindaian. Sebagian besar waktu keduanya sama. Terkadang tidak.
| Penyebab | Yang terjadi | Contoh |
|---|---|---|
| Perangkat atau lokasi offline | Perangkat terus mencatat pemindaian secara lokal, lalu mengirim semuanya saat koneksi kembali | Check-out pukul 13:01 tiba pada pukul 13:41, setelah pemindaian pukul 13:35 dari perangkat lain |
| Keterlambatan jaringan | Event dari perangkat yang berbeda melewati rute yang berbeda dan membutuhkan waktu yang berbeda | Dua pemindaian berselang satu detik tiba dalam urutan terbalik |
| Beberapa perangkat per orang | Karyawan check-in di gerbang utama dan check-out di pintu samping | Event dari dua perangkat saling bercampur secara tidak terduga |
| Impor rekonsiliasi | Event yang hilang diisi kemudian dari log perangkat | Event dari hari Senin ditambahkan ke sistem Anda pada hari Selasa |
Payload sudah menunjukkan perbedaannya. LogTime adalah saat pemindaian terjadi. Time adalah stempel waktu dari pesan itu sendiri, dalam GMT. Dalam contoh payload di atas, pemindaian terjadi pukul 07:48 waktu lokal, tetapi pesan dikirim pukul 04:19 GMT, yang berarti pukul 09:49 dalam zona waktu yang sama, dua jam kemudian. Selisih itulah yang terlihat ketika perangkat sedang offline. Jika Anda mengurutkan berdasarkan waktu kedatangan, pemindaian itu akan berada di posisi yang salah.
|
Waktu kedatangan menunjukkan kapan server Anda mengetahuinya. LogTime menunjukkan kapan kejadiannya. Absensi harus selalu mengikuti LogTime. |
04 · Delapan Aturan
Panduan Data Absensi yang Bersih
Delapan aturan ini menangani setiap kasus di atas. Empat aturan pertama berada di penerima callback dan penyimpanan Anda. Empat aturan terakhir berada di logika yang mengubah event tersimpan menjadi absensi.
|
Simpan setiap event mentah terlebih dahulu Simpan setiap payload persis seperti yang diterima sebelum melakukan hal lain dengannya. Jika suatu aturan ternyata keliru kemudian hari, Anda dapat memproses ulang dari data mentah. |
|
|
Abaikan OperationID yang berulang Pastikan OperationID bersifat unik di penyimpanan Anda. Jika OperationID yang sama datang lagi, lewati penyimpanan dan tetap balas dengan done. |
|
|
Gunakan kunci alami untuk impor Untuk event yang diimpor selama rekonsiliasi, perlakukan kombinasi UserId, LogTime, dan SerialNumber sebagai identitas pemindaian, sehingga pemindaian yang sama tidak pernah tersimpan dua kali dari dua sumber. |
|
|
Urutkan berdasarkan LogTime, jangan berdasarkan kedatangan Parse LogTime beserta offset zona waktunya, dan selalu urutkan berdasarkan field tersebut saat menghitung absensi. |
|
|
Hitung secara tertunda, jangan saat kedatangan Jangan menetapkan jam kerja hari itu saat check-out tiba. Hitung ulang ketika event terlambat datang, dan kunci hari tersebut hanya setelah jendela penyelesaian, misalnya sebelum penggajian dijalankan. |
|
|
Gabungkan pemindaian ganda dengan jeda minimum Perlakukan pemindaian oleh orang yang sama dalam jendela waktu singkat, misalnya dua menit, sebagai satu absensi. Pilih jendela waktu yang sesuai dengan tempat kerja Anda. |
|
|
Pasangkan absensi dengan aturan yang jelas Tentukan cara menangani absensi dengan label yang salah, misalnya dengan memasangkan pemindaian sesuai urutan waktu, atau menggunakan pemindaian pertama sebagai kedatangan dan yang terakhir sebagai kepulangan. Terapkan aturan yang sama di semua tempat. |
|
|
Simpan catatan setiap koreksi Ketika suatu aturan menggabungkan, mengabaikan, atau memberi label ulang pada sebuah pemindaian, catat apa yang terjadi dan alasannya. HR dan auditor perlu melihat bagaimana pemindaian mentah berubah menjadi jam kerja. |
|
Jaga agar jam perangkat tetap akurat LogTime berasal dari jam perangkat. Jika waktu perangkat salah, setiap pemindaian di perangkat tersebut juga salah, dan tidak ada pengurutan yang dapat memperbaikinya. Pastikan setiap perangkat memiliki tanggal, waktu, dan zona waktu yang benar, serta periksa kembali setelah listrik padam atau setelah pembaruan firmware. |
05 · Menerapkan Aturan Bersama-sama
Contoh Penerapan: Satu Karyawan, Satu Hari yang Berantakan
Berikut adalah hari yang realistis untuk karyawan 2 di lokasi Burj Khalifa, ditampilkan sesuai urutan event yang sampai ke server. Lokasi tersebut kehilangan koneksi untuk sebagian hari itu.
| Diterima | OperationID | Tipe | LogTime | Yang dilakukan aturan |
|---|---|---|---|---|
| 09:02 | op-1001 | CheckIn | 08:58 | Disimpan |
| 09:03 | op-1001 | CheckIn | 08:58 | OperationID sama: diabaikan, done dikirim |
| 09:04 | op-1002 | CheckIn | 08:59 | Dalam dua menit dari 08:58: digabung sebagai pemindaian ganda |
| 13:40 | op-1004 | CheckIn | 13:35 | Disimpan |
| 13:41 | op-1003 | CheckOut | 13:01 | Terlambat diterima dari periode offline: ditempatkan sebelum 13:35 berdasarkan LogTime |
| 18:05 | op-1005 | CheckIn | 18:04 | Check-in kedua berturut-turut: dipasangkan sebagai check-out terakhir hari itu |
Setelah diurutkan berdasarkan LogTime dan dibersihkan, hari tersebut menjadi dua periode kerja yang jelas:
| Periode | Mulai | Selesai | Durasi |
|---|---|---|---|
| Pagi | 08:58 | 13:01 | 4 jam 3 menit |
| Siang | 13:35 | 18:04 | 4 jam 29 menit |
| Total jam kerja | 8 jam 32 menit |
Tanpa aturan, event mentah yang sama bisa menghasilkan tiga check-in di pagi hari, check-out yang muncul setelah check-in sore, dan tidak adanya check-out di akhir hari. Penggajian akan menandai kesalahan atau, lebih buruk lagi, menghitung jam kerja yang salah tanpa ada yang menyadarinya.
06 · Dibangun untuk Data yang Bersih
Bagaimana Cams Gateway Membantu Anda Menjaga Catatan Tetap Bersih
Data absensi yang bersih dimulai dari event yang membawa informasi yang tepat. Cams Biometrics Gateway dirancang agar setiap event yang diterima sistem Anda dapat diidentifikasi, diurutkan, dan ditelusuri.
| Kemampuan Cams | Cara membantu |
|---|---|
| OperationID pada setiap event | Memberi sistem Anda cara yang andal untuk mengenali dan mengabaikan event yang dikirim ulang |
| LogTime dengan offset zona waktu | Memungkinkan Anda menempatkan event sesuai urutan waktu kejadiannya, di mana pun dan kapan pun event tersebut tiba |
| UserId, SerialNumber, dan LabelName | Mengidentifikasi orang, perangkat, dan lokasi, yang bersama-sama membentuk kunci alami untuk impor |
| Cache dan antrean offline | Menyimpan event selama gangguan koneksi dan mengirimkannya dengan stempel waktu aslinya |
| Konfirmasi done | Memberikan sinyal yang jelas bahwa setiap event telah diterima, sehingga pengiriman dapat dikonfirmasi |
| Operasi RESTful untuk memuat log | Memungkinkan Anda mengambil log perangkat sesuai permintaan untuk merekonsiliasi dan mengisi kekosongan |
| AI Code Generator Prompts | Menghasilkan penerima callback yang memvalidasi token dan mencatat setiap event, siap untuk Anda tambahkan aturan dalam panduan ini |
|
Siapa mengerjakan apa Cams Gateway mengirimkan setiap pemindaian yang telah diverifikasi beserta informasi yang dibutuhkan untuk membersihkannya. Menghapus duplikat teknis termasuk tugas penerima callback Anda. Menggabungkan pemindaian ganda, memasangkan absensi, dan menghitung jam kerja termasuk tugas HRMS, penggajian, atau logika absensi Anda, tempat aturan bisnis Anda sudah berada. |
Pertanyaan yang Sering Diajukan
|
Haruskah receiver saya menolak event duplikat dengan error? Tidak. Tetap balas dengan done untuk duplikat juga. Event tersebut memang sudah diterima dengan aman, dan balasan error dapat menyebabkan event itu dikirim ulang. Cukup lewati penyimpanannya. |
|
Bisakah saya hanya menggunakan LogTime untuk mendeteksi duplikat? Tidak cukup jika berdiri sendiri. Dua orang yang berbeda bisa memindai pada detik yang sama. Gunakan OperationID untuk event yang dikirim ulang, dan kombinasi UserId, LogTime, serta SerialNumber untuk impor. |
|
Berapa lama jendela pemindaian ganda seharusnya? Cukup lama untuk menangkap ketukan berulang yang tidak disengaja, dan cukup singkat agar tidak menggabungkan absensi terpisah yang sebenarnya. Jendela satu hingga dua menit cocok untuk sebagian besar tempat kerja, tetapi pilihlah yang sesuai dengan shift dan tata letak lokasi Anda. |
|
Kapan absensi satu hari sebaiknya dikunci? Setelah jendela penyelesaian yang memungkinkan event tertunda tiba, misalnya keesokan paginya atau tepat sebelum penggajian dijalankan. Sampai saat itu, hitung ulang setiap kali event baru tiba untuk hari tersebut. |
|
Apakah ini juga berlaku untuk pemindaian wajah, kartu, dan PIN? Ya. Setiap jenis input tiba dalam format event yang sama, dengan field OperationID dan LogTime yang sama, sehingga aturan yang sama berlaku terlepas dari cara orang tersebut melakukan verifikasi. |
Kesimpulan: Kepercayaan Berasal dari Aturan, Bukan Keberuntungan
Event absensi yang ganda dan tidak berurutan bukanlah kasus langka. Itu adalah bagian normal dari menjalankan absensi biometrik di perangkat nyata, jaringan nyata, dan orang sungguhan. Perbedaan antara data absensi yang dipercaya HR dan data yang menimbulkan sengketa bukanlah soal keberuntungan. Itu adalah seperangkat aturan yang jelas, diterapkan secara konsisten.
Abaikan OperationID yang berulang. Urutkan semuanya berdasarkan LogTime. Perlakukan duplikat manusia sebagai aturan bisnis, bukan kesalahan teknis. Hitung secara tertunda, catat setiap koreksi, dan jaga agar jam perangkat tetap akurat. Dengan aturan-aturan tersebut diterapkan, setiap pemindaian yang telah diverifikasi menjadi catatan yang andal.
Cams Biometrics Gateway memberi Anda data untuk membuat aturan-aturan tersebut berjalan. Setiap event Callback membawa OperationID, LogTime beserta offset zona waktunya, serta detail pengguna, perangkat, dan lokasi yang diperlukan untuk mengidentifikasi setiap pemindaian, dari perangkat di lebih dari 15 merek. Cache dan antrean offline melindungi event selama gangguan, dan operasi RESTful memungkinkan Anda merekonsiliasi dengan log perangkat kapan pun dibutuhkan. Jelajahi platform di CamsBiometrics.com, baca dokumentasi Web API lengkap di developer.camsbiometrics.com, dan hasilkan receiver callback Anda dengan AI Code Generator Prompts.