@alanwang-merit/meritdata-platform-skill-package 1.0.10 → 1.0.12

package/skills/meritdata-dev-docs-file-finder/references/dev-docs/28_2.2/344/272/272/345/221/230/347/273/264/346/212/244-/344/270/213/345/215/212.md

@@ -1,585 +0,0 @@
----
-name: 人员维护-下半（2.2.9-2.2.14）
-source-file: 外部接口清单
-source-section: 2 组织机构 → 2.2 人员维护 → 2.2.9–2.2.14
-keywords: [工作组人员, 人员查询, 人员更新, 按角色编码, 人员列表, 部门人员]
-use-cases: [工作组人员管理, 按角色编码查询, 按机构查询, 人员更新]
-related: [27]
----
-
-# 人员维护-下半（2.2.9-2.2.14）
-
-> **原文章节**：外部接口清单 → 2 组织机构 → 2.2 人员维护 → 2.2.9–2.2.14
-> **行号范围**：L3893–L4449
-
-## 🎯 一句话
-人员维护的后 6 个高级查询与更新接口：按角色编码查询、按工作组查询、按多 ID 查询、按机构查询、按部门查询、人员更新。
-
-## 📋 接口清单
-
----
-
-### 2.2.9
-
-- **接口地址**：`/api/ou/emp/list-by-roleCode`
-- **请求类型**：`application/x-www form-urlencoded`
-- **请求方式**：`post`
-- **接口备注**：`根据角色编码获取人员`
-- **调试工具**：`ApiPost`
-
-**请求体参数说明：**
-
-| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
-|---|---|---|---|---|
-| code | 111 | String | 是 | 暂无描述 |
-
-**返回成功参数说明：**
-
-| 参数名 | 示例值 | 参数类型 | 参数描述 |
-|---|---|---|---|
-| timestamp | 1661223940714 | Number | 时间戳 |
-| status | 1 | Number | 状态 |
-| message | 成功 | String | 返回消息 |
-| stackmessage |  | Object | 堆栈消息 |
-| path | /api/ou/emp/list-by-roleCode | String | api 路径 |
-| data |  | Object | 返回数据 |
-| extraInfo | {} | Object | 拓展信息 |
-| success | true | String | 成功响应 |
-
-**返回失败参数说明：**
-
-| 参数名 | 示例值 | 参数类型 | 参数描述 |
-|---|---|---|---|
-| 201 | Object | Object | Created |
-| 401 | Object | Object | Unauthorized |
-| 403 | Object | Object | Forbidden |
-| 404 | Object | Object | Not Found |
-
-**返回成功示例**：
-
-```json
-{
-"timestamp": 1661223940714,
-"status": 1,
-"message": "成功",
-"stackmessage": null,
-"path": "/api/ou/emp/list-by-roleCode",
-"data":{
-"rows": [
-{
-"deptName": "dsd",
-"code": "sds",
-"roleCode": "111",
-"name": "sadasd",
-"deptId": "3f2883b2823d5f6c01823d6c7554000a",
-"roleName": "111",
-"id": "3d6887c59b5642899425ea21202287b8",
-"deptCode": "dsd"
-}
-```
-
-
-**返回失败示例**：
-
-```json
-{"201":{},"401":{},"403":{},"404":{}}
-```
-
----
-
-### 2.2.10 id 根据工作组获取人员信息
-
-- **接口地址**：`/api/ou/emp/list-by-workgroup`
-- **请求类型**：`application/x-www form-urlencoded`
-- **请求方式**：`post`
-- **接口备注**：`获取某个工作组的人员`
----
-
-### 获取某个工作组的人员
-
-- **接口备注**：`获取某个工作组的人员`
-- **调试工具**：`ApiPost`
-
-**请求体参数说明：**
-
-| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
-|---|---|---|---|---|
-| id | 3f2883b2823d5f6c 01823d77e5be001f | String | 是 | 暂无描述 |
-
-**返回成功参数说明：**
-
-| 参数名 | 示例值 | 参数类型 | 参数描述 |
-|---|---|---|---|
-| timestamp | 1661223996641 | Number | 时间戳 |
-| status | 1 | Number | 状态 |
-| message | 成功 | String | 返回消息 |
-
-**返回失败参数说明：**
-
-| 参数名 | 示例值 | 参数类型 | 参数描述 |
-|---|---|---|---|
-| 201 | Object | Object | Created |
-| 401 | Object | Object | Unauthorized |
-
-**返回成功示例**：
-
-```json
-{
-"timestamp": 1661223996641,
-"status": 1,
-"message": "成功",
-"stackmessage": null,
-"path": "/api/ou/emp/list-by-workgroup",
-"data":{
-"rows": [
-{
-"deptName": "dsd",
-"code": "sds",
-"workgroupCode": "111",
-"name": "sadasd",
-"deptId": "3f2883b2823d5f6c01823d6c7554000a",
-"workgroupName": "111",
-"id": "3d6887c59b5642899425ea21202287b8",
-"deptCode": "dsd"
-}
-```
-
-
-**返回失败示例**：
-
-```json
-{"201":{},"401":{},"403":{},"404":{}}
-```
-
----
-
-### 2.2.11 id 根据人员查询人员列表
-
-- **接口地址**：`/api/ou/emp/list-in-id`
-- **请求类型**：`multipart/form-data`
-- **请求方式**：`post`
-- **接口备注**：`根据多个人员id 查询人员列表`
----
-
-### 根据多个人员查询人员列表
-
-- **接口备注**：`根据多个人员id 查询人员列表`
-- **调试工具**：`ApiPost`
-
-**URI 参数说明：**
-
-| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
-|---|---|---|---|---|
-| ids | Array | Array | 否 | 人员 id |
-
-**请求体参数说明：**
-
-| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
-|---|---|---|---|---|
-| ids | 52b421b7c8a145a6 ab9d32f0255ab9d2 | String | 是 | 暂无描述 |
-
-**返回成功参数说明：**
-
-| 参数名 | 示例值 | 参数类型 | 参数描述 |
-|---|---|---|---|
-| timestamp | 1661224079772 | String | 时间戳 |
-| status | 1 | Integer | 状态 |
-| message | 成功 | String | 返回消息 |
-| stackmessage |  | String | 堆栈消息 |
-| path | /api/ou/emp/list-in-id | String | api 路径 |
-| data |  | Array | 返回数据 |
-| extraInfo | {} | Object | 拓展信息 |
-| success | true | Boolean | 成功响应 |
-
-**返回失败参数说明：**
-
-| 参数名 | 示例值 | 参数类型 | 参数描述 |
-|---|---|---|---|
-| 201 | Object | Object | Created |
-
-**返回成功示例**：
-
-```json
-{
-"timestamp": 1661224079772,
-"status": 1,
-"message": "成功",
-页97/276
-"stackmessage": null,
-"path": "/api/ou/emp/list-in-id",
-"data": [
-{
-"tenantId": "",
-"secretCode": null,
-"secretName": null,
-"createTime": null,
-"updateTime": 1661224079772,
-"creatorId": null,
-"reviserId": null,
-"id": "52b421b7c8a145a6ab9d32f0255ab9d2",
-"name": "weijiahui",
-"code": "wjh",
-"sex": null,
-"birthday": null,
-"folk": "汉族",
-"education": null,
-"handset": null,
-"familyPhone": null,
-"email": null,
-"sortNo":3,
-"systemUser": 1,
-"deptId": "3f2883b2821950330182199cb96e0047",
-"deptCode": "merit",
-"deptName": "美林数据",
-"userId": "52b421b7c8a145a6ab9d32f0255ab9d2",
-"userState": "1",
-"weixinNo": null,
-"province": null,
-"city": null,
-"county": null,
-"grade": null,
-"workgroupName": null,
-"workgroupId": null,
-"postName": null,
-"postId": null,
-"postFlag": null,
-"roleId": null,
-"ipAddress": null,
-"macAddress": null,
-"gradeName": null,
-"manageDeptName": null,
-"manageDeptId": null,
-"empCategorys":{},
-页98/276
-"cateCodes": null,
-"userName": null,
-"detptype": null,
-"roleName": null,
-"did": null,
-"isSubDsAdmin": null,
-"isCGSysadmin": null,
-"authStatus": null,
-"parentsOrgs":{},
-"resultName": null,
-"cycleDeptName": null,
-"userType": null,
-"d": null,
-"addTime": null,
-"lastTime": null,
-"e": null,
-"f": null,
-"g": null,
-"h": null,
-"i": null,
-"j": null,
-"k": null,
-"l": null,
-"m": null,
-"n": null,
-"o": null,
-"p": null,
-"q": null,
-"r": null,
-"s": null,
-"t": null,
-"u": null,
-"v": null,
-"w": null,
-"x": null,
-"y": null,
-"z": null
-},
-],
-"extraInfo":{},
-"success":true
-}
-```
-
-
-**返回失败示例**：
-
-```json
-{"201":{},"401":{},"403":{},"404":{}}
-```
-
----
-
-### 2.2.12 获取机构下人员信息
-
-- **接口地址**：`/api/ou/emp/listEmp`
-- **请求类型**：`application/x-www form-urlencoded`
-- **请求方式**：`post`
-- **接口备注**：`获取某个机构部门下的人员，也可递归查询`
----
-
-### 获取某个机构部门下的人员，也可递归查询
-
-- **接口备注**：`获取某个机构部门下的人员，也可递归查询`
-- **调试工具**：`ApiPost`
-
-**请求体参数说明：**
-
-| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
-|---|---|---|---|---|
-| id | 3f2883b282195033 018219a0be6b004 e | String | 是 | 暂无描述 |
-
-**返回成功参数说明：**
-
-| 参数名 | 示例值 | 参数类型 | 参数描述 |
-|---|---|---|---|
-| timestamp | 1661224242645 | Number | 时间戳 |
-| status | 1 | Number | 状态 |
-| message | 成功 | String | 返回消息 |
-| stackmessage |  | Object | 堆栈消息 |
-| path | /api/ou/emp/listEmp | String | api 路径 |
-| data |  | Object | 返回数据 |
-| extraInfo | {} | Object | 拓展信息 |
-| success | true | String | 成功响应 |
-
-**返回失败参数说明：**
-
-| 参数名 | 示例值 | 参数类型 | 参数描述 |
-|---|---|---|---|
-| 201 | Object | Object | Created |
-| 401 | Object | Object | Unauthorized |
-| 403 | Object | Object | Forbidden |
-| 404 | Object | Object | Not Found |
-
-**返回成功示例**：
-
-```json
-{
-"timestamp": 1661224242645,
-"status": 1,
-"message": "成功",
-"stackmessage": null,
-"path": "/api/ou/emp/listEmp",
-"data":{
-"rows": [
-{
-"deptName": "11",
-"code": "zhangyan2",
-"simpleName": "11",
-"name": "张彦 2",
-"deptId":
-"3f2883b282195033018219a0be6b004e",
-"secretCode": null,
-"id": "602b31e6555d43e6aacc109a2ec464d8",
-"deptCode": "11"
-}
-```
-
-
-**返回失败示例**：
-
-```json
-{"201":{},"401":{},"403":{},"404":{}}
-```
-
----
-
-### 2.2.13 id
-
-- **接口地址**：`/api/ou/emp/listEmpBydeptId`
-- **请求类型**：`multipart/form-data`
-- **请求方式**：`post`
-- **接口备注**：`根据部门id 获取部门人员`
----
-
-### 根据部门获取部门人员
-
-- **接口备注**：`根据部门id 获取部门人员`
-- **调试工具**：`ApiPost`
-
-**请求体参数说明：**
-
-| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
-|---|---|---|---|---|
-| id | 3f2883b2823d5f6c 01823d6c7554000a | String | 是 | 暂无描述 |
-
-**返回失败参数说明：**
-
-| 参数名 | 示例值 | 参数类型 | 参数描述 |
-|---|---|---|---|
-
-**返回成功示例**：
-
-```json
-[
-{
-"tenantId": "",
-"secretCode": null,
-"secretName": null,
-"createTime": null,
-"updateTime": 1661224669785,
-"creatorId": null,
-"reviserId": null,
-"id": "3d6887c59b5642899425ea21202287b8",
-"name": "sadasd",
-"code": "sds",
-"sex": null,
-"birthday": null,
-"folk": null,
-"education": null,
-"handset": null,
-"familyPhone": null,
-"email": null,
-"sortNo": null,
-"systemUser": 1,
-"deptId": "3f2883b2823d5f6c01823d6c7554000a",
-"deptCode": null,
-"deptName": null,
-"userId": "3d6887c59b5642899425ea21202287b8",
-"userState": null,
-"weixinNo": null,
-"province": null,
-"city": null,
-"county": null,
-"grade": null,
-"workgroupName": null,
-"workgroupId": null,
-"postName": null,
-"postId": null,
-"postFlag": null,
-"roleId": null,
-"ipAddress": null,
-"macAddress": null,
-页 102/276
-"gradeName": null,
-"manageDeptName": null,
-"manageDeptId": null,
-"empCategorys":{},
-"cateCodes": null,
-"userName": null,
-"detptype": null,
-"roleName": null,
-"did": null,
-"isSubDsAdmin": null,
-"isCGSysadmin": null,
-"authStatus": null,
-"parentsOrgs":{},
-"resultName": null,
-"cycleDeptName": null,
-"userType": null,
-"d": null,
-"addTime": null,
-"lastTime": null,
-"e": null,
-"f": null,
-"g": null,
-"h": null,
-"i": null,
-"j": null,
-"k": null,
-"l": null,
-"m": null,
-"n": null,
-"o": null,
-"p": null,
-"q": null,
-"r": null,
-"s": null,
-"t": null,
-"u": null,
-"v": null,
-"w": null,
-"x": null,
-"y": null,
-"z": null
-}
-```
-
-
-**返回失败示例**：
-
-```json
-{"201":{},"401":{},"403":{},"404":{}}
-```
-
----
-
-### 2.2.14
-
-- **接口地址**：`/api/ou/emp/update1`
-- **请求类型**：`multipart/form-data`
-- **请求方式**：`post`
-- **接口备注**：`人员更新接口`
----
-
-### 人员更新接口
-
-- **接口备注**：`人员更新接口`
-- **调试工具**：`ApiPost`
-
-**请求体参数说明：**
-
-| 参数名 | 示例值 |  |  |  | 是否必填 | 参数描述 |
-|---|---|---|---|---|---|---|
-|  |  |  | 参数类型 |  |  |  |
-| name | 张彦2 | String |  |  | 是 | 暂无描述 |
-| id | 602b31e6555d43e 6aacc109a2ec464d 8 | String |  |  | 是 | 暂无描述 |
-| code | zhangyans | String |  |  | 是 | 暂无描述 |
-| userState | 1 | String |  |  | 是 | 暂无描述 |
-| userId | 602b31e6555d43e 6aacc109a2ec464d 8 | String |  |  | 是 | 暂无描述 |
-| deptId | 3f2883b282195033 018219a0be6b004 e | String |  |  | 是 | 暂无描述 |
-| updateTime | 1661224402299 | String |  |  | 是 | 暂无描述 |
-| deptName | 11 | String |  |  | 是 | 暂无描述 |
-| deptCode | 11 | String |  |  | 是 | 暂无描述 |
-| systemUser | 1 | String |  |  | 是 | 暂无描述 |
-| sortNo | 1 | String |  |  | 是 | 暂无描述 |
-| roleName | 普通用户,系统管 理员,调度编排管 理员 | String |  |  | 是 | 暂无描述 |
-
-**返回成功参数说明：**
-
-| 参数名 | 示例值 | 参数类型 | 参数描述 |
-|---|---|---|---|
-| timestamp | 1661224589814 | String | 时间戳 |
-| status | 1 | Integer | 状态 |
-| message | 成功 | String | 返回消息 |
-| stackmessage |  | String | 堆栈消息 |
-| path | /api/ou/emp/update1 | String | api 路径 |
-| data | true | Object | 返回数据 |
-| extraInfo | {} | Object | 拓展信息 |
-| success | true | Boolean | 成功响应 |
-
-**返回失败参数说明：**
-
-| 参数名 | 示例值 | 参数类型 | 参数描述 |
-|---|---|---|---|
-| 201 | Object | Object | Created |
-| 401 | Object | Object | Unauthorized |
-| 403 | Object | Object | Forbidden |
-| 404 | Object | Object | Not Found |
-
-**返回成功示例**：
-
-```json
-{
-"timestamp": 1661224589814,
-"status": 1,
-"message": "成功",
-"stackmessage": null,
-"path": "/api/ou/emp/update1",
-"data":true,
-"extraInfo":{},
-"success":true
-}
-```
-
-
-**返回失败示例**：
-
-```json
-{"201":{},"401":{},"403":{},"404":{}}
-```
-
----
-
-## 💡 使用建议
-- 2.2.9 `list-by-roleCode` 与 2.2.8 `list-by-role` 区别：前者按 `code`（业务编码），后者按 `id`（平台主键）
-- 2.2.10 `list-by-workgroup` 工作组是 **跨部门虚拟组织**（如"项目组"），与 2.2.12 `listEmp`（按机构）形成互补
-- 2.2.12 `listEmp` 支持 **递归查询**（默认），如果不需要递归需要查文档确认是否传 `recursive=0`
-- 2.2.14 `update1` 的 `roleName` 字段是 **冗余字段**（来自关联查询结果），不要用于更新角色分配
-
-## 🔗 相关章节
-- [27_2.2人员维护-上半](./27_2.2人员维护-上半.md)