跳到主要内容

Department

Department 表示组织架构中的部门节点。它继承 OrganizationNode 的通用字段,并额外补充了“所属公司”和“上级部门”两个更适合部门场景的便捷方法。

什么时候看这页

  • 你在脚本里拿到了部门对象,想确认当前部门能直接取哪些关系
  • 你想区分 getParentDetail()getParentDepartmentDetail() 的差别
  • 你在写按部门处理的业务逻辑

核心字段

方法返回值类型说明
getId()String部门 ID
getName()String部门名称
getType()String组织节点类型
getLeaderEmployee()String部门负责人员工 ID
getLeaderEmployeeDetail()Employee?部门负责人详情
getDescription()String描述信息
getParent()String上级节点 ID
getParentDetail()OrganizationNode?上级节点详情,可能是公司也可能是部门
getAdminLevel()String?行政级别,可为空
getCategory()NodeCategory节点分类

Department 额外提供的方法

方法返回值类型说明
getParentDepartmentDetail()Department?仅当上级也是部门时返回上级部门,否则返回 null
getCompanyDetail()Company获取所属公司详情

什么时候用哪个“父级”方法

  • 你只是想顺着组织树往上走:用 getParentDetail()
  • 你明确只关心“上级部门”而不想处理公司节点:用 getParentDepartmentDetail()
  • 你要找部门归属的公司主体:用 getCompanyDetail()

一个常见读取方式

var department = OrganizationHolder.getDepartment()
var parentDepartment = department == null ? null : department.getParentDepartmentDetail()

如果当前部门直接挂在公司下面,getParentDepartmentDetail() 会返回 null,这是预期行为。

使用提醒

  • 部门负责人信息来自组织数据,不直接等同于权限角色
  • 如果你在审批、通知或数据权限逻辑里依赖部门关系,最好先确认组织架构数据已经维护完整

下一步看哪里