Skip to content

用户选择器

用户选择器(PersonSelector)是一个通用的人员/部门/角色选择弹窗组件,用于流程设计中的发起人选择、审批人设置等场景。

相关接口

方法路径说明
POST/organizations/current-user-org-tree获取当前用户组织架构树
GET/roles获取角色列表

组织架构树

响应数据结构data 字段):

json
{
  "id": "org_001",              // 根节点 ID
  "name": "XX 科技有限公司",      // 节点名称
  "type": "organization",       // 节点类型:organization
  "children": [                 // 子节点列表
    {
      "id": "dept_001",         // 部门 ID
      "name": "技术部",          // 部门名称
      "type": "department",     // 节点类型:department
      "children": [             // 子节点(部门或用户)
        {
          "id": "user_001",     // 用户 ID
          "name": "张三",        // 用户名称
          "type": "user"        // 节点类型:user
        },
        {
          "id": "dept_002",     // 子部门 ID
          "name": "前端组",      // 子部门名称
          "type": "department", // 节点类型:department
          "children": []
        }
      ]
    }
  ]
}

节点类型(type)说明:

类型说明
organization组织根节点
department部门节点,可包含子节点
user用户节点,叶子节点

角色列表

响应数据结构data 字段):

json
[
  {
    "id": "role_001",       // 角色 ID
    "roleName": "部门经理",   // 角色名称
    "roleCode": "dept_mgr"  // 角色编码
  }
]

选择模式

组件支持以下选择模式:

  • 可选类型:通过 selectableTypes 控制,支持 user(用户)、department(部门)、role(角色)的组合
  • 单选/多选:通过 singleMode 控制
  • 筛选:通过 filter 参数限制可选范围

鄂ICP备2022006250号-5