HOS基础开发平台

# 从 2.5.3.3 升级到 2.5.4

# 更新时间

2024 年 06 月 18 日

# 更新内容

  1. 兼容达梦数据库
  2. 兼容南大通用数据库8C版本
  3. 支持国际化组件联合主键
  4. 菜单模块改造优化
  5. openApi管理、第三方接口配置出入参存储结构升级改造
  6. 修复若干 bug
  7. 优化部分用户体验
  8. 文档说明内容更新
  9. 兼容老版统一认证
  10. 打印设计器新增打印机配置、即打即停、纸张横\纵向配置、表格内显示图片；新增自定义模板元素，手动传入页面元素的功能
  11. 403或404页面可以在静态文件夹中的指定文件内自定义配置。使用详见自定义403或404错误页面内容

备注：2.5.4是从2.5.3.3升级上来的，
如果当前版本是2.5.3，请按照2.5.3->2.5.3.1->2.5.3.3->2.5.4的顺序进行升级，
如果当前版本是2.5.2，请先升级升级到2.5.3，再按照顺序升级到2.5.4。

# 前端升级步骤

  1. 请到 hos-app-web (opens new window) 代码仓库中release-2.5.4分支中将源码下载到本地；
  2. 如果自己业务工程中 src/sys的代码没有进行过手动修改的话，将该代码手动删除，然后将hos-app-web 中src/sys 的代码复制到本地工程即可；
  3. 如果自己业务工程中 src/sys的代码进行过手动修改的话，请自行与hos-app-web 中src/sys 的代码进行比对，手动进行同步并解决冲突代码；
  4. 如果自己业务工程中 package.json、vue.config.js、.env.development的代码进行过手动修改的话，请自行与hos-app-web 中的代码进行比对，手动进行同步并解决冲突代码。
  5. 如果自己业务工程中 src/App.vue、src/permission.js的代码进行过手动修改的话，请自行与hos-app-web 中的代码进行比对，手动进行同步并解决冲突代码。
  6. 如果自己业务工程中 public/environment.js、public/index.html的代码进行过手动修改的话，请自行与hos-app-web 中的代码进行比对，手动进行同步并解决冲突代码。
  7. 在public/static文件夹下新增一个图片，名称为loading.png。

# 后端升级步骤

  1. 在根 pom 文件中修改hos-app-dependencies的版本号为2.5.4-RELEASE, 修改hos-starter-dependencies的版本号为1.3.3-RELEASE,修改 hos-security-dependencies的版本号为1.0.5-RELEASE
<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>com.mediway.hos</groupId>
            <artifactId>hos-app-dependencies</artifactId>
            <version>2.5.4-RELEASE</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
        <dependency>
            <groupId>com.mediway.hos</groupId>
            <artifactId>hos-starter-dependencies</artifactId>
            <version>1.3.3-RELEASE</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>

        <dependency>
            <groupId>com.mediway.hos</groupId>
            <artifactId>hos-security-dependencies</artifactId>
            <version>1.0.5-RELEASE</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

# 修改yml文件

  1. 在认证白名单配置中添加接口
hos-security:
   login:
      white-list:                         #认证白名单
         - /i18n/element/get-login-page-config
  1. 微服务模块中如果引用了hos-app-base微服务模块中api的jar包，如hos-app-org-api或hos-app-core-api,则需要在微服务的配置文件添加hos.cloud.name配置，其值为hos-app-cloud-runner服务的服务名，默认为hos-base-server：
hos:
  cloud:
    name: hos-base-server

# 升级数据库

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

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

# 上传模板文件

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

# 增加菜单刷新

在需要重新加载菜单的地方，调用window.parent.postMessage(obj,'*')方法手动触发刷新菜单。 其中obj数据格式为：

{
   //必传固定
  "type": "refreshMenu",
  "data": {
     //参数可为空非必传
    "categoryId": "",
     "categoryLocation": "",
     "resourceCode": "",
     "pageData":{
        //菜单的个性化配置的时候传入的数据;   
     }
     
 }
}

← 从 2.5.3.1 升级到 2.5.3.3 →