
# 基于数字主线引擎实现"5G产线物料缺失异常追溯方案设计"
由于5G产品研发技术门槛高，研发阶段如果发生器件质量问题，如何实现快速、精准追溯至关重要。在缺乏统一平台支撑的情况下，相关问题只能依靠人工汇总的方式处理，单次追溯耗时长达1\~2天，不仅影响现网问题处置效率，降低客户满意度，还会推高生产成本。
本案例以"物料清单中部分物料缺货将导致哪些生产设备停机"为典型场景，依托数字主线引擎的数据追溯能力，实现对该类问题的高效解决。
通过构建5G产线物料缺失异常追溯设计方案，可完整体验数字主线引擎的数据建模、数据模型图谱、实例数据入图、数据探索及图形化API编排等核心功能。如需了解数字主线引擎的更多功能介绍，请参见[产品功能](https://support.huaweicloud.com/productdesc-idme/idme_productdesc_0003.html)。
#### 场景说明
针对5G基站研发制造生产过程进行模型抽象与设计，确定图谱中需包含物料清单、部件、质检员、仓库、出口管制类型、生产设备、测试文档等模型节点，以及这些模型节点间的关联关系（存放、部件有出口管制、设备有出口管制限制等）。
图15G基站研发制造全流程业务模型抽象示意图   
![](https://support.huaweicloud.com/qs-idme/figure/zh-cn_image_0000002542919894.png "点击放大")
#### 前提条件
- 已[注册华为账号并开通华为云](https://support.huaweicloud.com/usermanual-account/account_id_001.html)，并完成[实名认证](https://support.huaweicloud.com/usermanual-account/account_auth_00001.html)。
- 已[开通数字主线引擎](https://support.huaweicloud.com/consog-idme/idme_consog_0041.html)。
 
#### 开发流程
[图2]展示了基于数字主线引擎，构建5G产线物料缺失异常追溯设计方案的完整开发流程。
图2基于数字主线引擎的追溯设计方案构建流程   
![](https://support.huaweicloud.com/qs-idme/figure/zh-cn_image_0000002543464210.png "点击放大")
**在正式操作前，** **假设已在数字主线引擎中，授予了操作用户user001开发人员以上的权限。**
#### 步骤1：模型设计
根据[图1]，首先需完成模型图谱内各模型节点（如部件、仓库等），以及模型基本信息与属性的配置。数据实体创建成功并发布后，将在数据模型图谱中自动生成对应节点。然后，再对实体间业务关联关系进行定义。关系实体创建并发布后，图谱中将自动生成模型节点间的关系连线。
#### 创建数据实体并发布
1. 使用"user001"账号登录数字主线引擎。
2. 选择"模型设计 \> 数据模型管理"，默认进入"数据实体"页面。
3. 单击"创建"，弹出"创建数据实体"页面。
4. 配置数据实体基本信息和对应属性后，根据界面提示保存。
   
   参考[3]至[4]依次创建多个数据实体模型，实体配置信息如[表1]和[表2]所示。
    表1多个数据实体的基本信息配置 
   | 英文名称             | 中文名称   | 英文描述             | 中文描述   | 责任人     | 是否主数据 | 产品阶段 | 是否构建表 |
   |:---|:---|:---|:---|:---|:---|:---|:---|
   | Part             | 部件     | Part             | 部件     | 选择当前操作者 | 是     | 分析态  | 不构建表  |
   | QualityInspector | 质检员    | QualityInspector | 质检员    | 选择当前操作者 | 否     | 分析态  | 不构建表  |
   | WareHouse        | 仓库     | WareHouse        | 仓库     | 选择当前操作者 | 是     | 分析态  | 不构建表  |
   | ECCN             | 出口管制类型 | ECCN             | 出口管制类型 | 选择当前操作者 | 否     | 分析态  | 不构建表  |
   | Equipment        | 生产设备   | Equipment        | 生产设备   | 选择当前操作者 | 是     | 分析态  | 不构建表  |
   | TestingReport    | 测试文档   | TestingReport    | 测试文档   | 选择当前操作者 | 否     | 分析态  | 不构建表  |
   | BoM              | 物料清单   | BoM              | 物料清单   | 选择当前操作者 | 否     | 分析态  | 不构建表  |
      
    表2Part数据实体属性 
   | 英文名称         | 中文名称 | 英文描述         | 中文描述 | 类型 | 密级 | 文本长度 | 是否唯一键 | 是否关联属性 | 是否必填 |
   |:---|:---|:---|:---|:---|:---|:---|:---|:---|:---|
   | WareHouse_ID | 仓库ID | WareHouse_ID | 仓库ID | 文本 | 秘密 | 100  | 否     | 是      | 是    |
      
   
   
5. 在数据实体列表中勾选[4]中创建的所有数据实体，单击"发布"。
   
   已发布的数据实体可在模型图谱中生成相关的模型节点。
   
   
 
#### 创建关系实体并发布
1. 选择"模型设计 \> 数据模型管理"，默认进入"数据实体"页面。
2. 在左侧导航栏选择"关系实体"，进入"关系实体"页面。
3. 单击"创建"，弹出"创建关系实体"页面。
4. 配置关系实体基本信息和对应属性后，根据界面提示保存。
   
   参考[3]至[4]依次创建多个关系实体模型，实体配置信息如[表3]所示。
    表3多个关系实体的基本信息配置 
   | 英文名称               | 中文名称      | 英文描述               | 中文描述      | 责任人     | 是否实体 | 选择源、目标的数据实体名称以及关联属性                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | 是否构建表 |
   |:---|:---|:---|:---|:---|:---|:---|:---|
   | Store              | 存放        | Store              | 存放        | 选择当前操作者 | 是    | - 源数据实体名称：Part  - 源端关联属性：WareHouse_ID  - 目标数据实体名称：WareHouse  - 目标端关联属性：ID           | 不构建表  |
   | HasEquipment       | 包含生产设备    | HasEquipment       | 包含生产设备    | 选择当前操作者 | 是    | - 源数据实体名称：TestingReport  - 源端关联属性：ID  - 目标数据实体名称：Equipment  - 目标端关联属性：ID           | 不构建表  |
   | HasECCNOnEquipment | 设备有出口管制限制 | HasECCNOnEquipment | 设备有出口管制限制 | 选择当前操作者 | 是    | - 源数据实体名称：Equipment  - 源端关联属性：ID  - 目标数据实体名称：ECCN  - 目标端关联属性：ID                 | 不构建表  |
   | HasECCNOnPart      | 部件有出口管制   | HasECCNOnPart      | 部件有出口管制   | 选择当前操作者 | 是    | - 源数据实体名称：Part  - 源端关联属性：ID  - 目标数据实体名称：ECCN  - 目标端关联属性：ID                     | 不构建表  |
   | HasBoM             | 有物料清单     | HasBoM             | 有物料清单     | 选择当前操作者 | 是    | - 源数据实体名称：Part  - 源端关联属性：ID  - 目标数据实体名称：BOM  - 目标端关联属性：ID                   | 不构建表  |
   | InspectQuality     | 实施质量检查    | InspectQuality     | 实施质量检查    | 选择当前操作者 | 是    | - 源数据实体名称：QualityInspector  - 源端关联属性：ID  - 目标数据实体名称：Part  - 目标端关联属性：ID            | 不构建表  |
   | WritesReport       | 写测试文档     | WritesReport       | 写测试文档     | 选择当前操作者 | 是    | - 源数据实体名称：QualityInspector  - 源端关联属性：ID  - 目标数据实体名称：TestingReport  - 目标端关联属性：ID   | 不构建表  |
      
   
   
5. 在关系实体列表中勾选[4]中创建的所有关系实体，单击"发布"。
   
   已发布的关系实体可在模型图谱中生成相关模型节点间的关系线。
   
   
 
#### 查看数据模型图谱
选择"模型设计 \> 数据模型图谱"，进入"数据模型图谱"页面。
您可以看到由部件、物料清单、仓库等模型节点以及节点间关系线组成的业务图谱。
图35G基站研发制造业务模型图谱   
![](https://support.huaweicloud.com/qs-idme/figure/zh-cn_image_0000002573810997.png "点击放大")
#### 步骤2：实例入图
数据入图是指为已完成设计的实体模型添加具体数据实例，将关系型数据库、CSV文件等来源数据映射至图数据库，使彼此有关联的数据形成相互连接的网络，用于构建知识图谱并支撑后续数据探索。本方案通过配置CSV文件类型的数据入图任务，完成数据入图。
#### 创建数据入图任务
1. 选择"数据联接 \> 数据入图"，默认进入"数据入图任务"页面。
2. 单击"创建"，系统右侧弹出"任务定义"页面。
3. 填写数据入图任务的基本信息。 
   以Part数据实体和HasBom关系实体为例，具体配置信息可参考[表4]和[表5]。
    表4Part_task基本信息 
   | 参数      | 说明               |
   |:---|:---|
   | 任务名称    | Part_task。       |
   | 任务描述    | 部件入图任务。          |
   | 任务类型    | 默认"周期任务"且不支持修改。  |
   | 导入对象类型  | 选择数据实体\&关系。      |
   | 任务owner | 选择当前操作者。         |
   | 数据实体    | 选择Part数据实体。      |
   | 数据入图类型  | 选择"CSV文件"类型。     |
   | 删除数据    | 保持默认"否"。         |
   | 优先级     | 保持默认值10，表示最低优先级。 |
      
    表5HasBom_task基本信息 
   | 参数      | 说明               |
   |:---|:---|
   | 任务名称    | HasBom_task。     |
   | 任务描述    | 有物料清单入图任务。       |
   | 任务类型    | 默认"周期任务"且不支持修改。  |
   | 导入对象类型  | 选择关系实体。          |
   | 任务owner | 选择当前操作者。         |
   | 数据实体    | 选择HasBom关系实体。    |
   | 数据入图类型  | 选择"CSV文件"类型。     |
   | 删除数据    | 保持默认"否"。         |
   | 优先级     | 保持默认值10，表示最低优先级。 |
      
   
   
4. 单击"下一步"，在入图配置阶段的**目标端信息** 中，下拉选择"映射名称"后单击"保存"。
   
   参考[2]至[4]，依次创建Warehouse、ECCN、Equipment、TestingReport、BoM等数据实体，以及Store、HasEquipment、HasECCNOnEquipment、HasECCNOnPart、HasBoM、InspectQuality、WritesReport等关系实体的数据入图任务。
   
   
 
#### 为实体添加实例数据
1. 在"数据入图任务"页面的任务列表中，找到待操作的目标任务（如Part_task），单击其操作列处的![](https://support.huaweicloud.com/qs-idme/figure/zh-cn_image_0000002573936823.png "点击放大")。
2. 进入下载中心，找到已下载的模板文件，填写并保存。
3. 单击其操作列处的，弹出"CSV导入"窗口。
4. 选取[2]中提前准备好的文件，根据页面提示单击"确认执行"。
5. 参考上述步骤，为所有数据实体与关系实体添加实例数据。
 
 #### 步骤3：数据探索
以查询"物料清单中部分物料缺货，将导致哪些生产设备停工"为典型场景，开展数据探索分析。
1. 选择"数据探索 \> 数据图谱 \> 模型图谱"，进入"模型图谱"页面。
2. 在搜索框右侧单击，弹出"路径查询"窗口。
3. 输入起始节点（BOM）、终点节点（Equipment）等，单击"搜索"。 
   找出BOM和Equipment的最短路径（物料清单-部件-出口管制类型-生产设备）。
   图4找出BOM和Equipment的最短路径   
   ![](https://support.huaweicloud.com/qs-idme/figure/zh-cn_image_0000002573851625.png "点击放大")
   
   
4. 单击路径旁的![](https://support.huaweicloud.com/qs-idme/figure/zh-cn_image_0000002543369800.png "点击放大")数据探索图标跳转至"模型路径探索"。单击数据实体（如BoM）后的![](https://support.huaweicloud.com/qs-idme/figure/zh-cn_image_0000002543211708.png "点击放大")，在快捷菜单中单击"筛选实例"，然后在弹出的"筛选实例"窗口中按需添加实例数据。
   
   通过添加所有短缺的物料实例数据（如物料1、物料5、物料8、物料10）至探索画布中，并筛选"管制类型1"（假设其含义为欧洲管制）类型的ECCN模型，可直观查看到受本次物料短缺影响的生产设备（设备1、设备2）。
   图5查看受本次物料短缺影响的生产设备   
   ![](https://support.huaweicloud.com/qs-idme/figure/zh-cn_image_0000002543229522.png "点击放大")
   
   
5. 单击"保存"，输入数据探索名称"物料清单中物料缺货会造成哪些生产设备停工"，单击"确定"保存。
 
#### 步骤4：编排异常数据追溯API
利用聚合服务编排，可实现零代码拖拽的方式来生成API，将数据探索结果固化后供后续快速复用。
以[步骤3：数据探索]中"物料清单中部分物料缺货将导致哪些生产设备停机"的探索结果为例，编排异常数据追溯API。
1. 选择"数据探索 \> 数据探索"，默认进入"实例图谱探索"页面。
2. 在左侧导航栏选择"模型路径探索"，进入"模型路径探索"页面。
3. 在模型路径选择框中下拉切换，找到[步骤3：数据探索]中的"物料清单中物料缺货会造成哪些生产设备停工"数据探索，单击"发布"。
4. 单击"配置聚合服务"，填写如[表6]的服务基本信息后，单击"确定"保存。
   
    表6聚合服务基本信息 
   | 参数      | 说明                       |
   |:---|:---|
   | API英文名称 | Abnormal_Data_Trace_API。 |
   | API中文名称 | 异常数据追溯API。               |
   | API英文描述 | Abnormal_Data_Trace_API。 |
   | API中文描述 | 物料清单中部分物料缺货将导致哪些生产设备停机。  |
      
   
   
5. 选择"数据服务 \> 聚合服务编排"，进入"聚合服务编排"页面。
6. 在列表中找到API英文名称为"Abnormal_Data_Trace_API"的API，单击"编码"超链接打开该API的详情页。
7. 切换至"服务开发"页签，单击"运行"，输入BoM_ID（如1），单击"生产环境运行"并查看运行结果。 
   运行完后下方"输出结果"处展示运行结果。
   图6运行服务   
   ![](https://support.huaweicloud.com/qs-idme/figure/zh-cn_image_0000002573865029.png "点击放大")
   
   
8. 脚本运行成功之后，单击"保存用例"，将本次的入参保存下来作为"服务测试"的用例。
9. 切换至"服务发布"页签，配置服务发布信息后单击"保存"。 
   表7响应参数说明 
   | 响应参数   | 示例内容                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
   |:---|:---|
   | 请求示例   | 单击"引入用例"，自动填充请求示例至请求参数中。 {"BoM_ID":"1","BoM_Name":"","pageSize":10,"pageNumber":1,"returnTotalCountFlag":false}                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
   | 正常响应示例 | { "data": \[{ "Part_ID": "2", "Equipment_ID": "1", "ECCN_ID": "1", "Equipment_NAME": "设备1", "BoM_ID": "1", "ECCN_NAME": "管制限制1", "Part_NAME": "BBU", "BoM_NAME": "物料1" }, ...... \], "resultType": "SUCCESS", "errors": {} } |
   | 异常响应示例 | {"data": \[{...}\],"resultType": "ERROR","errors": \[\]}                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
   | 错误码示例  | - 403 {"message":"无权限"}   - 500 {"message":"服务器内部异常"}                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
      
   
   
10. 单击"发布"，完成该数据服务的发布。后续可在"服务发布"页签中获取API调用信息，通过接口调用，快速追溯5G物料缺失对相关设备造成的影响。 
    图7API调用信息   
    ![](https://support.huaweicloud.com/qs-idme/figure/zh-cn_image_0000002550744196.png "点击放大")
    
    
 
#### 出现问题？
非常抱歉您在使用时出现问题，您可以第一时间[联系我们](https://console.huaweicloud.com/smartadvisor)，也可以先参考相关文档进行问题定位和解决。
以下是用户在使用数字主线引擎时出现的常见问题，建议您先参考文档进行问题定位和解决。
- 为什么IAM账号无法访问数字主线引擎？ 请参见[用户权限管理](https://support.huaweicloud.com/instg-idme/idme_instg_0264.html)。
  
- 如何登录数字主线引擎？ 请参见[登录数字主线引擎](https://support.huaweicloud.com/consog-idme/idme_consog_0045.html)。
  
 
