操作步骤 创建应用，用于对软件应用的设计和构建。 iDME提供控制台和API两种创建方式，具体操作请参见创建应用（控制台）和创建应用（API）。 在应用设计态构建并发布应用。 构建应用：对业务规则进行设计和开发，具体操作请参见数据建模引擎用户指南。 发布应用：生成相应代码包，具体操作请参见发布应用。 部署应用，生成应用运行态，用于多租户应用集成测试及数据服务调用。 iDME提供控制台和API两种部署方式，具体操作请参见部署应用（控制台）和部署应用（API）。

请求示例 示例背景 已在cn-north-4区域的TestApp应用中，构建一个名称为“TestMV”、多维版本属性为“view2”的M-V模型数据实体，并完成了实体发布、应用发布和应用部署。 已在应用运行态通过可视化页面或API的方式创建一个多维版本的 数据实例 ，其数据实例的唯一编码为“523616294595981234”。 您的业务数据存在较大变更，希望可以创建新的版本，差异化管理实例数据。 示例代码 { "params": { "modifier": "XDM_Developer", "masterId": "637652965003370496", "workCopyType": "BOTH", "view2": { "id": "4" } } }

响应示例 { "result": "SUC CES S", "data": [ { "id": "637773750976122880", "creator": "XDM_Developer", "modifier": "XDM_Developer", "createTime": "2024-05-30T14:05:11.504+0000", "lastUpdateTime": "2024-05-30T14:05:11.504+0000", "rdmVersion": 1, "rdmDeleteFlag": 0, "rdmExtensionType": "MultiViewMv", "tenant": { "id": "-1", "creator": "xdmAdmin", "modifier": "xdmAdmin", "createTime": "2024-05-30T01:11:34.110+0000", "lastUpdateTime": "2024-05-30T01:11:34.110+0000", "rdmVersion": 1, "rdmDeleteFlag": 0, "rdmExtensionType": "Tenant", "tenant": null, "className": "Tenant", "name": "basicTenant", "description": "默认租户", "kiaguid": null, "securityLevel": "internal", "nameEn": null, "code": "basicTenant", "disableFlag": false, "dataSource": "DefaultDataSource" }, "className": "MultiViewMv", "name": "1", "description": null, "kiaguid": null, "securityLevel": "internal", "master": { "id": "637652965003370496", "creator": "XDM_Developer", "modifier": "XDM_Developer", "createTime": "2024-05-30T06:05:13.911+0000", "lastUpdateTime": "2024-05-30T06:14:31.070+0000", "rdmVersion": 2, "rdmDeleteFlag": 0, "rdmExtensionType": "MultiViewMvMaster", "tenant": { "id": "-1", "creator": "xdmAdmin", "modifier": "xdmAdmin", "createTime": "2024-05-30T01:11:34.110+0000", "lastUpdateTime": "2024-05-30T01:11:34.110+0000", "rdmVersion": 1, "rdmDeleteFlag": 0, "rdmExtensionType": "Tenant", "tenant": null, "className": "Tenant", "name": "basicTenant", "description": "默认租户", "kiaguid": null, "securityLevel": "internal", "nameEn": null, "code": "basicTenant", "disableFlag": false, "dataSource": "DefaultDataSource" }, "className": "MultiViewMvMaster" }, "branch": { "id": "637773751051620352", "creator": "XDM_Developer", "modifier": "XDM_Developer", "createTime": "2024-05-30T14:05:11.496+0000", "lastUpdateTime": "2024-05-30T14:05:11.496+0000", "rdmVersion": 1, "rdmDeleteFlag": 0, "rdmExtensionType": "MultiViewMvBranch", "tenant": { "id": "-1", "creator": "xdmAdmin", "modifier": "xdmAdmin", "createTime": "2024-05-30T01:11:34.110+0000", "lastUpdateTime": "2024-05-30T01:11:34.110+0000", "rdmVersion": 1, "rdmDeleteFlag": 0, "rdmExtensionType": "Tenant", "tenant": null, "className": "Tenant", "name": "basicTenant", "description": "默认租户", "kiaguid": null, "securityLevel": "internal", "nameEn": null, "code": "basicTenant", "disableFlag": false, "dataSource": "DefaultDataSource" }, "className": "MultiViewMvBranch", "version": "C" }, "latest": true, "latestIteration": true, "versionCode": 3, "iteration": 1, "version": "C", "latestVersion": true, "workingCopy": false, "workingState": { "code": "CHECKED_IN", "cnName": "已检入", "enName": "checked in", "alias": "CHECKED_IN" }, "checkOutUserName": null, "checkOutTime": null, "preVersionId": "637760894251569152", "view2": { "id": "4", "creator": "XDM_Developer", "modifier": "XDM_Developer", "createTime": "2024-05-30T07:17:01.666+0000", "lastUpdateTime": "2024-05-30T07:17:01.666+0000", "rdmVersion": 1, "rdmDeleteFlag": 0, "rdmExtensionType": "Entity", "tenant": { "id": "-1", "creator": "xdmAdmin", "modifier": "xdmAdmin", "createTime": "2024-05-30T01:11:34.110+0000", "lastUpdateTime": "2024-05-30T01:11:34.110+0000", "rdmVersion": 1, "rdmDeleteFlag": 0, "rdmExtensionType": "Tenant", "tenant": null, "className": "Tenant", "name": "basicTenant", "description": "默认租户", "kiaguid": null, "securityLevel": "internal", "nameEn": null, "code": "basicTenant", "disableFlag": false, "dataSource": "DefaultDataSource" }, "className": "Entity", "name": null, "description": null, "kiaguid": null, "securityLevel": "internal", "ref": null, "lifecycleTemplate": null, "lifecycleState": null, "folder": null, "clsAttrs": null, "owner": [], "aclEntry": null, "rootNode": null, "parentNode": null, "leafFlag": true, "fullPath": "4/", "rawFullPath": "4/", "disableFlag": false, "extAttrs": [], "extAttrMap": {} }, "lifecycleTemplate": null, "lifecycleState": null, "disableFlag": false, "aclEntry": null, "clsAttrs": null, "owner": [], "extAttrs": [], "extAttrMap": {} } ], "errors": [] }

请求参数 表2 请求body参数 参数 是否必填 参数类型 描述 creator 否 String 创建者。 modifier 否 String 更新者。 masterId 是 String 主对象ID。 workCopyType 否 Object 此配置项用于创建多维版本数据实例时是否继承其对应的关系实例。根据业务需求，选择类型。 BOTH：若存在关系实例引用此数据实例作为源端实例或目标端实例，创建后的数据实例将继承这些关系实例。 SOURCE：若存在关系实例引用此数据实例作为源端实例，创建后的数据实例将继承这些关系实例。 TARGET：若存在关系实例引用此数据实例作为目标端实例，创建后的数据实例将继承这些关系实例。 NONE：创建后的数据实例将不继承任何关系实例。 CUSTOM：若指定的关系实体集合对应的关系实例引用此数据实例作为源端实例或目标端实例，创建后的数据实例将继承这些关系实例。 workingCopy 否 Boolean 是否工作副本，默认值false customLinkSet 否 List 关系实体名称的集合。 当“workCopyType”设置为“CUSTOM”时，需要设置此参数。 needSetNull 否 List 指定不复制的属性。被指定不复制的属性，其返回值将被设置为“null”。 view2 否 说明： 如果用户在应用设计态配置“多维版本”功能配置时，将此多维版本属性设置为必填，则请求参数为必填项。 Object 自定义的多维版本属性。 view2.id 是 String 多维版本属性的ID。 view2.clazz 否 String 多维版本属性的类名。

URI URL格式： POST http://{Endpoint}/rdm_{appID}_app/publicservices/dynamic/api/{entityName}/revise 参数说明： 表1 URI参数说明 参数 是否必填 参数类型 描述 Endpoint 是 String 承载REST服务端点的服务器 域名 或IP地址。 appID 是 String 应用ID。 entityName 是 String 实体的英文名称。

URI URL格式： POST http://{Endpoint}/rdm_{appID}_app/publicservices/api/{entityName}/createView 参数说明： 表1 URI参数说明 参数 是否必填 参数类型 描述 Endpoint 是 String 承载REST服务端点的服务器域名或IP地址。 appID 是 String 应用ID。 entityName 是 String 实体的英文名称。

请求示例 示例背景 您已在cn-north-4区域的TestApp应用中，构建一个名称为“TestMV”、多维版本属性为“view2”的M-V模型数据实体，并完成了实体发布、应用发布和应用部署。希望可以根据已创建的M-V模型数据实例，创建一个多维版本数据实例。 示例代码 { "params": { "versionId": "521722330943061234", "modifier": "DME_Developer", "view2": { "id": "11", "clazz": "ViewAttr" } } }

请求参数 表2 请求body参数 参数 是否必填 参数类型 描述 versionId 是 String 原视图的versionId，即已创建数据实例的version.唯一编码。 workCopyType 否 Object 此配置项用于创建多维版本数据实例时是否继承其对应的关系实例。根据业务需求，选择类型。 BOTH：若存在关系实例引用此数据实例作为源端实例或目标端实例，创建后的数据实例将继承这些关系实例。 SOURCE：若存在关系实例引用此数据实例作为源端实例，创建后的数据实例将继承这些关系实例。 TARGET：若存在关系实例引用此数据实例作为目标端实例，创建后的数据实例将继承这些关系实例。 NONE：创建后的数据实例将不继承任何关系实例。 CUSTOM：若指定的关系实体集合对应的关系实例引用此数据实例作为源端实例或目标端实例，创建后的数据实例将继承这些关系实例。 customLinkSet 否 List 关系实体名称的集合。 当“workCopyType”设置为“CUSTOM”时，需要设置此参数。 needSetNull 否 List 指定不复制的属性。被指定不复制的属性，其返回值将被设置为“null”。 view2 否 说明： 如果用户在应用设计态配置“多维版本”功能配置时，将此多维版本属性设置为必填，则请求参数为必填项。 Object 自定义的多维版本属性。 modifier 是 String 更新者。

响应示例 为篇幅起见，这里只展示部分内容。其中，"version": "A"表示多维视图的迭代版本。 { "result": "SUCCESS", "data": [ { "id": "523616294595981234", ...... "rdmVersion": 1, "rdmDeleteFlag": 0, "rdmExtensionType": "View2", "tenant": { ...... }, "className": "View2", "name": "AS", "description": null, "kiaguid": null, "securityLevel": "internal", "master": { ...... "rdmExtensionType": "View2Master", "tenant": { ...... }, "className": "View2Master" }, "branch": { ...... "rdmVersion": 1, "rdmDeleteFlag": 0, "rdmExtensionType": "View2Branch", "tenant": { ...... }, "className": "View2Branch", "version": "A" }, "latest": true, "latestIteration": true, "versionCode": 1, "iteration": 1, "version": "A", "latestVersion": true, "workingCopy": false, "workingState": { "code": "CHECKED_IN", "cnName": "已检入", "enName": "checked in", "alias": "CHECKED_IN" }, "checkOutUserName": null, "checkOutTime": null, "preVersionId": "52281****087179264", "viewAttr1": null, "viewAttr3": null, "viewAttr2": null } ], "errors": [] }

功能介绍 版本对象的创建视图接口（createView）和批量创建视图接口（batchCreateView）是根据M-V模型实体已有数据实例的versionId（version.唯一编码）并指定多版本属性进行创建。创建后该M-V模型实体会生成实例数据完全复制原数据实例现有信息，但“version.修订版本”和“branch.大版本”会从初始值重新开始计算的多维版本数据实例。 本章节以createView为例，如需调用batchCreateView，请前往全量数据服务查看。

请求示例 示例背景 已在设计态构建一个名称为“employee”的数据实体，该实体自定义了“age”和“sex”两个属性，并完成了实体发布、应用发布和应用部署。 已在运行态通过控制台或API的方式创建多个数据实例。 需要查询“sex”为“男性”的数据实例，且结果需要先按名称倒序排序，再按年龄倒序排序。 示例代码 { "params": { "sorts": [ { "sort": "DESC", "orderBy": "name" }, { "sort": "DESC", "orderBy": "age" } ], "filter": { "joiner": "and", "conditions": [ { "conditionName": "sex", "operator": "=", "conditionValues": [ "男" ] } ] }, "isNeedTotal": true } }

响应示例 { "result": "SUCCESS", "data": [ { "id": "455304645330341888", "creator": "test1 3c03e719256a427eb9277b64fcXXXXXX", "createTime": "2023-01-13T01:38:07.000+00:00", "modifier": "test1 3c03e719256a427eb9277b64fcXXXXXX", "lastUpdateTime": "2023-01-13T01:38:07.000+00:00", "rdmVersion": 1, "rdmExtensionType": "People", "rdmDeleteFlag": 0, "tenant": { "id": "-1", "clazz": "Tenant" }, "className": "People", "name": "李四", "description": null, "kiaguid": null, "securityLevel": "internal", "sex": "男", "age": 20 }, { "id": "455304534248394752", "creator": "test1 3c03e719256a427eb9277b64fcXXXXXX", "createTime": "2023-01-13T01:37:40.000+00:00", "modifier": "test1 3c03e719256a427eb9277b64fcXXXXXX", "lastUpdateTime": "2023-01-13T01:37:40.000+00:00", "rdmVersion": 1, "rdmExtensionType": "People", "rdmDeleteFlag": 0, "tenant": { "id": "-1", "clazz": "Tenant" }, "className": "People", "name": "张三", "description": null, "kiaguid": null, "securityLevel": "internal", "sex": "男", "age": 18 } ], "errors": [], "pageInfo": { "curPage": 1, "pageSize": 20, "totalRows": 2, "totalPages": 1 } }

请求参数 根据实体类型、功能的不同，请求body参数不同，您可以在全量数据服务查看API具体参数。为篇幅起见，这里只展示部分内容。 表2 请求body参数 参数 是否必填 参数类型 描述 sorts 否 List 排序。 sort 否 String 排序方式（asc/desc）。 orderBy 否 String 排序字段，可填写模型自身属性、参考对象的属性、扩展属性及分类属性。 filter 否 Object 查询条件。 isNeedTotal 否 Boolean 是否需要查询总记录数（false/true）。

URI URI格式： POST http://{Endpoint}/rdm_{appID}_app/services/dynamic/api/{entityName}/find/{pageSize}/{curPage} 参数说明： 表1 URI参数说明 参数 是否必填 参数类型 描述 Endpoint 是 String 承载REST服务端点的服务器域名或IP地址。 appID 是 String 应用ID。 entityName 是 String 实体的英文名称。 pageSize 否 String 分页查询时，每页最多展示的记录数。 curPage 否 String 分页查询的页数。

功能使用 表1 xDM-F功能使用 功能 描述 使用方式 基础数据服务 针对数据实体、关系实体、接口模型等自动生成数据服务，例如生成增、删、改、查、分页查询等原子接口，实现基础服务的调用。 控制台 API 文件服务 可以在数据实例中上传、下载多种格式文件，可满足文件管理的诉求。 控制台 API 安全受控 安全受控功能可以高安全、高可靠的管控数据访问权限及业务关键信息。 控制台 API 主版本服务 可以对数据对象进行检出、修订、检入操作，为M-V模型数据对象中master提供父类。 控制台 API 版本服务 可以为多版本对象提供M-V模型原子服务，用于业务对象追溯管理，提高追溯效率。 控制台 API 系统版本 可以通过版本号标识记录修改历史记录。 控制台 API 树形结构 可以指定全路径字段，为树形节点全路径绑定属性。 控制台 API 权限管理 可以根据自身业务需求，对数据或功能进行授权鉴权的开发。 控制台 API 业务编码生成器 业务编码生成器功能可以自定义规则，自动生成业务编码，为系统维护者提供便利。 控制台 API 文件夹管理 可创建多层级的文件夹结构，在创建数据实例时可指定所属文件夹，方便对数据进行分门别类。 控制台 API 分类管理 可以根据分类节点及分类属性快速检索对象，节约时间成本、提高查询效率和业务效率。 控制台 API 扩展属性 可以为数据对象添加扩展属性，用于租户的定制化扩展业务。 控制台 API 扩展类型 可以灵活定义对象的扩展类型，用于标识数据对象是否可被扩展。 控制台 API 生命周期管理 可以通过生命周期模板定义及管理，实现数据对象的全过程管理，以及对不同类型业务对象的过程追溯。 控制台 API 失效管理 可以灵活管理用户权限、业务属性（如零部件的损坏），便于用户识别。 控制台 API 所有者管理 可以通过所有者属性为数据对象授权。 控制台 API 标签管理 可以对已有数据对象从不同维度进行规划和分类管理。 控制台 API 多维视图&多维分支 可以通过不同视角（如设计、工艺、制造、服务等）对同一个数据对象（如BOM编码）进行差异化管理。 API 说明： xDM-F只能对M-V模型数据实体设置多维视图&多维分支能力，只支持通过API方式创建多维视图&多维分支数据实例。 数据分类管理 方便用户将同维度的数据实例进行分门别类管理、实例数据统一归集。 控制台 API 说明： 仅支持通过API方式将数据分类和数据分类对象进行关联。