查询人员组的条件
接口描述
此接口用于使用中间件查询人员组的条件信息
请求URI
/api/openapi/userGroup/conditions?companyCode=company-003&userGroupCode=GROUP-001
请求方式
GET
请求参数说明
字段名 | 类型 | 必填 | 约束 | 说明 |
---|---|---|---|---|
companyCode | String | 最大长度 36 | 公司编码 使用公司token时,该参数不使用 | |
userGroupCode | String | ○ | 最大长度 50 | 人员组编码 |
接口返回示例
{
"companyCode": "CMP-001",
"userGroupCode": "GROUP-001",
"userGroupConditionGroups": [
{
"userGroupConditionItems": [
{
"conditionProperty": "Company",
"conditionLogic": "I",
"enabled": true,
"conditionValues": [
"companyCode1",
"companyCode2"
]
},
{
"conditionProperty": "Department",
"conditionLogic": "I",
"enabled": true,
"conditionValues": [
"departmentCode1",
"departmentCode1"
]
},
{
"conditionProperty": "EmployeeRank",
"conditionLogic": "I",
"enabled": true,
"conditionValues": [
"rankCode1",
"rankCode2"
]
},
{
"conditionProperty": "EmployeeDuty",
"conditionLogic": "I",
"enabled": true,
"conditionValues": [
"positionCode1",
"positionCode2"
]
},
{
"conditionProperty": "EmployeeType",
"conditionLogic": "I",
"enabled": true,
"conditionValues": [
"typeCode1",
"typeCode2"
]
},
{
"conditionProperty": "UserPostExt",
"conditionFieldCode": "UserPostExt-001",
"conditionLogic": "I",
"enabled": true,
"conditionValues": [
"valueCode1",
"valueCode2"
]
},
{
"conditionProperty": "UserPostExt",
"conditionFieldCode": "UserPostExt-002",
"conditionLogic": "I",
"enabled": true,
"conditionValues": [
"valueCode1",
"valueCode2"
]
},
{
"conditionProperty": "UserInfoExt",
"conditionFieldCode": "UserInfoExt-001",
"conditionLogic": "I",
"enabled": true,
"conditionValues": [
"valueCode1",
"valueCode2"
]
},
{
"conditionProperty": "UserInfoExt",
"conditionFieldCode": "UserInfoExt-002",
"conditionLogic": "I",
"enabled": true,
"conditionValues": [
"valueCode1",
"valueCode2"
]
}
]
},
{
"userGroupConditionItems": [
{
"conditionProperty": "Company",
"conditionLogic": "I",
"enabled": true,
"conditionValues": [
"companyCode1",
"companyCode2"
]
},
{
"conditionProperty": "Department",
"conditionLogic": "I",
"enabled": true,
"conditionValues": [
"departmentCode1",
"departmentCode1"
]
},
{
"conditionProperty": "EmployeeRank",
"conditionLogic": "I",
"enabled": true,
"conditionValues": [
"rankCode1",
"rankCode2"
]
},
{
"conditionProperty": "EmployeeDuty",
"conditionLogic": "I",
"enabled": true,
"conditionValues": [
"positionCode1",
"positionCode2"
]
},
{
"conditionProperty": "EmployeeType",
"conditionLogic": "I",
"enabled": true,
"conditionValues": [
"typeCode1",
"typeCode2"
]
},
{
"conditionProperty": "UserPostExt",
"conditionFieldCode": "UserPostExt-001",
"conditionLogic": "I",
"enabled": true,
"conditionValues": [
"valueCode1",
"valueCode2"
]
},
{
"conditionProperty": "UserPostExt",
"conditionFieldCode": "UserPostExt-002",
"conditionLogic": "I",
"enabled": true,
"conditionValues": [
"valueCode1",
"valueCode2"
]
},
{
"conditionProperty": "UserInfoExt",
"conditionFieldCode": "UserInfoExt-001",
"conditionLogic": "I",
"enabled": true,
"conditionValues": [
"valueCode1",
"valueCode2"
]
},
{
"conditionProperty": "UserInfoExt",
"conditionFieldCode": "UserInfoExt-002",
"conditionLogic": "I",
"enabled": true,
"conditionValues": [
"valueCode1",
"valueCode2"
]
}
]
}
]
}
接口返回字段
字段名 | 类型 | 约束 | 说明 |
---|---|---|---|
companyCode | String | 最大长度 36 | 公司编码 使用公司token时,该参数不使用 |
userGroupCode | String | 最大长度 50 | 人员组编码 |
userGroupConditionGroups | List | 人员条件列表 |
UserGroupConditionGroup
字段名 | 类型 | 约束 | 说明 |
---|---|---|---|
userGroupConditionItems | List | 人员组条件 |
UserGroupConditionItem
字段名 | 类型 | 约束 | 说明 |
---|---|---|---|
conditionProperty | String | 条件类型 Company:公司 ※公司token时该类型不使用 Department:部门 EmployeeRank:级别 EmployeeDuty:职务 EmployeeType:类型 UserPostExt:岗位扩展字段 UserInfoExt:个人信息扩展字段 | |
conditionLogic | String | 条件逻辑 部门以外 I:包含 E:不包含 部门 IC:包含(指定部门,及子部门) I:包含(仅指定部门) EC:不包含(指定部门,及子部门) E:不包含(仅指定部门) | |
conditionFieldCode | String | 自定义字段编码 仅下面两种条件类型时,使用该参数且做必填校验 UserPostExt UserInfoExt | |
conditionValues | List | 条件列表 | |
enabled | Boolean | 是否有效 true/false 默认值为true |
失败示例
{
"message": "缺少必填项:{0}",
"errorCode": "120003"
}
字段说明
字段名称 | 类型 | 说明 |
---|---|---|
message | String | 返回信息说明 |
errorCode | String | 返回错误码 |
key | String | 人员组编号 |
错误代码
errorCode | message | 说明 |
---|---|---|
120003 | 缺少必填项:{0} | |
0013 | 参数:{0},最大长度{1} | |
spd.12366.003 | 人员组:{0}不存在或已失效 | |
spd.12366.005 | 公司:{0}不存在或已失效 |
← 更新人员组的条件