批量导入工时

批量导入工时是沐霖工时系统 v4.1.0 新增的便捷功能，支持通过 Excel 文件一次性导入多条工时记录，大幅提升数据录入效率。

功能概述

为什么需要批量导入？

场景	传统方式	批量导入
补录历史工时	逐天手动填报，耗时耗力	Excel 一次性导入，分钟级完成
团队工时汇总	收集每个人的数据后手动录入	整理 Excel 后统一导入
项目迁移	从旧系统导出数据后逐条重建	格式化后直接导入
跨天填报	切换日期多次填报	一个文件包含多天数据

导入流程

操作步骤：

1. 下载模板：系统提供标准 Excel 模板
2. 填写数据：按模板格式填写工时记录
3. 上传导入：上传 Excel 文件，系统自动解析
4. 查看结果：显示导入成功/失败统计

Excel 模板格式

必填字段

列名	必填	说明	示例
项目ID	✅	项目的主键 ID	1
填报日期	✅	工时日期（YYYY-MM-DD）	2026-06-01
工作内容	✅	工作描述	需求分析
工时	✅	工时数（小时）	4.0

可选字段

列名	必填	说明	示例
任务ID	❌	任务的主键 ID（可选）	5 或留空
是否完成	❌	任务完成状态	是 / 否 / true / false

模板示例

项目ID    任务ID    填报日期        工作内容      工时    是否完成
1         5        2026-06-01     需求分析       4.0     是
1         5        2026-06-02     原型设计       6.0     否
1                  2026-06-03     项目会议       2.0

使用指南

1. 下载模板

在工时填报页面，点击 "批量导入" 按钮，在弹出的对话框中点击 "下载模板" 获取标准 Excel 文件。

2. 填写数据

打开 Excel 模板，按照以下规则填写：

日期格式支持：

• ✅ 标准日期：2026-06-01
• ✅ Excel 日期序列号：自动识别
• ✅ 时间戳：自动转换

工时格式：

• ✅ 整数：4
• ✅ 小数：4.5
• ✅ 范围：0.5 ~ 24 小时

是否完成字段：

• ✅ 是 / 否
• ✅ true / false
• ✅ 1 / 0
• ✅ 留空（默认为 false）

3. 上传导入

填写完成后：

1. 点击 "选择文件" 上传 Excel
2. 系统自动解析并校验数据
3. 查看导入结果统计

4. 查看结果

导入完成后，系统会显示详细统计：

统计信息：

• ✅ 总天数：涉及多少个不同的日期
• ✅ 成功数：成功导入的天数
• ✅ 失败数：导入失败的天数
• ✅ 错误详情：每条失败记录的具体原因

数据验证规则

系统会对导入的数据进行严格校验：

必填字段验证

验证项	规则	错误提示
项目ID	必须为数字且项目存在	"项目ID不能为空" / "项目不存在"
填报日期	必须为有效日期	"日期格式不正确"
工作内容	不能为空	"工作内容不能为空"
工时	0.5 ~ 24 小时的数字	"工时必须为0.5-24之间的数字"

业务逻辑验证

验证项	规则	错误提示
重复填报	同一天同一项目不能重复填报	"该日期已存在工时记录"
工时上限	每人每天总工时不超过 24 小时	"当天工时总计超过24小时"
项目权限	只能导入自己有权限的项目	"无此项目权限"
任务关联	任务ID必须属于对应项目	"任务不属于该项目"

智能解析能力

日期解析

系统支持多种日期格式自动识别：

// 支持以下格式
"2026-06-01"         // 标准日期
"2026/06/01"         // 斜杠分隔
"06-01-2026"         // 月-日-年
45809                // Excel 序列号（2026-06-01）
1717200000000        // 时间戳（毫秒）

按日期分组

同一天的多条记录会自动合并处理：

输入：
2026-06-01  需求分析  4小时
2026-06-01  原型设计  3小时
2026-06-01  项目会议  1小时

处理：
→ 合并为 2026-06-01 的工时记录（总计8小时）
→ 工作内容合并：需求分析、原型设计、项目会议

布尔值解析

"是否完成"字段支持多种表达：

输入值	解析结果
true / 1 / 是 / yes	✅ true
false / 0 / 否 / no	❌ false
留空 / 其他	❌ false（默认）

错误处理

常见错误及解决方案

错误 1：项目ID不存在

原因： 填写的项目ID在系统中不存在

解决：

1. 在项目管理中查看项目的实际 ID
2. 修改 Excel 中的项目ID

错误 2：日期格式不正确

原因： 日期格式无法识别

解决：

1. 使用 YYYY-MM-DD 格式（如 2026-06-01）
2. 检查单元格格式是否为"日期"

错误 3：重复填报

原因： 该日期已存在工时记录

解决：

1. 删除已有记录后重新导入
2. 或在已有记录上手动补充

错误 4：工时超过上限

原因： 当天所有项目工时总计超过 24 小时

解决：

1. 检查当天已填报的工时
2. 调整导入的工时数

错误日志

导入失败时，系统会返回详细的错误信息：

{
  "totalDays": 10,
  "successDays": 8,
  "failedDays": 2,
  "errors": [
    {
      "row": 3,
      "date": "2026-06-05",
      "error": "该日期已存在工时记录"
    },
    {
      "row": 7,
      "date": "2026-06-08",
      "error": "工时必须为0.5-24之间的数字"
    }
  ]
}

注意事项

导入前检查清单

• [ ] 项目ID是否正确？
• [ ] 日期格式是否为 YYYY-MM-DD？
• [ ] 工时是否在 0.5 ~ 24 之间？
• [ ] 工作内容是否填写？
• [ ] 当天是否已有工时记录？
• [ ] 是否有项目权限？

性能建议

• 单次导入：建议不超过 100 条记录
• 大批量导入：分多次导入（按月拆分）
• 网络环境：确保网络稳定，避免上传中断

数据安全

• 导入前建议备份已有数据
• 导入过程中勿关闭浏览器
• 导入完成后检查结果统计

相关功能

• 工时填报 - 手动填报工时
• 工时审核 - 审核导入的工时
• 数据统计 - 查看导入后的统计数据

常见问题

Q1: 能否修改已导入的工时？

可以。导入的工时和手动填报的工时完全一样，可以在工时列表中编辑或删除。

Q2: 导入失败的数据会影响成功的数据吗？

不会。系统按天独立处理，失败的天数不影响成功的天数。

Q3: 能否导入其他人员的工时？

不能。只能导入自己有权限的项目工时，这是为了保证数据安全。

Q4: Excel 模板能否修改列名？

不建议修改。请使用系统提供的标准模板，否则可能无法正确识别。

Q5: 导入后能在哪里看到记录？

导入成功后，在"我的工时"或"数据统计"中可以看到导入的工时记录。