华为云用户手册

操作场景 为资源申请和绑定弹性公网IP后，可以直接访问Internet。 当您想找回已释放的弹性公网IP或申请一个指定地址的弹性公网IP时，您可以通过API接口来实现。在申请弹性公网IP时请将“ip_address”的值设置为您想找回或指定的IP地址。详情请参见《弹性公网IP API参考》。 如果该地址已被分配给其他用户则无法申请成功。 通过API接口不支持找回或创建指定的包年/包月的弹性公网IP。 管理控制台不支持找回或创建指定地址的弹性公网IP。

新手常见问题 基本问题 如何使用工业数字模型驱动引擎？ 工业数字模型驱动引擎计费相关问题？ 什么是M-V模型？ 什么是XDM应用？ iDME支持同时发布多个应用吗？ 进阶问题 应用发布后，在运行态为什么看不到构建的模型数据？ 如何获取已上传文件（图片）的文件（图片）路径？ 为什么 IAM 账号无法访问iDME？ 试用API时提示404怎么办？ 为什么调用API时，无法保存创建人和创建时间？ 批量删除的API最多可以同时删除多少条数据？ 更多常见问题，请参见常见问题。

工业数字模型驱动引擎常用操作 工业数字模型驱动引擎功能丰富，本节通过表格的形式为您展示常用功能。 表1 数据建模引擎常用功能 如果您想... 您可以参考... 购买数据建模引擎 购买数据建模引擎 创建应用 创建应用 登录iDME应用设计态 登录应用设计态 调整用户操作应用设计态的权限 用户管理 创建新的数据实体 创建数据实体（设计态） 对数据模型间建立关系 关系实体 将本地已有数据库数据转为iDME数据模型 反向建模 创建新的接口模型，便于后续继承该接口模型的实体创建更多与该接口模型具有相同自定义项的属性和关系 创建接口模型 修改iDME内置模型，自定义数据建模引擎（xDM Foundation，简称xDM-F）的能力和模型 XDM应用 登录iDME应用运行态 登录应用运行态 动态扩展模型类型、属性等 创建数据实体（运行态） 创建属性 定义生命周期模板，实现对象的全过程管理 生命周期管理 使用服务编排能力编排原子API，提高应用开发的速度与质量 服务编排管理 创建新的上传文件类型 创建文件类型 从各种维度（例如部门、团队、角色、群组等）对应用运行态资源进行权限管理 权限管理 查看到应用运行态的系统日志 系统日志 在本地计算机查看全量数据服务API 导出全量数据 表2 数字主线引擎常用功能 如果您想... 您可以参考... 开通数字主线引擎 开通数字主线引擎 删除数字主线引擎 删除数字主线引擎 登录数字主线引擎 登录数字主线引擎 内置的企业级多租，支持企业内自定义应用级多租，满足了不同应用场景下对数据隔离的要求 租户管理 调整用户的数据操作权限 用户权限管理 配置基础数据，如数据源、源系统、标签等 基础数据管理 多种方式新增数据实体 新增数据实体 多种方式新增关系实体 新增关系实体 建立数据入图任务，将实体模型对应的实例数据入到图数据库，便于构建模型 知识图谱 ，后续进行数据探索 新增数据入图任务 将数据模型及模型间关系以可视化模型图谱形式展示 数据模型图谱 图形化编排数据模型，低代码甚至零代码服务编排原子API，形成跨实体（表）的组合API 聚合服务编排 定义全局变量，实现在请求和脚本中存储和重用数据 环境变量 企业可基于项目绘制业务流程图，将流程中的业务活动与数据模型联接，并关联相关数据服务，形成业务流程关联的数据资产归档 数字化场景

iDME运行服务 包括数据建模引擎和数字主线引擎两种运行服务。 数据建模引擎：是用于应用部署和运行的计算、存储、网络等基础设施资源的集合。用户可以按运行服务的维度管理数据建模引擎资源和部署应用。例如，对应用进行部署、升级、卸载等操作，在应用运行态使用更丰富的数据管理能力。 数字主线引擎：采用数字化技术，定义产品全量数据模型，打通数据孤岛联接业务数据，全关联海量业务实例数据构建全价值网络，并为各领域提供高效数据索引、追溯、交互服务。

M-V模型 Master-Version（M-V）模型是工业数字模型驱动引擎-数据建模引擎（xDM Foundation，简称xDM-F）提供的一种实体模型，具有版本管理功能。创建“父模型”为“VersionObject”数据实体时，系统会自动生成三个对象（版本对象、主对象和分支对象），这三个对象称为M-V模型实体。 版本对象：即Version模型，又称为大版本，会自动生成两个“参考对象”类型的基本属性（Master和Branch）。 Master是一条源端为Version，目标端为Master的非组合参考关系，用于识别该实例归属的主对象。 Branch是一条源端为Version，目标端为Branch的非组合参考关系，用于识别同一个Master下相同的大版本。 如果在版本对象中进行修改、发布和作废的操作，主对象和分支对象会自动同步处理。 主对象：即Master模型，可单独编辑和修订。 分支对象：即Branch模型，可单独编辑和修订。

产品架构 iDME产品架构如图3所示，为满足工业软件对数据管理引擎整体技术要求高、业务需求复杂等诉求，iDME以“万物皆模型，一切皆数据”的架构设计思想，依托华为数字化转型经验，构建的工业数字模型驱动引擎。 图3 工业数字模型驱动引擎架构图 iDME产品形态包含iDME 设计服务和iDME 运行服务两部分。 iDME 设计服务：提供应用管理功能模块，集成创建、修改、开发和发布等功能为一体，方便您高效地开发和管理应用。 iDME 运行服务：包括数据建模引擎和数字主线引擎两种运行服务。 数据建模引擎：是用于应用部署和运行的计算、存储、网络等基础设施资源的集合。您可以按运行服务的维度管理数据建模引擎资源和部署应用。例如，对应用进行部署、升级、卸载等操作，在应用运行态使用更丰富的数据管理能力。 数字主线引擎：采用数字化技术，可同步应用模型，也可自定义产品全量数据模型，打通数据孤岛联接业务数据，全关联海量业务实例数据构建全价值网络，并为各领域提供高效数据索引、追溯、交互服务。

产品介绍 工业数字模型驱动引擎（Industrial Digital Model Engine，简称iDME），是基于数字化变革和数据管理优秀实践开发的创新型工业软件开发与运营平台，打造“基于模型+数据驱动”的公共底座，为协同打造新一代全栈自主可控工业软件体系提供根技术服务，助力快速构建和运营云化SaaS化工业软件，汇聚企业全场景数据，构建企业级数据图谱，提供万数互联的数据索引、追溯、交互服务。 图1 工业数字模型驱动引擎 —工业数据的“根” iDME由iDME 设计服务、数据建模引擎、数字主线引擎和工业数据模型模板库组成。 图2 工业数字模型驱动引擎 iDME当前已提供iDME 设计服务、数据建模引擎和数字主线引擎。 iDME 设计服务（iDME Studio）：是iDME数据模型开发平台，当前仅支持基于数据建模引擎能力创建和设计应用及数据模型。 数据建模引擎（xDM Foundation，简称xDM-F）：沉淀工业产品数据管理业务的优秀实践及模型标准，预置开箱即用的数据管理功能，基于元模型的理念提供灵活的数据模型扩展能力、以开放的云原生技术架构提供低码扩展及服务编排能力，使能客户低成本、高效构建数字化、云化、支持多租户形式的工业数据管理应用。 数字主线引擎（LinkX Foundation，简称LinkX-F）：采用数字化技术，定义产品全量数据模型，打通数据孤岛联接业务数据，全关联海量业务实例数据构建全价值网络，并为各领域提供高效数据索引、追溯、交互服务。 工业数据模型模板库：内置多套基于行业标准、华为经验、业界实践而抽象总结的工业软件数据模型模板，帮助您快速复用成熟、标准的数据模型。

数字主线引擎 其中表1展示了登录数字主线引擎后的产品功能。 表1 数字主线引擎功能概览 功能名称 功能描述 发布区域 我的工作空间 展示当前登录用户的导出、导入任务清单。 华北-北京四 xDM-F数据同步 通过xDM-F数据同步功能可将xDM-F模型与实例数据同步至LinkX-F系统。 说明： xDM-F数据同步功能仅支持企业级管理员操作。 华北-北京四 模型设计 定义产品全生命周期业务数据实体的管理规则，包括业务数据实体定义、数据实体之间的关系定义，以及数据实体与关系上的属性定义。 支持所有模型图谱化展示，更清晰的展现模型之间的关系。 支持对基础数据进行定制，在建模时使用，包括定制枚举类型和单位类型等。 支持多种方式创建模型，包括自定义模型参数、逆向建模、集成xDM-F模型自动生成模型数据信息等方式。 支持通过数据看板实时统计数据实体模型、数据实体模型属性、 数据实例 以及数据源映射的数量。 华北-北京四 数据联接 为已设计的数据模型添加数据实例，实现连接异构系统，将数据从其他类型的数据源映射到图数据库，彼此有关联的数据形成相互连接的网络。通过建立数据入图任务，即可读写大批量符合要求的数据，以实现数据入图的增量更新。 支持数据入图任务的进度监控。 支持数据任务执行后数据质量检查，检查数据量、数据值是否一致。 华北-北京四 数据质量 通过创建数据质量检查任务，根据已配置的数据实体属性约束规则，生成数据质量检查报告，获取异常数据量以及异常率等关键质量信息。 华北-北京四 数据探索 可视化数据模型图谱，支持在海量数据中快速探索数据间的关联关系。 华北-北京四 数据服务 支持数据服务管理，可自行定义API的URL、路径、API逻辑等。 支持服务编排，针对具体应用场景，从全生命周期数据模型中选择一个数据模型项作为起点，图形化编排数据模型的交互路径，通过设置起点和路径中的各个节点中的过滤条件和输出字段等，一键生成所需的API，以供其他系统调用。 华北-北京四 数字化场景 企业基于项目绘制业务流程图，将流程中的业务活动与数据模型联接，并关联相关数据服务，形成业务流程关联的数据资产归档。 华北-北京四 基础数据管理 支持配置管理系统基础数据，包括数据源、源系统、标签等。 华北-北京四 用户权限管理 内置的用户授权功能，通过给用户授权租户及角色，使其拥有不同租户的数据访问和操作权限，保证用户拥有必要的权限开展相应的工作，避免越权操作和非安全操作。 华北-北京四 租户管理 支持配置管理租户，提供内置的企业级多租，企业内可自定义的应用级多租，满足了不同应用场景下对数据隔离的要求。 华北-北京四 父主题： 产品功能

生成全领域视图，适配各类数据消费场景 图形化编排图数据服务：基于数据模型图谱，挑选已经发布的实体和关系，配置结构化的条件表达式，通过拖拉拽等方式快速构建主题图谱并发布至生产环境，提升数据复用效率。 条目级数据追溯，检查数据断点：支持批量选中多行数据进行多层的关联查询，支持检查与下一层无关联的断点数据。 数据质量检查：支持配置数据实体属性约束规则，根据质量检查任务生成报告，支持查看异常数据量/异常率以及导出异常数据明细。

高可靠、高性能、高安全能力 图5 高可靠、高性能、高安全能力 高可靠：对每个租户物理隔离，拥有完整的高可用架构，支持同城双活、异地容灾；提供灰度发布、灰度切换保障、应用不停机更新，并且支持灾备快速切换支撑应用容灾稳定运行；支持优雅停机和故障节点自动重启以及流量解析自动熔断限流等，保障租户微服务的长期稳定运行。 高性能：具备数据写入实时队列及访问缓存能力，支持万级TPS峰值访问，整体API访问性能约200ms；支持应用自动扩容，提升资源使用率；支持租户级数据、文档全文检索，性能好、准确率高。 数据安全：支持保存数据所有历史版本，可追溯数据所有变化；支持保存访问日志，可追溯所有访问操作；并支持数据安全加密、文件安全校验，保障机密安全存储。

基于图连接，构建海量业务数据全关联图谱 适配多来源数据：内置图数据库，并支持Oracle、SQL Server等关系型数据库。 适配大批量数据增量更新：支持每天亿级别的节点、边的更新。 适配LinkX-F的多层租户架构：支撑不同租户计算资源、数据接入通道的隔离，避免租户之间的影响。 完善的管理控制能力：Web管理控制台，可以在线配置任务。 运营运维能力：提供任务和调度监控、数据对账、模型入图进度等功能。

分布式云原生底座，支撑构建云化SaaS化工业软件 图6 分布式云原生架构 元模型驱动多租，支持租户级定制。 云化多租户技术底座，提供容器化、服务化、SaaS化的数据管理服务，具备横向扩展能力，支持按需使用、自动弹性伸缩，可动态替换、灵活部署，支撑高性能、高吞吐量、高并发低时延、高可用业务场景。 全栈分布式架构，可用性、可靠性强。 灵活支持多种部署方式。公有云部署，随时获取最新版本更新，获取最佳体验。充分的弹性资源，保障企业百倍的业务峰值考验 ；现场部署，用户数据存在本地，低时延响应，支持数据在华为云公有云异地备份，传输存储全程加密，应对极端风险，用户按需从华为云应用商店订阅服务，节约成本。

数据建模引擎 表1、表2和表3分别展示了登录数据建模引擎后的产品功能。 表1 应用级功能概览 功能名称 功能描述 发布区域 数据看板 展示当前应用下所有的数据实体、关系实体、数据实例的数量以及最近的变化趋势。 华北-北京四 我的工作空间 展示当前登录用户的导出和导入任务清单，支持任务里导出、导入文件的下载。 华北-北京四 数据模型管理 提供数据模型驱动、功能可配置、设计即开发的数据模型管理能力。 支持数据实体、关系实体、接口模型的创建、查看、编辑、删除、发布、修订、作废。支持扩展实体，支持通过勾选的方式配置数据实体与关系实体的功能，发布模型后生成模型相关的服务，可在数据模型图谱中查看应用下的全量模型。 支持在应用运行态创建和管理已发布模型对应的数据实例，方便用户对发布的模型进行测试。 支持通过反向建模的快速导入实体。 华北-北京四 服务编排管理 当数据模型提供的标准接口无法满足用户的业务诉求时，支持用户使用服务编排能力对服务进行高代码编排，形成新的接口。 华北-北京四 搜索服务管理 提供自定义将模型实体或实例进行联合全文检索的搜索服务管理能力，支持自定义设置索引字段，提供底层的搜索接口，具有较高的搜索性能和匹配性，且每个搜索服务相互隔离。 华北-北京四 数据服务管理 提供应用内系统管理API以及模型生成的所有API的信息与请求实例，在应用部署后可调用。 华北-北京四 主服务标签 支持系统标签与自定义标签的定义。 华北-北京四 用户管理 应用责任人可在应用设计态给不同职责的用户授予合理的角色，并依据实际业务的变化随时调整，保证用户拥有必要的权限开展相应的工作，避免越权操作和非安全操作。 华北-北京四 应用同步 支持同一租户下不同应用间设计态和运行态的模型数据间的同步功能。 执行同步操作需要同时具备源应用和目标应用的权限。 支持在线同步和离线同步。其中，离线同步需先在源应用下创建离线同步任务，然后下载生成的同步文件，最后在目标应用下上传同步文件，即可完成离线同步任务。 华北-北京四 应用发布 应用发布将当前应用发布的模型和基础数据发布为一版新的代码包，支持查看应用发布历史与发布内容，支持下载最新20个版本的jar包和代码包。 华北-北京四 表2 模型级功能概览 功能名称 功能描述 发布区域 基础数据服务 任何实体模型都具有的功能服务，应用通过生成的基础数据服务原子接口，可实现基础服务调用。 华北-北京四 文件服务 支持通过数据建模创建文件类型属性即可实现多种非结构化数据管理的诉求，无需任何开发即可拥有数据对象的文件管理能力。 大文件断点续传能力，文件切片多线程快速上传及下载。 支持批量文件上传、一键批量下载。 支持HTTPS安全传输协议、文件匿名保存、根据业务规则控制文件下载权限。 支持多种文件存储类型： 二进制文件，0~1M，如头像、铃声等，直接保存在数据库中。 通用文件，1~100M，如office文档、短视频等，保存在OBS中。 超大文件，100M以上，如3D图纸、长视频等，保存在OBS中。 华北-北京四 安全受控 适用于需要对业务数据的关键信息和数据密级进行管控的场景。 提供了基础属性“KiaGuid（关键信息资产唯一标识），SecurityLevel（密级）”的定义。 华北-北京四 主版本服务 适用于需要对数据进行检出、修订、检入操作的业务场景，如主对象保存对外的ID和名称等不频繁改动的属性，版本对象保存可能频繁修改的信息。与下游系统集成时，会组合主对象的ID、名称以及最新版本对象的属性信息。 每个版本对象都有自己的主对象。 主版本服务没有对外可调用的Restful原子接口。 对版本对象进行检出、更新等操作时，不可以修改主对象。 如有必要更新主对象的数据，可以调用版本服务中的UpdateByAdminOf和BatchUpdateByAdminOf原子接口。不建议随版本对象对主对象进行频繁更新。在创建属性时，应分析此属性是主对象属性，还是版本对象属性。 华北-北京四 版本服务 创建一个数据实体，选择父模型为VersionObject或者VersionObject的子模型，表示正在创建一个M-V模型，版本服务功能就会在功能列表中被带出。 华北-北京四 系统版本 适用于需要保存数据实体的历史操作日志的场景。 为对象提供QueryHistoryDataOf（分页查询历史版本信息）和_CompareVersionOf（对比版本信息）两种服务。 华北-北京四 树形结构 适用于树形结构的数据实体。 树形结构的原理：树形结构接口模型创建时，自动生成“ParentNode”参考对象类型的属性，参考自身，形成1:N的关系。 对外提供GetAllParentList（获取全部父项）、GetChildList（获取单层子项）、BatchRemoveChildNode（批量移除子项）、GetParent（获取单层父项）、BatchAddChildNode（批量添加子项）等原子接口。 对于M-V对象，只能在master对象上勾选。 华北-北京四 权限管理 为应用提供ACL属性，用于存储不同类型的授权和鉴权信息。 为应用提供基于数据对象和操作的授鉴权功能服务，应用可根据自身业务需求，进行数据或功能授权鉴权的开发。 华北-北京四 业务编码生成器 适用于需要自定义业务编码的场景。应用可自定义业务编码生成的规则以及“业务编码绑定属性”（属性需为“文本类型&唯一键”）。 支持通过GenerateBusinessCode（新增业务编码）接口使用此功能。 对于M-V对象，只能在master对象上勾选。 华北-北京四 文件夹管理 适用于对数据对象需要进行文件夹关联和管理的场景。 文件夹管理实现Foldered接口模型，自动生成Folder属性，以数据实体Folder作为参考模型。Folder作为一个具有系统版本、基础数据服务、扩展属性、扩展类型、树形结构、失效管理功能的实体模型，可提供相关原子接口和功能，进行文件夹的操作。 Foldered接口模型和Folder实体，建立了多对多关系实体FolderedLink，根据关系实体的基础数据服务的相关接口服务可进行文件夹关系操作。 华北-北京四 分类管理 适用于对数据对象需要进行分类属性管理的场景。 可为数据实体添加分类类型的属性，分类属性可实例化到分类节点。 对象可通过分类属性从所有分类节点中选择自己所在的分类。 若为M-V对象，仅支持在version模型上维护。 华北-北京四 扩展属性 适用于在运行环境中，租户需要扩展业务属性的场景。 勾选扩展属性功能后，通过模型发布，租户发布部署后，租户侧代码的实体类中便会生成相应的扩展属性列表属性。租户侧可以为对象添加扩展属性，对扩展属性的CRUD不需要再进行租户发布部署。 如果用于应用中台构建，可为用户提供添加扩展属性的CRUD Rest接口注册到APIG，供用户进行调用。 对于M-V对象，只能在version模型上勾选。 华北-北京四 扩展类型 适用于标明哪些实体模型可以在应用运行态中被扩展。被扩展是指租户可以基于此实体模型创建自己个性化的数据实体模型。 仅“实体模型”可勾选此功能。扩展模型从父模型继承扩展类型功能。因为抽象模型没有生成物理表，故其不具备扩展类型的功能。 仅勾选了此功能的“实体模型”才可作为应用运行态中扩展模型的父模型。 华北-北京四 生命周期管理 适用于需要对业务对象进行生命周期状态管理的场景。 需要定义生命周期模板和状态，来完成数据对象的生命周期管理。请为数据对象的操作动作分别定义初始状态和目标状态，否则会出现因无目标状态导致操作被禁止的情况。 对于M-V对象，只能在version模型上勾选。 华北-北京四 失效管理 提供了“生效/失效”标识字段，勾选“失效管理”后即可对数据对象进行生失效管理。 接口模型提供了生效、失效的方法。 会影响系统版本，会影响更新时间，会发出增量数据消息。 对于M-V对象，不影响业务版本。 华北-北京四 所有者管理 勾选此功能的数据实体会有Owner属性，代表数据Owner。如有需要，您可在授权模块中围绕数据Owner的维度为数据实例设置访问控制权限。数据Owner在系统中是一个系统级的虚拟角色。系统中内置了两种虚拟角色： All表示所有用户。 Owner表示数据所有者。 华北-北京四 标签管理 适用于需要对数据对象实例打标签的场景。 对外提供三个接口QueryTag（查询对象标签）、AddTag（给对象打标签）和remove（去除对象标签）。 为实例数据打的标签，来源于“基础数据管理”的“标签管理”模块，需要用户自定义。 华北-北京四 多维视图&多维分支 M-V模型实体的可选功能，只能在version模型上勾选。 支持用户以不同视角（如设计、工艺、制造、服务等）对同一个数据对象（如BOM编码）进行差异化管理。 一个M-V模型实体可添加三个多维版本管理数据对象，且各视图版本的数据独立演进，简化用户对多版本管理的操作。 华北-北京四 表3 属性级功能概览 功能名称 功能描述 发布区域 属性类型 为数据模型创建属性时，需要指定属性类型。 当前属性类型包括：文本、长文本、整型、长整型、浮点型、浮点型（自定义精度）、参考对象、文件、布尔值、日期、枚举、人员、URL和JSON。 不同的属性类型具备不同的约束条件。 华北-北京四 枚举 创建枚举类型时，需要为其创建枚举项。例如，枚举类型为性别，枚举值为男和女。 为模型创建属性或在属性库创建属性时，如果指定了属性类型为枚举，则必须指定枚举类型。 如果模型具有枚举类型的属性，为模型创建数据实例时，可以在枚举属性选择枚举项。 华北-北京四 密级 所有类型的属性都需要配置密级。 默认密级为：内部公开。 属性的密级作用于数据实例的属性值。 华北-北京四 合法值 创建合法值时，应为其配置具体的合法值列表。 合法值共有五种类型：文本、整型、长整型、浮点型和人员。 为模型创建属性或在属性库创建属性时，如果指定了属性类型为文本、整型、长整型、浮点型、人员，可以为其选择合法值。 如果模型属性选择了合法值，为模型创建数据实例时，此属性的字段值必须在合法值列表中。 华北-北京四 计量单位 创建计量单位时，需要为其创建具体的单位。例如计量单位：重量，单位：克和千克。 为模型创建属性或在属性库创建属性时，如果指定了属性类型为数字类型（整型、长整型或浮点型），则可根据需要指定计量单位（单位类型）。 如果模型具有计量单位的属性，为模型创建数据实例时，可以在为属性值选择单位。 华北-北京四 属性库 支持在属性库中维护属性。 如果数据模型选择了扩展属性功能，并配置了扩展属性类型和数量，则可以为数据模型从属性库中选择对应类型的属性。 为数据模型添加的扩展属性数量不能超过其配置的扩展属性数量。 华北-北京四 文件存储方式 为模型创建属性或在属性库创建属性时，如果指定了属性类型为文件，则必须选择文件存储方式。 提供两种文件存储方式： BLOB：数据库存储，最大支持1M。 对象存储：使用 对象存储服务 存储文件，文件≤100M使用普通上传，文件＞100M使用分块上传，最大支持10G。 华北-北京四 父主题： 产品功能

数字主线引擎权限 数字主线引擎采用数字化技术，定义产品全量数据模型，打通数据孤岛联接业务数据，全关联海量业务实例数据构建全价值网络，并为各领域提供高效数据索引、追溯、交互服务。 登录数字主线引擎（LinkX Foundation，简称LinkX-F）后，基于iDME RBAC（Role-Based Access Control，基于角色的访问控制）能力的授权，通过数字主线引擎中的用户授权功能使IAM用户拥有系统的合理操作权限。 数字主线引擎中内置了四类角色：企业级管理员、租户级管理员、开发人员和只读人员，这四类角色之间的关系和简要说明如下： 企业级管理员（En_ADMINISTRATOR）：拥有系统操作的最高权限，并可对除自身外的其他用户进行数据权限授权。 数字主线引擎购买成功后会自动开通企业租户，即服务购买账号也是开通企业租户的账号。该账号登录数字主线引擎后，系统默认会为其配置该角色。 租户级管理员（Func_ADMINISTRATOR）：由企业级管理员授权，享有授权应用租户下除“xDM-F数据同步”外的其他模块的数据操作权限，但不包含“全局用户授权”的可见可操作权限。 开发人员（Func_DEVELOPER）：由企业级管理员或租户级管理员授权，享有授权应用租户下除“xDM-F数据同步”、“租户管理”和“用户权限管理”外的其他模块的数据操作权限，但不包含“全局用户授权”和“活动日志”的可见可操作权限。 只读人员（Func_READER）：由企业级管理员或租户级管理员授权，享有授权应用租户的数据只读权限，但不包含“全局用户授权”和“活动日志”的可见权限。 父主题： 权限管理

产品规格 工业数字模型驱动引擎（Industrial Digital Model Engine，简称iDME）的产品规格如下所示： 表1和表2约束限制中应用、基础版数据建模引擎、节点、增量包、用户和MCU数量范围是指同一华为账号同一区域下，服务或服务对应配置项可设置的数量下限和上限。约束限制中所述的数量上限指初次购买时可配置的最大值（即总配额），实际购买时每次可设置的数量上限取决于剩余配额。如果某个资源的剩余配额不能满足后续的购买需求时，您可申请扩大配额，详细操作请参见配额管理。 表1 产品规格 产品类型 产品规格 约束限制 描述 iDME 设计服务 基础版 iDME设计服务 支持创建的应用数量范围：0-20 每个应用可开发模型数不超过500个。 “iDME 设计服务”指iDME的数据模型开发环境。 数据建模引擎 基础版 数据建模引擎 运行服务 同一华为账号同一区域下支持购买的基础版数据建模引擎数量范围：0-5 基础版数据建模引擎提供了物理隔离的运行环境，运行环境实例发放到租户虚拟私有云中，企业自用首选。 数据建模引擎-节点 基础版 数据建模引擎 节点 基础版 数据建模引擎 边缘节点 节点增长步长：1 节点数量范围：1-20 节点指支撑数据管理应用程序运行的云资源组合，用户在应用设计态完成数据模型开发后可根据需要购买一个或者多个“数据建模引擎-节点”部署数据管理应用程序，构建数据管理服务。数据建模引擎部署位置不同，适用的节点类型有所不同： 部署在公有云上，适用的节点类型为“基础版 数据建模引擎 节点”，单节点提供固定规格：应用运行4U8G*2、结构化数据存储200G、非结构化存储500G和基线数据存储20G。 部署在边缘云上，应用运行依赖于智能边缘小站所提供的资源，适用的节点类型为“基础版 数据建模引擎 边缘节点”。 数据建模引擎-增量包 结构化数据增量包(20GB) 文件数据增量包(500GB) 基线数据增量包(20GB*2) 增量包增长步长：1 结构化数据增量包数量范围：0-50 文件数据增量包数量范围：0-200 基线数据增量包数量范围：0-50 搭配“基础版 数据建模引擎 节点”使用，用于扩容节点中的数据容量。 单个结构化数据增量包可为节点扩容20GB的结构化数据容量。 单个文件数据增量包可为节点扩容500GB的文件数据容量。 单个基线数据增量包可为节点40GB的基线数据容量。 数据建模引擎-用户 基础版 数据建模引擎 用户 基础版 数据建模引擎 边缘用户 用户数量增长步长：1 基础版用户数量范围：1-10000 基础版边缘用户数量范围：50-10000 用户指数据管理应用所管理的最终用户。例如客户采用iDME构建PDM应用并服务于最终用户，则需要购买相应数量的“数据建模引擎-用户”商品。数据建模引擎部署位置不同，适用的用户类型有所不同： 部署在公有云上，适用的用户类型为“基础版 数据建模引擎 用户”。 部署在边缘云上，适用的用户类型为“基础版 数据建模引擎 边缘用户”。 数字主线引擎 数字主线引擎 MCU 数字主线引擎各服务能力规格根据分配的MCU数量不同而有所不同，详细请参见表2。 按需计费的MCU起购数量为6 包年/包月的MCU起购数量为10 MCU（Model Compute Unit），数字主线引擎计费的计算单元。根据各服务能力分配的MCU数量总和和使用时长计费。 根据数字主线引擎提供的以下服务能力进行MCU分配： 模型管理 服务管理 数据管理 表2 数字主线引擎各服务能力规格说明 服务能力 MCU分配指标 约束限制 描述 模型管理 已发布的数据模型数量 已发布的数据模型数量范围：50-6750（个） MCU数量范围：2-270 用户创建的业务模型（如数据实体、关系实体）数量，体现业务复杂度。每1MCU支持25个已发布的数据模型，MCU分配数量以正整数递增。 服务管理 各类数据服务调用所需的计算资源规模 服务管理范围：10-500（万边/秒） MCU数量范围：3-96 在每秒内服务可计算数据广度，体现业务分析规模。服务管理与MCU数量换算呈现非线性变化关系，详细请参见表3。 数据管理 模型承载的实例数据规模 数据规模范围：100-2000（GB） MCU数量范围：1-20 产品联接的数据大小，体现用户数据规模。每1MCU支持100GB，MCU分配数量以正整数递增。 表3 服务管理与MCU换算关系表 服务管理（万边/秒） MCU 10 3 20 6 50 12 100 24 200 48 500 96 父主题： 工业数字模型驱动引擎简介

数字主线引擎典型应用场景 传统 数据治理 过程中，先面向结果而后面向过程，“乱而后治”这种方式使得在各种单体式系统管理着标准各异的孤岛数据的情况下，不断耗费精力集成打通，数据复用效率及低。 工业数字模型驱动引擎-数字主线引擎采用直接面向业务对象，先建模后实例， 使用图结构承载物理产品的数字模型以及吸收的研发、销售、制造、供应、交付、运维等各环节相关数据，形成伴随物理产品全生命周期的全量数据价值网络，为各环节提供同源数据。从而实现“不治而顺”，统一模型，大幅度降低集成难度。 图2 数字主线引擎典型应用场景 供得上数据中台构建应用场景：连接研发、采购、供应、销售、交付等多领域数据，提供清洁可信的数据服务。 器件全量信息查询应用场景：一键查询器件全量和产业链看板分析，支撑TMG器件归一化、硬件工程师器件选型等高效作业。 器件质量追溯服务应用场景：基于LinkX-F图谱技术，通过多系统超大数据量处理，快速支撑连续性器件质量追溯一键式分析器件问题影响，有效提升器件质量问题分析处理效率。 制造域数据服务应用场景：支撑制造对基础数据可视及精准匹配，提升生产效率和产品加工质量。 作业类应用实践应用场景：统一系统间集成方式，简化集成，提供Part&BOM、offering、缺陷、需求等数据基础服务和聚合服务，支持DevX及硬件数字化快速编排、高效作业。

数据建模引擎典型应用场景 传统的软件开发过程中，需要大量的数据开发工作，对架构设计、模型设计要求极高，能力难以复用，数据迁移过程中也容易频频出错，标准难以统一。工业数字模型驱动引擎-数据建模引擎通过元模型驱动方式创新性的解决了数据管理工作痛点，功能可配置、服务可编排、一键发布、设计即开发，具有广泛的应用场景。 图1 数据建模引擎典型应用场景 基于工业数字模型驱动引擎-数据建模引擎构建的Saas产品，如SysDM系统工程研发平台解决方案、PDM集成产品开发平台、SPDM仿真数据管理平台、工艺过程管理系统MPM、互联数字工厂SaaS系统、工业软件产教融合云平台、数字化平台等，解决了以往高昂的硬件平台成本，以及海量的定制开发服务，重构用户体验、提升开发和响应效率、实现商业成功。 研发效率提升：强大的数据服务功能支持快速配置数据实例，自动生成数据服务，提升研发效率。 响应时间缩短：缩短API响应时间，大文件上下行速度明显提升。 迭代灵活高效：可视化的数据模型图谱，高代码编排及自定义数据服务API，让迭代更高效。 业务数据安全：多租户软隔离或硬隔离方式对数据进行加密隔离。

创建组织时为什么会重新登录？且输入账号密码后提示“账号或密码错误”？ OrgID默认认证源是华为账号，如果您登录iDME控制台的账号不是华为账号，在iDME控制台“创建组织”时则需要使用华为账号重新登录。 创建组织前，您可以将鼠标移动至控制台右上方的账号位置，在展开的菜单栏中，单击“基本信息”，进入基本信息页面。 如果“账号名”所在栏为“账号安全信息”，表示当前登录账号为华为云账号。建议您将华为云账号升级为华为账号，具体操作请参见升级。 如果您不想升级或无法升级华为云账号，请重新注册一个华为账号，使用该华为账号创建组织并将该组织分享给您的华为云账号，具体操作请参见组织管理。 如果“帐号名”所在栏为“华为帐号信息”，表示当前登录账号为华为账号。 父主题： 一般性相关问题

为什么要入图 传统数据库（如关系型数据库）的数据存储方式以表形式呈现，而表形式的数据存储方式不太适合描述数据之间的某些特定的复杂关系。例如想要查询实例数据之间的关系时，可能需要多次索引跨表查找，数据量大时必然会存在耗时长，查询效率低等缺点。 图1 传统数据库数据展示效果 图数据库是以图结构方式来表达数据，能更直观的展示出实例数据之间的关联关系。图数据库技术可以将关系信息储存为实体、灵活拓展为数据模型，这使得图模型对异构数据具有天然的包容力。 图2 图数据库数据展示效果

如何设置入图 在xDM-F系统，模型属性“入图”值的设置，会影响后期同步至LinkX-F系统中对应模型属性的“是否入图”值。我们根据xDM-F数据同步规则，可知xDM-F模型同步至LinkX-F系统中后，会根据xDM-F模型属性是否“入图”自动映射写入对应LinkX-F模型属性的“是否入图”值。 图3 在xDM-F中设置属性是否入图 在LinkX-F系统，入图或不入图指对模型属性“是否入图”值的设置，模型发布后系统会自动为入图属性配置图数据库映射字段，这样才能保证入图属性对应的实例数据入图。 xDM-F模型同步和属性入图的合理配置，不仅可以避免LinkX-F系统中数据管理资源的浪费，还可在后续数据分析时避免出现很多无用属性，影响分析效率。

支持的功能列表 表1 M-V模型支持的功能 类型 支持的功能 版本对象 基础功能：基础数据服务、安全受控、版本服务和文件服务。 可选功能：系统版本、权限管理、分类管理、数据分类管理、扩展属性、扩展类型、文件夹管理、生命周期管理、失效管理、多维视图&多维分支、所有者管理和标签管理。 主对象 基础功能：主版本服务和文件服务。 可选功能：系统版本、权限管理、业务编码生成器、分类管理、数据分类管理、扩展属性、文件夹管理、树形结构、失效管理、所有者管理和标签管理。 分支对象 基础功能：文件服务。 可选功能：文件夹管理。

修订记录 发布日期 修改说明 2024-03-28 第十四次正式发布。 新增 在工业数字模型驱动引擎中，IAM和OrgID的区别 入图和不入图有什么不同？ 什么是企业租户和应用租户？ 2024-02-23 第十三次正式发布。 新增 iDME常见错误提示及解决方法 ISCDesk登录页频繁自动刷新，如何处理？ 应用管理 修改 企业成员如何知道授权申请是否通过？ 软件试用到期后，如何申请使用？ 协同空间有什么使用限制？ 协同空间各角色分别有什么操作权限？ 2023-01-27 第十二次正式发布。 新增 ISCDesk是否支持记住密码和自动登录？ 长时间未登录系统，导致登录异常？ 成员授权按钮为什么会置灰？ 软件试用到期后，如何申请使用？ 修改 企业成员如何知道授权申请是否通过？ 协同空间各角色分别有什么操作权限？ 删除 空间文件为什么无法下载？ 2023-12-25 第十一次正式发布。 新增工业软件SaaS服务中心相关问题 2023-12-20 第十次正式发布。 新增数字化制造基础服务相关问题 2023-09-23 第九次正式发布。 新增为什么无法登录应用运行态？ 2023-08-29 第八次正式发布。 新增 创建实体时选择构建表的作用是什么？ 复杂实体属性太多，创建麻烦怎么办？ 什么是源端映射和目标端映射？ 维护目标端映射时的构建表有什么作用？ 什么是增量字段？ 关系型数据库映射配置中DelFlag字段的作用是什么？ 创建数据质量任务时，怎么选不出数据实体？ 聚合服务编排中非纯脚本服务选择入参时，提示错误“初始数据实体必填入参为空，请选择必填入参”？ 发布聚合服务后生成的API如何调用？ 删除 单节点配置是什么？可以支持多少用户数（并发用户数）或业务量？ 节点配置可以自定义吗？如果节点不够怎么办？ 什么是VPC？如何进行VPC配置？ 为什么我不能购买iDME商品？ 购买iDME商品前需要做哪些准备？ iDME商品购买失败后会自动退款吗？ 什么是运行服务、节点和用户？ 运行服务中的节点和用户可以转移吗？ 节点和用户的计费是叠加的，还是二选一？ 2023-08-19 第七次正式发布。 新增创建组织时为什么会重新登录？且输入账号密码后提示“账号或密码错误”？ 2023-07-22 第六次正式发布。 新增 单节点配置是什么？可以支持多少用户数（并发用户数）或业务量？ 节点配置可以自定义吗？如果节点不够怎么办？ 什么是VPC？如何进行VPC配置？ 为什么我不能购买iDME商品？ 购买iDME商品前需要做哪些准备？ iDME商品购买失败后会自动退款吗？ 什么是运行服务、节点和用户？ 运行服务中的节点和用户可以转移吗？ 节点和用户的计费是叠加的，还是二选一？ 2023-06-17 第五次正式发布。 新增 iDME支持同时发布多个应用吗？ 为什么使用API删除M-V模型的数据实例时，只能删除最新版本的实例数据？ 修改 2.1-工业数字模型驱动引擎如何收费？ 2023-05-20 第四次正式发布。 新增 为什么调用搜索服务管理API时，返回结果跟以前的不一样？ 为什么用户管理中会有“用户不存在”的用户？ 2023-02-18 第三次正式发布。 新增 什么是XDM应用？ 全量数据服务中的API支持导出吗？ 2023-01-15 第二次正式发布。 新增 如何获取已上传文件（图片）的文件（图片）路径？ 为什么IAM账号无法访问iDME？ 2022-11-30 第一次正式发布。

准备工作 在进行API编排前，已创建如下数据实体和关系实体，并基于这些实体创建了若干实例。 表1 服务使用的数据实体 英文名称 中文名称 中文描述 英文描述 SupplierSN 供应商SN实例 供应商SN的实例信息。 SupplierSN Part Part主信息 称为Item或部件，指企业经营活动相关的原材料、外协件、在制品、半成品、备件、成品、费用、服务等，包括编码、描述、计量单位、项目模板、状态、厂家信息等属性。 Part PurchaserSN 采购商SN实例 采购商SN的实例信息，含21条码、09条码等。 PurchaserSN ReverseBackItems 单板维修及返还记录 单板维修及返还记录，含逆向退回和报废数据。 ReverseBackItems ProductTallyShip 产品理货发货信息 产品理货发货信息，含条码理货、发货信息。 ProductTallyShip Offering Offering整合信息 Offering。 Offering PartVersion Part版本 Part版本。 PartVersion 表2 服务使用的关系实体中源端、目标端数据实体对应的关联属性 数据实体 属性英文名称 属性中文名称 属性英文描述 属性中文描述 类型 是否唯一键 密级 PartVersion PartNumber Part编码 PartNumber Part的唯一标识 文本 否 内部公开 PartVersion OfferingId Offering ID OfferingId Offering的ID，IT系统自动生成流水码 文本 否 内部公开 SupplierSN ID ID ID 唯一编码 文本 是 内部公开 ProductTallyShip BarCode BarCode BarCode BarCode 文本 否 内部公开 PurchaserSN PartNumber Part编码 PartNumber Part的唯一标识 文本 否 内部公开 PurchaserSN ID ID ID 唯一编码 文本 是 内部公开 ReverseBackItems Barcode barcode barcode barcode 文本 否 内部公开 Part BpartNumber Part编码 BpartNumber Part的唯一标识 文本 是 内部公开 Offering ID ID ID 唯一编码 文本 是 内部公开 表3 服务使用的关系实体 英文名称 中文名称 中文描述 英文描述 是否实体关系 源端数据实体 源端关联属性 目标端数据实体 目标端关联属性 PartVersionTOPartANDContain Part版本与Part的关系 Part版本与Part的关系。 PartVersion And Part Relationship 否 PartVersion PartNumber Part BpartNumber PartVersionTOOfferingANDContain Part版本与Offering的关系 Part版本与Offering的关系。 PartVersion And Offering Relationship 否 PartVersion OfferingId Offering ID SupplierSNAndPurchaserSNRelationship 供应商SN实例与采购商SN实例的关系 供应商SN实例与采购商SN实例的关系。 SupplierSN And PurchaserSN Relationship 是 SupplierSN ID PurchaserSN ID PurchaserSNAndProductTallyShipRelationship 产品理货发货信息与采购商SN实例的关系 产品理货发货信息与采购商SN实例的关系。 ProductTallyShip And PurchaserSN Relationship 否 ProductTallyShip BarCode PurchaserSN ID PurchaserSNAndPartRelationship 采购商SN实例与Part的关系 采购商SN实例与Part的关系。 PurchaserSN And Part Relationship 否 PurchaserSN PartNumber Part BpartNumber ReverseBackItemstoPurchaserSN 单板维修及返还记录与采购商SN实例的关系 单板维修及返还记录与采购商SN实例的关系。 ReverseBackItems And PurchaserSN Relationship 否 ReverseBackItems Barcode PurchaserSN ID 父主题： 实施步骤

操作流程 使用分块上传文件之前，您必须先调用“文件管理”的“file_startBatchUpload”接口校验待上传的文件之前是否上传至某个数据模型中。如果您之前已经上传某个文件，现在需要重新上传，那么该文件具有闪传能力，会自动闪传至数据模型中，无需重新分块上传。如果您没有上传过该文件，调用“file_startBatchUpload”接口时，初始化分块上传，成功执行此请求后将返回“docId”和“fileId”，用于后续的分块请求。 初始化分块上传后，调用“文件管理”的“upload_uploadLargeFile”接口根据指定的“docId”、“fileId”、“chunk”等参数值上传分块文件。 当使用“upload_uploadLargeFile”完成所有分块上传后，您必须调用“file_mergeFiles”来完成整个文件的分块上传。在使用该接口时，您必须在请求体中给出“docId”、“fileId”和“chunk”等参数值，用来校验每个分块的有效性。当所有的分块验证通过后，系统将把这些分块合并成一个完整的文件。

操作场景 工业数字模型驱动引擎-数据建模引擎（xDM Foundation，简称xDM-F）可以将待上传的文件分成多个分块分别上传，上传完成后再调用“file_mergeFiles”接口将这些分块合并成一个对象存储至某个数据模型中。 完成文件的分块上传后，可在调用数据实例的创建/更新接口时，将文件与该数据实例进行关联，从而实现对象化管理文件。 本文仅指导您如何通过API方式分块上传文件。关于如何创建/更新数据实例的接口请参见全量数据服务。

操作步骤 闪传文件。 如果您已上传某个文件，再上传该文件时，您只需执行本步骤即可完成文件上传。 接口相关信息 表1 startBatchUpload接口 接口信息 说明 URI格式 POST http://{Endpoint}/rdm_{appID}_app/services/rdm/basic/api/file/startBatchUpload Endpoint：必填，String类型，承载REST服务端点的服务器域名或IP地址。 appID：必填，String类型，应用ID。 applicationId：必填，String类型，应用ID。 model_name：必填，String类型，数据模型的英文名称。 model_number：选填，String类型，数据模型的编码。 attribute_name：必填，String类型，数据模型的属性英文名称。 file_name：选填，String类型，待上传文件的名称。本参数与fileName参数必须二选一。不能同时为空，且优先级低于fileName。 file_size：必填，String类型，待上传文件的大小。 chunks：必填，String类型，待上传文件的分块数量。您可以根据构建数据模型时创建属性的约束（分块大小）计算待上传文件的分块数量。 check_code：必填，String类型，文件唯一校验码，即文件的哈希值。 instance_id：必填，String类型，数据实例的唯一编码。 username：必填，String类型，用户名称。 fileId：选填，String类型，文件ID。 encrypted：选填，Boolean类型，用户名称。 exaAttr：选填，String类型，是否为扩展属性。 0：非扩展属性 1：扩展属性 请求参数 Header参数 X-Auth-Token：必填，String类型，用户的token。 Body参数 fileName：选填，String类型，待上传文件的名称。本参数与file_name参数必须二选一。不能同时为空，且优先级高于file_name。 响应参数 result：String类型，调用是否成功。 SUC CES S：成功 FAIL：失败 data：List类型，调用的返回结果。 isMergedFile：是否合并文件。 false：否 true：是 docId：文档ID。 fileId：文件ID。 errors：List类型，异常信息列表。 请求示例 新上传一个101MB的文件“testFile.zip”，由于在添加“文件”类型属性时“分块大小”为默认值（5MB），文件需分为21个分块。 POST https://dme.cn-north-4.huaweicloud.com/rdm_fce01234567d41828cf3473b07fa7ae2_app/services/rdm/basic/api/file/startBatchUpload?applicationId=fce01234567d41828cf3473b07fa7ae2&model_name=Craft_File&attribute_name=LargeFiles&file_name=testFile.zip&file_size=103424&chunks=21&check_code=1234567890&instance_id=1&username=XDM_User X-Auth-Token: ABCDEFJ.... 响应示例 { "result": "SUCCESS", "data": [ { "isMergedFile": false, "docId": "0000018BB1E33DC685E9C0045DFC7291", "fileId": "564032141298503680" } ], "errors": [] } 分块上传。 根据调用startBatchUpload接口设置的分块数量，依次执行uploadLargeFile接口。 接口相关信息 表2 uploadLargeFile接口 接口信息 说明 URI格式 POST http://{Endpoint}/rdm_{appID}_app/services/rdm/basic/api/upload/uploadLargeFile Endpoint：必填，String类型，承载REST服务端点的服务器域名或IP地址。 appID：必填，String类型，应用ID。 applicationId：必填，String类型，应用ID。 modelNumber：必填，String类型，数据模型的编码。 modelName：必填，String类型，数据模型的英文名称。 attributeName：必填，String类型，数据模型的属性英文名称。 docId：必填，String类型，文档ID，即调用startBatchUpload接口返回的docId。 fileId：必填，String类型，文件ID，即调用startBatchUpload接口返回的fileId。 fileName：必填，String类型，待上传文件的名称。 checkCode：必填，String类型，文件的唯一校验码，即文件的哈希值。 chunk：必填，Integer类型，待上传的分块位数。例如您上传第5块分块，填写5。 storageType：选填，Integer类型，文件的存储类型。 0：对象存储 1：BLOB exaAttr：选填，String类型，是否为扩展属性。 0：非扩展属性 1：扩展属性 username：选填，String类型，用户名。 请求参数 Header参数 X-Auth-Token：必填，String类型，用户的token。 响应参数 result：String类型，调用是否成功。 SUCCESS：成功 FAIL：失败 data：List类型，调用的返回结果。 errors：List类型，异常信息列表。 请求示例 根据请求示例的文件分块数量，依次执行如下接口。为篇幅起见，这里以上传第1个分块为例。 POST https://dme.cn-north-4.huaweicloud.com/rdm_fce01234567d41828cf3473b07fa7ae2_app/services/rdm/basic/api/upload/uploadLargeFile?attributeName=LargeFiles&modelName=Craft_File&applicationId=fce01234567d41828cf3473b07fa7ae2&fileId=564032141298503680&fileName=testFile.zip&checkCode=1234567890&chunk=1&docId=0000018BB1E33DC685E9C0045DFC7291&modelNumber=DM00127285 X-Auth-Token: ABCDEFJ.... [MultipartFile Form files] 响应示例 { "result": "SUCCESS", "data": [ "564091302493294592" ], "errors": [] } 分块合并。 接口相关信息 表3 mergeFiles接口 接口信息 说明 URI格式 POST http://{Endpoint}/rdm_{appID}_app/services/rdm/basic/api/file/mergeFiles Endpoint：必填，String类型，承载REST服务端点的服务器域名或IP地址。 appID：必填，String类型，应用ID。 applicationId：必填，String类型，应用ID。 modelName：必填，String类型， attributeName：必填，String类型， docId：必填，String类型，文档ID，即调用startBatchUpload接口返回的docId。 fileId：必填，String类型，文件ID，即调用startBatchUpload接口返回的fileId。 fileName：必填，String类型，待上传文件的名称。 checkCode：必填，String类型，文件的唯一校验码，即文件的哈希值。 instanceId：选填，String类型，数据实例的唯一编码。 exaAttr：选填，String类型，是否为扩展属性。 0：非扩展属性 1：扩展属性 请求参数 Header参数 X-Auth-Token：必填，String类型，用户的token。 响应参数 result：String类型，调用是否成功。 SUCCESS：成功 FAIL：失败 data：List类型，调用的返回结果。 fileSize：文件的大小。 fileId：文件ID。 errors：List类型，异常信息列表。 请求示例 POST https://dme.cn-north-4.huaweicloud.com/rdm_fce01234567d41828cf3473b07fa7ae2_app/services/rdm/basic/api/file/mergeFiles?applicationId=fce01234567d41828cf3473b07fa7ae2&modelNumber=DM00127285&modelName=Craft_File&attributeName=LargeFiles&fileName=testFile.zip&checkCode=1234567890&docId=0000018BB1E33DC685E9C0045DFC7291&exaAttr=0&fileId=564032141298503680 X-Auth-Token: ABCDEFJ.... 响应示例 { "result": "SUCCESS", "data": [ { "fileSize": "103424", "fileId": "564032141298503680" } ], "errors": [] }

请求示例 POST https://dme.cn-north-4.huaweicloud.com/rdm_fce01234567d41828cf3473b07fa7ae2_app/services/rdm/basic/api/upload/uploadFile?applicationId=e22c66fb1d05453fa33162772e3cc9c0&attributeName=LargeFiles&dataType=entity&encrypted=false&exaAttr=1&modelName=Industrial_File&modelNumber=DM00127283&storageType=0&username=XDM_User X-Auth-Token: ABCDEFJ.... [MultipartFile Form files]

URI URI格式： POST http://{Endpoint}/rdm_{appID}_app/services/rdm/basic/api/upload/uploadFile 参数说明： 表1 URI参数说明 参数 是否必填 参数类型 描述 Endpoint 是 String 承载REST服务端点的服务器域名或IP地址。 appID 是 String 应用ID。 modelNumber 是 String 数据模型的编码。 modelName 是 String 数据模型的英文名称。 dataType 否 String 数据模型的类型。 entity：数据实体 relation：关系实体 attributeName 是 String 数据模型的属性英文名称。 applicationId 是 String 应用ID。 username 是 String 用户名。 storageType 是 Integer 文件的存储类型。 0：对象存储 1：BLOB instanceId 是 String 数据实例的唯一编码。 exaAttr 是 String 是否为扩展属性。 0：非扩展属性 1：扩展属性 encrypted 否 Boolean 是否加密。当“storageType”设置为“0”时，需要设置此参数。 true：加密 false：不加密

功能介绍 通过“文件管理”接口“upload_uploadFile”可以将本地的文件上传至工业数字模型驱动引擎（Industrial Digital Model Engine，简称iDME）中。完成文件上传后，可在调用数据实例的创建/更新接口时，将文件与该数据实例进行关联，从而实现对象化管理文件。 “upload_uploadFile”接口最大支持上传100M文件。如需上传大于100M的文件，请使用分块上传的接口。 本文仅指导您如何通过API方式上传简单文件。关于如何创建/更新数据实例的接口请参见全量数据服务。

操作场景 文件服务是数据实体/关系实体的基础功能之一，在应用设计态创建的数据实体/关系实体均具有该能力。但在使用文件服务功能之前，您需要为数据实体/关系实体添加一个“文件”类型的属性。 如果您希望构建的数据模型在实例化时可以直接使用文件服务功能，您可在应用设计态构建数据模型时添加“文件”类型的基础属性/自定义基础属性，具体操作请参见管理数据实体属性/管理关系实体属性。 如果您希望构建的数据模型可以面向多种业务场景，或者不想对已构建的数据模型进行变更，但当前构建的数据模型无法满足您的业务需求时，您可以先在应用设计态构建具有“扩展属性”功能的数据模型，并在数据模型的“功能配置”中配置扩展属性规则（包含配置一个“文件”类型的扩展属性规则）。而后即可在应用运行态对数据模型进行定制化扩展。 本章节以构建一个“文件”类型扩展属性的数据实体为例。