1. 批量增加关系实例数据
批量增加关系类实例数据。
请求方式:POST
请求地址:/bosfoundationservice/{appKey}/prototype/egde-batch
1.1. 请求参数:
Headers:
参数名 | 类型 | 示例 | 是否必填 | 参数含义 |
---|---|---|---|---|
Authorization | string | c4570cb9ca324bc8ba7dd9d1967710ea | 是 | access_token |
PathParas:
参数名 | 类型 | 示例 | 是否必填 | 参数含义 |
---|---|---|---|---|
NULL | NULL | NULL | NULL | NULL |
SearchParas:
参数名 | 类型 | 示例 | 是否必填 | 参数含义 |
---|---|---|---|---|
transactionCode | string | 3MD2XzN70VkcvbXllg7x7V | 否 | 业务事务编码 |
Body:
application/json:
[
{
"bosclass": "xxx",
"from": "bosclass/key",
"to": "bosclass/key",
"xxxx": "xxxx"
......
}
]
1.2. 参数说明:
参数名 | 类型 | 示例 | 是否必填 | 参数含义 |
---|---|---|---|---|
NULL | NULL | NULL | NULL | NULL |
1.3. 正确返回:
Http Status Code:200
[
{
"code": "SUCCESS",
"message": "请求处理成功",
"data": "http://xxx.xxx.xxx/bosfoundationservice/h5e4ff8257dc4e86a8042097f67d2718/prototype/edges/irFolderDocument/by-key/xxxx"
}
]
1.4. 状态码:
状态码 | code | message | 原因 |
---|---|---|---|
200 | RELATIONSHIP_RELATIONENTITY_PERMISSION_INSUFFICIENT | 缺少对关联实体对象{bosclass/key}的读权限 | 如果对from、to对应的关联实体对象无读权限时 |
200 | BOSCLASS_NA | 不适用于{bosclass}类型实例数据 | 当对entity类型操作时 |
200 | JSON_FORMAT_WRONG | Json格式错误 | 当传入Body格式错误时 |
200 | RELATIONSHIP_BOSCLASS_NOTFOUND | 关系类{bosclass}不存在 | 当传入relationship错误时 |
200 | ENTITYKEY_FORMAT_WRONG | 实体对象{bosclass/key}格式错误 | 当传入body的from/to参数格式错误时 |
200 | RELATIONSHIP_RELATIONENTITY_SAME | 左右关联对象{bosclass/key}相同 | 若from,to数据相同 |
200 | RELATIONSHIP_RELATIONENTITY_DATATYPE_WRONG | 关联左/右对象{bosclass/key}数据类型错误 | 若from或to数据类型错误 |
200 | ENTITY_BOSCLASS_NOTFOUND | 实体类{bosclass}不存在 | 若from或to所在的类没有定义 |
200 | ENTITY_NOTFOUND | Key为{key}的{bosclass}实体对象不存在 | 若from或to数据不存在 |
200 | RELATIONSHIP_EXIST | 已存在左对象为{bosclass/key}、右对象为{bosclass/key}的关系对象 | 若关联关系已存在 |
200 | OBJECT_REQUIREDFIELD_EMPTY | XXX属性必填 | 当必填字段缺失时 |
200 | OBJECT_FIELD_DATATYPE_WRONG | XXX属性数据类型错误 | 当字段数据类型错误 |
200 | ENTITYKEY_FORMAT_WRONG | 实体对象{bosclass/key}格式错误 | 部分创建数据失败时,则返回成功信息及失败数据错误信息 |
200 | CLASS_READPERMISSION_REQUIRED | 缺少实体类{bosclass}的读权限 | 当关联实体启用了类权限,但当前用户没有类的读权限时 |
1.5. 注意事项:
1、关系类指数据模型中配置的关系类。
2、检查传入的"from"、"to"两个key值在数据库里是否已存在。
3、根据body中bosclass参数来判断数据类型。
4、关系数据可带属性数据,属性检查以bosclass定义为准。
5、检查bosclass、from、to值均一致的关系实例是否存在,如已存在则不能新建数据,并作错误提示。
6、"from"和"to"不可相同。
1.6. 请求示例
请求URL
http://bosgw.bimwinner.com/bosfoundationservice/{appKey}/prototype/egde-batch
Headers
Authorization: eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyS2V5IjoiMTUyN2ZmYWRhZjhhNGY0YWJhZTk4NWM2N2JiZDQ5NmQiLCJ1c2VyTmFtZSI6InJhb2ppYWp1biIsInVzZXJUeXBlIjoiMCIsImFwcEtleSI6InE4NWU4NTdhZWIwODQ1ZjE5YzBkY2QyYTQyNmUxMWUwIiwiYXBwTmFtZSI6InRlc3QxMTExMTEyMyIsImFwcERiIjoicTg1ZTg1N2FlYjA4NDVmMTljMGRjZDJhNDI2ZTExZTAiLCJsb2dpblRpbWUiOiIxNTk2Njk4MDAyMTA3IiwiZXhwIjowfQ.XsKFdpYnnH1lJ__u6x-4tvCnJ2BX7WfJ5EMGMAWfCe8
Body(application/json)
[
{
"bosclass": "uirtest2",
"from": "uotest/d14255f5af0046e1970a2505b024f474",
"to": "uo1111/77412deb8497445e8416f1451d150af4"
}
]
正常响应 200
[
{
"message": "请求处理成功",
"code": "SUCCESS",
"data": "http://bosgw.bimwinner.com/bosfoundationservice/q85e857aeb0845f19c0dcd2a426e11e0/prototype/edges/uirtest2/by-key/428b6a24cfbc4d8199b1cd640181ad0e"
}
]