1. 分页获取模型变更构件明细
分页获取模型变更概要中变更构件的所有变更明细。
请求方式:GET
请求地址:/api/{databaseKey}/compares/changes/list? compareKey={compareKey}&pageNumber={pageNumber}&pageSize={pageSize} &filters={filter1,filter2,……}&filterBase={base}&attributes={xxx,yyy,zzz}
1.1. 请求参数
Headers:
参数名 | 类型 | 示例 | 是否必填 | 参数含义 |
---|---|---|---|---|
Authorization | string | c4570cb9ca324bc8ba7dd9d1967710ea | 是 | 操作的通关令牌 |
PathParas:
参数名 | 类型 | 示例 | 是否必填 | 参数含义 |
---|---|---|---|---|
databaseKey | string | test | 是 | 数据库key,必传 |
SearchParas:
参数名 | 类型 | 示例 | 是否必填 | 参数含义 |
---|---|---|---|---|
compareKey | string | NULL | 是 | 模型对比key |
pageNumber | int | NULL | 是 | 分页返回的页码,从0开始 |
pageSize | int | NULL | 是 | 分页返回每页最大条目,取值100~10000 |
filters | string | NULL | 否 | 筛选条件,可选;多个筛选条件之间用英文逗号连接 |
filterBase | string | NULL | 否 | 筛选模型,可选;取值old、new,默认old |
attributes | string | NULL | 否 | 需要返回的属性,可选;多个属性之间用英文逗号连接 |
Body
application/json:
NULL
参数说明
参数名 | 类型 | 示例 | 是否必填 | 参数含义 |
---|---|---|---|---|
NULL | NULL | NULL | NULL | NULL |
1.2. 正确返回
{
"message": "请求处理成功",
"code": "SUCCESS",
"data": {
"content": [
{
"old": {
"key": "M208081111_3",
"geoFilePath": "xxxxxxxxxxxxxxxxxxxx"
},
"new": {
"key": "M208081112_3",
"geoFilePath": "xxxxxxxxxxxxxxxxxxxx"
},
"type": "geometry"
},
{
"old": {
"key": "M208081111_4",
"attribute": {
"系统名称": "系统名称1"
}
},
"new": {
"key": "M208081112_4",
"attribute": {
"系统名称": "系统名称2"
}
},
"type": "attribute"
},
{
"old": {
"key": "M208081111_5",
"geoFilePath": "xxxxxxxxxxxxxxxxxxxx",
"attribute": {
"系统名称": "系统名称1"
}
},
"new": {
"key": "M208081112_5",
"geoFilePath": "xxxxxxxxxxxxxxxxxxxx",
"attribute": {
"系统名称": "系统名称2"
}
},
"type": "both"
}
],
"totalElements": 521, //总数量
"totalPages": 6, //总页数
"last": false, //是否最后一页
"number": 0, //当前页码
"size": 100, //每页最大数量
"first": true, //是否第一页
"numberOfElements": 100 //本页数量
}
}
1.3. 状态码
状态码 | code | message | data | 原因 |
---|---|---|---|---|
NULL | NULL | NULL | NULL | NULL |
1.4. 备注
暂无备注
1.5. 注意事项
1、分页返回模型对比结果中构件具体几何或属性差异。
2、不包括新增或删除的构件。
3、filters为可选参数,用于根据构件属性筛选变更构件,当filters参数指定时,仅返回符合过滤条件的构件变更明细。
4、多个筛选条件用英文逗号分隔,其中一个条件满足即可。
5、筛选条件以指定模型为基准,由属性名和属性值构成,采用英文冒号连接,格式如下: filter_attribute:filter_value filter_attribute:过滤条件-属性字段 filter_value:过滤条件-属性值(如不指定,代表不为空) 举例: type:墙 type属性值包含墙的构件 attribute.code attribute.code属性不为空的构件。
6、filterBase 指定filters筛选的模型,默认是旧版,当为new时,筛选新版。
7、attributes不指定或为空时,返回构件key以及有变更的属性;否则返回指定的属性。