文档首页/ 工业数字模型驱动引擎/ 最佳实践/ 通过事务型任务API实现事务一致性/ 执行iDME原子接口
更新时间：2025-04-21 GMT+08:00
查看PDF
分享

执行iDME原子接口

操作场景

根据实际业务需求，按顺序调用一个或多个iDME原子接口，并为每个操作绑定唯一的事务ID，以确保所有相关操作都在一个完整的事务中执行。本章节将通过创建“ExtDataModel”数据实体的具体数据实例来演示如何使用这些原子接口，帮助用户掌握其操作流程和方法。

前提条件

已开启事务。

URI

  • URI格式：

    POST http://{Endpoint}/rdm_{appID}_app/services/dynamic/api/{entityName}/{atomicAPI}

  • 参数说明：
    表1 URI参数说明

    参数

    是否必填

    参数类型

    描述

    Endpoint

    是

    String

    承载REST服务端点的服务器域名或IP地址。

    appID

    是

    String

    应用ID。

    entityName

    是

    String

    实体的英文名称。

    atomicAPI

    是

    String

    实体的原子接口，例如create。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

用户的token。

X-Dme-Transaction-Version

是

String

v3版本的事务请求，只能设置为3。

X-Dme-Transaction-Id

是

String

事务ID，即开启事务返回的transaction_id。
表3 请求Body参数

参数

是否必选

参数类型

描述

id

是

String

唯一编码。

rdmVersion

是

Int

系统版本。

rdmExtensionType

否

String

实体类型。

createTime

否

Date

创建时间。

creator

否

String

创建者。

lastUpdateTime

否

Date

最后更新时间。

modifier

否

String

更新者。

tenant

否

Object

租户。

根据实体类型、功能的不同，请求Body参数不同，您可以在全量数据服务查看实体对应API的具体参数。

响应参数

表4 响应Body参数

参数

参数类型

描述

result

String

调用是否成功。

  • SUCCESS：成功
  • FAIL：失败

data

List

调用的返回结果，默认为空。

errors

List

异常信息列表。

请求示例

POST https://dme.cn-north-4.huaweicloud.com/rdm_fce01234567d41828cf3473b07fa7ae2_app/services/dynamic/api/ExtDataModel/create
X-Auth-Token: ABCDEFG....
X-Dme-Transaction-Version: 3
X-Dme-Transaction-Id: 538322343718555649

响应示例

{
    "result": "SUCCESS",
    "data": [],
    "errors": []
}

相关文档