导入数据实体

操作场景

当用户需要管理大量数据实体或复制属性时，手动逐一添加效率较低。工业数字模型驱动引擎-数据建模引擎（xDM Foundation，简称xDM-F）支持通过Excel模板批量导入数据实体及其属性，提升配置效率。

本文档详细介绍如何通过模板文件快速完成数据实体导入。

约束与限制

为了确保数据导入过程高效和准确，xDM-F对导入数据实体设置了如下规则和限制：

• 仅支持导入.xlsx格式文件，且文件末尾必须添加#EOF作为结束标识。
• 标准使用场景的应用设计态，单次批量导入的数据实体数量不能超过500个。轻量使用场景的应用设计态，单次批量导入的数据实体数量不能超过50个。
• 在配置导入文件时，需保证每个数据实体属性的中/英文名称在其所属父/子模型的所有属性中唯一，不能重复。
• 如果导入文件存在数据实体循环引用（如两个或多个数据实体互相参考引用，形成依赖环），则导入失败。
• 导入过程中，系统会根据如下规则自动调整：
  • 系统根据英文名称进行匹配，如果已存在相同英文名称的数据实体或其属性，则覆盖其配置；如果不存在，则新建数据实体或其属性。
  • 对于M-V模型中作为“版本对象”的数据实体，系统会自动将属性的“唯一键”修正为“否”，以避免同一版本内字段的重复性问题。
  • 对于属性类型为“文件”的数据实体属性，系统会自动将“必填”、“列表属性”、“入库”和“唯一键”修正为“否”，确保文件类型的灵活性和适用性。
  • 对于属性类型为“参考对象”的数据实体属性：
    • 系统自动关联目标数据模型，如果目标数据模型仅在导入文件中存在，则自动触发解耦逻辑，无需预配置关联数据。
    • 系统自动将“唯一键”修正为“否”。
    • 如果该属性的“组合关系”设置为“是”，系统自动将“必填”修正为“是”。
  • 对于属性类型为“JSON”的数据实体属性，系统会自动将“唯一键”、“列表属性”和“多值”修正为“否”，以适应JSON数据结构的特性。
  • 对于属性类型为“URL”的数据实体属性，系统会自动将“唯一键”修正为“否”，允许导入的数据中存在相同URL的不同记录。
  • 如果数据实体的某个属性设置“唯一键”为“是”，系统会自动将属性的“默认值”修正为空字符（""），以防默认值与已存在的数据发生冲突。
  • 如果数据实体的某个“文本”类型属性设置“值加密”为“是”，系统会自动将“列表属性”修正为“否”，以确保加密后的数据不会暴露在列表展示中。

前提条件

• 已登录应用设计态。
• 已下载和配置数据实体模板。下载模板请参见下载数据实体导入模板。

操作步骤

1. 在左侧导航栏中，选择“数据模型管理 > 数据实体”，进入数据实体页面。
2. 选择“导入导出批量操作 > 批量导入”。
   图1 批量导入
   

3. 在弹出的窗口中，选取已配置好的数据实体模板，单击“确认上传”。
4. 在弹出的提示框中，单击“确定”。

   您也可以单击提示框中的“我的导入任务”，查看任务进度。