dootask/resources/ai-kb/zh/howto/data-export/checkin.md

id, title, type, feature, scope, locale, aliases, related_tools, related_pages, prerequisites, negative, last_verified

id	title	type	feature	scope	locale	aliases	related_tools	related_pages	prerequisites	negative	last_verified
data-export.checkin.howto	导出签到数据	howto	data-export	admin	zh	导出签到 考勤导出 签到 Excel 打卡数据导出 月度考勤表		application	需要系统管理员权限 系统设置中签到功能已开启（`checkinSetting.open = open`）	必须先在系统设置打开签到，否则报「此功能未开启」 单次最多 100 个成员 日期范围最多 35 天 必填成员 / 日期 / 时间三个参数，缺一不可	v1.7.90

导出签到数据

入口

桌面端：左侧栏「应用」→「数据导出」（仅管理员）→「导出签到数据」。 对应 API：GET api/system/checkin/export。

前置条件

系统设置 → 签到设置 → 「开启签到功能」必须为开启；未开启会直接返回「此功能未开启，请前往系统设置开启」。

操作步骤

1. 进入「数据导出」→ 选「导出签到数据」
2. 选择成员（最多 100 个，必填）
3. 选择日期范围（最多 35 天，必填）
4. 选择班次时间范围，例如 09:00-18:00（必填）
5. 点击「导出」，文件由系统机器人 system-msg 私聊推送

导出字段

签到人、签到日期、班次时间、首次签到时间、首次签到结果、最后签到时间、最后签到结果、参数数据。每个成员一个 Sheet。

结果判定规则

• 首次签到：晚于班次开始时间标「迟到」（蓝色），无记录标「缺卡」（红色）
• 最后签到：考虑「延后时间」（默认 120 分钟）支持跨天打卡
• 当前时间还没到班次开始 / 结束时显示 -

不支持

• 不支持导出无班次成员
• 不支持跨月超 35 天一次导
• 不支持自定义结果判定规则（用系统全局设置）