Support Hub/API & Integrations/Tekrarlanan ve Sıra Dışı Geçiş Olaylarının Yönetimi
Translated from the English article and reviewed by a person. Read the English original
Developer

Tekrarlanan ve Sıra Dışı Geçiş Olaylarının Yönetimi

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.

1

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.

2

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.

3

İç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.

4

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.

5

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.

6

Ç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.

7

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.

8

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.

Was this article helpful?