### 数据说明 ``` 1.对象数据,即类型定义的实例,表示现实世界中的一个具体的物体,比如一个具体的房间,一个具体的空调 2. ``` ### 数据结构 | 字段 | 数据类型 | 查询字段 | 说明 | | -------------- | -------------- | -------- | -------------------------- | | id | String | Y | id,全局唯一 | | name | String | Y | | | localId | String | Y | | | localName | String | Y | | | projectId | String | Y | | | classCode | String | Y | | | objType | String | Y | | | valid | Integer | Y | | | createTime | Date | Y | | | createApp | String | | | | updateTime | Date | Y | | | updateApp | String | | | | 其他信息点编码 | 根据信息点定义 | Y | 参数不当会严重影响查询性能 | | | | | | ### 创建对象 接口说明 ``` 1.集团编码,项目id,appId,userId不可为空 2. 3.该接口为批量接口,任一对象创建失败则全部失败 ``` 请求方式 ``` POST /rwd/instance/object/create ``` 路径参数说明 | 字段 | 数据类型 | 说明 | | --------- | -------- | ------------------ | | groupCode | String | 集团编码, 不可为空 | | schemeId | String | 方案 id | | projectId | String | 项目 id, 不可为空 | | appId | String | 应用 id, 不可为空 | | userId | String | 用户 id, 不可为空 | 请求体 ``` [ { "id": "对象id, 调用方传入,若为空则生成默认id", "classCode": "类型编码,不可为空", "信息点编码": "信息点值" } ] ``` 返回数据 ``` { "result": "success" } ``` ### 更新对象 接口说明 ``` 1.集团编码,项目id,appId,userId不可为空 2. 3.该接口为批量接口,任一对象更新失败则全部失败 4.classCode不可修改 ``` 请求方式 ``` POST /rwd/instance/object/update ``` 路径参数说明 | 字段 | 数据类型 | 说明 | | --------- | -------- | ------------------ | | groupCode | String | 集团编码, 不可为空 | | schemeId | String | 方案 id | | projectId | String | 项目 id, 不可为空 | | appId | String | 应用 id, 不可为空 | | userId | String | 用户 id, 不可为空 | 请求体 ``` [ { "id": "对象id, 调用方传入,若为空则生成默认id,目前默认id为uuid", "信息点编码": "信息点值", "$remove": [ "要清除的信息点编码" ] } ] ``` 返回数据 ``` { "result": "success" } ``` ### 删除对象 接口说明 ``` 1.集团编码,项目id,appId,userId不可为空 2. 3.该接口为批量接口 4.对象删除后与该对象相关的关系数据也会被删除(异步,未实现) ``` 请求方式 ``` POST /rwd/instance/object/delete ``` 路径参数说明 | 字段 | 数据类型 | 说明 | | --------- | -------- | ------------------ | | groupCode | String | 集团编码, 不可为空 | | schemeId | String | 方案 id | | projectId | String | 项目 id, 不可为空 | | appId | String | 应用 id, 不可为空 | | userId | String | 用户 id, 不可为空 | 请求体 ``` [ "id1", "id2", "id3" ] ``` 返回数据 ``` { "result": "success" } ``` ### 查询对象 请求方式 ``` POST /rwd/instance/object/query ``` 路径参数说明 | 字段 | 数据类型 | 说明 | | --------- | -------- | ------------------ | | groupCode | String | 集团编码, 不可为空 | | schemeId | String | 方案 id | | projectId | String | 项目 id, 不可为空 | | appId | String | 应用 id | 请求体 ``` { "criteria":{ "localId": [ "ATAH-20", "ATAH-21" ], "classCode": "ACATAH", "relationFrom": { "graphId": "", "graphCode": "", "relCode": "", "objTo": "" }, "relationTo": { "graphId": "", "graphCode": "", "relCode": "", "objFrom": "" }, }, "withColumns": [ "信息点1", "信息点2" ] } ``` 请求参数说明 ``` 1.relationFrom和relationTo表示查询存在参数对应的关系数据的对象 ``` 返回数据 ``` { "result": "success", "count": 4, "data": [ { "id": "Eq1101050029022eb5d30eff4d33b42f246874650da8", "classCode": "ACATAH", "projectId": "Pj1101050029", "grouping": 1, "objType": "equipment", "valid": 1, "name": "设备-UYLQY", "localId": "ATAH-20", "localName": "吊顶式空气处理机组-F3公共通道-36", "createTime": 1601511294000, "createApp": "datautils", "updateTime": 1602384680000, "virtualInfoCodes": [] } ] } ```