HOS基础开发平台

# 从 R2.6.6.3.41 升级到 R2.6.6.3.43

# 更新时间

2025 年 7 月 11 日

# 更新内容

  1. 登录相关功能中关于使用到redis的keys查询优化改造，涉及到的功能点包括：多端登录控制、在线用户查询。
  2. 在线用户查询功能优化。
  3. 浏览器关闭或者窗口关闭时退出功能优化（由线程等待修改为redis过期监听）。
  4. 新增应用系统退出时是否触发统一认证退出的开关控制
  5. 实现单体登录与单点登录共存。
  6. 修复基础字典-学历导入数据不能更新是否启用字段的问题
  7. 修复基础字典-行政区划导出问题。
  8. 水印支持自定义组合文字，自定义调整水印的旋转角度。

# 前端升级步骤

  1. 请到 hos-app-web (opens new window) 代码仓库中 release-2.6.6.3.43 分支中将源码下载到本地。
  2. 如果自己业务工程中src/sys/hos-app-base的代码没有进行过手动修改的话，将该代码手动删除，然后将hos-app-web 中src/sys/hos-app-base的代码复制到本地工程即可；
  3. 如果自己业务工程中src/sys/hos-app-base的代码进行过手动修改的话，请自行与src/sys/hos-app-base的代码进行比对，手动进行同步并解决冲突代码；

# 后端升级步骤

  1. 在根 pom 文件中修改hos-app-dependencies的版本号为R2.6.6.3.43,修改hos-starter-dependencies的版本号为R1.5.7.17, 修改 hos-security-dependencies的版本号为R1.0.8.29。
<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>com.mediway.hos</groupId>
            <artifactId>hos-app-dependencies</artifactId>
            <version>R2.6.6.3.43</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
        <dependency>
            <groupId>com.mediway.hos</groupId>
            <artifactId>hos-starter-dependencies</artifactId>
            <version>R1.5.7.17</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
        <dependency>
            <groupId>com.mediway.hos</groupId>
            <artifactId>hos-security-dependencies</artifactId>
            <version>R1.0.8.29</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>
  1. 新增应用系统退出时是否触发统一认证退出的开关控制
    默认为false(只退出本系统)，不需要开启此功能的可以不进行配置
    配置成true(退出本系统以及统一认证)时，应用系统通过单点登录时，点击应用系统退出按钮会触发统一认证的退出，影响其他已打开应用的使用.
hos-security:
  oauth2:                                               #统一认证oauth2登录配置
    ssoLogout: false                                      #是否退出时触发统一认证退出，默认值为false

  1. 应用系统走单点登录的访问路径：前端的根路径/sso
    例如：https://114.251.235.9:8327/sso

    应用系统走单点登录还有个前提条件是后端yaml文件开启了统一认证（hos-security.oauth2.enable=true），另外统一认证服务是正常的，否则强制走单体登录。
    该功能影响通过单点方式打开其他应用具体菜单功能，打开的菜单路由由原来的:/菜单路由，改成：/sso?redirect=/菜单路由 例如：/organization改成/sso?redirect=/organization

  2. 在线用户查询方式由原来的从缓存获取改成从登录日志表查询，所以如果之前的登录用户没有正常退出，
    会被记录在内，这些数据需要进行手动强制下线处理。

# 数据库脚本

请根据数据库实际使用情况，仔细核对数据库类型，下载当前使用的数据库对应的升级脚本。

（以下为 高斯数据库 的升级示例）

  1. 前往 Gitlab 下载页面（https://106.63.4.7:8000/hos/demo/hos-app-demo/-/tree/master/project-strcutre/project-strcutre-demo/oa-doc/data/opengauss/2.6.6.3.43） , 用户名及密码为自己的 Git 账号密码，没有权限的话找王鑫申请，没有账号的话找自己的主管向公司申请。
  2. 下载hos-app-base-opengauss-2.6.6.3.40~2.6.6.3.43.sql文件
  3. 执行更新 SQLhos-app-base-opengauss-2.6.6.3.40~2.6.6.3.43.sql

← 从 R2.6.6.3.40 升级到 R2.6.6.3.41 →