Support Hub/API & Integrations/Cách xử lý các sự kiện chấm công trùng lặp và không đúng thứ tự
Translated from the English article and reviewed by a person. Read the English original
Developer

Cách xử lý các sự kiện chấm công trùng lặp và không đúng thứ tự

Cách xử lý các sự kiện chấm công trùng lặp và không đúng thứ tự

 

Chấm công sinh trắc học theo thời gian thực nghe có vẻ đơn giản: một người quét thẻ, hệ thống của bạn nhận được một sự kiện, và bạn lưu lại. Trên thực tế, dữ liệu chấm công phức tạp hơn nhiều. Cùng một sự kiện có thể đến hai lần. Một nhân viên có thể chạm vào máy quét hai lần liên tiếp. Một thiết bị bị mất kết nối có thể gửi sự kiện check-out buổi sáng vào buổi chiều. Ai đó có thể nhấn nhầm nút check-in. Nếu hệ thống của bạn lưu mọi sự kiện đúng như khi nhận được, những vấn đề nhỏ này sẽ dẫn đến sai số giờ làm, tranh chấp bảng lương và các báo cáo không ai tin cậy. Hướng dẫn này giải thích các loại sự kiện chấm công trùng lặp và không đúng thứ tự khác nhau, nguyên nhân gây ra chúng, và một bộ quy tắc rõ ràng, dựa trên OperationID và LogTime, giúp hồ sơ chấm công của bạn luôn sạch.

01 · Vấn đề

Vì sao dữ liệu chấm công sạch khó đạt được hơn vẻ ngoài

Sự kiện chấm công đến từ các thiết bị vật lý, nằm rải rác ở nhiều địa điểm, được người thật sử dụng và kết nối qua các mạng đôi khi bị gián đoạn. Mỗi yếu tố trong số đó tạo ra một cách khiến dữ liệu đến không hoàn chỉnh. Không yếu tố nào trong số đó là lỗi của hệ thống sinh trắc học. Đơn giản là đó là điều xảy ra khi thế giới vật lý gặp phần mềm.

Tin tốt là mọi sự kiện chấm công từ Cams Biometrics Gateway đều chứa thông tin cần thiết để làm sạch dữ liệu. Hai trường thông tin đảm nhiệm phần lớn công việc:

Trường Ý nghĩa Cho phép bạn làm gì
OperationID Mã tham chiếu duy nhất cho mỗi sự kiện mà Gateway gửi đi Nhận diện chính xác cùng một sự kiện nếu nó đến nhiều hơn một lần
LogTime Thời điểm người đó thực sự quét thẻ, kèm độ lệch múi giờ của thiết bị Sắp xếp các sự kiện theo đúng thứ tự thực tế đã xảy ra, bất kể chúng đến khi nào

Ba trường bổ sung giúp xử lý các trường hợp khó hơn: UserId xác định người, SerialNumber xác định thiết bị, và Type cho biết người đó đã nhấn check-in hay check-out.

Một sự kiện chấm công từ 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 · Không phải mọi bản trùng lặp đều giống nhau

Bốn loại sự kiện chấm công trùng lặp

Sai lầm phổ biến nhất là xử lý mọi bản trùng lặp theo cùng một cách. Có bốn loại khác nhau, và mỗi loại cần một cách khắc phục riêng. Một số mang tính kỹ thuật, còn một số đến từ cách con người sử dụng thiết bị.

Loại trùng lặp Biểu hiện Cách nhận biết Cần làm gì
Sự kiện được gửi lại Cùng một sự kiện đến hai lần Cùng OperationID Bỏ qua bản sao thứ hai, nhưng vẫn phản hồi done
Nhập dữ liệu chồng chéo Một sự kiện đã nhận qua callback bị nhập lại trong quá trình đối soát Cùng UserId, LogTime và SerialNumber, nhưng từ nguồn khác Bỏ qua bản sao thứ hai
Quét đôi Một người chạm vào máy quét hai lần trong vài giây OperationID khác nhau, cùng một người, LogTime rất gần nhau Coi là một lần chấm, áp dụng quy tắc khoảng cách tối thiểu
Chấm sai loại Một người nhấn check-in trong khi họ định check-out Hai lần check-in liên tiếp mà không có check-out ở giữa Áp dụng quy tắc ghép cặp khi tính số giờ

Trùng lặp kỹ thuật và trùng lặp do con người

Hai loại đầu tiên mang tính kỹ thuật: đó là cùng một lần quét được hệ thống của bạn ghi nhận hai lần, và chúng nên được bỏ qua. Hai loại sau mang tính con người: đó là các lần quét thực sự, riêng biệt, và việc quyết định ý nghĩa của chúng là một quy tắc nghiệp vụ. Hãy tách biệt hai cách xử lý này. Bộ tiếp nhận của bạn chỉ nên loại bỏ các bản trùng lặp kỹ thuật. Logic chấm công của bạn mới nên quyết định ý nghĩa của các bản trùng lặp do con người.

Vì sao sự kiện bị gửi lại

Callback là một cuộc trao đổi: Gateway gửi một sự kiện, và máy chủ của bạn trả lời bằng xác nhận done. Nếu phản hồi không bao giờ đến nơi, chẳng hạn vì máy chủ của bạn chạy chậm, khởi động lại, hoặc tạm thời không thể truy cập, sự kiện có thể được gửi lại. Máy chủ của bạn có thể đã lưu bản đầu tiên. Vì vậy, quy tắc luôn giống nhau: nếu bạn đã thấy một OperationID, đừng lưu lại, nhưng hãy phản hồi done để Gateway biết sự kiện đã đến nơi. Hãy xác nhận hành vi gửi lại chính xác cho cấu hình của bạn trong tài liệu Cams Web API.

Phản hồi bộ tiếp nhận của bạn gửi cho mọi sự kiện, kể cả bản trùng lặp

{ "status": "done" }

03 · Thứ tự đến không phải là thứ tự thực

Vì sao các sự kiện chấm công đến không đúng thứ tự

Máy chủ của bạn nhận sự kiện theo thứ tự đến. Việc chấm công phải được tính theo thứ tự quét. Phần lớn thời gian hai thứ tự này trùng nhau. Đôi khi thì không.

Nguyên nhân Điều gì xảy ra Ví dụ
Thiết bị hoặc địa điểm bị ngoại tuyến Thiết bị vẫn ghi nhận lượt quét cục bộ, sau đó gửi tất cả khi kết nối được khôi phục Lượt check-out lúc 13:01 đến lúc 13:41, sau lượt quét lúc 13:35 từ thiết bị khác
Độ trễ mạng Các sự kiện từ các thiết bị khác nhau đi theo những tuyến khác nhau và mất thời gian khác nhau Hai lượt quét cách nhau một giây đến theo thứ tự ngược lại
Nhiều thiết bị cho mỗi người Nhân viên check-in ở cổng chính và check-out ở cửa phụ Sự kiện từ hai thiết bị xen kẽ nhau một cách khó đoán
Nhập dữ liệu đối soát Các sự kiện còn thiếu được bổ sung sau từ nhật ký thiết bị Một sự kiện của thứ Hai được thêm vào hệ thống của bạn vào thứ Ba

Dữ liệu gửi đi đã cho bạn biết sự khác biệt. LogTime là thời điểm lượt quét xảy ra. Time là dấu thời gian của chính thông điệp, theo GMT. Trong dữ liệu mẫu ở trên, lượt quét xảy ra lúc 07:48 theo giờ địa phương, nhưng thông điệp được gửi lúc 04:19 GMT, tức là 09:49 theo cùng múi giờ, muộn hơn hai giờ. Khoảng chênh lệch đó chính là dấu hiệu điển hình của một giai đoạn ngoại tuyến. Nếu bạn sắp xếp theo thời điểm đến, lượt quét đó sẽ nằm sai vị trí.

Thời điểm đến cho biết máy chủ của bạn biết về sự kiện vào lúc nào. LogTime cho biết sự kiện thực sự xảy ra khi nào. Việc chấm công luôn phải theo LogTime.

04 · Tám quy tắc

Cẩm nang làm sạch dữ liệu chấm công

Tám quy tắc này xử lý mọi trường hợp đã nêu ở trên. Bốn quy tắc đầu thuộc về bộ tiếp nhận callback và lưu trữ của bạn. Bốn quy tắc sau thuộc về logic chuyển các sự kiện đã lưu thành dữ liệu chấm công.

1

Lưu mọi sự kiện thô trước tiên

Lưu từng payload đúng như đã nhận trước khi làm bất cứ việc gì khác. Nếu sau này một quy tắc được phát hiện là sai, bạn có thể xử lý lại từ dữ liệu thô.

2

Bỏ qua OperationID bị lặp lại

Đảm bảo OperationID là duy nhất trong kho lưu trữ. Nếu cùng một OperationID đến lần nữa, bỏ qua việc lưu và vẫn phản hồi done.

3

Dùng khóa tự nhiên khi nhập dữ liệu

Với các sự kiện được nhập trong quá trình đối soát, hãy coi tổ hợp UserId, LogTime và SerialNumber là định danh của lượt quét, để cùng một lượt quét không bao giờ bị lưu hai lần từ hai nguồn.

4

Sắp xếp theo LogTime, không bao giờ theo thời điểm đến

Phân tích LogTime cùng độ lệch múi giờ của nó, và luôn sắp xếp theo trường này khi tính toán chấm công.

5

Tính toán muộn, không tính ngay khi sự kiện đến

Đừng chốt số giờ làm của một ngày ngay khi có lượt check-out đến. Hãy tính lại khi các sự kiện đến muộn xuất hiện, và chỉ khóa một ngày sau một khoảng thời gian chờ ổn định, chẳng hạn trước khi chạy bảng lương.

6

Gộp các lượt quét đôi bằng khoảng cách tối thiểu

Coi các lượt quét của cùng một người trong một khoảng thời gian ngắn, chẳng hạn hai phút, là một lần chấm duy nhất. Hãy chọn khoảng thời gian phù hợp với nơi làm việc của bạn.

7

Ghép cặp lượt chấm theo một quy tắc rõ ràng

Quyết định cách xử lý các lượt chấm sai loại, chẳng hạn ghép các lượt quét theo thứ tự thời gian, hoặc lấy lượt quét đầu tiên làm giờ vào và lượt cuối làm giờ ra. Áp dụng cùng một quy tắc ở mọi nơi.

8

Lưu lại nhật ký mọi lần chỉnh sửa

Khi một quy tắc gộp, bỏ qua hoặc gán lại nhãn cho một lượt quét, hãy ghi lại điều gì đã xảy ra và lý do. Bộ phận nhân sự và kiểm toán cần thấy được cách các lượt quét thô trở thành số giờ làm việc.

Giữ đồng hồ thiết bị chính xác

LogTime lấy từ đồng hồ của thiết bị. Nếu thời gian của thiết bị bị sai, mọi lượt quét trên thiết bị đó đều sai, và việc sắp xếp lại cũng không thể khắc phục được điều này. Hãy đảm bảo mỗi thiết bị có đúng ngày, giờ và múi giờ, đồng thời kiểm tra lại sau khi mất điện hoặc cập nhật firmware.

05 · Áp dụng các quy tắc vào thực tế

Ví dụ minh họa: Một nhân viên, một ngày lộn xộn

Đây là một ngày thực tế của nhân viên 2 tại địa điểm Burj Khalifa, được trình bày theo thứ tự các sự kiện đến máy chủ. Địa điểm này đã bị mất kết nối trong một phần của ngày.

Thời điểm đến OperationID Type LogTime Quy tắc xử lý
09:02 op-1001 CheckIn 08:58 Đã lưu
09:03 op-1001 CheckIn 08:58 Cùng OperationID: đã bỏ qua, đã gửi done
09:04 op-1002 CheckIn 08:59 Trong vòng hai phút so với 08:58: gộp thành một lượt quét đôi
13:40 op-1004 CheckIn 13:35 Đã lưu
13:41 op-1003 CheckOut 13:01 Đến muộn từ giai đoạn ngoại tuyến: được đặt trước 13:35 theo LogTime
18:05 op-1005 CheckIn 18:04 Check-in thứ hai liên tiếp: được ghép thành lượt check-out cuối cùng của ngày

Sau khi sắp xếp theo LogTime và làm sạch, ngày làm việc trở thành hai giai đoạn rõ ràng:

Giai đoạn Bắt đầu Kết thúc Thời lượng
Buổi sáng 08:58 13:01 4 giờ 3 phút
Buổi chiều 13:35 18:04 4 giờ 29 phút
Tổng thời gian làm việc 8 giờ 32 phút

Nếu không có các quy tắc, cùng những sự kiện thô đó có thể tạo ra ba lượt check-in vào buổi sáng, một lượt check-out xuất hiện sau lượt check-in buổi chiều, và không có lượt check-out nào vào cuối ngày. Bảng lương sẽ báo lỗi hoặc, tệ hơn, tính sai số giờ mà không ai hay biết.

06 · Được xây dựng để giữ dữ liệu sạch

Cams Gateway giúp bạn giữ hồ sơ sạch như thế nào

Dữ liệu chấm công sạch bắt đầu từ những sự kiện mang đúng thông tin. Cams Biometrics Gateway được thiết kế để mọi sự kiện hệ thống của bạn nhận được đều có thể được nhận diện, sắp xếp và truy vết.

Năng lực của Cams Cách hỗ trợ
OperationID trên mọi sự kiện Cung cấp cho hệ thống của bạn cách đáng tin cậy để nhận diện và bỏ qua các sự kiện được gửi lại
LogTime kèm độ lệch múi giờ Cho phép bạn sắp xếp các sự kiện đúng thứ tự thực tế, dù chúng đến từ đâu và khi nào
UserId, SerialNumber và LabelName Xác định người, thiết bị và địa điểm, cùng nhau tạo thành khóa tự nhiên cho việc nhập dữ liệu
Bộ nhớ đệm và hàng đợi ngoại tuyến Giữ các sự kiện trong thời gian gián đoạn kết nối và gửi lại với dấu thời gian gốc
Xác nhận done Cung cấp tín hiệu rõ ràng rằng mỗi sự kiện đã đến nơi, nhờ đó việc gửi có thể được xác nhận
Các thao tác RESTful để tải nhật ký Cho phép bạn lấy nhật ký thiết bị theo yêu cầu để đối soát và lấp đầy mọi khoảng trống
AI Code Generator Prompts Tạo một bộ tiếp nhận callback xác thực token và ghi nhật ký mọi sự kiện, sẵn sàng để bạn thêm các quy tắc trong hướng dẫn này

Ai làm gì

Cams Gateway gửi mỗi lượt quét đã xác minh kèm thông tin cần thiết để làm sạch dữ liệu. Việc loại bỏ các bản trùng lặp kỹ thuật thuộc về bộ tiếp nhận callback của bạn. Việc gộp các lượt quét đôi, ghép cặp lượt chấm và tính số giờ thuộc về HRMS, bảng lương hoặc logic chấm công của bạn, nơi các quy tắc nghiệp vụ đã được áp dụng.

Câu hỏi thường gặp

Bộ tiếp nhận của tôi có nên từ chối các sự kiện trùng lặp bằng lỗi không?

Không. Vẫn phản hồi done cho các bản trùng lặp. Sự kiện đã đến nơi an toàn, và phản hồi lỗi có thể khiến nó bị gửi lại. Chỉ cần bỏ qua việc lưu.

Tôi có thể chỉ dùng LogTime để phát hiện bản trùng lặp không?

Không thể chỉ dựa vào LogTime. Hai người khác nhau có thể quét cùng một giây. Hãy dùng OperationID cho các sự kiện được gửi lại, và tổ hợp UserId, LogTime và SerialNumber cho việc nhập dữ liệu.

Khoảng thời gian cho lượt quét đôi nên là bao lâu?

Đủ dài để bắt các lần chạm lặp do vô tình, nhưng đủ ngắn để không gộp nhầm các lượt chấm riêng biệt thực sự. Khoảng từ một đến hai phút phù hợp với hầu hết nơi làm việc, nhưng hãy chọn khoảng phù hợp với ca làm việc và bố trí địa điểm của bạn.

Khi nào nên khóa dữ liệu chấm công của một ngày?

Sau một khoảng thời gian chờ ổn định để các sự kiện bị trễ kịp đến, chẳng hạn sáng hôm sau hoặc ngay trước khi chạy bảng lương. Cho đến lúc đó, hãy tính lại mỗi khi có sự kiện mới của ngày đó.

Điều này có áp dụng cho quét khuôn mặt, thẻ và mã PIN không?

Có. Mọi loại đầu vào đều đến theo cùng một định dạng sự kiện, với cùng các trường OperationID và LogTime, nên các quy tắc tương tự được áp dụng bất kể người đó xác minh bằng cách nào.

Kết luận: Sự tin cậy đến từ quy tắc, không phải may mắn

Sự kiện chấm công trùng lặp và không đúng thứ tự không phải là các trường hợp ngoại lệ hiếm gặp. Chúng là một phần bình thường của việc vận hành chấm công sinh trắc học trên các thiết bị thực tế, mạng thực tế và con người thực tế. Sự khác biệt giữa dữ liệu chấm công mà bộ phận nhân sự tin cậy và dữ liệu gây ra tranh chấp không nằm ở may mắn. Nó nằm ở một bộ quy tắc rõ ràng, được áp dụng nhất quán.

Bỏ qua các OperationID bị lặp lại. Sắp xếp mọi thứ theo LogTime. Coi các bản trùng lặp do con người là quy tắc nghiệp vụ, không phải lỗi kỹ thuật. Tính toán muộn, ghi lại mọi chỉnh sửa, và giữ đồng hồ thiết bị luôn chính xác. Khi các quy tắc này được áp dụng, mỗi lượt quét đã xác minh sẽ trở thành một bản ghi đáng tin cậy.

Cams Biometrics Gateway cung cấp dữ liệu để các quy tắc đó hoạt động. Mỗi sự kiện Callback đều mang theo OperationID, LogTime kèm độ lệch múi giờ, cùng thông tin người dùng, thiết bị và địa điểm cần thiết để nhận diện từng lượt quét, từ các thiết bị của hơn 15 thương hiệu. Bộ nhớ đệm và hàng đợi ngoại tuyến bảo vệ các sự kiện trong thời gian gián đoạn, và các thao tác RESTful cho phép bạn đối soát với nhật ký thiết bị bất cứ khi nào cần. Tìm hiểu thêm về nền tảng tại CamsBiometrics.com, đọc đầy đủ tài liệu Web API tại developer.camsbiometrics.com, và tạo bộ tiếp nhận callback của bạn bằng AI Code Generator Prompts.

Was this article helpful?