新增/更新
- 接口：/usergroup/save
- Method：POST
- 数据格式：JSON
请求参数
| 参数 |
类型 |
必须 |
默认值 |
主键 |
描述 |
| name |
string |
Y |
|
|
用户组名称 |
| businessCode |
string |
Y |
|
Y |
用户组编码(已存在则更新) |
| subUserGroups |
List<SubUserGroup> |
N |
|
|
子分组信息 |
| defaultSubUserGroup |
SubUserGroup |
N |
|
|
默认子分组信息，不填则默认生成一个不含成员的子分组,默认用户组不支持名称的修改 |
SubUserGroup结构
| 参数 |
类型 |
必须 |
默认值 |
主键 |
描述 |
| name |
string |
Y |
|
|
子分组名称 |
| businessCode |
string |
Y |
|
Y |
子分组编码，同一个用户组下的子用户组编码不能重复(已存在则更新) |
| assigneeEmployeeIds |
List<String> |
Y |
|
|
子分组成员工号(默认子分组可为空) |
| condition |
Condition |
N |
|
|
子分组职责范围条件(默认子分组无法配置职责条件) |
Condition结构
| 参数 |
类型 |
必须 |
默认值 |
主键 |
描述 |
| departmentBusinessCodes |
List<String> |
N |
|
|
部门编码列表，本级部门及所有下级部门生效 |
| subsidiaryBusinessCodes |
List<String> |
N |
|
|
业务实体编码列表 |
| costTrackingItemBusinessCodes |
List<String> |
N |
|
|
辅助核算选项编码列表 |
| currentDepartmentBusinessCodes |
List<String> |
N |
|
|
部门编码列表，仅本级部门生效 |
说明
- 该接口支持批量，但是批量保存响应较慢，所以不建议批量
- 该接口根据用户组的businessCode确定唯一的一条用户组数据，如果businessCode已存在则更新已有数据，不存在则新增
- 该接口根据子分组的businessCode确定唯一的一条子分组数据，如果businessCode已存在则更新已有数据，不存在则新增
示例
请求数据
{
"data": [{
"name": "用户组",
"businessCode": "1234",
"subUserGroups": [{
"name": "子分组",
"businessCode": "1234",
"assigneeEmployeeIds": ["k3", "k2"],
"condition": {
"departmentBusinessCodes": ["DP1609011KGFHYIO", "DP1609081G44ZU9S"],
"subsidiaryBusinessCodes": ["SU1609011JM6O0SG", "SU1706031IF92ARK"],
"costTrackingItemBusinessCodes": ["CTI1609091F38XZWG", "CTI160912Z9V0OOW"]
}
}],
"defaultSubUserGroup": {
"businessCode": "1234",
"assigneeEmployeeIds": ["k3", "k2"]
}
}]
}
返回数据(成功)
{
"code": "ACK",
"message": "保存成功",
"data": null,
"args": null,
"linkDetail": false,
"nonBizError": false
}
返回数据(失败)
{
"code": "NACK",
"message": "用户组名称和编码不能为空",
"data": null,
"args": null,
"linkDetail": false,
"nonBizError": false
}