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

步骤2：执行iDME原子接口

操作场景

创建事务型任务后，系统将根据原子接口执行序号依次执行原子接口。

本章节以创建“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-Task-Id

是

Long

事务型任务ID，即步骤1：创建事务型任务返回的transactionId。

X-Dme-Transaction-Task-No

是

Integer

当前原子接口的执行序号。
表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

异常信息列表。

请求示例

根据设置的原子接口执行序号，依次执行如下原子接口。

  • 原子接口1： 
    POST https://dme.cn-north-4.huaweicloud.com/rdm_fce01234567d41828cf3473b07fa7ae2_app/services/dynamic/api/ExtDataModel/create
X-Auth-Token: ABCDEFJ....
X-Dme-Transaction-Task-Id: 538322343718555649
X-Dme-Transaction-Task-No: 1
  • 原子接口2： 
    POST https://dme.cn-north-4.huaweicloud.com/rdm_fce01234567d41828cf3473b07fa7ae2_app/services/dynamic/api/ExtDataModel/create
X-Auth-Token: ABCDEFJ....
X-Dme-Transaction-Task-Id: 538322343718555649
X-Dme-Transaction-Task-No: 2

响应示例

原子接口1和原子接口2均返回如下结果：

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

相关文档