更新部门角色员工
接口描述
此接口用于对已存在部门,设置部门角色。部门角色必须提前设置完成。
限制・前提条件
上长信息必须在员工主数据中存在
关于参数的开始日、
无值时、不进行履历管理、用角色编码作为主键、覆盖更新、同一部门同一角色的上长只能设置一人;
有值时、更新的主键为角色编码,上长番号,开始日的组合、同一部门同一角色的上长可以设置多人。
接口权限
本接口需要集团权限
请求URI
/api/openapi/department/roles
请求方式
PUT
请求体示例
{
"departmentCode": "3001",
"departmentRoles": [
{
"departmentRoleCode": "6101",
"employeeId": "EMP-001",
"fromDate":"2021-03-03",
"toDate":"2021-03-04",
"isDelete":false
},
{
"departmentRoleCode": "3002",
"employeeId": "EMP-002",
"fromDate":"2021-03-03",
"toDate":"2021-03-04",
"isDelete":false
}
]
}
请求体字段
参数名 | 类型 | 是否必填 | 主键 | 规则 | 说明 |
---|---|---|---|---|---|
departmentCode | String | 是 | ○ | 最大长度 36 | 部门编码 |
departmentRoles | DepartmentRole[] | 是 | 部门角色列表 |
DepartmentRole
参数名 | 类型 | 是否必填 | 主键 | 规则 | 说明 |
---|---|---|---|---|---|
departmentRoleCode | String | 是 | ○ | 最大长度20 | 部门角色编码。部门经理编码为6101 |
employeeId | String | 是 | ○ | 最大长度32 | 员工工号 |
fromDate | String | 否 | 日期格式:yyyy-MM-dd | 开始日。使用"isDelete"参数时,开始日必填 | |
toDate | String | 否 | 日期格式:yyyy-MM-dd | 结束日 | |
isDelete | Boolean | 否 | 是否删除 |
接口返回示例
成功
{
"message": "success",
"oid": "d1de43ba-7cd6-496b-b07b-e16a2a5da7b9",
"key": "TEC-1"
}
失败示例
{
"message": "部门不存在",
"errorCode": "6061002"
}
字段说明
字段名称 | 类型 | 说明 |
---|---|---|
message | String | 返回信息说明 |
errorCode | String | 返回错误码 |
oid | UUID | 部门OID |
key | String | 部门编码 |
错误代码
errorCode | message | 说明 |
---|---|---|
120001 | 当前操作需要租户权限 | |
120003 | 缺少必填项:{0} | |
120115 | 没有可用的部门角色 | |
120116 | 部门角色编码不能重复 | |
1202071 | 员工不存在:{0} | |
6013009 | 日期格式为:yyyy-MM-dd | |
6047054 | 无效的部门编码 | 在开始时点(空白时使用系统时间),该部门尚未存在时、更新失败并报错 |
61000014 | 角色员工不存在 | 员工主数据中、指定的上长不存在 |
120015 | 开始日期不能大于结束日期 |