Tekrarlanan ve Sıra Dışı Geçiş Olaylarının Yönetimi
Gerçek zamanlı biyometrik devam kaydı basit görünür: biri tarar, sisteminiz bir olay alır ve bunu kaydeder. Pratikte ise devam verileri daha karmaşıktır. Aynı olay iki kez gelebilir. Bir çalışan tarayıcıya arka arkaya iki kez dokunabilir. Bağlantısı kopan bir cihaz, sabah yapılan bir çıkış kaydını öğleden sonra gönderebilir. Biri yanlış giriş düğmesine basabilir. Sisteminiz her olayı geldiği gibi kaydederse, bu küçük sorunlar hatalı çalışma saatlerine, bordro anlaşmazlıklarına ve kimsenin güvenmediği raporlara dönüşür. Bu kılavuz, farklı türdeki tekrarlanan ve sıra dışı geçiş olaylarını, nedenlerini ve devam kayıtlarınızı temiz tutan, OperationID ve LogTime alanlarına dayalı net bir kurallar setini açıklar.
01 · Sorun
Temiz Devam Verisi Göründüğünden Daha Zordur
Devam olayları fiziksel cihazlardan gelir, farklı lokasyonlara dağılmıştır, gerçek kişiler tarafından kullanılır ve bazen kopabilen ağlar üzerinden bağlanır. Bu etkenlerin her biri, verinin eksik veya hatalı ulaşmasına yol açabilir. Bunların hiçbiri biyometrik sistemin bir arızası değildir. Bunlar, fiziksel dünya yazılımla buluştuğunda ortaya çıkan doğal durumlardır.
İyi haber şu ki, Cams Biometrics Gateway'den gelen her geçiş olayı, onu temizlemek için ihtiyaç duyduğunuz bilgiyi taşır. Bu işin büyük kısmını iki alan yapar:
| Alan | Ne anlama gelir | Neyi yapmanızı sağlar |
|---|---|---|
| OperationID | Gateway'in gönderdiği her olay için benzersiz bir referans | Aynı olay birden fazla kez gelirse, tam olarak aynı olduğunu tanımak |
| LogTime | Kişinin gerçekten tarama yaptığı zaman; cihazın saat dilimi farkı ile birlikte | Olayları, ne zaman gelirlerse gelsin, gerçekleştikleri gerçek sırayla düzenlemek |
Daha zor durumlarda yardımcı olan üç alan daha vardır: UserId kişiyi, SerialNumber cihazı tanımlar ve Type kişinin giriş mi çıkış mı düğmesine bastığını belirtir.
|
Callback API üzerinden gelen bir geçiş olayı {
"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 · Tüm Tekrarlar Aynı Değildir
Dört Tür Tekrarlanan Geçiş Olayı
En yaygın hata, her tekrarı aynı şekilde ele almaktır. Dört farklı tür vardır ve her biri farklı bir çözüm gerektirir. Bazıları teknik nedenlerden, bazıları ise cihazların insanlar tarafından nasıl kullanıldığından kaynaklanır.
| Tekrar türü | Nasıl görünür | Nasıl tanınır | Ne yapılmalı |
|---|---|---|---|
| Yeniden iletilen olay | Tam olarak aynı olay iki kez gelir | Aynı OperationID | İkinci kopyayı yoksayın, ancak yine de done yanıtı gönderin |
| Çakışan içe aktarma | Callback ile alınmış bir olay, mutabakat sırasında yeniden içe aktarılır | Aynı UserId, LogTime ve SerialNumber, farklı bir kaynaktan | İkinci kopyayı yoksayın |
| Çift tarama | Bir kişi tarayıcıya birkaç saniye içinde iki kez dokunur | Farklı OperationID'ler, aynı kişi, LogTime değerleri birbirine çok yakın | Minimum aralık kuralını kullanarak tek bir geçiş olarak değerlendirin |
| Yanlış etiketlenmiş geçiş | Kişi çıkış yapmak isterken giriş düğmesine basar | Aralarında çıkış olmadan art arda iki giriş | Çalışma saatlerini hesaplarken bir eşleştirme kuralı uygulayın |
|
Teknik tekrarlar ile insan kaynaklı tekrarlar İlk iki tür teknik nitelikli olaylardır: sisteminiz tarafından iki kez görülen aynı tarama anlamına gelirler ve basitçe yoksayılmalıdırlar. Son iki tür ise insan kaynaklıdır: bunlar gerçek ve ayrı taramalardır ve bunların ne anlama geldiğine karar vermek bir iş kuralıdır. İki türün işlenmesini birbirinden ayrı tutun. Alıcı katmanınız yalnızca teknik tekrarları kaldırmalıdır. Devam mantığınız ise insan kaynaklı tekrarların ne anlama geldiğine karar vermelidir. |
Yeniden iletim neden olur
Callback bir karşılıklı iletişimdir: Gateway bir olay gönderir ve sunucunuz done onayıyla yanıt verir. Sunucunuz yavaş kaldığı, yeniden başlatıldığı veya kısa süreliğine ulaşılamaz olduğu için yanıt hiç gelmezse, olay yeniden gönderilebilir. Sunucunuz ilk kopyayı zaten kaydetmiş olabilir. Bu yüzden kural her zaman aynıdır: Bir OperationID'yi daha önce gördüyseniz, onu tekrar kaydetmeyin, ancak Gateway olayın ulaştığını bilsin diye done yanıtı gönderin. Kurulumunuz için tam yeniden iletim davranışını Cams Web API dokümantasyonunda doğrulayın.
|
Alıcınızın tekrarlar dahil her olay için gönderdiği yanıt { "status": "done" }
|
03 · Geliş Sırası Gerçek Sıra Değildir
Geçiş Olayları Neden Sıra Dışı Gelir
Sunucunuz olayları geliş sırasına göre alır. Devam ise tarama sırasına göre hesaplanmalıdır. Çoğu zaman bunlar aynıdır. Ancak bazen farklı olabilirler.
| Neden | Ne olur | Örnek |
|---|---|---|
| Cihaz veya lokasyon çevrimdışına düşer | Cihazlar taramaları yerel olarak kaydetmeye devam eder, bağlantı geri geldiğinde hepsini gönderir | Saat 13:01 çıkış kaydı, başka bir cihazdan gelen 13:35 taramasından sonra, saat 13:41'de ulaşır |
| Ağ gecikmeleri | Farklı cihazlardan gelen olaylar farklı yollardan geçer ve farklı sürelerde ulaşır | Bir saniye arayla yapılan iki tarama ters sırada ulaşır |
| Kişi başına birden fazla cihaz | Bir çalışan ana kapıda giriş yapar, yan kapıda çıkış yapar | İki cihazdan gelen olaylar öngörülemez biçimde iç içe geçer |
| Mutabakat içe aktarmaları | Eksik olaylar, cihaz kayıtlarından daha sonra doldurulur | Pazartesi tarihli bir olay, sisteminize salı günü eklenir |
Veri yükü farkı zaten gösterir. LogTime, taramanın gerçekleştiği zamandır. Time ise mesajın kendi zaman damgasıdır ve GMT cinsindendir. Yukarıdaki örnek veri yükünde, tarama yerel saatle 07:48'de gerçekleşmiş, ancak mesaj GMT 04:19'da gönderilmiştir; aynı saat diliminde bu 09:49 demektir, yani iki saat sonra. Bu fark, çevrimdışı bir dönemin tam olarak nasıl göründüğüdür. Olayları geliş zamanına göre sıralasaydınız, bu tarama yanlış yere düşerdi.
|
Geliş zamanı, sunucunuzun olayı ne zaman öğrendiğini gösterir. LogTime ise olayın ne zaman gerçekleştiğini gösterir. Devam kaydı her zaman LogTime'ı izlemelidir. |
04 · Sekiz Kural
Temiz Devam Verisi Rehberi
Bu sekiz kural, yukarıdaki tüm durumları ele alır. İlk dört kural callback alıcınıza ve depolamaya aittir. Son dört kural ise saklanan olayları devam kayıtlarına dönüştüren mantığa aittir.
|
Her ham olayı önce kaydedin Her veri yükünü, onunla başka bir işlem yapmadan önce, alındığı şekliyle kaydedin. Bir kural daha sonra yanlış çıkarsa, ham veriden yeniden işleme yapabilirsiniz. |
|
|
Tekrarlanan OperationID'leri yoksayın Depolamanızda OperationID'nin benzersiz olmasını sağlayın. Aynı OperationID tekrar gelirse, kaydetmeyi atlayın ve yine de done yanıtı gönderin. |
|
|
İçe aktarmalar için doğal anahtar kullanın Mutabakat sırasında içe aktarılan olaylar için UserId, LogTime ve SerialNumber kombinasyonunu taramanın kimliği olarak kabul edin; böylece aynı tarama iki kaynaktan asla iki kez kaydedilmez. |
|
|
Olayları asla geliş sırasına göre değil, LogTime'a göre sıralayın LogTime'ı saat dilimi farkıyla birlikte ayrıştırın ve devamı hesaplarken her zaman bu alana göre sıralayın. |
|
|
Hesaplamayı geç gelen olaylara göre yapın, geldiği anda değil Bir çıkış kaydı geldiği anda günün çalışma saatlerini kesinleştirmeyin. Geç olaylar geldiğinde yeniden hesaplayın ve günü yalnızca bir kesinleşme süresinden sonra, örneğin bordro çalışmadan önce kilitleyin. |
|
|
Çift taramaları minimum aralıkla birleştirin Aynı kişiye ait kısa bir süre içindeki taramaları, örneğin iki dakika, tek bir geçiş olarak değerlendirin. İş yerinize uygun bir süre seçin. |
|
|
Geçişleri net bir kuralla eşleştirin Yanlış etiketlenmiş geçişlerin nasıl ele alınacağına karar verin; örneğin taramaları zaman sırasına göre eşleştirmek veya ilk taramayı giriş, son taramayı çıkış olarak kullanmak gibi. Aynı kuralı her yerde uygulayın. |
|
|
Her düzeltmenin kaydını tutun Bir kural bir taramayı birleştirdiğinde, yok saydığında veya yeniden etiketlediğinde, ne olduğunu ve nedenini kaydedin. İK ve denetçilerin, ham taramaların çalışma saatlerine nasıl dönüştüğünü görmesi gerekir. |
|
Cihaz saatlerini doğru tutun LogTime, cihazın saatinden gelir. Bir cihazın saati yanlışsa, o cihazdaki her tarama da yanlış olur ve hiçbir sıralama bunu düzeltemez. Her cihazın doğru tarih, saat ve saat dilimine sahip olduğundan emin olun; elektrik kesintilerinden veya yazılım güncellemelerinden sonra bunları kontrol edin. |
05 · Kuralları Bir Araya Getirmek
Örnek Uygulama: Bir Çalışan, Karmaşık Bir Gün
Burj Khalifa lokasyonundaki çalışan 2 için gerçekçi bir gün aşağıda, olayların sunucuya ulaştığı sırayla gösterilmiştir. Lokasyon gün içinde bir süre bağlantısını kaybetmiştir.
| Ulaşma | OperationID | Type | LogTime | Kuralların yaptığı işlem |
|---|---|---|---|---|
| 09:02 | op-1001 | CheckIn | 08:58 | Kaydedildi |
| 09:03 | op-1001 | CheckIn | 08:58 | Aynı OperationID: yoksayıldı, done gönderildi |
| 09:04 | op-1002 | CheckIn | 08:59 | 08:58'den itibaren iki dakika içinde: çift tarama olarak birleştirildi |
| 13:40 | op-1004 | CheckIn | 13:35 | Kaydedildi |
| 13:41 | op-1003 | CheckOut | 13:01 | Çevrimdışı dönemden geç geldi: LogTime'a göre 13:35'ten önce yerleştirildi |
| 18:05 | op-1005 | CheckIn | 18:04 | Art arda ikinci giriş: günün son çıkışı olarak eşleştirildi |
LogTime'a göre sıralanıp temizlendiğinde gün, iki net çalışma dönemine dönüşür:
| Dönem | Başlangıç | Bitiş | Süre |
|---|---|---|---|
| Sabah | 08:58 | 13:01 | 4 saat 3 dakika |
| Öğleden sonra | 13:35 | 18:04 | 4 saat 29 dakika |
| Toplam çalışma | 8 saat 32 dakika |
Kurallar olmadan, aynı ham olaylar sabah üç giriş, öğleden sonraki bir girişten sonra görünen bir çıkış ve günün sonunda çıkış kaydının olmaması ile sonuçlanabilirdi. Bordro hataları işaretlerdi veya daha kötüsü, kimse fark etmeden yanlış saatleri hesaplardı.
06 · Temiz Veri İçin Tasarlandı
Cams Gateway Kayıtlarınızı Temiz Tutmanıza Nasıl Yardımcı Olur
Temiz devam verisi, doğru bilgiyi taşıyan olaylarla başlar. Cams Biometrics Gateway, sisteminizin aldığı her olayın tanımlanabilmesini, sıralanabilmesini ve izlenebilmesini sağlayacak şekilde tasarlanmıştır.
| Cams özelliği | Nasıl yardımcı olur |
|---|---|
| Her olayda OperationID | Sisteminize, yeniden iletilen olayları güvenilir biçimde tanıyıp yoksayma yolu sağlar |
| Saat dilimi farkı ile LogTime | Olayları nerede ve ne zaman gelirlerse gelsinler, gerçek sıralarına yerleştirmenizi sağlar |
| UserId, SerialNumber ve LabelName | Kişiyi, cihazı ve lokasyonu tanımlar; bunlar birlikte içe aktarmalar için doğal bir anahtar oluşturur |
| Çevrimdışı önbellek ve kuyruk | Bağlantı kesintileri sırasında olayları tutar ve bunları özgün zaman damgalarıyla iletir |
| done onayı | Her olayın ulaştığına dair net bir sinyal verir, böylece iletim doğrulanabilir |
| Kayıtları yüklemek için RESTful işlemler | Mutabakat yapmak ve boşlukları doldurmak için cihaz kayıtlarını istediğiniz zaman çekmenizi sağlar |
| AI Code Generator Prompts | Token'ları doğrulayan ve her olayı kaydeden bir callback alıcısı üretir; bu kılavuzdaki kuralları eklemeye hazır hale getirir |
|
Kim neyi yapar Cams Gateway, doğrulanmış her taramayı, temizlemek için gereken bilgiyle birlikte iletir. Teknik tekrarların kaldırılması callback alıcınıza aittir. Çift taramaların birleştirilmesi, geçişlerin eşleştirilmesi ve saatlerin hesaplanması ise iş kurallarınızın zaten bulunduğu HRMS, bordro veya devam mantığınızda yapılmalıdır. |
Sık Sorulan Sorular
|
Alıcım tekrarlanan olayları bir hatayla reddetmeli mi? Hayır. Tekrarlar için de done ile yanıt verin. Olay güvenli bir şekilde ulaştı ve bir hata yanıtı, olayın yeniden gönderilmesine neden olabilir. Olayı kaydetmeyi basitçe atlayın. |
|
Tekrarları tespit etmek için yalnızca LogTime'ı kullanabilir miyim? Tek başına hayır. İki farklı kişi aynı saniyede tarama yapabilir. Yeniden iletilen olaylar için OperationID'yi, içe aktarmalar için ise UserId, LogTime ve SerialNumber kombinasyonunu kullanın. |
|
Çift tarama penceresi ne kadar olmalı? Yanlışlıkla tekrarlanan dokunuşları yakalayacak kadar uzun, ama gerçek ayrı geçişleri birleştirmeyecek kadar kısa olmalı. Çoğu iş yeri için bir ila iki dakikalık bir pencere uygundur; ancak vardiyalarınıza ve lokasyon düzeninize uyan bir süre seçin. |
|
Bir günün devamı ne zaman kilitlenmeli? Geciken olayların ulaşmasına izin veren bir kesinleşme süresinden sonra; örneğin ertesi sabah veya bordro çalışmadan hemen önce. O zamana kadar, o gün için yeni olaylar geldikçe yeniden hesaplayın. |
|
Bu, yüz, kart ve PIN taramaları için de geçerli mi? Evet. Her giriş türü, aynı OperationID ve LogTime alanlarıyla aynı olay formatında gelir; bu nedenle kişinin nasıl doğrulandığına bakılmaksızın aynı kurallar uygulanır. |
Sonuç: Güven Şansa Değil, Kurallara Dayanır
Tekrarlanan ve sıra dışı geçiş olayları nadir uç durumlar değildir. Gerçek cihazlar, gerçek ağlar ve gerçek insanlarla biyometrik devam sistemi işletmenin olağan bir parçasıdır. İK'nın güvendiği devam verisi ile anlaşmazlığa yol açan veri arasındaki fark şans değildir. Bu fark, tutarlı biçimde uygulanan küçük ve net bir kurallar setinden kaynaklanır.
Tekrarlanan OperationID'leri yoksayın. Her şeyi LogTime'a göre sıralayın. İnsan kaynaklı tekrarları teknik hatalar değil, iş kuralları olarak ele alın. Hesaplamayı geç olaylara göre yapın, her düzeltmeyi kaydedin ve cihaz saatlerini doğru tutun. Bu kurallar yerine oturduğunda, doğrulanmış her tarama güvenilir bir kayda dönüşür.
Cams Biometrics Gateway, bu kuralların çalışmasını sağlayacak veriyi size sunar. Her Callback olayı; bir OperationID, saat dilimi farkıyla birlikte bir LogTime ve her taramayı tanımlamak için gereken kişi, cihaz ve lokasyon bilgilerini taşır. Bu bilgiler 15'ten fazla markaya ait cihazlardan gelir. Çevrimdışı önbellek ve kuyruk, kesinti sırasında olayları korur; RESTful işlemler ise ihtiyaç duyduğunuzda cihaz kayıtlarıyla mutabakat yapmanıza olanak tanır. Platformu CamsBiometrics.com adresinde inceleyin, tam Web API dokümantasyonunu developer.camsbiometrics.com adresinde okuyun ve AI Code Generator Prompts ile callback alıcınızı oluşturun.