[]
        
(Showing Draft Content)

流程评论

流程评论是一个有助于改进流程执行的重要功能。它允许流程参与者在流程执行过程中进行交流、提出问题、分享意见,以便更好地理解和协作。在活字格中,您可以轻松实现流程评论功能。

简单示例 Demo

📎comments.zip

image

需求分析

基础需求

  1. 发表评论:一旦流程进入允许评论的任务节点,流程参与者可以在任务页面上发表评论。

  2. 评论内容:评论内容可以是纯文字、超文本、附件等信息。

  3. 评论历史:用户可以提出问题、提供建议或分享相关信息,并允许用户随时查看以前的评论。

高级需求

  1. 条件评论:定义哪些流程,哪些任务节点可以接受评论。

  2. 评论权限:定义谁可以在任务节点上发表评论,例如流程参与者或特定角色。

  3. 评论通知:设置是否向任务负责人发送新评论的通知。这有助于确保负责人能够及时看到和回应评论。

开发

数据表

  1. 添加一个评论表,包含ID,流程实例ID两个字段。

  2. 添加一个评论详情表,包含ID,评论表ID,内容三个字段。

    image

页面

  1. 添加一个流程评论页面,页面左上角放置一个静态文本评论列表。

  2. 页面主体为一个图文列表,数据源绑定评论详情表。

  3. 数据默认排序为创建日期正序,可在页面右上角放置一个单选按钮切换排序。

  4. 页面底部放置一个富文本编辑框,然后添加一个用于提交评论的按钮。

  5. 最后,在 FGC_任务详情页面底部放置一个页面容器单元格,用于显示流程评论页面。

    image

    image

服务端命令

  1. 添加一个提交评论的服务端命令,用于页面上的提交按钮。

  2. 命令接受两个参数流程实例ID和内容。

  3. 首先使用流程实例ID参数查询评论表,如果未查询到,就创建一条新的评论表记录。

  4. 然后为评论表添加一条新的评论详情表记录,其字段内容即为命令的内容参数。

    校验:建议为命令添加适当的校验条件,比如判断当前登录用户是否为流程的参与者,首先通过流程实例ID查询所有任务,接着检查当前登录用户是否为所有任务负责人里的一员。

    附件:若要支持评论的同时上传附件功能,请为评论详情表添加一个附件字段,然后在页面上添加一个附件单元格,点击提交评论按钮时,将单元格的值传递给提交评论服务端命令,并保存至数据库。

    通知:通过扩展提交评论服务端命令,例如为其添加一个发送邮件命令,即可实现新评论的通知。此外,您还可以轻松地实现其他通知方式,如发送钉钉消息,微信消息,手机短消息,站内即时消息等。

    image

测试

通过仔细测试和验证,您可以确保流程评论功能在流程应用中顺利运作。以下是一些测试方案和注意事项:

1. 数据表测试

  • 验证评论表和评论详情表的正确创建和关联。

  • 确保数据排序功能正常,用户可以切换评论的排序方式。

2. 页面测试

  • 测试流程评论页面的可视化,确保评论列表和富文本编辑框的显示正常。

  • 确保提交评论按钮可以正常提交用户输入的评论内容。

3. 服务端命令测试

  • 验证提交评论的服务端命令,包括参数传递、评论表和评论详情表的记录创建,以及内容的正确存储。

4. 整合测试

  • 确保流程评论功能与流程引擎的其他功能集成正常,例如,评论与流程实例或任务实例的关联,以及通知与任务负责人的流程交互。

5. 性能测试

  • 对于大量流程实例和评论,测试流程评论功能的性能,确保系统能够处理高负载情况下的评论。

6. 安全性测试

  • 确保评论功能不会引发安全漏洞,如跨站脚本攻击,其可通过过滤用户的输入进行防范。

7. 用户培训

  • 最后,确保用户接受培训,以了解如何使用流程评论功能。提供用户文档或培训材料,以帮助他们充分利用该功能。

总结

通过流程评论功能,您可以增强流程的协作性和透明度。流程评论使得流程参与者能够在流程执行过程中共享信息、讨论问题,并及时解决潜在的问题,从而提高业务效率和准确性。