# Vue3＋Flowable表单怎么升级？新字段、权限与旧单一起验收

“采购申请加一个收货地点”，看起来只是页面多一个输入框。上线以后却有三个不同的问题：新申请能否填写，旧申请应该显示什么，审批人能否按正确权限查看。

这篇讨论RuoYi Office独立数据表表单的一次实际升级：第一版已经产生两张完成审批的采购单，第二版增加可选字段，再发起新单。文章把这次操作与Vue3管理端、后端发布逻辑放在一起，解释版本到底保存在哪里。

这里的重点是业务表单升级，不是Vue依赖升级，也不是整个平台的数据库迁移教程。

![Vue3与Flowable表单版本分叉时间线](https://developer.qcloudimg.com/http-save/yehe-12798805/a1bc0bd37bb692532930620ef58a6bbc.png)

*新版本承接新申请，旧单保留对应定义；能否这样工作，需要前后端和存储共同配合。*

## 先看旧单，再决定新字段应该怎样上线

2026年10月20日的教学采购表单采用独立业务表`bpm_f_tutorial_purchase_08`。第一版有两张申请：5000元只经过部门审核，5000.01元增加财务复核，两张都已完成。

第二版新增可选字段`deliveryLocation`，对应收货地点。发布表单和关联流程后，新申请金额1200元，并填写教学收货地点。

![第一版采购申请的历史画面](https://developer.qcloudimg.com/http-save/yehe-12798805/1a1d073a255c3480d7f722fc6753059b.png)

*[实测·历史教程] 第一版旧申请保持原字段展示；它不是第二版页面故意把新增字段留空。*

![第二版采购申请填写新增收货地点](https://developer.qcloudimg.com/http-save/yehe-12798805/3e73e319d2b11733b36c0e86b0d2dda7.png)

*[实测·历史教程录屏帧] 新申请使用新增字段。画面来自教程完整帧，保留系统整体，没有裁切。*

本次数据库只读核对中，三张单据的金额为5000、5000.01和1200，表单版本为1、1、2，流程状态均为2，新单的收货地点已保存。

这里最重要的结果不是“字段出现了”，而是新旧两种数据在同一系统里有明确解释。旧单不应该因为新增字段而突然像一张没填完整的申请，新单也不能继续被错误地当作第一版。

## “保存设计”与“发布版本”，不是同一个按钮的不同名字

开发时常把页面配置看作一份JSON，保存即覆盖。但业务表单已经有历史单据以后，覆盖当前设计与改变运行定义，就需要分开讨论。

当前`BpmFormServiceImpl`对独立数据表表单作了明确区分：保存设计不会像非独立表单那样同步更新已部署流程的字段信息。

```java
if (!managed) {
    syncProcessDefinitionFormFields(
            updateReqVO.getId(), updateReqVO.getFields(), updateReqVO.getConf());
}
```

这段代码的范围很重要：本文的版本结论针对`managed`独立数据表路径。不能拿它推导所有表单类型都采用相同的冻结规则。

独立表单的保存首先服务于设计编辑。真正发布时，系统另外生成版本记录，保存配置、字段以及模型快照。读取`BpmFormManagedServiceImpl`可以看到：

```java
versionMapper.insert(new BpmFormVersionDO().setFormId(form.getId()).setVersion(version)
        .setConf(form.getConf()).setFields(form.getFields())
        .setModelSnapshot(JsonUtils.toJsonString(snapshot)).setChangeSummary(plan.summary()));
```

快照让“当时发布了什么”有了独立记录。否则设计器今天改过一次，昨天发起的申请就可能失去可解释的字段定义。

这也给发布评审提供了落点：先看变化摘要和数据模型，再决定是否发布，而不是因为新页面预览正常就直接让它影响运行。

![独立数据表发布前的检查画面](https://developer.qcloudimg.com/http-save/yehe-12798805/1e73e416ba2252244714d054d0e05374.png)

*[实测·历史教程] 发布预览用于核对表结构及变更方向；它不能替代发布后的新单与旧单检查。*

## 表单有了v2，流程不一定已经使用v2

教学升级中，发布表单以后还发布了关联流程。原因可以从`BpmProcessDefinitionServiceImpl`看得很清楚：独立表单的流程部署会读取最新已发布版本，未发布或找不到版本记录时抛错。

```java
formVersion = formVersionMapper.selectByFormIdAndVersion(
        form.getId(), form.getPublishedVersion());
if (formVersion == null) {
    throw exception(FORM_MANAGED_VERSION_NOT_EXISTS);
}
```

随后流程定义保存该版本的字段、配置和版本号。由此，设计草稿、表单发布版、流程定义是三个相关但不同的对象。

如果只保存草稿，新字段还不属于可部署的发布版本；如果只发布表单、没有让新流程定义关联它，新申请的入口也未必按预期使用最新结构。

所以遇到“已经加了字段，但用户看不到”，不要第一反应就清缓存。先核对当前打开的是哪个流程定义、它绑定哪个表单版本、页面是否从正确的入口发起。缓存只是可能的原因之一。

业务数据也会留下版本标记。当前`BpmFormManagedDataServiceImpl.createData`写入：

```java
values.put("form_version", info.getFormVersion());
```

这里取的是流程定义信息中的版本，不是随意读取设计器当前版本。对排查历史单据来说，数据行、流程定义和表单快照由此可以相互核对。

## Vue3管理端应让用户看懂自己正在改哪一层

后端有版本机制，前端如果只显示一个“保存成功”，用户仍然容易误会。

当前Vue3数据模型抽屉`data-model-drawer.vue`分别加载模型和版本列表，并展示字段标识、物理列名、逻辑类型、列类型、状态以及加入版本。设计器还显示“已发布v…”标签。

这些信息不是为了让业务人员每天研究DDL，而是让实施人员可以回答：收货地点对应哪一列，什么时候加入，当前模型有没有发布过。

另一个值得注意的交互是“放弃未发布的修改”。实际确认文案说明表单设计将恢复为最新发布版，未发布修改会丢失：

```typescript
content: `表单设计将恢复为 v${model.value.publishedVersion}，未发布的修改会丢失。`,
```

这不是“恢复整个系统到任意历史版本”，也不是“删除第二版产生的业务数据”。前端必须把恢复的对象写清楚，否则一个设计草稿操作，可能被使用者误解为数据库回滚能力。

本文依据当前源码分析这些展示与文案；教学案例没有专门执行一次数据库回退演练，不能把界面上的恢复提示当作回退成功证明。

## 新字段能显示，还要看谁能看到、谁必须填写

增加字段时，常见的第二次返工是：申请人可以录入，但审批人看不到；或者所有旧单打开以后都出现必填警告。

应把字段可见、字段可编辑、字段必填与模型版本放在一起核对。可选收货地点的升级，比改变一个关键金额字段的必填或计算规则更容易界定影响范围，但仍然需要正常用户检查。

![节点字段权限配置](https://developer.qcloudimg.com/http-save/yehe-12798805/54e710130d245ba6495e20eff41b299a.png)

*[实测·历史教程] 字段规则还需结合具体节点检查。管理员能打开设计器，不代表普通申请人和审批人的实际表现。*

本课曾同时配置组件必填与起始节点必填，空表校验会出现重复提示，但拦截有效。记录保留了这个现象，原因没有定性，也没有擅自修改公共组件。这个细节提醒我们：两层规则都存在时，除了“能不能拦住”，还要检查是否给用户造成重复或矛盾提示。

正式升级时可以准备三种身份：申请人、审批人、无权限用户；再给每种身份安排一张旧单和一张新单。检查入口可见、字段展示、允许操作及报错信息。本文案例证明了指定账号的权限与字段流程，不覆盖所有租户和角色组合。

## 给不同变更分级，别把所有升级都叫“加字段”

这次验证的是新增可选字段。其他变化应该另列验收任务，而不是直接沿用成功结论。

| 变化 | 需要先决定什么 | 应重点回归什么 |
|---|---|---|
| 新增可选字段 | 默认值、存储列、展示节点 | 新单保存、旧单回查 |
| 新增必填字段 | 哪些版本必须填，旧数据怎样处理 | 旧单编辑与不同节点提交 |
| 改金额精度或计算方式 | 历史值是否重算、谁确认差额 | 汇总、审批条件、报表 |
| 删除或改名字段 | 历史引用、接口与报表依赖 | 旧单、导出、下游使用 |
| 修改字段类型 | 转换失败如何处理、是否可恢复 | 存量数据与异常样本 |

这是一份升级评审建议，不表示当前系统已经自动完成表中所有迁移。尤其是字段删除、类型变化和历史金额重算，必须明确数据处理方案，不能由页面组件变化暗中决定。

教学导出的配置JSON也仅作为本地核对快照，没有验证为跨环境直接导入包。把配置交给另一套系统前，还要核对表单标识、组织角色、流程关联以及目标环境中的数据模型。

## 宇擎建议：发布检查同时看新单和旧单

对于经常增加字段、调整审批的企业应用，可以保留一组固定回归对象：一张旧的完成单、一张必要时用于验证的运行中单、一张新版本申请，再配普通申请人与审批人。每次变更明确哪些对象应该受影响、哪些不应改变。

本课实际验证了旧完成单与新申请共存，没有把运行中实例迁移作为通过项。若业务要求正在审批的单据也立即使用新规则，应专门设计迁移方案，而不是默认重新发布会改变所有实例。

发布清单最好同时记录前端构建版本、后端版本、表单版本、流程定义和数据变更。它们不必总在同一天变化，但排查时必须能够找到对应关系。

一套系统是否容易维护，不只看第一版做得快不快，还看第二版上线以后，第一版留下的数据能不能继续被正确理解。**保存设计、发布快照、绑定流程、标记数据，再用真实角色回查新旧单据**，这条链路比“新页面已经部署”更接近一次完整升级。


“采购申请加一个收货地点”，看起来只是页面多一个输入框。上线以后却有三个不同的问题：新申请能否填写，旧申请应该显示什么，审批人能否按正确权限查看。

Vue3＋Flowable表单怎么升级？新字段、权限与旧单一起验收

人工智能

Vue3+Flowable表单升级中，独立数据表表单通过版本快照区分新旧定义，确保旧单保留原字段、新单启用新字段。本文以采购申请增加收货地点为例，详解保存设计、发布版本、流程绑定及数据标记的协作机制，并给出新旧单共存的验收方法，帮助开发者规避字段显示异常或权限错配问题。

数据处理

代码解释

数据库

JSON

让每一个 Agent，都跑在云上

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

Vue3＋Flowable表单怎么升级？新字段、权限与旧单一起验收-腾讯云开发者社区-腾讯云

Vue3＋Flowable表单怎么升级？新字段、权限与旧单一起验收

Vue3＋Flowable表单怎么升级？新字段、权限与旧单一起验收

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐