提供统一的界面填写工作日志，核心提供如下的能力：1）保留原日志填写入口的基础上，统一日志填报的入口，默认将上次填报的项目的任务罗列出来，可以切换日期、项目来填报日志；2）增加今日总结、明日计划的填报；3）支持共享填报，无需为多人创建相同的任务，他们可以在同一个任务上共同填报工时，例如：会议、请假等。

日志适配插件

开源版17.6.1及以下的版本需要先安装官方的日志插件effort，17.6.2及以上的版本可以不安装官方的日志插件effort。

本插件提供统一的界面填写工作日志，核心提供如下的能力：1）保留原日志填写入口的基础上，统一日志填报的入口，默认将上次填报的项目的任务罗列出来，可以切换日期、项目来填报日志；2）增加今日总结、明日计划的填报；3）支持共享填报，无需为多人创建相同的任务，他们可以在同一个任务上共同填报工时，例如：会议、请假等。

解决痛点

1、日志的入口散落到各个项目的任务、缺陷、版本、测试单里。没有统一聚合的填写入口。

2、日志汇总只是将当天的日志明细罗列，看不到关联的项目、任务，看不到耗时、任务的状态。

3、缺少今日计划和今日总结的对比，缺少明日计划的规划。

4、缺少公共的任务的填写机制，例如开会、请假、参与培训等，很多人都需要填写，目前需要为每个人分配具体的任务，管理麻烦。

产品特点

1、统一日志填报的入口。可以多选项目进行填报。默认显示上次填报的项目。

2、提供 今日计划、明日计划的填写，汇总今日的日志和今日计划进行对比。

2、每人每天的日志汇总按项目归类，显示耗时和任务的状态。不只是罗列当天日志明细。

3、支持公共任务的填写机制。标记任务类型为共享，这种类型下任务不需要指派具体的人，具备响应角色权限就可以共同填报日志。

4、测试单、提测版本的日志可按角色共享填写。

5、零碎缺陷日志汇总成一条日志显示。【这条需要安装官方的日志插件effort】

6、方便统计漏填日志的人员。

日志填报

日志明细

日志汇总

其中“刷新汇总数据”，它是用于立即刷新数据的，当数据量大时汇总数据比较耗费资源，建议只开放管理人员。数据每天早上会自动更新汇总的。

日志汇总或明细的导出

提测版本-共享填报

提测版本是指在执行-版本创建的条目。这里只显示已经关联了测试单而且测试单还未关闭的条目。

使用场景：开发人员当天这个版本修复了一系列小问题（每个问题基本就是10多分钟，但合起来可能有1-2个小时），或者临时的多次部署安装更新等操作（合起来有1个小时），不想登记多个缺陷或多个任务来跟踪，那么这些开发人员可以填报工时到“提测版本”。

默认是开发、研发主管角色可以看到此提测版本的公共条目，如果要调整，修改配置文件：

{安装目录}\zentao\extension\custom\effortmate\config.php 如下的条目

$config->effortmate->shareTaskTypeList["build"]=$config->effortmate->dev_roleName.','.$config->effortmate->dev_manager_roleName;

如果不想开放出来，不想作为共享填报，可以修改配置文件：

{安装目录}\zentao\extension\custom\effortmate\config.php 如下的条目，将值为false

$config->effortmate->isShareBuild = true;

测试单-共享填报

提测版本是指在“执行-测试”创建的测试单条目。这里只显示还未关闭的条目。

使用场景：测试人员当天这个测试了一系列小问题（每个问题基本就是10多分钟，但合起来可能有1-2个小时），或者临时的多次部署安装更新等操作（合起来有1个小时），不想登记多个缺陷或多个任务来跟踪，那么这些开发人员可以填报工时到“测试单”

默认是测试、测试主管角色可以看到此测试单的公共条目，如果要调整，修改配置文件：

{安装目录}\zentao\extension\custom\effortmate\config.php 如下的条目

$config->effortmate->shareTaskTypeList["testtask"]=$config->effortmate->test_roleName.','.$config->effortmate->test_manager_roleName;

如果不想开放出来，不想作为共享填报，可以修改配置文件：

{安装目录}\zentao\extension\custom\effortmate\config.php 如下的条目，将值为false

$config->effortmate->isShareTestTask = true;

显示全部人员的汇总

使用场景：管理员要快速识别：指定部门指定日期范围内是否存在为填报的情况，以便管理。

在日志汇总里勾选上“显示部门全部成员”，就会显示所有人填写的情况，如果耗时、今日明细等为空就表示没有填写。

特别的，离职的人员（人员的真实姓名里如果含有‘离职’字样的人）的日志如果为空，则不显示。如果也想显示这些离职的人，可以修改配置：

{安装目录}\zentao\extension\custom\effortmate\config.php 如下的条目，将值为false

$config->effortmate->isKickQuitJob = true;

缺陷日志聚合显示 【这条需要安装官方的日志插件effort】

使用场景：开发人员修复了多个缺陷，每个缺陷都填写了日志。但是工作明细里期望不要具列出来都修改了哪些缺陷。统一显示“bug修改”就行。

公共任务填报

使用场景：有一些任务很多人都需要填写，例如开会、请假、参与培训等。标记任务类型为共享，这种类型下任务不需要指派具体的人，具备响应角色权限就可以共同填报日志。

步骤1：禅道-后台-自定义-任务-类型，增加一个新的类型

名称可以自己随意，例如 ：public 公共

步骤2、修改配置，设置共享填报的模式为TASKTYPE

{安装目录}\zentao\extension\custom\effortmate\config.php 如下的条目，将值为TASKTYPE

$config->effortmate->shareTaskModel = "TASKTYPE" ; // 可以选填：NONE, TASKTYPE 或 TASK。

步骤3、修改配置，设置参与的角色

在配置文件最后增加一行，如下的“public”为步骤1定义的类型的编码，“*”表示任何角色都可以参与这个公共任务的填写：

$config->effortmate->shareTaskTypeList["public"]="*";

如果要指定一个或多角色才能填写这个公共任务，这样配置：

$config->effortmate->shareTaskTypeList["public"]=$config->effortmate->product_manager_roleName.",".$config->effortmate->product_roleName.",".$config->effortmate->dev_manager_roleName;

上面的角色分别是什么意思，附上说明（也可以在配置文件重新进行定义）：

//产品经理角色的Name

$config->effortmate->product_roleName = "产品经理";

//产品主管角色的Name

$config->effortmate->product_manager_roleName = "产品主管";

//项目经理角色的Name

$config->effortmate->project_manager_roleName = "项目经理";

//开发人员角色的Name

$config->effortmate->dev_roleName = "研发";

//开发主管角色的Name

$config->effortmate->dev_manager_roleName = "研发主管";

//测试人员角色的Name

$config->effortmate->test_roleName = "测试";

//测试主管角色的Name

$config->effortmate->test_manager_roleName = "测试主管";

//UI人员角色的Name

$config->effortmate->UI_roleName = "UI";

步骤4：创建任务，任务类型就选择上面的“公共”类型

指派人不需要指定。指定了也没关系，只要符合步骤3的角色的人都可以看到这个公共任务的。

步骤5：待填工作明细里就会出现

只要符合步骤3的角色的人都可以看到这个公共任务的。

默认显示部门事务的项目

使用场景：企业矩阵的管理模式，导致一个员工的任务，往往两种来源：交付项目、部门事务。在日志填报时，默认显示其部门事务项目下指派给他的任务。减去手动勾选的麻烦，避免遗漏部门的事务。

步骤1：创建的执行名称，要带上“部门事务”四个字眼

然后为这个执行选择团队人员。

步骤2：登录后就可以默认看到这个部门事务的“执行”被选中

并且会在待填写列表里加载指派给他的任务。

分配权限

使用场景：为其他成员分配权限，分配后就可以在左侧导航看到“日志”。

其中“刷新汇总数据”，它是用于立即刷新数据的，当数据量大时汇总数据比较耗费资源，建议只开放给管理人员。数据每天早上会自动更新汇总的。