主题
工时表导入生成日报
更新日期：2026-09-09（基线 v1.251.0）
一、功能简介
有些团队的工时是在外部表格里统计的（考勤系统导出、车间手工填的月度工时表）。这个功能让你把整张月度工时统计表一次导进来，批量生成日报，不用让每个人回系统里补填一个月。
流程是：选年月 → 下载模板 / 上传文件 → 看核对报告（只试算、不写库）→ 确认导入 → 导入记录（可撤销）。
二、什么时候用它
- 工时在别的系统里统计，但需要在本系统里有日报数据（做统计、算成本、看饱和度）；
- 某个月大家忘了填日报，需要按线下工时表补齐；
- 车间/外包团队不直接用系统，由管理员代为录入。
三、开始之前（前置条件）
| 项 | 说明 |
|---|---|
| 入口 | 左侧菜单「工时导入」。（2026-09-17 前这个菜单叫「工时表导入」。） |
| 权限 | 这是管理员级操作（一次影响很多人的日报），没有权限时菜单不显示。 |
| 先下模板 | 别自己造表格 —— 用页面上的「下载当月空白模板」，表头和列顺序必须对得上。 |
| 先想清楚年月 | 导入是按「所属年月」整批处理的，选错月份会替换掉别的月份的数据。 |
四、操作步骤
第 1 步 选年月、下模板
- 在「选择所属年月」里选这批工时属于哪个月；
- 点「下载当月空白模板」，得到一张带表头的空表；
- 按模板填好工时。模板里自带一页「填写说明」，规则以它为准。
一行 = 一个人 + 一个项目 + 一整月。 同一个人在同一个项目上只占一行，重复了会阻断；工时格子按天填数字（支持 0.5 步长，不上班就留空，填 0 与留空等价、都不生成日报）。
一行可以横跨这个项目下的多个任务，不用为了"一行一个任务"去拆行。系统按任务计划开始日期的先后顺序分配：先把逐日工时灌进排在最前的那个任务，它的累计投入达到计划工时后，后面的任务顺延承接。承接结果会逐条列在核对报告的「提醒」里，可以直接忽略、照常导入。
⚠️ 横跨多任务时，每个任务都必须配了「计划工时」——因为这时完成度没法按任务手填，系统要按「累计投入 ÷ 计划工时 × 100%」估算（封顶 100%）。有任务缺计划工时会阻断该行，先去任务编辑里补上。
完成度列只对「整行落在一个任务上」的行有意义：填了值，该月最后一个有工时的那天取这个值；留空则按任务计划周期自动推算（计划开始日 0%、计划结束日 100%）。
第 2 步 上传并看「核对报告」
- 点「选择文件」挑好填完的表，再点「上传工时统计表」； （没选文件就点会提示「请先选择要上传的工时统计表」）
- 系统生成核对报告。⚠️ 这一步只是试算，不会写入任何数据，页面上也明写了这句。
核对报告分几块看：
| 区块 | 看什么 |
|---|---|
| 必须先改正的问题 | ❗ 阻断项 —— 不改完不让导入（比如人名对不上、工时格式错） |
| 提醒（不影响导入） | 可以带着问题导入，但最好先看一眼 |
| 按人小计 / 按项目小计 | 核对总数对不对，避免整表填错了还照导 |
| 考勤备注 | 不入库，仅供对照 |
没有阻断项时，页面会显示「没有阻断问题，可以导入」。
第 3 步 确认导入
点确认时会弹出这批的影响预览，形如：
将为 N 人生成 N 条日报、N 条明细，合计 N 小时。
⚠️ 如果这个月之前已经导入过，确认框会变成警告色并追加：
⚠️ YYYY-MM 已经导入过（N 条日报 / N 条明细），本次将整批替换。未出现在本表中的人员，其已导入的日报会被删除（员工自己手工填写的日报不受影响）。
这句要读三遍：重导是整批替换，不是"增量补充"。这次表里少了某个人，他上次导进去的日报会被删掉。
确认后开始导入，页面显示「正在导入」并轮询进度，完成提示「导入完成」。
如果中途失败，提示是「导入失败，数据已整体回退」—— 不会留下导一半的脏数据。
第 4 步 查导入记录 / 撤销
页面下方是「导入记录」表，列有：所属年月、文件名、日报数、明细数、合计工时、状态、操作人、导入时间、操作。
发现导错了，点该批次的撤销，二次确认「撤销这批导入」后提示「已撤销」，状态变「已撤销」。
五、常见问题与注意事项
- 上传了会不会直接改数据？ 不会。上传只出核对报告，页面明写「不会写入任何数据」。真正写库是在你点确认之后。
- ⚠️ 同一个月导第二次会怎样？ 整批替换，不是追加。这次表里没有的人，他上次导入的日报会被删除。补录某个人时，要把全月所有人都放在表里一起导，不能只导那一个人。
- 员工自己填的日报会被覆盖吗？ 不会。替换只作用于由导入生成的日报，手工填写的不受影响。
- 提示"必须先改正的问题"？ 那是阻断项，不改完导不了。常见是人名在系统里找不到、工时不是数字、项目对不上。
- "提醒"要不要管？ 不影响导入，但建议看一眼再决定 —— 它通常提示数据可疑（比如某人当月工时明显异常）。
- 考勤备注列填了没反应？ 那一列不入库，仅供对照用。
- 导到一半失败了，数据会不会乱？ 不会，失败会整体回退。
- 导错月份了怎么办？ 去导入记录里撤销那一批，再选对月份重导。
- 能不能只导一个部门？ 可以，但要牢记"整批替换"的口径 —— 建议按月、全量导，避免误删别人的数据。
- 一个人这个月在同一个项目里做了好几个任务，要拆成几行吗？ 不用，还是一行。系统按任务的计划开始日期先后顺序分配工时，前一个任务投满计划工时后，后面的顺延接上。（旧版本会因为"一行跨了多个任务"直接阻断，现在改成只在核对报告里提醒。）
- 跨多任务的行报错说缺计划工时？ 这是阻断项。横跨多任务时完成度靠「累计投入 ÷ 计划工时」估算，任务没配计划工时就算不出来 —— 去任务编辑里给这几个任务补上计划工时再导。
- 完成度那列填了好像没生效？ 它只对整行落在一个任务上的行有效。一行跨了多个任务时完成度是系统按投入比例估算的，手填的值不采用。
六、相关功能
- 填写日报：员工自己填报的入口，见《日报管理 - 填写日报》。
- 批量填报：在系统里一次填多天多任务，见《日报管理 - 批量填报》。
- 日报审核：导入生成的日报同样进入审核流程，见《日报管理 - 日报审核》。