实用的非入侵式的工作日志、工时统计及加班管理模块，强大的任务耗时统计分析功能，通过登记取证强制要求组员每个工作日填写任务完成情况。独立模块安装，不影响禅道原来的功能。包括：工作日志（日历）、日志填写不完整自动检测并邮件提醒、上个工作超负荷邮件通知、日志不完整登记（日历）、工作日调整、耗时统计及明细、加班审批管理、加班转审批管理 .

不同的禅道版本要下载插件对应的版本.

《升级到16.5以后，原来的工作日志菜单不见了怎么办》： https://www.yuque.com/books/share/2211c34d-4c6e-442d-9785-8d490c0f8863/dt9kap

试用时遇到问题邮件沟通：tonny0216@126.com

支持开源版、企业版和专业版安装此插件。开源版可以直接安装。企业版和专业版安装有点特殊，请阅读帮助文档。

由于咨询较多，我们精心汇总了一份很详尽的插件帮助手册，可解君愁。

在线帮助手册(带文档目录，阅读比较方便)： https://www.yuque.com/books/share/2211c34d-4c6e-442d-9785-8d490c0f8863/vqf0fd

概述

零散的工作日志意义不大，无法统计分析；通过任务的准确分类和及时填报的耗时来统计研发管理各个环节的投入。此模块主要解决 2 个问题： 1 、确保每个人都每天都要领任务，并及时填报工作耗时。 2 、准确统计各个项目、各个分类下的工作成本。

强调的是对任务的处理情况的填报，而不是事后日志的追补。前者可预估可归类可统计；后者零散无法统计。所以，本模块的工作日志是在做任务时填写的处理情况，由系统自动生成工作日志，无需凭空回想登记。

特点

· 兼容禅道开源版、专业版、企业版。
· 安装和卸载不影响禅道原来的功能，包括数据。做到真正的无缝插入。
· 日志必须与工作任务挂钩。项目->任务->日志，日志能追溯到具体的任务，没任务填写不了日志，倒逼项目团队管理好自己的任务。
· 提醒催办组员填写日志。不填写，提醒；还不填写，提醒组长；还不填写，登记，可配置。登记数据贵司可用于绩效考核。
· 加班工作量（事后）审核。保证加班工作量真实，经过审核。
· 全面的统计。按项目、按部门、按模块统计工作量，能钻取导出工作明细。
· 每项任务的剩余工作量能自动计算。
· 支持为缺陷填写开发或测试的工作量和工作内容，自动转为工作日志，并纳入项目工作量统计
· 兼容性非常好，能很好兼容禅道最新版本。兼容测试也很及时，从16年开始，总是在第一时间做禅道最新版本的测试。
· 支持钉钉/飞书工作消息通知，可以选择邮件/钉钉/飞书选其一或同时同时发送（10.8版本）

领域模型

功能图总览

支撑组员、部门经理、项目经理、工作日志IT维护员四个角色的日常的工作日志登记和维护的工作。以下分别从四个角色的操作来描述。

工作日志IT维护员

设置“检查规则”

可以设置指定用户的日志才需要被检查填写完整性（不添加检查规则的用户将不检查）。

对指定的用户 ，

1) 可设置其汇报的上级 ，只支持设置 1 位上级

2) 可设置是否让上级接收邮件通知（这个通知是指：个人日志填写不完整自动检测并登记后会发出邮件通知）

3) 可以启用或禁用此检查规则，“启用”后系统才会检测日志填写的完整性、及系统自动发邮件通知功能

特别要注意，如下状态要设置为启用：

支持批量添加或修改检查规则（考虑到多个人的上级都是同一个人，批量添加可以减少维护工作量）

工作日志填写提醒（系统自动）

1) 每个工作日的指定时刻检查上一个工作日的日志完整，如果不完整（即：工作量小于公司每天规定工时），发邮件提醒，邮件发给个人和其上级（如果不需要通知上级，在“检查规则”里选择不通知），邮件格式如下：

2) 日志填写不完整提醒的检测时刻可以配置。默认上午8点和10点各提醒一下。这个两个时间点调整，如下图，点击编辑可以调整时间。

工作日志不完整登记（系统自动）

1) 每个工作日的指定时刻检查 上 一个工作日的日志完整，如果不完整（即：工作量小于公司每天规定工时），发邮件通知并登记入库。

可以查看每天被登记的人员，也可以导出。

点击可以查看登记的情况

2) 日志填写不完整登记的检测时刻可以配置。默认上午 11 点。这个时间可以在禅道的后台-系统-定时相应的记录来修改。

如果不需要邮件提醒，这样设置：

点击链接查看：https://www.yuque.com/docs/share/ca2db1bf-3164-4005-b8fa-2dc61ddcaea9?# 《工作日志不完整不需要邮件提醒》

处理日志不完整申诉

用户可能因为请假调休 \ 出差来不及登记日志，可以由管理员取消登记。

取消时需记录：取消时间、取消原因、取消操作 。

维护工作日调整

根据国家节假日或公司要求调整工作日。

可以将指定日期设置为工作日或非工作日。

如果原来的工作日被调整为非工作日，就不会去检查它们的工作日志，因为放假啦可以不工作~~

维护工作时长

有些公司8小时，有些7.5小时。可以调整。

修改文件，保存即可（无需重启服务），

如果是16.4及以下的版本：{安装目录}\xampp\zentao\module\myworklog\config.php

如果是16.5及以上的版本：{安装目录}\xampp\zentao\extension\custom\myworklog\config.php

如果是linux版本：/var/www/html/extension/custom/myworklog/config.php

/* 工作时长设定.*/ $config->myworklog->workHourOnADay = 8;

维护时薪、月薪

时薪月薪是个很敏感的数据，工作量统计里能否被查看到，需要设置权限才行，如下：

权限设置

基本此模块每个操作都可以设置权限。

1. 一般普通员工就开放如下这几个权限

再为他们添加缺陷的工作登记的权限

他们登录后，菜单是这样的

1. 部门经理一般开通如下几个权限

如果是插件10.9以后的版本，还要勾选上“数据统计首页”权限项（10.9版本增加的），这样“数据统计”菜单才能出来：

他们登录后，菜单是这样的

1. 项目经理一般开通如下几个权限

如果是插件10.9以后的版本，还要勾选上“数据统计首页”权限项（10.9版本增加的），这样“数据统计”菜单才能出来：

他们登录后，菜单是这样的

其中，还有几个特别的权限：

1、"查看所有部门的工作日志"，会影响“工作日志（表格）”里日志明细的查询

如果具备此权限，如下这里会显示所有部门，表示可以查看任一一个部门的日志明细。选择“/”表示可以查询所有部门的明细；如果不具备此权限，默认能看本部门下的所有的人日志。

那能否只允许成员只能看自己的日志，不给看别人的日志呢？也可以，但不推荐（因为团队的工作应该可以共享，大家相互监督）。这样设置，修改文件：

如果是16.4及以下的版本：{安装目录}\xampp\zentao\module\myworklog\config.php。

如果是16.5及以上的版本：{安装目录}\xampp\zentao\extension\custom\myworklog\config.php。

如果是linux版本：/var/www/html/extension/custom/myworklog/config.php

保存即可（无需重启服务）。将false改为true，表示只能看自己的日志。

//设置工作日志（日历）、工作日志（表格）、日志不完整记录只能看自己的工作日志

$config->myworklog->worklogview_onlyself = false;

那能否只允许成员只能看自己的日志，但是部门经理可以看本部门的日志呢？目前不支持。可以为个别管理者开放“查看所有部门的工作日志”权限，看所有人的日志。

2、“查看所有项目的工作日志”，会影响“耗时统计（项目成员-模块）”下的项目的统计。

如果不具体此权限，只能查看项目经理为本人的项目的工作量的统计情况；如果具体此权限，可以统计所有的项目的工作量

钉钉通知设置（10.7重磅推出）

修改配置文件：

如果是Windows版本版本（禅道17.6.2+）：{安装目录}\xampp\zentao\module\myworklog\config.php。

如果是linux版本：/var/www/html/extension/custom/myworklog/config.php

//20230402：后台-通知设置-webhook列表中类型为“钉钉工作消息通知”的一个条目的ID

$config->myworklog->webhookID_dingding = "1";

//20230402：工作日志不完整检查提醒通知方式

$config->myworklog->noticeType = "mail"; //mail:邮件通知；dingding：钉钉通知。如果需要多种通知方式，使用逗号分隔，例如:mail,dingding

其中：

1、noticeType 可以修改为 dingding，如果同时需要邮件通知，就是mail,dingding

2、webhookID_dingding的值可以从如下界面获取，注意是类型为“钉钉工作消息通知”，否则发送通知失败。

如何配置一个“钉钉工作消息通知”webhook，可以参考我们这边配置的一个过程：

https://www.yuque.com/yuxian-tgyyu/hwusy9/wt42emzgipypskzp

以上都配置好了，可以使用admin登陆禅道，访问如下的路径就可以进行测试钉钉工作通知是否正常：

windows部署的禅道，访问：

http://{ip}:{port}/zentao/myworklog-sendDingdingTest-1-admin-title-hello.html

linux部署的禅道，访问：

http://{ip}:{port}/myworklog-sendDingdingTest-1-admin-title-hello.html

上面url的参数说明：

1 ：就是上面配置文件里的webhookID_dingding的值，替换成你真实的

admin ：是禅道里的用户的账号，但是要找一个绑定了钉钉账号的

title：就是要发送的标题

hello: 就是要的发送的内容

访问以上url，

如果成功界面会显示：string(20) "{"result":"success"}"，钉钉上会收到消息：

这样就表示全部链路都是打通的了，到时日志不完整的提醒就会发到各人的钉钉的了。

如果失败，会提升失败的原因，

• 如果提供的webhookID_dingding并不是类型为“钉钉工作消息通知”，会显示：string(78) "{"result":"fail","message":"webhookType is not dinguser,can't send dingding."}"
• 如果提供的禅道账号并没有绑定到钉钉的账号，会显示：string(87) "{"result":"fail","message":"can't get the 'dev1' dingding openId,can't send dingding."}"

最终，按上面的配置的话，到了通知的时间钉钉能收到日志提示，如下：

飞书通知设置（10.8重磅推出）

修改配置文件：

如果是Windows版本版本（禅道17.6.2+）：{安装目录}\xampp\zentao\extension\custom\myworklog\config.php。

如果是linux版本：/var/www/html/extension/custom/myworklog/config.php

//20230510：后台-通知设置-webhook列表中类型为“飞书工作消息通知”的一个条目的ID $config->myworklog->webhookID_feishu = "2"; //20230402：工作日志不完整检查提醒通知方式 $config->myworklog->noticeType = "feishu"; //mail:邮件通知；dingding：钉钉通知；feishu:飞书。如果需要多种通知方式，使用逗号分隔，例如:mail,dingding,feishu

其中：

1、noticeType 可以修改为 feishu，如果同时需要邮件通知，就是mail,feishu

2、webhookID_feishu的值可以从如下界面获取，注意是类型为“飞书工作消息通知”，否则发送通知失败。

如何配置一个“飞书工作消息通知”webhook，可以参考禅道官网这边配置的一个过程（我们安装这个文档，测试是可以成功）：

https://www.zentao.net/book/zentaopms/477.html

以上都配置好了，可以使用admin登陆禅道，访问如下的路径就可以进行测试钉钉工作通知是否正常：

windows部署的禅道，访问：

http://{ip}:{port}/zentao/myworklog-sendFeishuTest-2-admin-title-hello.html

linux部署的禅道，访问：

http://{ip}:{port}/myworklog-sendFeishuTest-2-admin-title-hello.html

上面url的参数说明

2：就是上面配置文件里的webhookID_dingding的值，替换成你真实的

admin ：是禅道里的用户的账号，但是要找一个绑定了钉钉账号的

title：就是要发送的标题

hello: 就是要的发送的内容

访问以上url，如果成功界面会显示：string(20) "{"result":"success"}"，飞书上会收到消息：

这样就表示飞书发送全部链路都是打通的了，到时日志不完整的提醒就会发到各人的飞书的了。

如果失败，会提示失败的原因，

• 如果提供的webhookID_feishu并不是类型为“飞书工作消息通知”，会显示：string(78) "{"result":"fail","message":"webhookType is not feishuuser,can't send feishu."}"
• 如果提供的禅道账号并没有绑定到钉钉的账号，会显示：string(87) "{"result":"fail","message":"can't get the 'dev1' feishu openId,can't send feishu."}"

最终，按上面的配置的话，到了通知的时间飞书能收到日志提示，如下：

组员的使用

填写工作日志

1. 工作台-我的-待办任务，点击列表右侧的“工时”按钮，弹出表单填写工作日志。
2. 填写后可以到工作日志-工作日志（日历）里看到填写过的内容。如果已经填够当天的工时，格子是绿色，如果没填够是红色。蓝色表示是未来的工作日，还不需要校对。

1. 剩余工时如果要支持自动计算，需要安装另一个插件（免费）。 链接地址：安装“任务剩余工时自动计算”插件

填写缺陷的工作日志（5.6重磅推出）

缺陷的修复和回归，也占用项目组很大一部分的工作量。禅道原生的功能在任务管理中，可以导入bug成为一个任务（主要是为了规划任务的安排），在此任务上填写工作日志和工作量，就可以被统计到项目的工作量里。但是大家反馈较为麻烦，因为缺陷数量一般很多，每次都要人工导入嫌麻烦，而且同一个缺陷一般有开发和测试人员参与，那就要分别导入两个任务，并分别指派给开发人员和测试人员，还是很麻烦的。

功能入口1：测试-Bug-操作列，新增了一个“工时”

功能入口2：bug详情底部的操作按钮，新增了一个“工时”

开发人员和测试人员就可以填写工作量和备注，会自动生成工作日志。 只有未关闭的缺陷才能填写工作日志。

自动登记到日志里，同时，也就可以被纳入工作量统计了。

注意要添加如下的权限，才可以看到操作的按钮

查看工作日志并导出

工作日志-工作日志（表格），可以导出个人的工作日志明细。

部门经理的使用

分配工作任务

项目-任务-建任务，设定预计工时，指派处理人。

被指派的人就可以在 工作台-我的-待办任务，看到此任务。

查看部门成员的工作量、人力费用统计

工作日志-耗时统计(部门成员-模块)

• 统计当前用户所在部门所有成员投入的工作量统计情况。
• 如果这些成员参与了多个项目，可以进一步按项目进行统计。

• 甚至可以按项目的模块逐层统计，这个很方便。
• 可以钻取到工作明细，支持导出。

• 可以查看时薪、工薪。不过需要有权限才能查看。

按账号、按日期、按项目维度统计工作量（10.8重磅推出）

1、工作日志-统计(成员累计)，按账号统计，可以统计每个人的耗时。

支持钻取进去看每个人的工作日志明细

2、工作日志-统计(成员累计)，按账号+日期统计，可以统计每个人每天的耗时。

3、工作日志-统计(成员累计)，按账号+日期+项目统计，可以统计每个人每天在每个项目的耗时。

加班审批

管理理念：加班代表着成本，需要对这些成本进行管控。管控手段包括：加班时长异常提醒、加班内容审批。加班内容也是工作日志的内容，在填写工作日志时就可以生成加班的工时，对工作日志的审批就是对加班的审批。

加班耗时显示

在工作日历中，显示加班的时长。

如果是工作日：加班的时长=当天工作总耗时-工作日正常上班的时长。

如果是非工作日：加班的时长=当天工作总耗时。

设置加班默认审批人

在“检查规则”里配置组员的加班的默认审批人（1人）。

加班审批（事后）

以日历的方式查看一个月内每天加班用户。

1. 以日历的方式展示。例如3月份有31天，就展示31个格子，每个格子代表一天。
2. 在格子里罗列单天有加班的用户。
3. 审批人对加班进行审批，

填写如下内容：

系数：必填，0\0.1\0.2\0.3\0.4\0.5\0.6\0.7\0.8\0.9\1，默认是1。

原因：可选。

系统自动记录审批人和审批时间。

4.审批人只能对归属自己审批的成员进行审批。

5.已审批显示在"checked[X\Y]",X表示审批人同意的加班时长，Y表示审批人同意加班系数，点击checked 可以弹出审批详情页面：系数、原因、审批人、审批时间。

6.未审批的用户红色标记。在有权限的情况下，点击用户名可以弹出审批页面。

7.审批人可以对审批进行修改。没有日期限制。

8.在工作日志（日历）上也可以进行审批。

加班转审批

审批人可以转审批（只能选一个人）。

转后的审批人可以再转审批。

默认的审批人和最后一位转审批的人才可以审批。

例如，成员出差他的工作可能在现场的领导更加清楚，那么原审核人可以通过转审批满足这种特殊情况。

导出加班明细（已审批）

导出指定月份的已审批的的加班情况：日期、账号、姓名、是否工作日、工作内容、工作总时长（h）、审批前加班时长（h）、审批后加班时长（h）、审批后的加班系数、理由、审批时间、审批用户。

项目经理的使用

项目经理对于日志管理和部门经理大体相同，看公司对项目经理的授权如何。主要的差别，工作量的统计，部门经理和项目经理关注的重点不太相同。

部门经理关注其部门成员的投入到各个项目的情况、每个人的工作是否饱和；

项目经理只关注自己负责的项目里的项目成员的工作量情况，不是投入到他这个项目的日志明细，他看不到。他只能看自己负责的项目的工作量，如下，项目负责人设定方式。

查看项目成员的工作量、人力费用统计

工作日志-耗时统计（项目成员-模块）

· 统计项目成员投入的工作量统计情况。
· 甚至可以按项目的模块逐层统计，这个很方便。
· 可以钻取到工作明细，支持导出。
· 可以查看时薪、工薪。不过需要有权限才能查看。