旧版聚合表升级失败处理方法
1. 简介
1.1 产生背景
在通过 升级助手 升级旧版聚合表过程中，由于配置不完全兼容，少数旧版聚合表无法直接升级为新版，用户可以生成一张新版聚合表调整配置后正常使用。
1.2 错误码对应表
本文将针对下表中不同的错误码与报错情况，进行报错说明并提供处理方法。
错误码 | 报错内容 | 注意事项 |
101 | 数据来源存在已删除表单 | 1）在「101」与「1501」报错情况下，不建议直接修改旧版聚合表中的数据来源、字段关联，否则升级后会导致，聚合表内配置和表单/仪表盘中调用配置失效。 2）手动生成并调整新版聚合表后，不会自动替换表单/仪表盘中的引用，需参考旧版聚合表中「引用关系」手动替换表单/仪表单中引用的聚合表。 |
201 | 过滤条件包含数组等于 | |
301 | 维度同一表单下包含多个子表单 | |
401 | 过滤条件/维度/指标存在已删除字段 | |
402 | ||
403 | ||
501 | 聚合主字段维度时，指标中同时包含主子字段 | |
502 | 指标中包含非数据来源的子字段 | |
601 | ||
701 | 聚合子字段维度时，指标中包含主字段 | |
801 | 过滤条件包含非数据来源的子字段 | |
901 | 指标/校验条件配置有误 | |
902 | ||
1501 | 数据来源存在未被引用表单 | |
—— | 异常配置 |
2. 数据来源存在已删除表单
2.1 报错说明
旧版聚合表中数据来源表单被删除导致无法直接升级。
2.2 处理方法
生成新版聚合表后，删除失效的数据来源表单，若需替换为其他表单可先删除再添加新表单。
3. 过滤条件包含数组等于
3.1 报错说明
旧版聚合表的过滤条件中配置了复选框组、下拉复选框、成员多选、部门多选字段的「等于」条件，数组类型「等于」的用法不规范，新聚合表中已经取消。
3.2 处理方法
提供如下两种方案：
- 在旧版聚合表中，将等于切换为「包含任意一个」或「同时包含」，重新升级；
- 生成新版聚合表，将对应条件切换为为「包含任意一个」或「同时包含」。
4. 维度同一表单下包含多个子表单
4.1 报错说明
维度配置中只能使用「数据来源」中最多 1 个子表单字段，若有其他子表单的字段则会报错。
4.2 处理方法
生成新版聚合表后，进行如下调整：
1）若其他子表单对应的维度非必要，则直接删除。
2）若有必要统计其他子表单的数据，建议新建一张聚合表来聚合其他的子表单数据。
5. 过滤条件/维度/指标存在已删除字段
5.1 报错说明
旧版聚合表中引用的字段可能已删除，导致无法直接升级。
5.2 处理方法
生成新版聚合表后，再删除掉失效字段或替换为其他字段。
6. 聚合主字段维度时，指标中同时包含主子字段
6.1 报错说明
若在维度构建中只需要使用某个表单的主字段，此时指标中同时引用了该表单的主字段和子字段则会报错。
6.2 处理方法
生成新版聚合表后，调整指标中的主字段。例如指标中引用的主字段是通过子字段对应子表单中的数据汇总得到的，则可以将聚合表指标中的主字段切换为对应的子字段。
7. 指标中包含非数据来源的子字段
7.1 报错说明
若在维度构建中使用某个表单的子表单字段，则「数据来源」中须选择对应 1 个子表单，此时指标中只能使用该子表单的子字段，若引用该表单的其他子表单字段则会报错。
7.2 处理方法
生成新版聚合表后，进行如下调整：
1）若维度中非必要使用该子字段，则直接删除该维度，并调整「数据来源」中该表单的子表单为指标中对应的子表单；
2）维度中有必要保留子字段，则删除引用其他子表单的指标。
8. 聚合子字段维度时，指标中包含主字段
8.1 报错说明
若在维度构建中使用某个表单的子表单字段，则「数据来源」中须选择对应子表单，此时指标中只能使用该子表单的子字段，若引用该表单的主字段则会报错。
8.2 处理方法
生成新版聚合表后，进行如下调整：
1）若维度中非必要使用该子字段，则直接删除该维度并删除「数据来源」中该表单对应的子表单；
2）若维度中有必要保留子字段，则根据该主字段与对应子表单的关系进行调整。例如，主字段是通过汇总子表单字段而来的，则指标中，可以将主字段调整为对应的子表单字段。
9. 过滤条件包含非数据来源的子字段
9.1 报错说明
「过滤条件」中所使用的子表单字段与数据来源中所用字段不一致，主要有以下两种情况：
- 情况一：过滤条件中使用子表单 1 中字段，数据来源中使用主字段；
- 情况二：过滤条件中使用子表单 1 中字段，数据来源中使用子表单 2 中字段。
9.2 处理方法
修改旧版聚合表后，重新进行升级：
1）若该过滤条件非必要，则直接删除该筛选条件。
2）若该过滤条件必要，则在对应表单中，通过公式把该子字段的值转换为主字段，并在聚合表中将筛选条件修改为主字段。
10. 指标/校验条件配置有误
10.1 报错说明
指标公式或校验条件公式配置不符合规范时则会报错。
10.2 处理方法
提供如下两种方案：
- 生成新聚合表后，重新编辑公式。
- 在旧版聚合表中检查指标/校验条件公式，修改后再升级。
11. 数据来源存在未被引用表单
11.1 报错说明
数据来源中添加了表单，但是在所有指标中都未调用该表单的字段。
11.2 处理方法
生成新聚合表后，删除多余数据源，或根据该数据源配置所需的指标。
12. 异常配置
12.1 报错说明
配置保存异常导致无法升级。
12.2 处理方法
重新保存旧版聚合表后再升级。
400-111-0890
在线咨询