主数据模型配置与数据维护问题排查指南

排查指南详细说明

通用前置检查：

• 确认版本：明确是MDM 7.3.0版本。
• 检查基础环境：
  • 清理浏览器缓存，或使用无痕模式重新登录。
  • 确认浏览器版本兼容性（推荐Chrome、Edge最新版本）。
• 优先使用最新前端补丁：涉及前端展示类问题，优先申请并使用最新的 EOS 8.3.3 AFCenter UI补丁。您可以通过以下链接访问官方补丁列表：
  • EOS 8.3.3 前端补丁: EOS8.3.3补丁列表
• 区分问题类型：
  • 模型配置问题：在“管理门户”->“模型管理”->“主数据”->“页面配置”中配置表单时出现的问题。
  • 数据维护问题：在“业务门户”->“模型信息”->“数据维护”中操作数据时暴露的问题。
• 查阅MDM补丁列表：您可以通过以下链接访问MDM专用补丁列表：
  • MDM 7.3 补丁列表: 主数据7.3补丁列表

---

场景一：模型配置-低开表单问题

说明：此类问题发生在模型管理的“页面配置”向导页中，属于模型配置阶段的问题，与后续数据维护无直接关系。

• 问题现象：

  1. 在“页面配置”中配置字段组件时，组件类型无法修改或保存。
  2. 字段拖拽调整顺序后，保存不生效。
  3. 编码字段在表单中未正确显示为编码组件。
  4. 子模型表单配置后，在预览时无法显示。

• 排查步骤：

  1. 第一步：排除产品BUG。

     • 操作：
       • 优先申请最新的EOS 8.3.3 AFCenter UI补丁，解决大部分前端展示类问题。
       • 在MDM官方补丁列表中，搜索关键词 页面配置、表单、组件、编码。
     • 相关补丁示例：
       • PLATFORM_8.3.3_AFCENTER_UI_20251219_P1（解决低开页面主数据模型字段显示为空等问题）
       • MDM_7.3_UI_20251208_P1（修复子模型字典字段修改后反显失效）
       • MDM_7.3_UI_20251106_P1（优化组织显示、面包屑等问题）
       • MDM_7.3_UI_20251021_P1（解决约束配置删除非选中行问题）
       • MDM_7.3_UI_20251124_P1（解决子模型过多被按钮遮挡问题）
     • 解决方案：
       • 1.优先使用产品最新补丁合集，见补丁列表中补丁合集列表
       • 2.若找到描述匹配的补丁，则申请并应用

  2. 第二步：根据问题现象排查。

     • 现象：组件类型无法修改或保存不生效

       • 排查项：修改组件类型后，是否点击了“保存”并重新发布了模型。
       • 排查项：浏览器控制台是否有JS报错。
       • 解决方案：
         • 修改组件配置后，需保存并重新发布模型。
         • 清理浏览器缓存后重试。

     • 现象：编码字段未显示为编码组件

       • 排查项：在“页面配置”中，是否将该字段的组件类型修改为“业务组件-编码”。
       • 排查项：是否已在“编码配置”向导页中为该字段配置了编码方案。
       • 解决方案：
         • 在页面配置中，将字段组件类型修改为“业务组件-编码”。
         • 完成编码方案配置后重新发布模型。
         • 注意：子模型不支持编码组件，不要在子模型中使用。

     • 现象：子模型表单配置后无法显示

       • 排查项：子模型是否已在“字段配置”中正确添加。
       • 排查项：子模型的页面配置是否已完成。
       • 解决方案：
         • 确保子模型已在主模型的“字段配置”中作为子模型添加。
         • 完成子模型的页面配置后，重新发布主模型。

---

场景二：数据维护-展示/操作问题

说明：此类问题发生在“业务门户”->“模型信息”->“数据维护”页面，是模型发布后用户在操作数据时遇到的问题，通常与模型配置不当有关，但问题暴露在数据维护阶段。

• 问题现象：

  1. 新增、编辑数据时，表单字段显示不全或布局错乱。
  2. 子表数据无法新增、查看或删除。
  3. 列表页查询条件不生效，或查询结果与预期不符。
  4. 数据保存后，前台展示与后台数据不一致（如字典项不显示）。
  5. 主子表数据维护时，子表数据丢失或无法回显。

• 排查步骤：

  1. 第一步：排除产品BUG。

     • 操作：
       • 优先申请最新的EOS 8.3.3 AFCenter UI补丁，解决大部分前端展示类问题。
       • 在MDM官方补丁列表中，搜索关键词 数据维护、子表、查询、保存、显示。
     • 相关补丁示例：
       • PLATFORM_8.3.3_AFCENTER_UI_20251219_P1（解决低开页面字段显示为空等问题）
       • MDM_7.3_ALL_20251020_P1（修复子表引用字典时数据显示异常、左树右表查询问题）
       • MDM_7.3_ALL_20250929_P1（修复主子表模型子表字典不回显问题）
       • MDM_7.3_UI_20251205_P1（解决参考数据列表编辑页面显示不全）
       • MDM_7.3_SERVER_20251229_P1（优化between查询容错机制）
       • MDM_7.3_UI_20251208_P1（修复子模型字典字段修改后反显失效）
     • 解决方案：
       • 1.优先使用产品最新补丁合集，见补丁列表中补丁合集列表
       • 2.若找到描述匹配的补丁，则申请并应用

  2. 第二步：回溯模型配置问题。

     • 现象：表单显示不全或布局错乱

       • 排查项：返回“模型管理”->“页面配置”，检查表单布局是否合理，是否有组件被拖动到可视区域外。
       • 排查项：检查字段是否被设置为隐藏，但在“数据授权”中未正确配置权限。
       • 解决方案：
         • 在页面配置中重新调整表单布局，保存并重新发布模型。
         • 如需隐藏字段，应在“数据授权”中取消该字段的读权限，而非在页面配置中隐藏。

     • 现象：子表数据异常

       • 排查项：返回模型“字段配置”向导页，检查子模型是否已正确添加，关联关系是否正确。
       • 排查项：子表的页面配置是否完整。
       • 解决方案：
         • 修正子模型配置后，重新发布模型。
         • 子表数据需在主表编辑状态下进行维护。

     • 现象：查询条件不生效

       • 排查项：返回“页面配置”的“默认视图”，检查查询条件的字段配置是否正确。
       • 排查项：编码字段作为查询条件时，是否将控件类型设置为“文本框”（常见遗漏点）。
       • 解决方案：
         • 编码字段查询条件配置：自定义条件 -> 选择编码字段 -> 控件类型选择文本框。
         • 重新配置后保存并发布模型。

     • 现象：字典项不显示或显示为编码

       • 排查项：返回“页面配置”，检查下拉组件的“数据来源”配置是否正确。
       • 排查项：是否已选择“被引用字段”和“显示字段”。
       • 解决方案：
         • 正确配置数据来源，选择引用字段和显示字段，重新发布模型。
         • 申请补丁解决子表字典显示问题。

---

场景三：业务字典/参考数据问题

说明：此类问题涉及字典和参考数据的配置、发布及在表单中的使用，可能同时影响模型配置和数据维护两个阶段。

• 问题现象：

  1. 下拉选择字典项时，选项为空或不显示。
  2. 字典项选择后，保存成功但列表页不显示（显示为编码或空白）。
  3. 树形字典查询时，面包屑导航显示空白。
  4. 字典字段的默认值不生效。
  5. 国际化环境下，字典项未翻译或翻译错误。

• 排查步骤：

  1. 第一步：排除产品BUG。

     • 操作：
       • 优先申请最新的EOS 8.3.3 AFCenter UI补丁，解决大部分前端展示类问题。
       • 在MDM官方补丁列表中，搜索关键词 字典、参考数据、下拉、默认值、国际化。
     • 相关补丁示例：
       • PLATFORM_8.3.3_AFCENTER_UI_20251107_P1（解决下拉多选默认值问题）
       • PLATFORM_8.3.3_AFCENTER_UI_20251031_P1（EOS前端补丁，配合字典功能使用）
       • MDM_7.3_SERVER_20251103_P1（解决字典过滤、默认值、接口默认值等问题）
       • MDM_7.3_SERVER_20251111_P1（解决树形参考数据面包屑显示不正常）
       • MDM_7.3_ALL_20251020_P1（修复子表引用字典时单元格显示空白）
     • 解决方案：
       • 1.优先使用产品最新补丁合集，见补丁列表中补丁合集列表
       • 2.若找到描述匹配的补丁，则申请并应用

  2. 第二步：根据问题现象排查。

     • 现象：下拉选项为空

       • 排查项：参考数据或业务字典是否已发布，且数据是否已维护。
       • 排查项：在模型“页面配置”中，下拉组件的“数据来源”配置是否正确。
       • 排查项：对于参考数据，是否已选择“被引用字段”和“显示字段”。
       • 解决方案：
         • 发布字典/参考数据模型，并维护业务数据。
         • 正确配置数据来源，选择引用字段和显示字段，重新发布模型。

     • 现象：选择后不显示（显示为编码）

       • 排查项：下拉组件的数据来源配置中，“显示字段”是否已正确选择。
       • 排查项：对于子表中的字典字段，是否存在已知的UI显示问题。
       • 解决方案：
         • 修正显示字段配置，重新发布模型。
         • 申请补丁 MDM_7.3_ALL_20251020_P1 解决子表字典显示问题。

     • 现象：树形字典面包屑空白

       • 排查项：树形字典的父字段配置是否正确。
       • 解决方案：申请补丁 MDM_7.3_SERVER_20251111_P1。

     • 现象：默认值不生效

       • 排查项：默认值是在“页面配置”中设置，还是在字典模型中设置。
       • 解决方案：
         • 在“页面配置”中为下拉组件设置默认值。
         • 申请补丁 MDM_7.3_SERVER_20251103_P1 解决接口调用时的默认值问题。

     • 现象：国际化未翻译

       • 排查项：是否已配置国际化资源文件。
       • 解决方案：
         • 在“页面配置”中使用国际化资源配置，提取中文翻译。
         • 如涉及需通过jar文件解决的国际化问题：请通过AME+发起工单，申请获取对应的国际化补丁jar包，放置到mdm/lib目录下并重启服务。

---

场景四：业务门户/菜单问题

说明：此类问题涉及模型在业务门户中的展示和访问，与“数据授权”中的菜单权限配置密切相关。

• 问题现象：

  1. 业务门户中看不到已授权的模型菜单。
  2. 点击菜单后页面404或无法加载。
  3. 菜单名称显示乱码或未国际化。
  4. 自定义扩展菜单无法显示或访问。

• 排查步骤：

  1. 第一步：排除产品BUG。

     • 操作：
       • 优先申请最新的EOS 8.3.3 AFCenter UI补丁，解决大部分前端展示类问题。
       • 在MDM官方补丁列表中，搜索关键词 菜单、门户、404、扩展菜单。
     • 相关补丁示例：
       • PLATFORM_8.3.3_AFCENTER_UI_20251219_P1（解决低开页面字段显示为空等问题）
       • MDM_7.3_UI_20251215_P1（优化工作台跳转，解决404错误）
       • MDM_7.3_UI_20260209_P1（解决工作台我的流程、问题数据跳转404）
       • MDM_7.3_UI_20251106_P1（优化组织显示等问题）
     • 解决方案：
       • 1.优先使用产品最新补丁合集，见补丁列表中补丁合集列表
       • 2.若找到描述匹配的补丁，则申请并应用

  2. 第二步：根据问题现象排查。

     • 现象：菜单不显示

       • 排查项：在“数据授权”中，检查对应角色是否已配置该模型的“菜单权限”。
       • 排查项：确认用户是否已分配到正确的平台角色（编码以mdm-开头）。
       • 排查项：模型的“排序号”是否设置，影响菜单显示顺序。
       • 解决方案：
         • 在“数据授权”中为角色配置模型的菜单权限。
         • 确保用户角色分配正确。
         • 为模型设置排序号。

     • 现象：点击菜单404

       • 排查项：检查Nginx转发配置是否正确，特别是静态资源路径。
       • 排查项：检查AFCenter后端服务是否正常。
       • 解决方案：
         • 添加正确的Nginx转发配置：

           location /api/afc {
               proxy_set_header Host $host;
               proxy_set_header X-Real-IP $remote_addr;
               proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
               proxy_set_header X-EOS-SourceSysKey dc6baaed30e541d78bb91274803d9432;
               proxy_pass http://AFCenter后端IP:端口;
           }

         • 确保AFCenter服务正常运行。

     • 现象：菜单名称乱码/未国际化

       • 排查项：模型的“模型名称”是否已正确设置。
       • 排查项：国际化场景下，是否已提取中文翻译。
       • 解决方案：
         • 修改模型名称为正确显示的名称。
         • 在“页面配置”中使用国际化资源配置，提取中文翻译。
         • 如涉及需通过jar文件解决的国际化问题：请通过AME+发起工单，申请获取对应的国际化补丁jar包，放置到mdm/lib目录下并重启服务。

     • 现象：扩展菜单无法显示

       • 排查项：自定义页面的“资源编码”是否正确复制并填写到扩展菜单配置中。
       • 排查项：填写页面编码时是否去掉了“mdm”前缀。
       • 解决方案：
         • 在低开中心复制正确的资源编码。
         • 在“数据授权”->“菜单功能权限”->“低开扩展”中，填写去掉前缀后的页面编码。