BioTime 集成¶
BioTime 是一款第三方考勤应用，与 Odoo 集成后可从 BioTime 服务器检索考勤 打卡记录 （打卡记录）。这些打卡记录会被转换为考勤记录，从而无需在 考勤 应用中手动记录员工的签到与签退。
重要
该集成基于 BioTime 8.5 和 9.0 API 构建。此集成连接的是 BioTime 软件， 而非 ZKTeco 终端。设备兼容性取决于 BioTime 本身。在添加新终端之前，请查阅已安装版本对应的 BioTime 官方支持设备清单。
安装¶
要配置数据库，必须先安装一个模块。打开 应用 应用，清除搜索栏中的默认筛选器，然后搜索 ZKTeco。安装 考勤 ZKTeco BioTime 模块。
配置¶
要配置 BioTime 集成，请导航至 。滚动到 ZKTeco BioTime 部分，并配置以下字段：
公司名称：输入注册在 BioTime 服务器上的公司名称。当服务器托管不止一家公司的数据时，用此字段确定要检索哪家公司的数据。
服务器 URL：输入 ZKTeco BioTime 服务器的完整 URL。
电子邮件：输入用于验证 BioTime 服务器的电子邮件地址。
密码：输入用于验证 BioTime 服务器的密码。
交易获取窗口：输入每次同步时从 BioTime 服务器检索打卡数据的天数。请将时间窗口设置得足够宽，以覆盖同步间隔，以免同步延迟时遗漏打卡记录。
签出回溯：输入在匹配签退时向后查找未关闭签入的天数。如果在该窗口内未找到，则该签退将保持未匹配状态。
填写完各字段后，点击 保存，然后点击 ZKTeco BioTime 部分中的 测试连接 按钮。连接成功后即可检索数据。
检索交易¶
连接到 BioTime 服务器的设备称为 终端 （终端）。每条考勤记录都会标明该交易是由哪个终端生成的。
BioTime 将每次打卡单独存储为一条签入或签退记录，而 Odoo 考勤 应用中的记录则将签入和签退信息合并到同一条记录中。因此，从 BioTime 检索到的打卡记录会先在数据库中单独存储，然后再转换为 考勤 应用的记录。
要查看检索到的 BioTime 记录，请导航至 。每条 ZKTeco Transaction 记录会显示以下信息：
员工：与该交易关联的员工。系统通过 员工表单 的 设置 选项卡中的 ZKTeco 员工 ID 字段进行匹配。如果未找到匹配项，会在 处理说明 字段中显示警告。
打卡时间：BioTime 服务器上记录的打卡时间，已转换为用户的时区。
类型：BioTime 服务器上的
Check-In（对应值为 0）或Check-Out（对应值为 1）。其他任何值均不受支持，系统会发出警告，提示必须先选择有效类型才能进行处理。终端：生成该交易的终端，即设备。
考勤：交易处理完成后生成的考勤记录。在成功处理之前，此字段为空。
是否已处理：指示该交易是否已转换为考勤记录。
处理说明：当交易无法匹配或处理时显示警告，例如未找到匹配的员工或未找到有效类型。
Zkteco 交易：该交易在 BioTime 服务器上的 ID。
小技巧
交易每 12 小时自动同步一次。若要在任意时间手动检索，请在 ZKTeco 交易 仪表板上点击 获取。
处理交易¶
处理 ZKTeco 交易会将其转换为 考勤 应用的考勤记录。交易的处理方式取决于其类型。
签入 交易会创建一条新的考勤记录，除非该员工已经存在一条未关闭的考勤记录（即有签入但没有对应签退的记录）。
签退 交易会关联到在设置菜单中配置的 签出回溯 期间内找到的最早一条未关闭考勤记录，并使用该记录的签退时间。
注解
员工在 同一时间 不能拥有两条未关闭的考勤记录。
要处理一条交易，请选中它并点击 面试。如果处理失败，请查看 处理说明 字段了解原因。记录修正后，再次点击 面试。如果打卡数据本身看起来有误或不完整，请点击 重新获取 重新从 BioTime 服务器拉取数据，然后再进行重新处理。这两个操作既可用于单条交易，也可以在列表视图中批量执行。
Example
在此示例中，一条签入交易无法处理，因为一条更早的考勤记录仍处于打开状态。1 月 28 日的交易未能处理，因为已经存在一条 1 月 28 日签入的考勤记录仍处于打开状态。必须先为该记录签退，员工才能再次签入。
一条 ZKTeco Transaction 成功处理后，其关联的考勤记录会出现在该交易的 Attendance 字段中，并且该考勤记录的模式被设置为 BioTime，从而与手动输入或通过其他签到方式产生的考勤记录区分开来。
重要
一条 ZKTeco Transaction 成功处理后， 无法 在其仍与考勤记录关联的情况下删除。请先删除该考勤记录。