概述
Frappe Framework 中的 待办事项 文档类型可帮助用户跟踪和管理分配给自己或他人的任务。待办事项可以独立创建，也可以与系统中的其他文档关联，从而提供一个集中式的任务管理系统。
待办事项字段
- 状态：可以是“未开始”、“已完成”或“已取消”
- 优先级：设置为“高”、“中”或“低”（默认为“中”）
- 颜色：可选的彩色标签，用于视觉识别
- 截止日期：任务应完成的时间
- 描述：任务的主要内容（必填）
- 参考类型 和 名称：可选链接到相关文档（例如，特定的工单、线索等）
- 角色：可选的角色分配
- 分配人：创建或分配任务的用户
- 负责人：负责完成任务的用户
创建待办事项
可以通过以下几种方式创建待办事项：
-
直接创建：
- 导航到待办事项列表
- 点击“添加待办事项”按钮
- 填写必填信息并保存
-
通过分配功能：
- 从任何文档（例如，工单、任务）中，使用“分配给”功能
- 系统会创建一个待办事项并将其链接到该文档
-
通过电子邮件：
- 使用适当的设置向系统发送电子邮件
- 邮件内容会自动转换为待办事项（待办事项位于
email_append_to设置中）
-
通过分配规则：
- 根据条件设置自动分配
- 当条件满足时，系统会自动创建待办事项（注意：不能对待办事项文档类型本身设置分配规则）
管理待办事项
标记为已完成
要将 待办事项 标记为已完成：
- 打开该待办事项
- 将状态更改为“已完成”
- 保存文档
只有被分配人（“负责人”字段中的用户）才能关闭分配给他们的待办事项。如果通过界面操作，当其他人试图完成他人的待办事项时，系统会显示错误提示。
取消待办事项
要取消 待办事项：
- 打开该待办事项
- 将状态更改为“已取消”
- 保存文档
取消与完成不同，它表示该任务将不会被执行，而不是已经完成。
截止日期的影响
截止日期字段：
- 有助于确定任务的优先级
- 提供目标完成日期
- 在列表视图中用于对待办事项进行排序和筛选
- 分配规则会使用它进行自动化的截止日期管理
但是，系统不会在截止日期临近或已过时自动发送提醒。如果您需要此功能，请考虑创建自定义的 通知。
通知
系统在以下场景中会发送通知：
-
当文档被分配或分配被取消时：
- 被分配人会收到通知
- 通知中包含任务描述以及分配人或取消分配人的信息
-
全局通知计数器：
- 未完成的待办事项会计入 Frappe 界面中的通知计数器
- 该计数器可帮助用户一目了然地查看自己有多少未完成的任务
权限
- 用户可以查看分配给自己或由自己创建的待办事项
- 系统管理员可以访问所有待办事项
- “所有”角色拥有创建、读取、写入和删除待办事项的权限
与其他文档的集成
当 待办事项 链接到其他文档时：
- 分配待办事项时，会在被引用的文档中添加一条评论
- 待办事项完成或取消时，也会添加一条评论
- 被引用文档的
_assign字段中的分配用户列表会更新 - 查看被引用的文档时，用户可以查看该文档分配给了谁
使用分配规则
虽然不能为 待办事项 文档类型本身创建分配规则，但可以为其他文档类型创建规则来生成待办事项：
- 根据文档条件创建规则
- 使用轮询、负载均衡或基于字段的分配方式来分配任务
- 根据文档字段自动设置截止日期
- 当文档条件发生变化时，关闭或重新分配待办事项
分配规则为整个系统的任务管理提供了强大的自动化功能。