批量查询指定组织的下级组织树分支

接口限制：100次/秒/企业 3000次/分钟/企业

适用场景：1.批量查询指定组织的下级组织树分支

警告信息：1.若对应的组织单元不存在，则进行错误提示

tips：1.下级组织树分支，包含指定组织的直线下级组织、下级的下级，一直到最后。如：A的下级B、C，B的下级B1、B2，C的下级C1、C2、C3，则返回结果包含B、C、B1、B2、C1、C2、C3。
2.组织单元有时间轴概念，默认获取当天的组织单元信息
3.默认组织OId为0，根组织OId为900+租户ID，如：900100000
4.默认查询未删除的组织单元信息
5.该接口不支持指定排序条件，强制按行政维度_路径（POIdOrgAdmin_TreePath）正序排列，从而保证同一层级的组织列表顺序排列

错误码示例

{
"data": null,
"code": "417",
"message": "OIds所有元素必须为大于等于0的整数"
}

curl --location --request POST 'https://openapi.italent.cn/TenantBaseExternal/api/v5/Organization/GetSubOrganizationTrees' \ --header 'Content-Type: application/json' \ --data-raw '{ "oIds": [ 4745240, 4745241 ], "queryDate": "2021-06-21", "isWithDisable": false, "isWithSelf": true, "isWithDeleted": false, "columns": null, "enableTranslate": true //启用翻译功能 }'

{ "data": { "property1": [ { "name": "string", "shortName": "string", "code": "string", "oId": 0, "level": "string", "status": 0, "establishDate": "2019-08-24T14:15:22Z", "startDate": "2019-08-24T14:15:22Z", "stopDate": "2019-08-24T14:15:22Z", "changeDate": "2019-08-24T14:15:22Z", "pOIdOrgAdmin": 0, "pOIdOrgReserve2": 0, "pOIdOrgReserve3": 0, "isCurrentRecord": true, "personInCharge": 0, "hRBP": 0, "shopOwner": 0, "administrativeAssistant": 0, "personInChargeDeputy": "string", "businessModifiedBy": 0, "businessModifiedTime": "2019-08-24T14:15:22Z", "legalMan": "string", "address": "string", "fax": "string", "postcode": "string", "phone": "string", "url": "string", "description": "string", "number": "string", "broadType": "string", "economicType": "string", "industry": "string", "place": "string", "orderAdmin": 0, "orderReserve2": 0, "orderReserve3": 0, "comment": "string", "oIdOrganizationType": "string", "pOIdOrgAdmin_TreePath": "string", "pOIdOrgAdmin_TreeLevel": 0, "pOIdOrgReserve2_TreePath": "string", "pOIdOrgReserve2_TreeLevel": 0, "firstLevelOrganization": 0, "secondLevelOrganization": 0, "thirdLevelOrganization": 0, "fourthLevelOrganization": 0, "fifthLevelOrganization": 0, "sixthLevelOrganization": 0, "seventhLevelOrganization": 0, "eighthLevelOrganization": 0, "ninthLevelOrganization": 0, "tenthLevelOrganization": 0, "orderCode": 0, "pOIdOrgAdminNameTreePath": "string", "isVirtualOrg": true, "leaderWithSpecificDuty": 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 } ], "property2": [ { "name": "string", "shortName": "string", "code": "string", "oId": 0, "level": "string", "status": 0, "establishDate": "2019-08-24T14:15:22Z", "startDate": "2019-08-24T14:15:22Z", "stopDate": "2019-08-24T14:15:22Z", "changeDate": "2019-08-24T14:15:22Z", "pOIdOrgAdmin": 0, "pOIdOrgReserve2": 0, "pOIdOrgReserve3": 0, "isCurrentRecord": true, "personInCharge": 0, "hRBP": 0, "shopOwner": 0, "administrativeAssistant": 0, "personInChargeDeputy": "string", "businessModifiedBy": 0, "businessModifiedTime": "2019-08-24T14:15:22Z", "legalMan": "string", "address": "string", "fax": "string", "postcode": "string", "phone": "string", "url": "string", "description": "string", "number": "string", "broadType": "string", "economicType": "string", "industry": "string", "place": "string", "orderAdmin": 0, "orderReserve2": 0, "orderReserve3": 0, "comment": "string", "oIdOrganizationType": "string", "pOIdOrgAdmin_TreePath": "string", "pOIdOrgAdmin_TreeLevel": 0, "pOIdOrgReserve2_TreePath": "string", "pOIdOrgReserve2_TreeLevel": 0, "firstLevelOrganization": 0, "secondLevelOrganization": 0, "thirdLevelOrganization": 0, "fourthLevelOrganization": 0, "fifthLevelOrganization": 0, "sixthLevelOrganization": 0, "seventhLevelOrganization": 0, "eighthLevelOrganization": 0, "ninthLevelOrganization": 0, "tenthLevelOrganization": 0, "orderCode": 0, "pOIdOrgAdminNameTreePath": "string", "isVirtualOrg": true, "leaderWithSpecificDuty": 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 } ] }, "code": "string", "message": "string" }

请求参数

Body 参数application/json

oIds

array[integer <int32>]

必需

查询指定组织单元OId集合，元素个数需小于等于300，且各元素值必须大于等于0，示例：[3879,3889]。注意：默认组织OId为0，根组织OId为900+租户ID，如：900100000

isWithDisable

boolean

可选

是否包含停用组织，默认false，不包含。

isWithSelf

boolean

可选

是否包含指定组织自身，默认false，不包含。

queryDate

string <date-time> | null

可选

查询日期，默认查询当前日期，null也表示当前日期。示例：2021-01-01。注意：组织单元是有时间轴概念，类似任职记录

isWithDeleted

boolean

可选

是否包括已删除数据，默认否，示例：true/false

columns

array[string]

可选

查询字段列表，默认为null(获取全部信息)，非必填。注意：该参数仅表示是否查询该列的值，不控制响应模型的字段。例：["Name","OId","Code","Status"]

enableTranslate

boolean

可选

是否开启动态翻译，默认否，示例：true/false。开启后，自动翻译数据源等字典类型字段，结果在响应参数的TranslateProperties中，key为对应字段加Text后缀，值为翻译后文本

示例

返回响应

🟢200查询响应结果

application/json

Body

data

object

可选

数据结果，字典键为指定的组织单元OId，值为对应组织的列表集合

额外字段

array [object {64}]

可选

code

string

可选

响应码（正常情况必须200）或异常错误编码（异常情况）：200-OK，417-参数异常、业务不合法，500-内部服务器异常。示例："200"

message

string

结果消息

可选

批量查询指定组织的下级组织树分支

错误码示例#

请求参数

返回响应

错误码示例