HOS基础开发平台

# 从 2.5.4 升级到 2.6.1.3.0

# 更新时间

2024 年 08 月 15 日

# 更新内容

  1. 数据治理内容（组织人员菜单下功能）升级 v3 版本发布。v3 版本组织架构、账号数据均由上游各系统推送，平台暂不支持维护该部分数据。详见以下说明：数据关系 、数据来源。
  2. 登录方式升级，按照最新岗位单元方式登录。详见说明登录须知
  3. 优化openApi 日志。
    • 增加数据分类标识列，方便查看推送的数据分类。
    • 优化了上游数据推送失败时的提示，增加成功条数、失败条数、数据描述等。
  4. 内置的工作流回调接口改造优化。
  5. 提供当前账号相关基本属性的获取工具类，详见用户上下文。
  6. 优化文件存储秘钥存取安全性。
  7. 页面国际化维护逻辑，详见页面国际化维护及前端使用说明。
  8. 新增部分系统参数，如全局默认首页菜单编码、openApi日志保存天数、接口日志保存天数。详见内置系统参数说明。
  9. 动态参数内置属性优化。
  10. 人员信息升级。人员详情增加组织单元 OOOP 信息；增加人员排班数据查看的功能，详见查看人员排班信息。
  11. 菜单模块改造优化。
  12. 导航栏提供菜单搜索功能。
  13. 支持菜单平铺功能，在environment.js中修改VUE_FLOAT_MENU配置项为true。
  14. 修复若干 bug
  15. 优化部分用户体验
  16. 文档说明内容更新

# 前端升级步骤

  1. 请到 hos-app-web (opens new window) 代码仓库中release-2.6.1.3.0分支中将源码下载到本地；
  2. 如果自己业务工程中public、src/sys以及bin 的代码没有进行过手动修改的话，将该代码手动删除，然后将hos-app-web 中public、src/sys以及bin的代码复制到本地工程即可；
  3. 如果自己业务工程中public、src/sys以及bin 的代码进行过手动修改的话，请自行与hos-app-web 中public、src/sys以及bin的代码进行比对，手动进行同步并解决冲突代码；
  4. 在源码的根目录中新增_webpack-plugins目录,并在src目录下新增 public-path.js文件,并用于在npm run build构建时使用,如果有本地构建需求,务必一起复制到本地工程；
  5. 本次升级对 src目录里面的 App.vue、main.js、permission.js 文件有改动， 如果自己业务工程没有改动这几个文件，请直接复制，如果有改动，请进行比对，手动进行同步并解决冲突代码；
  6. 本次升级对 env.development文件有改动， 如果自己业务工程没有改动这个文件，请直接复制，如果有改动，请进行比对，手动进行同步并解决冲突代码。

# 后端升级步骤

  1. 在根 pom 文件中修改hos-app-dependencies的版本号为R2.6.1.3.0, 修改hos-starter-dependencies的版本号为R1.4.0,修改 hos-security-dependencies的版本号为R1.0.6
<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>com.mediway.hos</groupId>
            <artifactId>hos-app-dependencies</artifactId>
            <version>R2.6.1.3.0</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
        <dependency>
            <groupId>com.mediway.hos</groupId>
            <artifactId>hos-starter-dependencies</artifactId>
            <version>R1.4.0</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>

        <dependency>
            <groupId>com.mediway.hos</groupId>
            <artifactId>hos-security-dependencies</artifactId>
            <version>R1.0.6</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>
  1. 前往 Gitlab 下载页面（http://119.255.194.80/hos/demo/hos-app-demo/-/tree/2.6.1.3.0/project-strcutre/project-strcutre-demo/oa-business-parent/oa-boot-runner/src/main/java/com/mediway/hos） , 用户名/密码：hosuser/99ahivPJt
  2. 下载SecurityLoginConfig文件。
  3. 将文件放入启动模块中，覆盖原文件。

2.6.1.3.0-runner.jpg

# 升级数据库

根据数据库实际使用情况下载对应的升级脚本。（以下为 mysql 的升级示例）

  1. 前往 Gitlab 下载页面（http://119.255.194.80/hos/demo/hos-app-demo/-/tree/2.6.1.3.0/project-strcutre/project-strcutre-demo/oa-doc/data/mysql/2.6.1.3.0） , 用户名/密码：hosuser/99ahivPJt
  2. 下载hos-app-base-mysql-2.5.4~2.6.1.3.0.sql文件
  3. 执行更新 SQLhos-app-base-mysql-2.5.4~2.6.1.3.0.sql

# 修改 yml 文件

在 yml 配置文件中补充以下内容

hos-security:
  login: #登录相关配置
    white-list: #认证白名单
      /org/hos-post/select-post-page

spring:
  jackson:
    default-property-inclusion: non_null
    serialization:
      FAIL_ON_EMPTY_BEANS: false

# 上传模板文件

  1. 下载模板文件。
  2. 在文件存储管理中，配置好需要存储文件的服务器。 2.5.1-fileStorage.png
  3. 在文件管理中，导入第一步下载好的 zip 格式模板文件压缩包。 2.5.1-file.png

# 补充说明

升级前请注意：

  1. 该版本为最新 v3 版本组织架构，与 v2 版本不兼容适配。升级前建议备份数据库！升级后需要重新整理接收基础数据，且相关业务需按最新表结构梳理或开发调整。
  2. 该版本目前仅支持 mysql、人大金仓数据库，后续版本会支持其他数据库。

← 从 2.5.4.5 升级到 2.5.4.6 →