Difference between revisions of "Fingerprint Service Log"

Revision as of 14:55, 2 January 2019

There are 2 logs maintained. Time Log records all punches made at the time clock while Admin Log records all other logs sent from the time clock.

Admin Log

The AdminLog will contain the following Message Types:

• Admin Log Received
• Device Connection Changed
• New Fingerprint

Admin Log Received

This message type represents multiple actions. The action can been seen in the JsonData column.

• Insert User - when a time clock receives a user that is not in the time clock, the clock sends an "Insert User" message.

{"access_control":false,"action":"Insert User","admin_id":"","log_id":29,"result":0,"time":"Jan 1, 2019 10:29:05 PM","timezone_offset":"GMT-05:00","user_id":"10000"}

• Update User - when a time clock receives a user that is already in the time clock, the clock sends an "Update User" message.

{"access_control":false,"action":"Update User","admin_id":"","log_id":31,"result":0,"time":"Jan 1, 2019 10:32:50 PM","timezone_offset":"GMT-05:00","user_id":"10000"}

• Enroll Backup Fp - sent when a fingerprint is enrolled. The actual fingerprint data will be sent in the message type New Fingerprint. The action is oddly named but implies that a fingerrpint was enrolled, and the service should "BackUp the Fingerprint".

{"access_control":false,"action":"EnrollBackupFp","admin_id":"","log_id":30,"result":6,"time":"Jan 1, 2019 10:30:55 PM","timezone_offset":"GMT-05:00","user_id":"10000"}

• App Version - sent after Clean DB is done at the clock, or a Reset Device is sent from the management software.

{"access_control":false,"action":"App Version","admin_id":"","data":"eyJWZXJzaW9uTmFtZSI6IlNla3VyZUlEIEFwcCAyLjguMTArIiwiRGJWZXJzaW9uIjoiMS4zOCIs\nIlBsdWdpbnMiOlsiVGltZWNvIDMuNDkrIl19\n","log_id":1,"result":1,"time":"Jan 1, 2019 11:20:23 PM","timezone_offset":"GMT-05:00","user_id":""}

• Turn On - sent when a time clock powers on

{"access_control":false,"action":"TurnOn","admin_id":"","log_id":32,"result":0,"time":"Jan 1, 2019 11:06:56 PM","timezone_offset":"GMT-05:00","user_id":""}

• BatchSet Wifi - sent when the clock powers on and the clock is using Wi-Fi.

{"access_control":false,"action":"BatchSet_Wifi","admin_id":"","log_id":33,"result":0,"time":"Jan 1, 2019 11:07:00 PM","timezone_offset":"GMT-05:00","user_id":"0"}

• BatchSet Wired Net - sent when the clock powers on and the clock is using an Ethernet cable.

{"access_control":false,"action":"BatchSet_WiredNet","admin_id":"","log_id":36,"result":0,"time":"Jan 1, 2019 11:14:58 PM","timezone_offset":"GMT-05:00","user_id":"0"}

DeviceConnectionChanged

This occurs when the clock connects or disconnects from the service. Also occurs when the service is restarted. JsonData will contain true or false.

NewFingerprint

This occurs when the user enrolls an employee at the time clock. There is also a log when the service sends a fingerprint to the time clock but this log is created by the service and the serial number will be "server". The Jsondata is similar but the serial number is "server" when the fingerprint is sent from the service to the time clock, and it is the serial number of the time clock when the clock sends the fingerprint.

{"finger_number":6,"template":"(Fingerprint data sent from clock)","user_id":"10000"}

{"user_id":"10000","finger_number":6,"template":"(Fingerprint data sent to clock)"}

Time Log

One record per punch is created even if the time logs are sent together in one Json payload.