查询人员组的条件

接口描述

此接口用于使用中间件查询人员组的条件信息

请求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}不存在或已失效