1. 增加一条{relationship}关系类实例数据
增加一条关系类实例数据。
请求方式:POST
请求地址:/bosfoundationservice/{appKey}/prototype/edges/{relationship}增加一条{relationship}
1.1. 请求参数:
Headers:
参数名 | 类型 | 示例 | 是否必填 | 参数含义 |
---|---|---|---|---|
Authorization | string | c4570cb9ca324bc8ba7dd9d1967710ea | 是 | access_token |
PathParas:
参数名 | 类型 | 示例 | 是否必填 | 参数含义 |
---|---|---|---|---|
relationship | string | irSystemTag | 是 | 关系类名 |
SearchParas:
参数名 | 类型 | 示例 | 是否必填 | 参数含义 |
---|---|---|---|---|
transactionCode | string | 3MD2XzN70VkcvbXllg7x7V | 否 | 业务事务编码 |
Body:
application/json:
{
"from": "bosclass/key //左对象类/左对象实例key",
"to": "bosclass/key //右对象类/右对象类实例key",
"...": "..."
}
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} | 若关联关系已存在 |
200 | OBJECT_REQUIREDFIELD_EMPTY | XXX属性必填 | 当必填字段缺失时 |
1.5. 注意事项:
1、关系类指数据模型中配置的关系类。
2、检查传入的"from"、"to"两个key值在数据库里是否已存在。
3、根据{relationship}参数来判断数据类型,在body中不传递bosclass属性。
4、关系数据可带属性数据,属性检查以relationship定义为准。
5、检查relationship、from、to值均一致的关系实例是否存在,如已存在则不能新建数据,并作错误提示。
6、"from"和"to"不可相同。