更新时间:2024-08-19 GMT+08:00
分享

比较M-V模型的版本对象

操作场景

应用设计态完成模型的构建、发布(模型发布和应用发布),以及控制台部署应用后,会在应用运行态自动生成相应的接口。本文介绍如何通过版本对象比较接口(compareBusinessVersion)实现比较不同版本对象间的基本属性、扩展属性和关联关系。

URI

  • URL格式:

    POST http://{Endpoint}/rdm_{appID}_app/publicservices/api/{entityName}/compareBusinessVersion

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

    参数

    是否必填

    参数类型

    描述

    Endpoint

    String

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

    appID

    String

    应用ID。

    entityName

    String

    实体的英文名称。

请求参数

表2 请求body参数

参数

是否必填

参数类型

描述

id

String

主对象ID,用于标识版本对象。

basicVersion

String

基础版本对象的版本号。

correlationVersion

String

待比较的版本对象的版本号

为篇幅起见,这里只展示部分内容。更多参数信息,您可以在全量数据服务进行查看。

响应参数

返回两个版本对象的对比结果。

请求示例

示例背景

您已在cn-north-4区域的TestApp应用中,构建一个名称为“TestMV”的M-V模型数据实体,并完成了实体发布、应用发布和应用部署。希望对主对象ID为“492060584863342592”的A.1版本和A.2版本进行比较。

示例代码

{
	"params":{
		"id":"492060584863342592",
		"basicVersion":"A.1",
		"correlationVersion":"A.2"
	}
}

响应示例

为篇幅起见,这里只展示部分内容。

{
    "result": "SUCCESS",
    "data": [
        {
           ......    //返回基础版本对象版本号A.1的所有内容
        },
        {
            ......    //返回待比较版本对象版本号A.2的基本属性的区别
            "relations": [
		......    //返回待比较版本对象版本号A.2的关联关系的区别(所有区别都是A.2与A.1对比后A.2的区别)。如需对比A.1的区别,传参时调换A.1和A.2的顺序,将A.2作为基础版本对象版本号,A.1作为待比较的版本对象的版本号即可。
            ],
            "extAttrs": {
                ......    //返回待比较版本对象版本号A.2的扩展属性的区别
            },
            "latest": true,
            "lastUpdateTime": "2023-04-27 14:35:56"
        }
    ],
    "errors": []
}

相关文档