
# 根据ID更新人员信息（API名称：person/update）
#### 功能介绍
根据ID更新人员信息。
#### 相关接口
| **接口名称**                                                             | **调用说明**                                                     |
|:---|:---|
| [获取Token](https://support.huaweicloud.com/api-isdp/api_01_0019.html) | 调用该接口获取到Token，再调用其他接口时，需要在请求消息头中添加"Authorization"，其值即为Token。 |
   
#### URL
| **请求方式** | **HTTPS地址**                                    | **服务架构** | **消息体类型**        |
|:---|:---|:---|:---|
| POST     | https://***isdp+域名***/openapi/v1/person/update | OpenAPI  | application/json |
   
#### 请求头
| **KEY**       | **VALUE**              | **是否必填** | **描述**                                                                                           |
|:---|:---|:---|:---|
| Content-Type  | application/json       | 是        | 无                                                                                                |
| Authorization | bearer ${access_token} | 是        | bearer +" "+[5.2.1](https://support.huaweicloud.com/api-isdp/api_01_0019.html)中获取的access_token的值 |
   
#### 请求参数
| **参数**             | **类型**      | **是否必填** | **描述**                                                                                         |
|:---|:---|:---|:---|
| personId           | String      | 是        | 人员ID                                                                                           |
| personCode         | String      | 是        | 人员编码                                                                                           |
| personName         | String      | 是        | 人员姓名                                                                                           |
| personType         | String      | 是        | 人员类型，可选项Admin、Customer、Employee、Supplier、Other                                                 |
| phone              | String      | 是        | 电话号码                                                                                           |
| personStatus       | String      | 是        | 人员状态，OC场景固定值NoAccountOpened，OP环境和红蓝一体固定值OpenAccount                                            |
| adminOrgId         | String      | 是        | 所属行政组织id（部门）                                                                                   |
| activeFlag         | String      | 否        | 是否自动发送激活短信，Y：自动发送                                                                              |
| qualificationCode  | String      | 否        | 作业资质id（多个用英文逗号分隔）                                                                              |
| extPerson          | Map         | 否        | 人员扩展信息，根据具体业务填写                                                                                |
| password           | String      | 否        | 密码，OP环境支持修改密码                                                                                  |
| certificateType    | String      | 否        | 证件类型，增加证件时必填，可选项： PASSPORTS、ID_CARD |
| certificateNo      | String      | 否        | 证件号码                                                                                           |
| roleRuleList       | List\<Map\> | 否        | 需要授权的角色（多个用英文逗号分隔）                                                                             |
| qualificationList  | List\<Map\> | 否        | 人员技能                                                                                           |
| personPositionList | List\<Map\> | 否        | 人员岗位                                                                                           |
| profilePictureId   | String      | 否        | 证件照id                                                                                          |
   
extPerson参数
| **参数**                         | **类型** | **描述** |
|:---|:---|:---|
| gender                         | String | 性别     |
| nation                         | String | 民族     |
| birthplace                     | String | 籍贯     |
| birthdate                      | String | 出生日期   |
| employeeID                     | String | 工号     |
| accessTime                     | String | 入路时间   |
| accessMode                     | String | 入路方式   |
| politicalProfile               | String | 政治面貌   |
| timeOfJoinCommunistParty       | String | 入党时间   |
| timeOfJoinCommunistYouthLeague | String | 入团时间   |
| homeAddress                    | String | 家庭住址   |
| fatherName                     | String | 父亲姓名   |
| fatherWorkCompany              | String | 父亲工作单位 |
| fatherPosition                 | String | 父亲职务   |
| motherName                     | String | 母亲姓名   |
| motherWorkCompany              | String | 母亲工作单位 |
| motherPosition                 | String | 母亲职务   |
| spouseName                     | String | 配偶姓名   |
| spouseWorkCompany              | String | 配偶工作单位 |
| spousePosition                 | String | 配偶职务   |
| degree                         | String | 学位     |
| professional                   | String | 专业     |
| graduationSchool               | String | 毕业学校   |
| graduationTime                 | String | 毕业时间   |
   
qualificationList参数
| **参数**          | **类型**  | **描述**        |
|:---|:---|:---|
| skillDomainName | String  | 技能种类          |
| skillName       | String  | 技能名称          |
| skillLevelName  | String  | 技能等级          |
| startDate       | String  | 证书开始时间        |
| endDate         | String  | 证书结束时间        |
| hireStatus      | Integer | 是否在聘，1在聘，0未在聘 |
   
roleRuleList列表内的Map参数
| **参数**   | **类型** | **描述** |
|:---|:---|:---|
| roleNo   | String | 角色编号   |
| ruleCode | String | 规则编码   |
   
personPositionList列表内的Map参数
| **参数**     | **类型** | **描述** |
|:---|:---|:---|
| positionId | String | 岗位ID   |
   
#### 响应参数
| **参数**  | **类型**  | **描述**      |
|:---|:---|:---|
| Status  | String  | 状态描述，请求是否成功 |
| Msg     | String  | 报错信息        |
| Failed  | Boolean | 请求失败标识      |
| Success | Boolean | 请求成功标识      |
   
#### 请求示例
```
{
    "personId": "5001540",
    "personCode": "test0727",
    "personName": "test0727",
    "personType": "Employee",
    "phone": "138****0727",
    "personStatus": "NoAccountOpened",
    "adminOrgId": "9911293975",
    "activeFlag": "Y",
    "qualificationCode": "68,69",
    "certificateNo": "440********6018888",
    "certificateType": "ID_CARD",
    "extPerson": {
        "gender": "female",
        "nation": "cn"
    },
    "qualificationList": [
        {
            "personQualId": "5000049",
            "skillName": "急救证",
            "skillLevelName": "1级",
            "skillDomainName": "安全",
            "hireStatus": 1
        }
    ],
    "personPositionList": [
        {
            "positionId": "112524"
        }
    ]
}
```
#### 响应示例
```
{
    "status": "success",
    "msg": null,
    "data": null,
    "failed": false,
    "success": true
}
```
