User用户

概述

当前系统下的用户相关操作函数

usersWithRole

返回拥有roleIdList角色中任意一个角色的用户列表

User.usersWithRole(roleIdList)

参数	类型	描述
roleIdList	Array<String>	角色的标识符数组

返回值

类型 Array<String> 拥有roleIdList中任意一个角色的用户ID数组

示例

User.usersWithRole(['admin'])//[user1, user2, user3]

usersWithDepartment

返回属于departmentIdList部门用的用户列表

User.usersWithDepartment(departmentIdList)

参数	类型	描述
departmentIdList	Array<String>	部门标识符数组

返回值

类型 Array<String> 返回属于departmentIdList部门用的用户列表

示例

User.usersWithDepartment(['yanfabu'])

superiorUsers

返回userId的上级列表

User.superiorUsers(userId)

参数	类型	描述
userId	String	要查询上级的用户ID

返回值

类型 Array<String> 用户的上级的ID列表

示例

User.superiorUsers('user1')//[user2,user3]

superiorUsersWithLevel

返回userId的连续上级列表

User.superiorUsersWithLevel(userId,level)

参数	类型	描述
userId	String	要查询上级的用户ID
level	Integer	要查询上级层数

返回值

类型 Array<String> 用户的上级的ID列表

示例

User.superiorUsersWithLevel(Context.userId(),1)

subordinateUsers

返回userId的下属列表

User.subordinateUsers(userId)

参数	类型	描述
userId	String	要查询下属的用户ID

返回值

类型 Array<String> 用户下属的ID列表

示例

User.subordinateUsers('user1')//[user2,user3]

subordinateUsersWithLevel

返回userId的连续下属列表

User.subordinateUsersWithLevel(userId)

参数	类型	描述
userId	String	要查询下属的用户ID

返回值

类型 Array<String> 用户下属的ID列表

示例

User.subordinateUsersWithLevel('user1',2)//[user2,user3]

leaderOfDept

返回单个部门负责人列表

User.leaderOfDept(departmentId)

参数	类型	描述
departmentId	String	部门ID

返回值

类型 Array<String> 部门的负责人的用户ID列表

示例

User.leaderOfDept('dept1')//[user2,user3]

leaderOfDeptWithLevel

返回连续上级部门负责人列表

User.leaderOfDeptWithLevel(departmentId,level)

参数	类型	描述
departmentId	String	部门ID
level	Integer	要查询上级层数

返回值

类型 Array<String> 返回连续上级部门负责人列表

示例

User.leaderOfDeptWithLevel('yanfabu',1)

leaderOfDeptList

返回多个部门的负责人列表

User.leaderOfDeptList(departmentIdList)

参数	类型	描述
departmentIdList	Array<String>	部门ID列表

返回值

类型 Array<String> 部门的负责人的用户ID列表

示例

User.leaderOfDeptList(['dept1', 'dept2'])//[user2,user3,user4]

parentOfDept

返回部门的父部门ID

User.parentOfDept(departmentId)

参数	类型	描述
departmentId	String	部门ID

返回值

类型 String 父部门的ID

示例

User.parentOfDept('dept1')//dept2

parentOfDeptList

返回部门的父部门ID列表

User.parentOfDeptList(departmentId)

参数	类型	描述
departmentId	String	部门ID

返回值

类型 Array<String> 父部门ID列表

示例

User.parentOfDept('dept1')//['dept2','dept3']

childrenOfDept

返回单个部门所有下级部门列表

部门的结构为树形结构，该接口会递归的返回指定部门下树形结构的所有子节点。

User.childrenOfDept(departmentId)

参数	类型	描述
departmentId	String	部门ID

返回值

类型 Array<String> 子部门的ID列表

示例

User.childrenOfDept('dept1')//[dept2,dept3]

childrenOfDeptList

返回多个部门的所有下级部门列表

User.childrenOfDeptList(departmentList)

参数	类型	描述
departmentList	Array<String>	部门ID列表

返回值

类型 Array<String> 子部门的ID列表

示例

User.childrenOfDeptList(['dept1', 'dept2'])//[dept2,dept3]

directChildrenOfDept

返回直接下级部门列表

User.directChildrenOfDept(departmentId)

参数	类型	描述
departmentId	String	部门ID

返回值

类型 Array<String> 子部门的ID列表

示例

User.directChildrenOfDept('dept1')//[dept2]

user

返回用户信息

User.user(userId)

参数	类型	描述
userId	String	用户ID

返回值

类型 User

示例

User.user(Context.userId())

{
  "avatar": "pic10.png",
  "companyRoleList": [
    "designer",
    "admin"
  ],
  "departmentList": [
    "dev"
  ],
  "id": "zhangsan",
  "leaderList": [],
  "name": "张三",
  "roleList": [
    "admin"
  ],
  "userName": "zhangsan"
}

userInfo

返回用户信息

User.userInfo(userId)

参数	类型	描述
userId	String	用户ID

返回值

类型 UserInfo

示例

User.userInfo(Context.userId())

{
  "avatar": "pic10.png",
  "companyRoleList": [
    "designer",
    "admin"
  ],
  "departmentList": [
    "dev"
  ],
  "id": "zhangsan",
  "leaderList": [],
  "name": "张三",
  "roleList": [
    "admin"
  ],
  "userName": "zhangsan"
}

deptList

返回departmentIdList部门的部门信息列表

User.deptList(departmentIdList)

参数	类型	描述
departmentIdList	Array<String>	部门ID列表

返回值

类型 Array<Dept>

示例

User.deptList(['dept1', 'dept2'])

dept

返回部门信息

User.dept(deptId)

参数	类型	描述
deptId	String	部门ID

返回值

类型 Dept

示例

User.dept('dept1')