+
+
+
+
+
+
+
diff --git a/hr_biometric_attendance/static/src/js/stopwatch.js b/hr_biometric_attendance/static/src/js/stopwatch.js
new file mode 100644
index 000000000..19e263ee0
--- /dev/null
+++ b/hr_biometric_attendance/static/src/js/stopwatch.js
@@ -0,0 +1,76 @@
+/** @odoo-module **/
+import {registry} from "@web/core/registry";
+import {parseFloatTime} from "@web/views/fields/parsers";
+import {useInputField} from "@web/views/fields/input_field_hook";
+import {standardFieldProps} from "@web/views/fields/standard_field_props";
+import {Component, useState, onMounted} from "@odoo/owl";
+
+// Function to format minutes into HH:MM:SS format
+function formatMinutes(value) {
+ if (value === false) {
+ return "";
+ }
+ const isNegative = value < 0;
+ if (isNegative) {
+ value = Math.abs(value);
+ }
+ let hours = Math.floor(value / 60);
+ let minutes = Math.floor(value % 60);
+ let seconds = Math.floor((value % 1) * 60);
+ seconds = `${seconds}`.padStart(2, "0");
+ minutes = `${minutes}`.padStart(2, "0");
+ return `${isNegative ? "-" : ""}${hours}:${minutes}:${seconds}`;
+}
+export class StopWatch extends Component {
+ static template = "StopwatchTemplate";
+ static props = {
+ ...standardFieldProps
+ };
+ setup() {
+ this.state = useState({
+ stopwatch: 0,
+ liveCapture: this.props.record.data.is_live_capture
+ })
+ useInputField({
+ getValue: () => this.durationFormatted,
+ refName: "numpadDecimal",
+ parse: (v) => parseFloatTime(v),
+ });
+ onMounted(async () => {
+ if (this.state.liveCapture) {
+ const datetimeObj = new Date(this.props.record.data.live_capture_start_time);
+ const now = new Date();
+ const timeDiff = now - datetimeObj;
+ this.state.stopwatch = timeDiff / 1000 / 60;
+ this._runTimer();
+ }
+ });
+ }
+
+ // Computed property to get the formatted duration
+ get durationFormatted() {
+ return formatMinutes(this.state.stopwatch);
+ }
+
+ // Function to run the timer
+ _runTimer() {
+ if (this.state.liveCapture == false) {
+ clearTimeout(this.timer);
+ return; // Exit the function
+ }
+ this.timer = setTimeout(async () => {
+ // Increment the duration every second
+ this.state.stopwatch += 1 / 60;
+ this._runTimer();
+ }, 1000);
+ }
+}
+
+// Definition of StopWatch as a component
+export const stopWatch = {
+ component: StopWatch,
+ supportedTypes: ["float"],
+};
+registry.category("fields").add("stopwatch", stopWatch);
+// Register the formatMinutes function under the "formatters" category
+registry.category("formatters").add("stopwatch", formatMinutes);
diff --git a/hr_biometric_attendance/static/src/xml/stopwatch_view.xml b/hr_biometric_attendance/static/src/xml/stopwatch_view.xml
new file mode 100644
index 000000000..86882b956
--- /dev/null
+++ b/hr_biometric_attendance/static/src/xml/stopwatch_view.xml
@@ -0,0 +1,10 @@
+
+
+
+
+
+
+
+
+
+
+ Community
+
+
+ Enterprise
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ + THIS MODULE INTEGRATES ODOO EMPLOYEE MANAGEMENT + WITH BIOMETRIC DEVICE. + + Fetch biometric user details from biometric + device and sync with odoo, available in + community and enterprise V18 +
+HR BIOMETRIC DEVICE INTEGRATION +
+
+ 
+
+
+
+
+ 
+ Email Us
+
+
+ 
+ Skype Us
+
+
+
+ Email Us
+
+
+
+ Skype Us
+
+
+ 
+
+
+
+ 
+
+
+
+ 
+
+
+
+
+
+
+
+
+
+ This module uses an external python dependency + 'pyzk'. Before installing the module install the + python package first. The required python + package can be installed using the following + command, +
+
+ + This module uses an external python dependency + 'pyzk'. Before installing the module install the + python package first. The required python + package can be installed using the following + command, +
+
pip
+ install pyzk
+
+
+
+
+
+
+
+
+ Key + Highlights
+
+
+
+
+
+ 
+
+
+ + Live Capture +
++ Real-time Data Fetching from Biometric + Device to Odoo .
+
+
+
+
+
+
+
+
+ + Schedule Downloads +
++ You can schedule attendance downloads by + configuring the time in the settings. +
+
+
+
+
+
+
+
+
+ + User Management +
++ You can create, update, and delete users + from the biometric device, managing them + through Odoo employees +
+
+
+
+
+
+
+
+
+ + Options for Restart and Clear Data +
++ We can restart the device and also clear + attendance log in a single click.
+
+
+
+
+
+
+
+
+ + Supporting Models +
+
+ This Module Support With The Following
+ ZKteco Machines (Clients have
+ Reported):
+ * UFace202
+ * IFace990
+ * K40 Pro
+ * SFace900
+ * FR1500
+ * UA760
+ * MB10
+
+
+
+
+
+
+
+
+ HR Biometric Device Integration
+
+ Are you ready to make your business more
+ organized?
+
+
+
+
+ Are you ready to make your business more
+ organized?
+
Improve now!
+
+
+ 
+ 
+
+ 
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ 
+
+
+ 
+
+
+
+
+
+
+
+
+ + Biometric Device Menu. + + +
+
+
+ + A new menu has been added to the + Attendance Module for + configuring the Biometric + Device. You can find this option + under Attendance --> Biometric + Device. +
+
+
+
+ 
+
+
+
+
+
+
+
+
+
+
+
+
+ + Test Connection + + +
+
+
+ + Create a new biometric device by + configuring the machine's IP + address and port, and then test + the connection to ensure it is + working. +
+
+
+
+ 
+
+
+
+
+
+
+
+
+
+
+
+
+ + Notification If Test Connection Succeed + +
+
+
+ + If the Test connection fails, + you will be notified with a + Validation error message +
+
+
+
+ 
+
+
+
+
+
+
+
+
+
+
+
+
+ + + + Biometric Device Functionalities +
+
+
+ + In this area, you can see + buttons + that provide access to different + functionalities. +
+
+
+
+ 
+
+
+
+
+
+
+
+
+
+
+ + Download Data + +
+
+
+ + Clicking the Download button + allows you to manually download + data from the machine. This will + save the attendance records, + register employee details, and + update the device information. +
+
+
+
+ 
+
+
+
+
+
+
+
+
+
+
+
+
+ + Attendance Analysis + + +
+
+
+ + Here we can see the Attendance + in Attendance Analysis +
+
+
+
+ 
+
+
+
+
+
+
+
+
+
+
+
+
+ + Clear Data + + +
+
+
+ + We can clear attendance from + both device and odoo. +
+
+
+
+ 
+
+
+
+
+
+
+
+
+
+
+
+
+ + + + +
+
+
+ + We can see the cleared log in + Chatter. +
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ + Restart Device + + +
+
+
+ + We can restart the device in a + single click. +
+
+
+
+ 
+
+
+
+
+
+
+
+
+
+
+
+
+ + Live Capture + + +
+
+
+ + If 'Live Capture' enabled, we + can get the real-time attendance + from the device. +
+
+
+
+ 
+
+
+
+
+
+
+
+
+
+
+
+ + The stopwatch appears when live + capturing is enabled. You also + have the option to disable live + capturing. +
+
+
+
+ 
+
+
+
+
+
+ 
+
+
+
+
+
+
+
+
+
+
+
+ + Set Timezone + + +
+
+
+ + We can set the Timezone of the + user into the device. +
+
+
+
+ 
+
+
+
+
+ + Will notify if the timezone is + set. +
+
+
+
+ 
+
+
+
+
+
+
+
+
+
+
+ + User Management + +
+
+
+ + By clicking this button, a + wizard will open to manage + users. +
+
+
+
+ 
+
+
+
+
+ + Here we have several options for + managing users. +
+
+
+
+ 
+
+
+
+
+ + by selecting 'Get all Users', we + can get all users from the + device. +
+
+
+
+ 
+
+
+
+
+ + Here we can see all the users + from the device. + . +
+
+
+
+ 
+
+
+
+
+ + By selecting 'create user', we + can select the employee from the + list. + +
+
+
+
+ 
+
+
+
+
+ + + + We can see the details in the + Chatter. +
+
+
+
+ 
+
+
+
+
+ + By selecting 'update user', the + user will update in device. +
+
+
+
+ 
+
+
+
+
+ + By clicking 'Delete User', We + can Delete the user from machine + or both devices. +
+
+
+
+ 
+
+
+
+
+ + We can see the details in the + Chatter. +
+
+
+
+ 
+
+
+
+
+
+
+
+
+
+
+ + + Biometric Device details in the Employee's Form. + +
+
+
+ + You can see the biometric device + details in the HR Settings of + the Employee form. + +
+
+
+
+ 
+
+
+
+
+
+
+
+
+
+
+ + Configure from Employee form. + +
+
+
+ + You can configure the biometric + device user details from + employee form. + +
+
+
+
+ 
+
+
+
+
+ + If the employee is already a + device user, here we can update + and delete.Else we can create + the user from here. +
+
+
+
+ 
+
+
+
+
+
+
+
+
+
+
+
+ + Schedule Downloads + +
+
+
+ + In the settings, you can set up + a schedule for automatic + attendance downloads and + configure the time interval and + period for these downloads + +
+
+
+
+ 
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ + Real-Time Attendance Capturing
+
+
+
+
+
+
+
+
+
+ + Option To Restart Biometric + Device In Odoo.
+
+
+
+
+
+
+
+
+
+ + Option To Maintain Biometric + Device Attendance Logs In Odoo
+
+
+
+
+
+
+
+
+
+ + Downloads And Save Machine + Information
+
+
+
+
+
+
+
+
+
+
+ + Set Device's Timezone As The + Odoo User Time Zone.
+
+
+
+
+
+
+
+
+
+ + You Can Schedule Attendance + Downloads By Configuring The + Time In The Settings.
+
+
+
+
+
+
+
+
+
+ + You Can Create, Update, And + Delete Users From The Biometric + Device, Managing Them Through + Odoo Employees. Also, You Can + Manage It From The Biometric + Device Form.
+
+
+
+
+
+
+
+
+
+
+ This Module Support With The
+ Following ZKteco Machines
+ (Clients have Reported):
+ * UFace202
+ * IFace990
+ * K40 Pro
+ * SFace900
+ * FR1500
+ * UA760
+ * MB10
+
+
+ + +
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ 
+
+
+ + Yes. This module supports integration with various zk biometric devices. You can configure device settings, and it will automatically fetch attendance logs into Odoo +
+
+
+
+
+
+
+ + You can configure the sync interval manually or set it to auto-sync at specific time intervals using scheduled actions. +
+
+
+
+
+
+ + Yes. The module has built-in logic to prevent duplication based on employee, device ID, and timestamp. +
+
+
+
+
+
+
+
+ + Latest Release 18.0.1.0.0 +
+ + 3rd July, 2025 + +
+
+
+
+
+
+
+ Add
+
+
+
+ -
+
- + Initial Commit + + +
+
+ + Related Products +
+ +
+ 
+ 
+ 
+ 
+ 
+ + Our Services
+
+
+
+
+
+
+
+
+
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+
+
+
+
+ ....
+
+ -
+
-
+
-
+
+
+
+
+
+