1. 根据条件批量创建关联关系
根据映射条件批量创建关联关系实例
请求方式:POST
请求地址:/bosfoundationservice/{appKey}/prototype/edge-batch/by-mapping
1.1. 请求参数:
Headers:
参数名 | 类型 | 示例 | 是否必填 | 参数含义 |
---|---|---|---|---|
Authorization | string | c4570cb9ca324bc8ba7dd9d1967710ea | 是 | access_token |
PathParas:
参数名 | 类型 | 示例 | 是否必填 | 参数含义 |
---|---|---|---|---|
appKey | string | c6bc62b43a44476384dae30d55b4af2f | 是 | BOS应用key |
SearchParas:
参数名 | 类型 | 示例 | 是否必填 | 参数含义 |
---|---|---|---|---|
NULL | NULL | NULL | NULL | NULL |
Body:
application/json:
{
"updateType":"ignore", //左右对象已存在关联或与关联关系规则(1:N,N:1,1:1)冲突时的处理方式,ignore:忽略本次操作,不创建,默认方式;replace:删除原有关系,创建新关系
"relationship": { //关联关系定义
"bosclass": "relationshipClass", //关系类名称
"condition": [ //左右对象的映射规则
{
"from": "CONCAT(name,type)",//左对象字段
"to": "title", //右对象字段
"operator": "==", //比较运算符
"number":"false", //比较时将内容转化为数字后再比较
"logic":" " //条件连接,若只有一条查询条件则为空。值可为Or,And
}
]
},
"from": { //左对象定义
"bosclass": "leftEntityClass", //对象类名称
"condition": [ //过滤条件
{
"field":"name",//查询字段
"operator":"like",// 匹配规则 精确查询,模糊查询等等
"value":"zhao", //值
"number":"false", //比较时将内容转化为数字后再比较
"logic":" " //条件连接,若只有一条查询条件则为空。值可为Or,And。
}
]
},
"to": { //右对象定义
"bosclass": "rightEntityClass", //对象类名称
"condition": [ //过滤条件
{}
]
}
}
参数说明:
参数名 | 类型 | 示例 | 是否必填 | 参数含义 |
---|---|---|---|---|
updateType | string | NULL | 否 | 数据重复时的更新策略 |
relationship | object | NULL | 是 | 关系类定义及左右对象的映射关系 |
from | object | NULL | 是 | 左对象定义及过滤条件 |
to | object | NULL | 是 | 右对象定义及过滤条件 |
1.2. 正确返回:
Http Status Code:200
{
"code": "SUCCESS",
"message": "请求处理成功",
"data": [ //新建的关系key列表
"xxxxx",
"yyyyy"
]
}
1.3. 状态码:
状态码 | code | message | data | 原因 |
---|---|---|---|---|
200 | JSON_FORMAT_WRONG | Json格式错误 | NULL | 传入body格式错误 |
200 | BODY_PARAMETER_EMPTY | 接口Body参数{xxx}不可为空 | NULL | 传入Body不含relationship、from、to或者relationship、from、to为空 |
200 | OBJECT_REQUIREDFIELD_EMPTY | bosclass属性必填 | NULL | relationship、from、to中不含bosclass或者bosclass为空 |
200 | ENTITY_BOSCLASS_NOTFOUND | 实体类{entity}不存在 | NULL | from、to中的bosclass错误 |
200 | RELATIONSHIP_BOSCLASS_NOTFOUND | 关系类{relationship}不存在 | NULL | relationship中bosclass错误 |
200 | OBJECT_REQUIREDFIELD_EMPTY | {xx}属性必填 | NULL | relationship的condition中不含from、to或from、to为空 |
200 | OBJECT_FIELD_DATA_WRONG | {xx}属性数据错误 | NULL | relationship的condition中from、to属性不存在 |
1.4. 注意事项:
无