# 数据标准模块问题排查指南

# 排查指南详细说明

通用前置检查：

确认版本：明确是7.5.0版本。
确认分域权限：标准管理受分域权限控制，确认当前用户有权限访问对应分域。
查阅补丁列表：优先检索官方补丁。您可以通过以下链接访问官方补丁列表：
- DAMP 7.5.0 补丁列表: 数据资产7.5.0补丁列表 (opens new window)

# 场景一：标准导入/导出异常

高频现象：
1. 标准分域中添加了字段，但导入模板中不显示。
2. 标准分类叶子节点导入失败，未按设置值导入。
3. 数据元标准与物理实体关联关系批量导入失败。
排查步骤：
1. 第一步：排除产品BUG。
  - 操作：在官方补丁列表中，搜索关键词 导入、导出、模板。
  - 相关补丁示例：
    - DAMP_7.5.0_SERVER_20250820_P1（解决标准分域字段导入模板不显示）
    - DAMP_7.5.0_SERVER_20250828_P1（解决标准分类叶子节点导入失败）
  - 解决方案：
    - 1.优先使用产品最新补丁合集，见补丁列表中补丁合集列表
    - 2.若找到描述匹配的补丁，则申请并应用
2. 第二步：检查模板格式。
  - 操作：确认使用的是从当前系统下载的最新模板。
  - 排查项：
    - 模板文件是否损坏。
    - 必填列是否填写完整。
    - 分类编码是否与系统内一致。
    - 叶子节点标识（是/否）是否正确填写。
  - 解决方案：重新下载模板，将数据以纯文本格式粘贴后重新上传。
3. 第三步：检查分类层级数据。
  - 操作：检查rcm_standard_group表中的分类数据。
  - 排查项：
    - GROUP_LEVEL层级值是否正确。
    - IS_LEAF叶子节点标识是否正确（1为叶子节点）。
    - 分类编码是否唯一。
  - 解决方案：
```
-- 检查分类层级
SELECT id, group_name, group_level, is_leaf FROM rcm_standard_group WHERE group_name = '问题分类';

-- 修正叶子节点标识
UPDATE rcm_standard_group SET is_leaf = 1 WHERE id = '分类ID' AND 该分类下无子分类;
```

# 场景二：标准分类/分组异常

高频现象：
1. 标准分类叶子节点导入失败。
2. 标准分类无法删除，提示“操作数据异常”。
3. 标准分类菜单两个按钮大小不一致。
排查步骤：
1. 第一步：排除产品BUG。
  - 操作：在官方补丁列表中，搜索关键词 分类、叶子节点、按钮。
  - 相关补丁示例：
    - DAMP_7.5.0_SERVER_20250828_P1（解决标准分类叶子节点导入失败）
    - DAMP_7.5.0_UI_20251114_P1（解决标准分类菜单按钮大小不一致）
    - DAMP_7.5.0_SERVER_20251021_P1（解决标准分类点击查询空指针）
    - DAMP_7.5.0_SERVER_20250918_P1 （解决标准分类删除一级分类报错操作数据异常）
  - 解决方案：
    - 1.优先使用产品最新补丁合集，见补丁列表中补丁合集列表
    - 2.若找到描述匹配的补丁，则申请并应用
2. 第二步：检查分类删除约束。
  - 操作：删除分类失败时，检查引用关系。
  - 排查项：
    - 该分类下是否有子分类。
    - 该分类下是否有关联的标准（数据元、参考数据等）。
  - 解决方案：
```
-- 查找引用该分类的标准
SELECT COUNT(*) FROM rcm_standard_dict WHERE group_id = '待删除分类ID';
SELECT COUNT(*) FROM rcm_standard_index WHERE group_id = '待删除分类ID';
SELECT COUNT(*) FROM rcm_standard_dataelement WHERE group_id = '待删除分类ID';
SELECT COUNT(*) FROM rcm_standard_dimension WHERE group_id = '待删除分类ID';
-- 先删除或移动这些标准到其他分类，再删除分类
```
3. 第三步：检查分类层级数据。
  - 操作：如果点击分类时报空指针，取消分类时正常。
  - 解决方案：申请补丁 DAMP_7.5.0_SERVER_20251021_P1。

# 场景三：标准关联异常

高频现象：
1. 数据元标准关联逻辑模型后，已发布的逻辑模型中看不到。
2. 标准关联资产后，点不开无法查看详情。
3. 数据源标准关联物理模型时不显示。
排查步骤：
1. 第一步：排除产品BUG。
  - 操作：在官方补丁列表中，搜索关键词 关联、映射、点不开。
  - 相关补丁示例：
    - DAMP_7.5.0_SERVER_20250729_P1（解决数据元关联逻辑模型不显示）
    - DAMP_7.5.0_UI_20250805_P1（解决标准关联资产点不开）
    - METACUBE_7.5.1_SERVER_20250724_P1（解决数据源标准关联物理模型不显示）
  - 解决方案：
    - 1.优先使用产品最新补丁合集，见补丁列表中补丁合集列表
    - 2.若找到描述匹配的补丁，则申请并应用
2. 第二步：检查标准发布状态。
  - 操作：确认标准是否已发布。
  - 排查项：只有“已发布”状态的标准才能被关联和查看。
  - 解决方案：完成标准的发布流程，待状态变为“已发布”后再进行关联操作。
3. 第三步：检查关联目标状态。
  - 操作：确认要关联的目标（逻辑模型、物理模型）是否存在且已发布。
  - 排查项：
    - 逻辑模型是否已发布。
    - 物理模型是否已采集成功。
    - 数据源是否已正确分配给系统。
  - 解决方案：确保关联目标状态正常后，重新关联。
4. 第四步：处理“数据源标准关联物理模型不显示”问题。
  - 操作：申请补丁 METACUBE_7.5.1_SERVER_20250724_P1。
  - 解决方案：打补丁后，在系统管理中删除已选择的数据源，重新选择。

# 场景四：标准流程/状态异常

高频现象：
1. 指标数据变更时报错。
2. 标准作废流程总是存在，无法取消。
排查步骤：
1. 第一步：排除产品BUG。
  - 操作：在官方补丁列表中，搜索关键词 变更、作废、流程。
  - 相关补丁示例：
    - DAMP_7.5.0_SERVER_20250902_P1（解决指标数据变更报错）
    - DAMP_7.5.0_UI_20251119_C1（支持数据元标准作废直接物理删除）
  - 解决方案：
    - 1.优先使用产品最新补丁合集，见补丁列表中补丁合集列表
    - 2.若找到描述匹配的补丁，则申请并应用
2. 第二步：处理“作废流程无法取消”问题。
  - 现象：标准作废流程总是存在，无法取消。
  - 排查项：平台参数配置中流程开关是否开启。
  - 解决方案：
    - 进入“技术门户” -> “配置中心” -> “平台参数”。
    - 找到指标流程开关 metric.isOpenFlow，设置为 N 关闭流程。
    - 点击“刷新缓存”使配置生效。

# 场景五：标准监控/规则异常

高频现象：
1. 标准落标统计查看结果无数据。
2. 通过数据元标准无法正常生成质量检核规则，规则名称为null。
3. 数据元标准生成的参考数据自定义检核规则运行失败。
4. 数据元标准关联质量规则时分页不生效。
排查步骤：
1. 第一步：排除产品BUG。
  - 操作：在官方补丁列表中，搜索关键词 落标统计、检核规则、分页。
  - 相关补丁示例：
    - DAMP_7.5.0_SERVER_20250903_P1 + QUALITYCUBE_7.3.0_SERVER_20250903_P1（解决标准落标统计无数据）
    - DAMP_7.5.0_SERVER_20251121_P1（解决质量检核规则名称为null）
    - DAMP_7.5.0_SERVER_20250918_P2（解决数据元完整性检查失败）
    - DAMP_7.5.0_UI_20251128_P1（解决参考数据检核后为undefined）
    - DAMP_7.5.0_SERVER_20250911_P1（解决质量规则查询分页错误）
    - DAMP_7.5.0_SERVER_20251112_P1（解决核检规则监控只显示规则标准和映射标准）
  - 解决方案：
    - 1.优先使用产品最新补丁合集，见补丁列表中补丁合集列表
    - 2.若找到描述匹配的补丁，则申请并应用
2. 第二步：确认质量模块集成状态。
  - 操作：检查是否已集成数据质量模块。
  - 排查项：标准监控功能依赖数据质量模块，未集成时无法使用。
  - 解决方案：如需使用标准监控功能，需部署并集成数据质量模块。
3. 第三步：检查规则生成配置。
  - 操作：当标准无法生成质量规则时。
  - 排查项：
    - 数据元标准中“规则信息”节点是否已配置。
    - 数据元质量开关是否开启。
    - 标准是否已关联技术元数据。
  - 解决方案：
    1. 在数据元新增/编辑页面，点击“生成检核规则”完成规则配置。
    2. 标准发布成功后，执行“添加关联”操作，关联技术元数据。
    3. 关联成功后，规则会自动推送到数据质量平台。
4. 第四步：处理“参考数据自定义检核规则运行失败”问题。
  - 解决方案：
    1. 申请补丁 DAMP_7.5.0_SERVER_20250918_P2。
    2. 变更发布状态的数据元标准生成的规则，规则信息中参考数据检核后为undefined，申请补丁 DAMP_7.5.0_UI_20251128_P1。

# 场景六：词根管理异常

高频现象：
1. 新增词根时报错：xpath 'radical/createTime'无法处理。
2. 词根创建失败。
排查步骤：
1. 第一步：排除产品BUG。
  - 操作：在官方补丁列表中，搜索关键词 词根、xpath。
  - 相关补丁示例：
    - PLATFORM_8.3.3_AFCENTER_20250826_P1（解决词根新增报错）
  - 解决方案：
    - 1.优先使用产品最新补丁合集，见补丁列表中补丁合集列表
    - 2.若找到描述匹配的补丁，则申请并应用
2. 第二步：检查EOS版本。
  - 操作：如果词根创建失败，建议使用EOS最新大补丁后验证。
  - 解决方案：获取EOS 8.3.3补丁：http://help.primeton.com/productcs/patches/product-doc/EOSPlatform%E8%A1%A5%E4%B8%81%E5%88%97%E8%A1%A8/EOSPlatform8.3.3%E8%A1%A5%E4%B8%81%E5%88%97%E8%A1%A8.html

# 场景七：标准分域/自定义字段异常

高频现象：
1. 标准分域中添加了字段，但导入模板中不显示。
2. 编辑标准分域字段分组名称失败。
排查步骤：
1. 第一步：排除产品BUG。
  - 操作：在官方补丁列表中，搜索关键词 分域、自定义字段、分组。
  - 相关补丁示例：
    - DAMP_7.5.0_SERVER_20250820_P1（解决标准分域字段导入模板不显示）
    - DAMP_7.5.0_SERVER_20251211_P1（解决编辑标准分域字段分组名称失败）
  - 解决方案：
    - 1.优先使用产品最新补丁合集，见补丁列表中补丁合集列表
    - 2.若找到描述匹配的补丁，则申请并应用
2. 第二步：检查分域发布状态。
  - 操作：确认自定义字段所在的分域已发布。
  - 排查项：分域状态是否为“已发布”。
  - 解决方案：在分域管理中，点击“发布”完成分域发布。
3. 第三步：检查定时任务配置。
  - 操作：如果标准映射关联不通过，检查定时任务。
  - 解决方案：
    - 标准推荐定时配置：damp.standard.recommend.time
    - 落标统计定时配置：damp.standard.summary.time

← 数据服务相关问题排查指南与数据质量对接相关功能排查指南 →