滚动查询指定组织下的员工与单条任职信息
POST
/TenantBaseExternal/api/v5/Employee/GetEmployeeOfOrganization
2.主要用于查询组织下的员工
3.查询结果仅支持返回员工对应的单条任职记录（若存在多条，优先取未删除的主职）。如需查询员工对应的多条任职记录，请使用【根据时间窗滚动查询变动的员工与多条任职信息GetListByTimeWindow】接口
2.每批次数据量必须小于等于300
3.滚动查询有过期时间限制。两次滚动查询接口调用间隔不能超出10秒，超出间隔后，查不到下批次数据。故必须通过while循环查出全部数据后再处理具体业务。
4.滚动查询不能跳页，拿了第一页后要拿第三页，滚动查询不支持
5.滚动查询不能回跳，拿 了第三页之后要跳回第二页，滚动查询不支持
6.使用滚动查询而非分页查询，是为了防止大批量获取数据时，深分页导致超时
2.默认排序条件：若排序参数为空，则默认先按照UserID升序，然后按照创建时间降序
3.仅支持查询审批生效的记录；若删除状态不作为查询条件，默认为未删除的员工相关信息
4.是否包括已删除数据（IsWithDeleted）和自定义字段查询条件（ExtQueries）针对的是员工信息与任职记录，与指定组织无关
5.累计工龄（WorkYearTotal）、累计集团工龄（WorkYearGroupTotal）、累计司龄（WorkYearCompanyTotal）非实时数据，而是每天定时任务刷新，故存在延迟情况
错误码示例
"scrollId": null,
"isLastData": false,
"total": 0,
"data": null,
"code": "417",
"message": "OrgOId不能为空且为正整数！"
}
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://openapi.italent.cn/TenantBaseExternal/api/v5/Employee/GetEmployeeOfOrganization' \
--header 'Content-Type: application/json' \
--data-raw '{
"orgOId": 4745255,
"includeSubOrg": false,
"queryDate": "2021-06-29",
"isWithDisable": false,
"empStatus": null,
"employType": [
0
],
"serviceType": [
0
],
"isGetLatestRecord": true,
"withDisabled": false,
"scrollId": "",
"capacity": 2,
"sort": {
"Name": 1
},
"extQueries": [//自定义字段查询条件
{
"fieldName": "extExtQueryFloat_127666_832132060",
"queryType": 5,//等于
"values": [
"1"
]
},
{
"fieldName": "extExtQueryText_127666_1870946722",
"queryType": 6,//不等于
"values": [
"文本1"
]
},
{
"fieldName": "extExtQueryInt_127666_637453549",
"queryType": 7,//区间
"values": [
"1",
"1000"
],
"includeLowerValue": true,//包含最小值
"includeUpperValue": false//不包含最大值
}
],
"isWithDeleted": false,
"columns": null,
"enableTranslate": true
}'响应示例响应示例
{
"scrollId": "string",
"isLastData": true,
"total": 0,
"data": [
{
"employeeInfo": {
"userID": 0,
"name": "string",
"_Name": "string",
"gender": 0,
"email": "string",
"iDType": "string",
"iDNumber": "string",
"birthday": "2019-08-24T14:15:22Z",
"workDate": "2019-08-24T14:15:22Z",
"homeAddress": "string",
"mobilePhone": "string",
"weiXin": "string",
"iDPhoto": "string",
"personalHomepage": "string",
"speciality": "string",
"major": "string",
"postalCode": "string",
"passportNumber": "string",
"constellation": "string",
"bloodType": "string",
"residenceAddress": "string",
"joinPartyDate": "2019-08-24T14:15:22Z",
"domicileType": 0,
"emergencyContact": "string",
"emergencyContactRelationship": "string",
"emergencyContactPhone": "string",
"qQ": "string",
"aboutMe": "string",
"homePhone": "string",
"graduateDate": "2019-08-24T14:15:22Z",
"marryCategory": "string",
"politicalStatus": "string",
"nationality": 0,
"nation": "string",
"birthplace": "string",
"registAddress": "string",
"educationLevel": "string",
"lastSchool": "string",
"engName": "string",
"officeTel": "string",
"businessAddress": "string",
"backupMail": "string",
"applicantId": 0,
"age": 0,
"businessModifiedBy": 0,
"businessModifiedTime": "2019-08-24T14:15:22Z",
"sourceType": 0,
"objectId": "string",
"customProperties": {
"property1": {},
"property2": {}
},
"translateProperties": {
"property1": "string",
"property2": "string"
},
"createdBy": 0,
"createdTime": "2019-08-24T14:15:22Z",
"modifiedBy": 0,
"modifiedTime": "2019-08-24T14:15:22Z",
"stdIsDeleted": true
},
"recordInfo": {
"userID": 0,
"pObjectDataID": "string",
"oIdDepartment": 0,
"startDate": "2019-08-24T14:15:22Z",
"stopDate": "2019-08-24T14:15:22Z",
"jobNumber": "string",
"entryDate": "2019-08-24T14:15:22Z",
"lastWorkDate": "2019-08-24T14:15:22Z",
"regularizationDate": "2019-08-24T14:15:22Z",
"probation": 0,
"order": 0,
"employType": 0,
"serviceType": 0,
"serviceStatus": 0,
"approvalStatus": 0,
"employmentSource": "string",
"employmentForm": "string",
"isCharge": "string",
"oIdJobPost": "string",
"oIdJobSequence": "string",
"oIdJobPosition": "string",
"oIdJobLevel": "string",
"oidJobGrade": "string",
"place": "string",
"employeeStatus": "string",
"employmentType": "string",
"employmentChangeID": "string",
"changedStatus": "string",
"pOIdEmpAdmin": 0,
"pOIdEmpReserve2": 0,
"businessTypeOID": "string",
"changeTypeOID": "string",
"workYearBefore": 0,
"workYearGroupBefore": 0,
"workYearCompanyBefore": 0,
"workYearTotal": 0,
"workYearGroupTotal": 0,
"workYearCompanyTotal": 0,
"oIdOrganization": 0,
"whereabouts": "string",
"blackStaffDesc": "string",
"blackListAddReason": "string",
"transitionTypeOID": "string",
"changeReason": "string",
"probationResult": "string",
"probationActualStopDate": "2019-08-24T14:15:22Z",
"probationStartDate": "2019-08-24T14:15:22Z",
"probationStopDate": "2019-08-24T14:15:22Z",
"isHaveProbation": "string",
"remarks": "string",
"addOrNotBlackList": true,
"businessModifiedBy": 0,
"businessModifiedTime": "2019-08-24T14:15:22Z",
"objectId": "string",
"customProperties": {
"property1": {},
"property2": {}
},
"translateProperties": {
"property1": "string",
"property2": "string"
},
"createdBy": 0,
"createdTime": "2019-08-24T14:15:22Z",
"modifiedBy": 0,
"modifiedTime": "2019-08-24T14:15:22Z",
"stdIsDeleted": true
}
}
],
"code": "string",
"message": "string"
}请求参数
Body 参数application/json
返回响应
扫码加入交流群修改于 2021-10-13 10:54:24