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