DepartmentTimeline.Builder (larksuite-oapi 2.8.5 API)

java.lang.Object
- com.lark.oapi.service.corehr.v2.model.DepartmentTimeline.Builder

封闭类:: DepartmentTimeline

public static class DepartmentTimeline.Builder
extends Object

构造器概要

构造器
构造器和说明

Builder()

构造器
构造器和说明
`Builder()`

方法概要

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

从类继承的方法 java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 构造器详细资料
  - Builder
```
public Builder()
```
- 方法详细资料
  - id
```
public DepartmentTimeline.Builder id(String id)
```
    部门 ID
    示例值：4719456877659520852
    
    参数:
    
    id -
    
    返回:
  - versionId
```
public DepartmentTimeline.Builder versionId(String versionId)
```
    部门版本 ID(默认返回)
    示例值：7238516215202170412
    
    参数:
    
    versionId -
    
    返回:
  - names
```
public DepartmentTimeline.Builder names(I18n[] names)
```
    部门名称
    示例值：
    
    参数:
    
    names -
    
    返回:
  - subType
```
public DepartmentTimeline.Builder subType(Enum subType)
```
    部门类型，枚举值可通过文档【飞书人事枚举常量】部门子类型（department_sub_type）枚举定义部分获得
    示例值：
    
    参数:
    
    subType -
    
    返回:
  - parentDepartmentId
```
public DepartmentTimeline.Builder parentDepartmentId(String parentDepartmentId)
```
    上级部门 ID
    示例值：4719456877659520111
    
    参数:
    
    parentDepartmentId -
    
    返回:
  - manager
```
public DepartmentTimeline.Builder manager(String manager)
```
    部门负责人雇佣 ID，枚举值及详细信息可通过【查询员工信息】接口查询获得
    示例值：6893013238632416777
    
    参数:
    
    manager -
    
    返回:
  - code
```
public DepartmentTimeline.Builder code(String code)
```
    编码
    示例值：D00000456
    
    参数:
    
    code -
    
    返回:
  - effectiveDate
```
public DepartmentTimeline.Builder effectiveDate(String effectiveDate)
```
    生效日期
    示例值：2020-05-01
    
    参数:
    
    effectiveDate -
    
    返回:
  - active
```
public DepartmentTimeline.Builder active(Boolean active)
```
    是否启用
    示例值：true
    
    参数:
    
    active -
    
    返回:
  - descriptions
```
public DepartmentTimeline.Builder descriptions(I18n[] descriptions)
```
    描述
    示例值：
    
    参数:
    
    descriptions -
    
    返回:
  - customFields
```
public DepartmentTimeline.Builder customFields(CustomFieldData[] customFields)
```
    自定义字段类型，详细见[获取自定义字段列表](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/query)
    示例值：
    
    参数:
    
    customFields -
    
    返回:
  - expirationDate
```
public DepartmentTimeline.Builder expirationDate(String expirationDate)
```
    失效时间
    示例值：2020-05-02
    
    参数:
    
    expirationDate -
    
    返回:
  - treeOrder
```
public DepartmentTimeline.Builder treeOrder(String treeOrder)
```
    树形排序，代表同层级的部门排序序号;- 数据类型为字符串，实际按数值大小排序，数值越小，同层级部门展示越靠前；仅对同一父部门下的直接子部门生效;- 数值生成规则：; - 编号长度由同层级部门数量动态决定：同层级部门≤10 个为 6 位编号，10~20 个为 7 位编号，超过 100 个统一为 16 位编号，以此类推; - 新建部门时系统自动赋值：同层级下一个新部门编号，会在上一个部门编号基础上按固定数值自动累加；例如 6 位编号每次固定加 1000，7 位编号每次固定加 10000; - 重排触发：当同层级部门数量超出当前编号长度可容纳范围，或多次拖拽排序无法正常插入位置时，会触发同层级编号全局重新编排；所有部门编号会按新的长度和累加规则重新生成，数值可能出现明显变大; - 当同一父部门下的子部门数量超过 1000 个时，系统在维护排序编号时可能出现异常问题。;- 更新时机：; - 创建部门场景tree_order不会实时生成，10分钟内更新完毕; - 在页面拖动部门排序时tree_order可以实时生成; - 变更部门上级时，会清空tree_order，并触发重算list_order和tree_order，10分钟内更新完毕（list_order由部门上级路径的所有tree_order用“-”拼接生成）
    示例值：001000
    
    参数:
    
    treeOrder -
    
    返回:
  - listOrder
```
public DepartmentTimeline.Builder listOrder(String listOrder)
```
    列表排序，代表所有部门的混排序号，为该部门上级路径上所有tree_order用“-”拼接。;- 该字段在新建/更新场景非立即更新，10分钟后会延迟更新;- 由于list_order变更会导致[部门变更接口](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/department/events/updated)产生大量事件，因此事件接口不会针对该字段同步变更事件，如果有需求订阅请联系[Oncall](https://applink.feishu.cn/TLJpeNdW)单独开启。;- 同层部门（相同上级）数量超过1000时，该字段不再更新
    示例值：001000-001000
    
    参数:
    
    listOrder -
    
    返回:
  - isRoot
```
public DepartmentTimeline.Builder isRoot(Boolean isRoot)
```
    是否根部门(默认返回)
    示例值：false
    
    参数:
    
    isRoot -
    
    返回:
  - isConfidential
```
public DepartmentTimeline.Builder isConfidential(Boolean isConfidential)
```
    是否保密（该功能暂不支持，可以忽略）
    示例值：false
    
    参数:
    
    isConfidential -
    
    返回:
  - staffingModel
```
public DepartmentTimeline.Builder staffingModel(Enum staffingModel)
```
    是否使用职务
    示例值：
    
    参数:
    
    staffingModel -
    
    返回:
  - costCenterId
```
public DepartmentTimeline.Builder costCenterId(String costCenterId)
```
    成本中心id
    示例值：7142384817131652652
    
    参数:
    
    costCenterId -
    
    返回:
  - build
```
public DepartmentTimeline build()
```

类 DepartmentTimeline.Builder

构造器概要

方法概要

从类继承的方法 java.lang.Object

构造器详细资料

Builder

方法详细资料

id

versionId

names

subType

parentDepartmentId

manager

code

effectiveDate

active

descriptions

customFields

expirationDate

treeOrder

listOrder

isRoot

isConfidential

staffingModel

costCenterId

build