【人员管理】【HROP】人员查询

网关白名单

职能字段说明

传参：withOrgInfo=true
回参解释：
organizationPositionVos数组下是每个组织
不同组织下的岗位职能不同，数据按组织和岗位分组

获取路径：
编码：organizationPositionVos.positionVos.dutyStructs.code
名称：organizationPositionVos.positionVos.dutyStructs.name

例子：

[
    {
        "name": "组织1",
        "positionVos": [
            {
                "dutyStructs": [
                    {
                        "code": "investigateWorkAllocation",
                        "name": "职责1"
                    },
                    {
                        "code": "investigateBusinessClassification",
                        "name": "职责2"
                    }
                ],
                "name": "岗位1"
            }
        ]
    }
]

管理范围（withManageRanges）说明

传参：withManageRanges=true
回参解释：
manageRange对象下是管理范围
1、dealMajors：业务分类范围的id和名称
2、distinctPermissionStructs：管理范围的条件
2.1、字段是数组，表示多个岗位下的管理范围配置
2.2、每个管理范围配置最多包含3个部分，通过settingType区分：BUILDING（建筑楼层实例配置），INSTANCE（指定的实例配置），OBJECT_TYPE（类型配置：空间功能类型、建筑楼层类、专业、对象类）
2.2.1、BUILDING表示楼层建筑实例自身在范围内，或者所在楼层建筑的对象实例在范围内
2.2.2、INSTANCE表示实例id在范围内
2.2.3、OBJECT_TYPE表示这类实例在范围内
2.2.4、3个部分数据的交并关系：BUILDING和OBJECT_TYPE是取交集，INSTANCE和BUILDING/OBJECT_TYPE取并集

例子：

[
    [
        {
            "settingType": "BUILDING",
            "structItems": [
                {
                    "category": "BUILDING",
                    "dataList": [
                        {
                            // 建筑id
                            "fieldType": "BUILDING",
                            "whiteList": [
                                "Bd1720455752453169152"
                            ]
                        },
                        {
                            // 楼层id
                            "fieldType": "FLOOR_ID",
                            "whiteList": [
                                "Fl1718548707517538304",
                                "Fl1718548477958397952"
                            ]
                        }
                    ]
                }
            ]
        },
        {
            "settingType": "INSTANCE",
            "structItems": [
                {
                    "category": "INSTANCE",
                    "dataList": [
                        {
                            // 实例id
                            "fieldType": "ID",
                            "whiteList": [
                                "Sp7480382824bbcefc79d4254cc785d9f257c03bf6ee",
                                "Sp7480382824e526c437fecf4442aa5f76fff5110f6e",
                                "Sp7480382824e8bdb84a17d549fd809771767252b686"
                            ]
                        }
                    ]
                }
            ]
        }
    ],
    [
        {
            "settingType": "OBJECT_TYPE",
            "structItems": [
                {
                    "category": "ARCHITECTURAL_SPACE",
                    "dataList": [
                        {
                            // 空间功能类型
                            "fieldType": "MEOI_ROOM_FUNC_TYPE",
                            "whiteList": [
                                "SFT-01.02.00",
                                "SFT-01.05.00"
                            ]
                        },
                        {
                            // 建筑楼层类型
                            "fieldType": "OBJECT_TYPE",
                            "whiteList": [
                                "building",
                                "floor"
                            ]
                        }
                    ]
                },
                {
                    "category": "ELECTROMECHANICAL",
                    "dataList": [
                        {
                            // 专业
                            "fieldType": "MAJOR",
                            "whiteList": [
                                "AC"
                            ]
                        },
                        {
                            // 对象类，“专业-对象类”形式（对象类可以有多个所属专业）
                            "fieldType": "CLASS_CODE",
                            "whiteList": [
                                "SE-SETDHI",
                                "SE-SETDHF"
                            ]
                        }
                    ]
                }
            ]
        }
    ]
]

请求参数

Header 参数

Body 参数application/json

示例

{
    "projectIds": [
        "string"
    ],
    "projectIdRanges": [
        "string"
    ],
    "underProjectIds": [
        "string"
    ],
    "orgIds": [
        "string"
    ],
    "positionIds": [
        "string"
    ],
    "positionCategoryIds": [
        "string"
    ],
    "personIds": [
        "string"
    ],
    "accountIds": [
        "string"
    ],
    "phones": [
        "string"
    ],
    "majorSkillCodes": [
        "string"
    ],
    "duties": [
        "string"
    ],
    "instanceIds": [
        "string"
    ],
    "manageRangeQuery": {
        "projectId": "string",
        "instanceIds": [
            "string"
        ],
        "dealMajorIds": [
            0
        ],
        "positionRelLimit": "new HashSet<>()",
        "classCodes": [
            "string"
        ],
        "belongBuildingIds": [
            "string"
        ]
    },
    "workStatus": "ON_WORK",
    "withOrgInfo": false,
    "queryDeleted": false,
    "keyword": "string",
    "isScheduling": true,
    "withRoleInfo": false,
    "withResponsibility": false
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200

application/json

Bodyapplication/json

示例

[
  {
    "id": "",
    "name": "",
    "mobileNum": "",
    "email": "",
    "gender": "",
    "birthday": "",
    "workStatus": "",
    "majorSkills": [
      {
        "code": "",
        "name": ""
      }
    ],
    "accountId": "",
    "accountName": "",
    "permanentValidity": false,
    "effectiveTime": "",
    "isDeleted": false,
    "isScheduling": false,
    "organizationPositionVos": [
      {
        "id": "",
        "name": "",
        "parentId": "",
        "independence": false,
        "orgTypeStruct": {
          "code": "",
          "name": ""
        },
        "directProject": "",
        "customProject": {
          "businessOpeningTime": "",
          "productLine": {
            "code": "",
            "name": ""
          },
          "countryCode": "",
          "provinceCode": "",
          "cityCode": "",
          "totalArea": 0.0,
          "publicArea": 0.0,
          "rentedArea": 0.0,
          "undergroundGarageArea": 0.0
        },
        "manageAttribute": [
          {
            "code": "",
            "name": ""
          }
        ],
        "fillCarbon": false,
        "provinceCode": "",
        "cityCode": "",
        "officeArea": 0.0,
        "groupCode": "",
        "createTime": "",
        "allParentNames": [
          ""
        ],
        "positionVos": [
          {
            "id": "",
            "name": "",
            "dutyStructs": [
              {
                "code": "",
                "name": ""
              }
            ],
            "customize": false,
            "orgId": "",
            "orgName": "",
            "positionCategoryId": "",
            "positionCategoryName": "",
            "positionCategoryPath": ""
          }
        ]
      }
    ],
    "entryTime": "",
    "experience": 0,
    "orgType": "",
    "capabilities": [
      {
        "name": "",
        "code": "",
        "expriationTime": ""
      }
    ],
    "employmentType": "",
    "manageRange": {
      "personId": "",
      "projectId": "",
      "deliveryAccount": false,
      "dealMajorIds": [
        0
      ],
      "distinctPermissionStructs": [
        [
          {
            "settingType": "",
            "structItems": [
              {
                "category": "",
                "dataList": [
                  {
                    "fieldType": "",
                    "whiteList": [
                      ""
                    ],
                    "blockList": [
                      ""
                    ]
                  }
                ]
              }
            ]
          }
        ]
      ],
      "dealMajors": [
        {
          "code": "",
          "name": ""
        }
      ]
    }
  }
]