form.getuserinfo
功能说明
描述
获取用户的详细信息。
函数原型
form.getuserinfo(userids,type=0,bErr=True)参数
| 名称 | 类型 | 描述 |
|---|---|---|
| userids | 字符型/数组：列表型 | 用户成员id（id在通讯录"成员设置"中查看），此参数可以为字符串或者数组；为字符串的情况下，直接返回当前用户的信息；为数组的情况下，同时查询多个符号条件的多个用户的信息，以二维数据的方式返回 |
| type | 整型 | 指定userids的类型 0表示是userid 1表示是企业内用户id 2表示是用户的手机号码 3表示是团队姓名 |
| bErr | 逻辑型 | 在userids为数组的情况下才生效，True表示遇到错误立即返回，False表示继续执行（此时返回值里的错误userid将保留空数组） |
| 企业内用户id在通讯录里查看 |
|---|
 |
返回值
| 类型 | 描述 |
|---|---|
| 数组：字典型 | userids参数为字符串的时候返回指定用户信息，userids参数为数组的情况下，同时查询多个符合条件的多个用户的信息，以二维数据的方式返回，获取失败返回空数组 |
- 数据格式：
{ "category":0, "remark":"bobo的备注", "name":"bobo", "title":"教授", "dept":[ { "ismanager":True, "name":"部门1", "id":"51a46202e6c4839854bcb243" }, { "id":"5c10d76b4e38a45800266", "ismanager":False, "name":"部门2", "parent":{ "istop":False, "manager":[ "5757ce7ca9f27cdee7cda6a3", "5ee2198b9eae9aeaecf0b438" ], "name":"开发部", "id":"569b845d6fa928d1de40aeb4" } } ], "phone":"137********", "id":"5b68110f7cf2885b5e19e66a", "innerid":"bb" } - userids为[数组型]时的返回结果(如果type=3时团队姓名对应的用户存在多个则返回包含多个元素的列表)：
{ "5b68110f7cf2885b5e19e66a":{ "name":"bobo", "remark":"bobo的备注", "id":"5b68110f7cf2885b5e19e66a", "title":"教授", "innerid":"bb", "category":0, "dept":[ { "name":"abc2", "ismanager":False, "id":"59988c3f51325af8a75f301a", "istop":True, "parent":{} } ], "phone":"137********" }, "547a48c50eccde5ac8c0883b":{ "name":"bobo2", "remark":"bobo2的备注", "id":"547a48c50eccde5ac8c0883b", "title":"", "innerid":"PiBaiJun", "category":0, "dept":[ { "name":"abc2", "ismanager":False, "id":"59988c3f51325af8a75f301a", "istop":True, "parent":{} } ], "phone":"137********" } }
| 名称 | 描述 |
|---|---|
| id | 用户/部门id |
| name | 团队姓名 |
| category | 用户状态（-1表示被邀请的人尚未同意其邀请，同意后自动变为2，0表示团队创建者，2表示普通成员） |
| title | 用户的职称 |
| innerid | 企业内用户id |
| dept | 用户的父级部门信息 |
| phone | 用户的手机号码 |
| remark | 成员的备注信息 |
| ismanager | True表示是当前的部门主管，False表示不是 |
| parent | 部门的父级部门信息 |
| istop | True表示为顶级部门 |
| manager | 部门的主管信息（可能有多个主管） |
备注
可能出现的错误信息，执行 getlasterror 函数获取具体详细信息：
- 错误编码=getlasterror()
- 错误信息=getlasterror(1)
| 错误编码 | 错误信息 |
|---|---|
| 1407 | api执行频率超出限制 |
| 1400 | 参数类型不正确 |
| 1302 | 赋值失败 |
| 1506 | 连接数据库失败 |
| 1526 | 部门或成员id不能为空 |
| 1528 | 成员不存在 |
| 1533 | 数据库执行失败 |
其他：
- 所有表单api调用频率限制为1000次/分钟。
示例
def test():
# 查询单个用户信息
ret=form.getuserinfo("5ba0a4cefe5cfd97ba12a4c2")
print(ret)
# 查询多个用户信息
ret=form.getuserinfo(["5ba0a4cefe5cfd97ba12a4c2","5ba0a4cefe5cfd97ba12a4c3"])
print(ret)演示示例
- 暂无
安装包下载
- 暂无
相关视频
- 暂无
