mirror of
https://github.com/kuaifan/dootask.git
synced 2026-07-31 18:35:56 +00:00
55 lines
1.9 KiB
Markdown
55 lines
1.9 KiB
Markdown
---
|
||
id: data-export.checkin.howto
|
||
title: 导出签到数据
|
||
type: howto
|
||
feature: data-export
|
||
scope: admin
|
||
locale: zh
|
||
aliases:
|
||
- 导出签到
|
||
- 考勤导出
|
||
- 签到 Excel
|
||
- 打卡数据导出
|
||
- 月度考勤表
|
||
related_tools: []
|
||
related_pages: [application]
|
||
prerequisites:
|
||
- 需要系统管理员权限
|
||
- 系统设置中签到功能已开启（`checkinSetting.open = open`）
|
||
negative:
|
||
- 必须先在系统设置打开签到，否则报「此功能未开启」
|
||
- 单次最多 100 个成员
|
||
- 日期范围最多 35 天
|
||
- 必填成员 / 日期 / 时间三个参数，缺一不可
|
||
last_verified: 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 天一次导
|
||
- 不支持自定义结果判定规则（用系统全局设置）
|