基础框架文档中心

外观

版本记录 ​

v1.8.2 ​

2025/7/21

本版本实现了流程引擎会签功能，修复了一些问题。

新增 ​

  1. 流程引擎新增会签功能，支持多人办理工作。
  2. 流程引擎新增办理附件功能，支持上传图片与文件。
  3. 部门组织同步新增编码字段。
  4. 新增基于网关的新版消息服务调用方法，其内部不再使用 UHP。

修正 ​

  1. 修正流程引擎转发任务无法查看详情问题。
  2. 修正流程引擎在特殊节点时进行管理员操作报错问题。
  3. 修正流程引擎在发起流程时产生不必要的消息通知问题。
  4. 修正基于配置的服务默认名称与预期不一致问题。

变更 ​

  1. SagUmppService 中原有 sendQyWechat/Async 方法已标记为过时，请使用新增重载方法。

移除 ​

无

升级指南 ​

  1. 请执行docs/versions/v1.8.2.sql。
  2. 如果使用新版 sendQyWechat/Async 方法，请更新配置文件：
    yaml
    umpp:
 qyAgentId: # 网关下发的企业应用标识，联系负责人获得
 # 其它配置项已省略，请参看 v1.8.1 说明

v1.8.1 ​

2025/6/25

本版本开放了一些系统关键数据的查询功能，支持流程引擎与员工中心集成。

新增 ​

  1. 流程管理功能新增“流程中心”显示开关，支持在流程中心隐藏指定流程。
  2. 菜单管理功能新增“数据共享”开关，允许管理人员设置是否开放给外部使用。
  3. 新增开放数据查询接口，支持菜单、用户菜单、流程、用户流程、工作、任务查询。
  4. 新增工作数据实时推送功能，支持与员工中心集成。
  5. 流程引擎节点配置支持添加备注信息。
  6. 流程引擎流程管理支持上传操作手册，供用户办理工作时下载查看。
  7. 流程引擎的用户节点新增节点服务设置功能，支持在流程到达该节点时执行自定义逻辑。
  8. 新增基于网关的消息平台调用服务 SagUmppService。
  9. HttpUtils 网络请求方法新增请求超时参数 timeout。

修正 ​

  1. 修正流程引擎子流程节点无法配置页面视图问题。

变更 ​

  1. HttpUtils 网络请求现在默认超时时间为 60 秒。如不满足业务需要，请调用重载方法指定超时时间。

移除 ​

无

升级指南 ​

  1. 请执行docs/versions/v1.8.1.sql。
  2. 如果要启用向员工中心推送工作数据功能，请添加如下配置：
    yaml
    hzcc:
 workflow:
   empCenter:
     sysCode: frm # 员工中心下发的应用标识
     enable: false # 功能开关
     max-trans-exec-seconds: 10 # 事务预期最大执行时间。推送服务会在事务开始到此时间内不断尝试获取最新数据，不宜设置过大。
     max-retry: 3 # 网络请求错误重试次数
     retry-delay-millis: 1000 # 网络请求错误重试时间间隔
     retry-grow-factor: 2 # 网络请求错误重试时间间隔增长因子。本次时间=上次时间*因子。
    注意：使用此功能需要同时配置网关信息。
  3. 如果要调用网关服务，请添加如下配置。
    yaml
    # sag调用参数
sag:
  appId: jfrm # 网关下发的应用标识
  secret: 4b8xxxxxxx129 # 网关下发的应用密钥
  url: http://118.195.128.183:3095 # 网关地址
  4. 如果要使用消息平台服务，请添加如下配置。
    yaml
     # umpp调用参数
 umpp:
   emailCode: 529742454 # 消息平台下发的邮件账号标识
   appCode: jfrm # 当前应用自定义标识
   qyCode: qy_xxx # UHP下发的企业微信应用标识

v1.8.0 ​

2024/8/29

本版本升级了流程引擎。添加了更多功能，优化了部分原有功能实现方式。

新增 ​

  1. 添加基于规则的流程操作人、抄送接收人配置功能
  2. 添加基于规则的流程超时、提醒功能
  3. 添加转发、转办功能
  4. 添加工作代理功能
  5. 添加消息模板管理功能
  6. 添加管理员流程干预功能
  7. 创建工作时，支持直接推进工作。
  8. 添加流程分类及统计功能
  9. 添加我的工作查询功能，支持自定义扩展
  10. 添加与OA系统待办中心的集成功能。
  11. @Excel 注解添加 trimZero 开关，用于控制是否删除结尾的0。
  12. 添加与HRM系统原始接口的组织、人员同步功能。

修正 ​

  1. 修正跨域导出文件时未返回相关响应头问题。
  2. 修正配置的多个系统退出地址不生效问题。

变更 ​

  1. 流程不允许删除、编辑状态，只允许上线与下线。
  2. 流程start节点作为起填节点，无需重复推进。流程权限由start节点操作人配置决定。
  3. 工作不再支持草稿状态，创建后不推进即可。
  4. 非本人或默认（未指定人员）任务不可办理，支持忽略权限。
  5. 子流程发起与结束参数，现支持版本号、业务id。
  6. 原workStepDto变更为workStepNodeDto
  7. 分支节点未匹配任何条件时，现在会抛出异常。
  8. 结束节点任务办理人员不再使用当前用户，无需办理。
  9. 删除工作时，支持非创建者操作，默认限制为开始节点。
  10. @BoundFiles 注解的 businessId 参数，现在可以指定从返回结果中获取值。例如："#result.id"。

移除 ​

  1. 移除/api/wf/workflow-nodes/work/{id}接口，不再支持根据工作查询节点列表。
  2. 移除/api/wf/work-tasks/work/{id}接口，不再支持根据工作查询任务列表。

升级指南 ​

  1. 请执行docs/versions/v1.8.0.sql。
  2. application-*.yml文件添加hzcc.workflow.notice配置项，取值由消息平台下发。
  3. application-*.yml文件设置xxl.job.enabled为true。
  4. 在xxl-job管理端创建执行器：wf-timeout、wf-message。
    • wf-message建议触发频率为5分钟
    • wf-timeout触发频率可适当放宽至20分钟，最大不能超过1小时。
  5. 阅读流程引擎文档，了解新功能使用方法。

v1.7.2 ​

2024/6/14

本版本补充了更多人员信息。

新增 ​

  1. 添加岗位信息同步
  2. 添加人员岗位、上级信息

修正 ​

  1. 修正人员查询时，匹配工号或姓名的正则问题。

变更 ​

无

移除 ​

无

升级指南 ​

  1. 请执行docs/versions/v1.7.2.sql。

v1.7.1 ​

2023/11/14

本版本优化了一些累积问题。

新增 ​

  1. 数据维度为树型数据时，支持更多控制选项

修正 ​

无

变更 ​

无

移除 ​

无

升级指南 ​

  1. 请执行docs/versions/v1.7.1.sql。

v1.7.0 ​

2023/7/28

本版本添加了工作流引擎相关内容。

新增 ​

  1. 流程管理功能
  2. 工作创建、办理、消息提醒功能
  3. 工作台功能

修正 ​

无

变更 ​

无

移除 ​

无

升级指南 ​

  1. 请执行docs/versions/v1.7.0.sql。
  2. 配置文件添加hzcc.workflow.notice配置项，具体请参考hzcc-frm-api配置文件。

v1.6.1 ​

2023/6/26

本版本对树型字典相关内容进行了重构，使命名易于理解，功能稍作增强；以及一些其它累积更新。

新增 ​

  1. 用户表添加岗位字段

修正 ​

  1. 修复字典缓存操作无效问题

变更 ​

  1. 树字典相关文件更名Classification -> TreeDictionary，ClassificationType -> TreeDictionaryType。
  2. 合并树字典查询接口，支持根据typeId或typeCode查询；支持includeDisabled查询。
  3. 树字典取消-1（删除）状态使用，不再支持删除操作。

移除 ​

无

升级指南 ​

  1. 请执行docs/versions/v1.6.1.sql。

v1.6.0 ​

2023/5/28

本版本加入了组织机构（部门）数据同步功能，提供了相关查询接口；同时加入人员-组织机构关联，可根据部门信息查询人员。

新增 ​

  1. 添加组织机构(Organization)相关同步、查询功能
  2. 添加人员-组织机构同步功能；根据组织机构搜索人员功能

修正 ​

无

变更 ​

无

移除 ​

无

升级指南 ​

  1. 请执行docs/versions/v1.6.0中升级sql。

v1.3.1 ​

2023/6/28

本版本加入了用户岗位信息，供从外部同步使用。

新增 ​

  1. 用户添加岗位字段

修正 ​

无

变更 ​

无

移除 ​

无

升级指南 ​

  1. 请执行docs/versions/v1.3.1.sql。

v1.3.0 ​

2022/12/6

优化数据权限功能；添加用户姓名拼音及查询功能

新增 ​

  1. 用户表添加拼音信息
  2. 用户数据权限表添加维度选项文本信息

修正 ​

无

变更 ​

  1. UserService#serchList 搜索逻辑修改为：工号精确、拼音右模糊、姓名左右模糊搜索。

移除 ​

无

升级指南 ​

  1. 务必执行docs/versions/v1_3_0中升级sql。

v1.2.0 ​

资源表添加数据权限信息，优化数据权限功能

新增 ​

  1. 资源表添加数据权限信息

修正 ​

无

变更 ​

无

移除 ​

无

升级指南 ​

  1. 务必执行docs/versions/v1_2_0中升级sql。