1. 批量删除{entity}对象类实例数据
批量删除数据。
请求方式:DELETE
请求地址:/bosfoundationservice/{appKey}/prototype/entity-batch/{entity}?delRelation={delRelation}
1.1. 请求参数:
Headers:
参数名 | 类型 | 示例 | 是否必填 | 参数含义 |
---|---|---|---|---|
Authorization | string | c4570cb9ca324bc8ba7dd9d1967710ea | 是 | access_token |
PathParas:
参数名 | 类型 | 示例 | 是否必填 | 参数含义 |
---|---|---|---|---|
entity | string | folders | 是 | 对象类类名 |
SearchParas:
参数名 | 类型 | 示例 | 是否必填 | 参数含义 |
---|---|---|---|---|
delRelation | boolean | true/false | 是 | true表示删除所有关系;false表示不删除任何关系 |
transactionCode | string | 3MD2XzN70VkcvbXllg7x7V | 否 | 业务事务编码 |
Body:
application/json:
[
"xxx # 要删除的对象 key",
"xxx"
]
1.2. 参数说明:
参数名 | 类型 | 示例 | 是否必填 | 参数含义 |
---|---|---|---|---|
key | string | FLD-02 | 是 | 对象类Key(直接填写值即可,无需填写参数名) |
1.3. 正确返回:
(Http Status Code:200)
[
{
"code": "SUCCESS",
"message": "请求处理成功",
"data": "{key}"
}, //data为被删除对象的key
{
"code": "SUCCESS",
"message": "请求处理成功",
"data": "{key}"
} //data为被删除对象的key
]
1.4. 状态码:
状态码 | code | message | data | 原因 |
---|---|---|---|---|
200 | ENTITY_NOTFOUND | 为{key}的{entity}实体对象不存在 | NULL | 当{key}的xxxx不存在时 |
200 | ENTITY_DELETEPERMISSION_REQUIRED | 缺少实体对象{entity/key}的删除权限 | NULL | 当对实体对象无删除权限时 |
200 | ENTITY_RELATIONSHIP_EXIST | 实体对象{entity/key}存在关联关系 | NULL | 当delRelation值为false,且{key}的对象还存在关联关系时 |
200 | RELATIONSHIP_RELATIONENTITY_PERMISSION_INSUFFICIENT | 缺少对关联实体对象{bosclass/key}的读权限 | NULL | 当删除关系时如果对关系中另一关联实体对象无读权限 |
200 | JSON_FORMAT_WRONG | Json格式错误 | NULL | 当传入Body格式错误时 |
200 | ENTITY_BOSCLASS_NOTFOUND | 实体类{entity}不存在 | NULL | 当传入entity错误时 |
200 | BOSCLASS_NA | 不适用于{entity}类型实例数据 | NULL | 当对relationship、users或其子孙类操作时 |
200 | ENTITY_NOTFOUND | Key为{key}的{entity}实体对象不存在 | NULL | 部分数据删除失败时,返回成功和失败错误信息 |
200 | CLASS_DELETEPERMISSION_REQUIRED | 缺少实体类{bosclass}的删除权限 | NULL | 当实体启用了类权限,但当前用户没有类的删除权限时 |
1.5. 注意事项:
1、delRelation值为true时,删除实例数据时需先删除与此实例对象关联的所有关系。
2、delRelation如若未传默认值为false,如若参数值非法按默认值为false处理。
3、传入的key须为同一基类,但可为不同子类的key。
4、支持删除同一基类,不同子类的数据。
5、不可操作users及其子孙类实体对象 。
6、当实体类启用了类权限时,需要当前用户对该实体类拥删除权限。