# 导入数据实体
#### 操作场景
当用户需要管理大量数据实体或复制属性时，手动逐一添加效率较低。工业数字模型驱动引擎-数据建模引擎（xDM Foundation，简称xDM-F）支持通过Excel模板批量导入数据实体及其属性，提升配置效率。
本文档详细介绍如何通过模板文件快速完成数据实体导入。
#### 约束与限制
为了确保数据导入过程高效和准确，xDM-F对导入数据实体设置了如下规则和限制：
- **文件格式要求** ：仅支持导入.xlsx格式文件，且文件末尾必须添加**#EOF**作为结束标识。
- **数量限制**：标准使用场景的应用设计态，单次批量导入的数据实体数量不能超过500个。轻量使用场景的应用设计态，单次批量导入的数据实体数量不能超过50个。
- **数据规范** ：
  - 配置导入文件时，每个数据实体属性的中文名称和英文名称，在其所属父模型及子模型的所有属性中必须唯一，不可重复。
  
  - 如果导入文件中存在数据实体的循环引用（如两个或多个数据实体互相参考引用，形成依赖环），则导入失败。
   
- **导入过程中的自动调整规则** ：
  - 系统会根据英文名称进行匹配。如果已存在相同英文名称的数据实体或其属性，则覆盖其配置；如果不存在，则新建数据实体或其属性。
  
  - 针对不同属性类型或模型类型的特殊处理如下：
    - M-V模型中作为"版本对象"的数据实体：系统自动将属性的"唯一键"修正为"否"，避免同一版本内字段重复。
    
    - 属性类型为"文件"：系统自动将"必填"、"列表属性"、"入库"和"唯一键"修正为"否"，保障文件类型属性的灵活性。
    
    - 属性类型为"参考对象"：
      - 系统自动关联目标数据模型。如果目标数据模型仅存在于当前导入文件中，将自动触发解耦逻辑，无需预先配置关联数据。
      
      - 系统自动将属性的"唯一键"修正为"否"。
      
      - 如果属性的"组合关系"设置为"是"，系统自动将"必填"修正为"是"。
      
      - 如果属性关联的目标数据模型（已发布状态）属于其他应用，执行导入时需同时满足： 操作人需具有目标数据模型所属应用的"应用责任人"或"应用开发人员"权限。
        目标数据模型所属应用的使用场景需与当前应用一致。如：当前应用为"标准使用场景"时，关联的目标数据模型所属应用也必须为"标准使用场景"。
        
       
    
    - 属性类型为"JSON"：系统自动将"唯一键"、"列表属性"和"多值"修正为"否"，以适应JSON数据结构的特性。
    
    - 属性类型为"URL"：系统自动将"唯一键"修正为"否"，允许导入的数据中存在相同URL的不同记录。
    
    - 属性设置了"唯一键"为"是"：系统自动将"默认值"修正为空字符（""），以防默认值与已有数据冲突。
    
    - "文本"类型属性设置了"值加密"为"是"：系统自动将"列表属性"修正为"否"，确保加密数据不会暴露在列表展示中。
     
   
 
#### 前提条件
- 已[登录应用设计态](https://support.huaweicloud.com/consog-idme/idme_consog_0013.html)。
- 已下载和配置数据实体模板。下载模板请参见[下载数据实体导入模板](https://support.huaweicloud.com/usermanual-idme/idme_usermanual_0017.html)。
 
#### 操作步骤
1. 在左侧导航栏中，选择"数据模型管理 \> 数据实体"，进入数据实体页面。
2. 选择"导入导出批量操作 \> 批量导入"。 
   图1批量导入   
   ![](https://support.huaweicloud.com/usermanual-idme/figure/zh-cn_image_0000001841018337.png "点击放大")
   
   
3. 在弹出的窗口中，选取已配置好的数据实体模板，单击"确认上传"。
4. 在弹出的提示框中，单击"确定"。 
   您也可以单击提示框中的"我的导入任务"，查看任务进度。