导入数据实体

操作场景

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

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

约束与限制

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

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