HOS基础开发平台

# 从 2.6.3.3.0 升级到 2.6.4.3.0

# 更新时间

2024 年 11 月 20 日

# 更新内容

  1. 基础框架支持精简版和简版，历史版本即默认版本为专业版。其中：
    • 精简版按人员定岗（业务单元/业务岗位）绑定的角色决定使用权限。
    • 简版直接使用账号分配的角色决定使用权限。
    • 专业版保持不变，由上游排班系统指定的岗位单元内的业务岗位绑定角色决定使用权限。
      具体内容详见平台功能介绍。
  2. 支持页面查看当前使用的前后端版本，便于问题版本的快速定位。
  3. 新增功能: 页签切换确认/菜单切换抛出事件/退出登陆确认。具体内容详见菜单管理。
  4. 修复若干 bug。
  5. 优化部分用户体验。

# 前端升级步骤

  1. 请到 hos-app-web (opens new window) 代码仓库中release-2.6.4.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. 如果自己业务工程中.env.development、src/App、src/dynamic-loader.js、src/main.js、src/moduleConfig.js、package.json的代码进行过手动修改的话，请自行与hos-app-web 中.env.development、src/App、src/dynamic-loader.js、src/main.js、src/moduleConfig.js、package.json的代码进行比对，手动进行同步并解决冲突代码；
  5. 如果自己业务工程中src/biz/enum/grantTypeEnum.js、src/biz/version.js、src/biz/views/sysDialog/index.vue、vue.config.js的代码进行过手动修改的话，请自行与hos-app-web 中src/biz/config.js、src/biz/enum/grantTypeEnum.js、src/biz/router/util/index.js、src/biz/utils/biz-tab-layout-expand.js、src/biz/version.js、src/biz/views/sysDialog/index.vue、vue.config.js的代码进行比对，手动进行同步并解决冲突代码；
  6. 新增_webpack-plugins/EditHtmlContentWebpackPlugin.js文件;
  7. 删除src/biz/.version文件、src/sys/hos-app-base/.version文件；
  8. src/public-path.js、src/permission.js、src/defaultSettings.js更改为src/sys/hos-app-base/public-path.js、src/sys/hos-app-base/permission.js、src/sys/hos-app-base/defaultSettings.js；
  9. 复制hos-app-web中的biz/version.js文件到自己本地工程的相应目录上去；在version.js里可以定义自己前端业务代码的版本号，登录后点击头像-代码版本可以查看相关前端后端的代码版本。

# 后端升级步骤

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

  1. 后端增加 VERSION 接口，用于获取当前使用版本。
    2.1. 前往 Gitlab 下载页面（http://119.255.194.80/hos/demo/hos-app-demo/-/tree/2.6.4.3.0/project-strcutre/project-strcutre-demo/oa-business-parent/oa-boot-runner/src/main/java/com/mediway/hos/controller） , 用户名/密码：hosuser/99ahivPJt
    2.2. 下载VersionController文件。
    2.3. 将文件放入启动模块中com.mediway.hos.controller包下。 如下图所示：

    26430.png
    2.4. 参考 HOS 基础平台后端版本的获取逻辑，确定一个稳定的类，在VersionController中完善后端业务模块版本的获取代码。

// HOS基础平台后端版本获取示例
String hosVersion= AppPackageInfoUtil.getVersion(HosUserAccountController.class);

26430-2.png

# 精简版使用配置

如需使用精简版，请在 yml 文件中配置以下内容。不配默认为专业版（professional）。

hos:
  functional:
    version: professional #professional、wrought、simple (专业版、精简版、简版)

# 升级数据库

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

（以下为 mysql 的升级示例）

支持的数据库

  1. 前往 Gitlab 下载页面（http://119.255.194.80/hos/demo/hos-app-demo/-/tree/2.6.4.3.0/project-strcutre/project-strcutre-demo/oa-doc/data/mysql/2.6.4.3.0） , 用户名/密码：hosuser/99ahivPJt
  2. 下载hos-app-base-mysql-2.6.3.3.0~2.6.4.3.0.sql文件
  3. 执行更新 SQLhos-app-base-mysql-2.6.3.3.0~2.6.4.3.0.sql
    注：因时间原因，该版本只支持高斯数据库、人大金仓数据库、南大通用8C数据库和mysql数据库。

# 上传模板文件

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

← 从 2.6.3.3.0 升级到 2.6.3.3.1 →