组织岗位

# 组织岗位

## 组织岗位

### 新增组织岗位

组织岗位中添加人员和管理范围

#### 支持版本：暂不支持

#### 接口

HttpPost：api/FrontEnd/addUserToOrgRole/{roleCode}

#### 请求实体

| 参数名 | 参数位置 | 类型 | 是否必填 | 说明 |
| --- | --- | --- | --- | --- |
| Authorization | Header |  | 是 | 调用者身份鉴权：[获取token](http://invalid.uri) |
| UserId | Header |  | 是 | 调用者用户Id |
| TnCode | Header |  | 是 | 租户code |
| roleCode | Route | string | 是 | 组织岗位编码code （必填） |
| RoleName | Body | string | 否 | 组织岗位名称（非必填） |
| Users | Body | 集合 | 否 | 岗位用户数据集合：\[{"UserID":"18f923a7\-\*\*\*\*", \-\-岗位用户id(\*必填)"ManagerScopeIds":"部门id1;部门id2", \-\- 管理部门id，用;分割 (\*必填)"IsConcurrent":false, \-\- 是否兼任(非必填,默认false)"Description":"" \-\- 描述(非必填)}] |

请求示例1:

仅新增组织岗位buzhang（Users传空，如果buzhang编码存在，则不做处理；如果组织岗位名称参数为空的话，将以buzhang作为组织岗位名称）

api/FrontEnd/addUserToOrgRole/buzhang

```
{  
 "RoleName":"部长",  
 "Users": []  
}  
```

请求示例2:

向编码为buzhang的组织岗位添加岗位人员 （如果buzhang编码不存在，则新增；如果组织岗位名称参数为空的话，将以buzhang作为组织岗位名称）

api/FrontEnd/addUserToOrgRole/buzhang

```
{
	"Users": [{
		"UserID": "18f923a7-5a5e-426d-94ae-a55ad1a4b239",
		"ManagerScopeIds": "c896bfa0-4545-4e98-b25c-f552f9082025;79244dc5-daa3-4fe6-8e50-bdf7c7f8dfc9"
	},
  {
		"UserID": "55e74748-71f8-4126-9185-21db04bec607",
		"ManagerScopeIds": "79244dc5-daa3-4fe6-8e50-bdf7c7f8dfc9",
    "IsConcurrent": true,
    "Description": "张部长兼任管理开发部"
	}]
}
```

* 同一岗位编码下的岗位人员-管理部门 需要保证唯一

#### 返回结果

| 参数名 | 类型 | 说明 |
| --- | --- | --- |
| Code | int | 状态码:200表示成功，201表示失败 |
| Message | string | 错误消息（当Code为201时，返回错误消息内容） |
| Status | int | 状态：1表示成功，0表示失败 |

返回示例(成功)：

```
{  
 "Code": 200,  
 "Message": "",  
 "ExceptionSeqNo": null,  
 "Result": true,  
 "Status": 1,  
 "MessageShowType": 0  
}  
```

返回示例(失败)：

```
{
    "Code": 203,
    "Message": "ManagerScopeIds[205e4ed8-db1f-40c7-9e2d-bf656d53c2c1]该管理部门Id不存在",
    "ExceptionSeqNo": null,
    "Result": null,
    "Status": 0,
    "MessageShowType": 0
}
```

### 查询角色里的人员集合

根据角色code查找角色里的人员集合

#### 支持版本：暂不支持

#### 接口

HttpGet：api/FrontEnd/getRoleUserList/{roleCode}

#### 请求实体

| 参数名 | 参数位置 | 类型 | 是否必填 | 说明 |
| --- | --- | --- | --- | --- |
| Authorization | Header |  | 是 | 调用者身份鉴权：[获取token](http://invalid.uri) |
| UserId | Header |  | 是 | 调用者用户Id |
| TnCode | Header |  | 是 | 租户code |
| roleCode | Route | string | 是 | 角色编码code （必填） |

请求示例:

api/FrontEnd/getRoleUserList/admin

#### 返回结果

| 参数名 | 类型 | 说明 |
| --- | --- | --- |
| Code | int | 状态码:200表示成功，201表示失败 |
| Message | string | 错误消息（当Code为201时，返回错误消息内容） |
| Result | 集合 | 查询结果集 |
| Status | int | 状态：1表示成功，0表示失败 |

返回示例(成功)：

```
{
    "Code": 200,
    "Message": "",
    "ExceptionSeqNo": null,
    "Result": [
        {
            "ObjectID": "18f923a7-5a5e-426d-94ae-a55ad1a4b239",
            "UserCode": "administrator",
          	"UserName": "系统管理员",
          	"ParentID": "18f923a7-5a5e-426d-94ae-a55ad1a4b240",
            "ParentName": "公司",
          	"IsConcurrent":false
        }
    ],
    "Status": 1,
    "MessageShowType": 0
}
```

返回示例(失败)：

```
{  
 "Code": 203,  
 "Message": "角色Code[admin1]不存在",  
 "ExceptionSeqNo": null,  
 "Result": null,  
 "Status": 0,  
 "MessageShowType": 0  
} 
```

## 自定义角色

### 新增应用自定义角色

新增一个应用自定义角色，根据应用code来加角色，如果code传ALL,就所有应用都加这个角色

#### 支持版本：暂不支持

#### 接口

HttpPost：api/FrontEnd/addAppOrgRole/{roleCode}/{forApp}

#### 请求实体

| 参数名 | 参数位置 | 类型 | 是否必填 | 说明 |
| --- | --- | --- | --- | --- |
| Authorization | Header |  | 是 | 调用者身份鉴权：[获取token](http://invalid.uri) |
| UserId | Header |  | 是 | 调用者用户Id |
| TnCode | Header |  | 是 | 租户code |
| roleCode | Route | string | 是 | 自定义角色编码code （必填） |
| forApp | Route | string | 是 | 应用Code |
| RoleName | Body | string | 否 | 组织岗位名称（非必填） |
| RoleScope | Body | 集合 | 否 | 自定义角色人员或部门集合：\["3169a033\-f02a\-4035\-8bd1\-2fab7aeb40ee", "18f923a7\-5a5e\-426d\-94ae\-a55ad1a4b239"] |

请求示例:

向项目管理应用\[xmgl]的自定义角色admin1添加人员 （如果admin1编码不存在，则新增；如果自定义角色名称参数为空的话，将以admin1作为自定义角色名称）

api/FrontEnd/addUserToOrgRole/admin1/xmgl

```
{
	"RoleScope": ["3169a033-f02a-4035-8bd1-2fab7aeb40ee", 
    						"18f923a7-5a5e-426d-94ae-a55ad1a4b239"]
}
```

#### 返回结果

| 参数名 | 类型 | 说明 |
| --- | --- | --- |
| Code | int | 状态码:200表示成功，201表示失败 |
| Message | string | 错误消息（当Code为201时，返回错误消息内容） |
| Status | int | 状态：1表示成功，0表示失败 |

返回示例(成功)：

```
{  
 "Code": 200,  
 "Message": "",  
 "ExceptionSeqNo": null,  
 "Result": true,  
 "Status": 1,  
 "MessageShowType": 0  
}  
```

返回示例(失败)：

```
{  
 "Code": 203,  
 "Message": "应用Code[xmgl1]不存在",  
 "ExceptionSeqNo": null,  
 "Result": null,  
 "Status": 0,  
 "MessageShowType": 0  
}  
```