旧版聚合表手动升级与调整方法

1. 简介

1.1 旧版聚合表下线背景

截止 2026 年 4 月，后台已完成了绝大部分旧版聚合表迁移，部分旧版聚合表由于配置不合理无法平滑迁移。

当前新聚合表已覆盖旧版聚合表业务场景，为避免功能冗余和对新功能拓展的阻碍，我们将下线旧版聚合表功能，届时所有剩余旧版聚合表将默认转变为新聚合表，已有调用旧版聚合表的业务将受到影响，建议管理员在截止日期前将旧版聚合表手动调整并升级为新版。

免费版及试用版：2026 年 5 月 31 日晚；
付费版：2026 年 6 月 30 日晚。

注：付费版包括标准版、企业版、旗舰版、入门版、定制版、青春版。

1.2 旧版聚合表下线效果

旧版聚合表下线后，应用下剩余的旧版聚合表将自动转为新聚合表。详情如下所示：

旧版聚合表中的不合理配置会在新聚合表中标红报错。
若在表单和仪表盘中调用了旧版聚合表，则需将升级后的新聚合表中的标红报错调整完毕，表单和仪表盘中的配置才会恢复生效。

2. 手动调整升级

为确保您的业务不受影响，我们建议您排查自身企业中的旧版聚合表，并根据使用情况进行手动升级。手动调整升级步骤如下所示：

2.1 排查旧版聚合表是否使用

您可通过点击旧版聚合表使用查询链接，输入租户 id 后查询旧版聚合表的使用情况，或使用以下方式辅助判断：

若聚合表的行表头和指标已存在报错，但并没有影响到具体的业务使用，大概率为已废弃/未使用；
若聚合表的引用详情为空，大概率为已废弃/未使用。

查询出旧版聚合表的使用情况后，您可进行如下处理：

使用类型	类型说明	建议处理方式
在使用	近半年内被调用过或查看过计算结果	排查不合理配置，调整升级为新聚合表。详细步骤可参见【3.2 旧版聚合表调整升级】。
已废弃或未使用	近半年内未被调用过或未查看过计算结果	确认不再使用后可进行以下任一操作： 1）删除老聚合表。 2）通过「升级 >> 忽略并升级」转为新聚合表（配置有报错）。 3）等待功能下线时自动转为新聚合表（配置有报错）。

2.2 旧版聚合表调整升级

若您需要对自己的旧版聚合进行手动调整升级，您可通过如下所示两条路径进行调整。详情可参见：旧版聚合表升级助手。

1）聚合表内升级

进入需要调整升级的旧版聚合表设置页面，点击右上角的「升级」按钮，定位到升级错误原因后可先调整配置再升级，或点击「忽略并升级」为新聚合表后再调整配置。

2）通过升级助手升级

进入「应用后台 >> 高级功能 >> 聚合表」中，点击旧版聚合表右侧的「升级助手」，在升级助手设置页面，选择需要升级的旧版聚合表后，点击「确定」即可。定位到升级错误原因后可先调整配置再升级，或点击「忽略并升级」为新聚合表后再调整配置。

3. 升级失败调整方法

根据报错类型对应的处理方法，调整旧版聚合表后升级，或「忽略并升级」为新聚合表后再调整。

编号	错误类型	示例/说明	建议处理方式
101	数据来源中存在已删除表单		删除/修改报错表单
401	过滤条件中存在已删除字段		删除/修改报错过滤条件
402	维度中存在已删除字段		删除/修改报错维度
403	指标中存在已删除字段		删除/修改报错指标
201	过滤条件包含数组等于	过滤条件中配置复选框组、下拉复选框、成员多选、部门多选字段的“等于”条件导致报错，数组类型“等于”的用法不规范，新聚合表中已经取消	删除/修改为「包含任意一个」或「同时包含」
301	维度同一表单下包含多个子表单	维度/关联关系配置中同一列的子字段只能来自同 1 个子表单。	1）若其他子表单对应的维度非必要，则直接删除； 2）若有必要统计其他子表单的数据：在新聚合表中新增该子表单作为数据来源新建一张聚合表来聚合该子表单数据。
501	聚合主字段维度时，指标中同时包含主子字段	若在维度构建中只需要使用某个表单的主字段，此时指标中同时引用了该表单的主字段和子字段则会报错	1）若对应子字段指标非必要，可直接删除； 2）若对应子字段指标必要：在新聚合表中新增该子表单作为数据来源；新建一张聚合表来聚合该子表单数据
502/601	指标中包含非数据来源的子字段	指标中引用的字段只能来自于数据来源中的表单/子表单，若引用了其他子表单内字段则会报错	1）若对应子字段指标非必要，可直接删除； 2）若对应子字段指标必要：在新聚合表中新增该子表单作为数据来源；新建一张聚合表来聚合该子表单数据
701	聚合子字段维度时，指标中包含主字段	若在维度构建中使用某个表单的子表单字段，则「数据来源」中须选择对应子表单，此时指标中只能使用该子表单的子字段，若引用该表单的主字段则会报错	1）若对应主字段指标非必要，可直接删除； 2）若对应主字段指标必要，可考虑三种方式：聚合子字段来实现聚合主字段的效果在数据来源处新增该表单（不含子表单）数据来源新建一张聚合表统计主字段指标
801	过滤条件包含非数据来源的子字段	「过滤条件」中所使用的子字段只能来自「数据来源」中选择的子表单，若来自其他子表单则会报错	1）若对应过滤条件非必要，可直接删除 2）若该过滤条件必要：在新聚合表中新增该子表单作为数据来源在原表单中通过公式把该子字段的值转换为主字段，并在聚合表中筛选该主字段
901	指标配置有误	指标公式配置不符合规范时报错	修改报错指标公式
902	校验条件配置有误	校验条件公式配置不符合规范时报错	修改报错校验条件公式
1501	数据来源存在未被引用表单	数据来源中添加了表单，但是在所有指标中都未调用该表单的字段	删除多余数据源根据该数据源配置所需的指标

4. 升级操作案例

701 类报错处理较为复杂，我们将针对此报错做单独说明。本章节将使用库存统计案例来演示该类报错如何进行升级调整。

报错原因分析

示例

旧版聚合表中未对字段关联关系、行表头和指标中使用的子字段进行限制，导致部分特殊配置下存在计算结果错误；

新聚合表中增加如下限制：当数据来源为表单+子表单时，维度可使用主字段或所选子表单的子字段，指标公式仅能引用所选子表单的数字类子字段。

旧版聚合表升级时不符合此规则会报错 701。

4.1 排查该聚合表是否在使用

1）查询旧版聚合表使用详情查询链接得知该聚合表状态为「在使用」

2）查看聚合表引用详情，可看到有表单调用，且能判断该表业务在正常使用中。

根据查询及查看结果判断，该聚合在使用，需要手动调整升级。

4.2 升级并获取报错信息

4.2.1 升级旧版聚合表

1）点击升级按钮，获取报错信息为701。

4.2.2 定位具体报错原因

1）梳理老聚合表配置

根据梳理，老聚合表的配置如下所示：

来源表

行表头引用的字段

指标引用的字段

入库单
出库单

产品编号入库明细1.产品编号
出库明细1.产品编号

库存数量

入库明细1.入库数量（子）
出库明细1.入库数量（子）

入库年份标记数

入库年份标记数（主）

入库总金额

入库总金额（主）

2）定位具体报错原因

行表头使用了「入库单」中的子字段，则新聚合表中可直接在数据来源中选择子表单「入库明细 1」，此时指标中则只能使用子表单「入库明细 1」中的字段，不能使用主字段；
排查发现指标「入库年份标记数」和「入库总金额」中引用了「入库单」中的主字段，需调整这两个字段。

4.3 手动调整升级为新聚合表

对照帮助文档可知，701 类报错有多种方法可处理，以下演示 4 种方法，用户实际操作时根据业务情况自行判断适用哪一种，当前案例中使用方法一和方法二更合适。

方法	调整内容	示例
方法一	对应主字段指标「入库年份标记数」非必要，可直接删除。
方法二	在旧版聚合表中，将「入库总金额」的公式转化为聚合子字段「入库明细1.入库金额」，然后点击升级。
方法三	忽略并升级为新聚合表，系统在新聚合表中自动添加了一个没有子表单的数据源「入库单」，此时需要手动完善「入库单」对应的维度。如下所示：点击「配置数据来源表」，添加来源表为「入库表 >> 入库明细 1」；点击「未完成维度配置」，设置「入库单.入库明细 1」中的维度为「入库明细 1.产品编号」。
方法四	重新搭建一张聚合表专门统计「入库年份标记数」、「入库总金额」原聚合表中删除「入库年份标记数」、「入库总金额」后升级为新聚合表。	搭建新聚合表旧版聚合表中删除指标后升级：