| 程序包 | 说明 |
|---|---|
| com.lark.oapi.service.corehr.v2.model |
| 限定符和类型 | 方法和说明 |
|---|---|
DepartmentTimeline.Builder |
DepartmentTimeline.Builder.active(Boolean active)
是否启用
示例值:true
|
DepartmentTimeline.Builder |
DepartmentTimeline.Builder.code(String code)
编码
示例值:D00000456
|
DepartmentTimeline.Builder |
DepartmentTimeline.Builder.costCenterId(String costCenterId)
成本中心id
示例值:7142384817131652652
|
DepartmentTimeline.Builder |
DepartmentTimeline.Builder.customFields(CustomFieldData[] customFields)
自定义字段类型,详细见[获取自定义字段列表](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/query)
示例值:
|
DepartmentTimeline.Builder |
DepartmentTimeline.Builder.descriptions(I18n[] descriptions)
描述
示例值:
|
DepartmentTimeline.Builder |
DepartmentTimeline.Builder.effectiveDate(String effectiveDate)
生效日期
示例值:2020-05-01
|
DepartmentTimeline.Builder |
DepartmentTimeline.Builder.expirationDate(String expirationDate)
失效时间
示例值:2020-05-02
|
DepartmentTimeline.Builder |
DepartmentTimeline.Builder.id(String id)
部门 ID
示例值:4719456877659520852
|
DepartmentTimeline.Builder |
DepartmentTimeline.Builder.isConfidential(Boolean isConfidential)
是否保密(该功能暂不支持,可以忽略)
示例值:false
|
DepartmentTimeline.Builder |
DepartmentTimeline.Builder.isRoot(Boolean isRoot)
是否根部门(默认返回)
示例值:false
|
DepartmentTimeline.Builder |
DepartmentTimeline.Builder.listOrder(String listOrder)
列表排序,代表所有部门的混排序号,为该部门上级路径上所有tree_order用“-”拼接。
|
DepartmentTimeline.Builder |
DepartmentTimeline.Builder.manager(String manager)
部门负责人雇佣 ID,枚举值及详细信息可通过【查询员工信息】接口查询获得
示例值:6893013238632416777
|
DepartmentTimeline.Builder |
DepartmentTimeline.Builder.names(I18n[] names)
部门名称
示例值:
|
static DepartmentTimeline.Builder |
DepartmentTimeline.newBuilder() |
DepartmentTimeline.Builder |
DepartmentTimeline.Builder.parentDepartmentId(String parentDepartmentId)
上级部门 ID
示例值:4719456877659520111
|
DepartmentTimeline.Builder |
DepartmentTimeline.Builder.staffingModel(Enum staffingModel)
是否使用职务
示例值:
|
DepartmentTimeline.Builder |
DepartmentTimeline.Builder.subType(Enum subType)
部门类型,枚举值可通过文档【飞书人事枚举常量】部门子类型(department_sub_type)枚举定义部分获得
示例值:
|
DepartmentTimeline.Builder |
DepartmentTimeline.Builder.treeOrder(String treeOrder)
树形排序,代表同层级的部门排序序号;- 数据类型为字符串,实际按数值大小排序,数值越小,同层级部门展示越靠前;仅对同一父部门下的直接子部门生效;- 数值生成规则:; -
编号长度由同层级部门数量动态决定:同层级部门≤10 个为 6 位编号,10~20 个为 7 位编号,超过 100 个统一为 16 位编号,以此类推; -
新建部门时系统自动赋值:同层级下一个新部门编号,会在上一个部门编号基础上按固定数值自动累加;例如 6 位编号每次固定加 1000,7 位编号每次固定加 10000; -
重排触发:当同层级部门数量超出当前编号长度可容纳范围,或多次拖拽排序无法正常插入位置时,会触发同层级编号全局重新编排;所有部门编号会按新的长度和累加规则重新生成,数值可能出现明显变大;
- 当同一父部门下的子部门数量超过 1000 个时,系统在维护排序编号时可能出现异常问题。
|
DepartmentTimeline.Builder |
DepartmentTimeline.Builder.versionId(String versionId)
部门版本 ID(默认返回)
示例值:7238516215202170412
|
| 构造器和说明 |
|---|
DepartmentTimeline(DepartmentTimeline.Builder builder) |
Copyright © 2026. All rights reserved.