form.getdeptinfo
功能说明
描述
获取部门详细信息。
函数原型
form.getdeptinfo(deptids,bErr=True)参数
| 名称 | 类型 | 描述 |
|---|---|---|
| deptids | 字符型/数组：列表型 | 部门id（id在通讯录"部门设置"中查看） [字符型]：查询指定的部门信息 [列表型]：查询多个部门的信息，以二维数据的方式返回 |
| bErr | 逻辑型 | 在deptids为数组的情况下才生效，True表示遇到错误立即返回，False表示继续执行（此时返回值里的错误deptid将保留空数组） |
返回值
| 类型 | 描述 |
|---|---|
| 数组：字典型 | 获取成功返回指定的部门详细信息，获取失败返回空数组 |
- 数据格式：
- deptids为[字符型]时的返回结果：
{ "istop":True, "id":"51a46202e6c4839854bcb243", "number":2, "manager":{}, "parent":{}, "name":"部门1" } - deptids为[数组型]时的返回结果：
{ "5c10d76b4e38a45800266":{ "manager":[ "547a48c50eccde5ac8c0883b" ], "istop":False, "name":"部门2", "id":"5c10d76b4e38a45800266", "number":4, "parent":{ "istop":True, "manager":[ "5b68110f7cf2885b5e19e66a", "547a48c50eccde5ac8c0883b" ], "id":"51a46202e6c4839854bcb243", "number":1, "name":"abc" } }, "51a46202e6c4839854bcb243":{ "manager":{}, "istop":True, "name":"部门1", "id":"51a46202e6c4839854bcb243", "number":3, "parent":{} } }
| 名称 | 描述 |
|---|---|
| id | 部门id，可以在表单系统中查询 |
| number | 部门编号 |
| name | 部门名称 |
| istop | True表示为顶级部门 |
| parent | 部门的父级部门信息 |
| manager | 部门的主管信息（可能有多个主管） |
备注
可能出现的错误信息，执行 getlasterror 函数获取具体详细信息：
- 错误编码=getlasterror()
- 错误信息=getlasterror(1)
| 错误编码 | 错误信息 |
|---|---|
| 1407 | api执行频率超出限制 |
| 1400 | 参数类型不正确 |
| 1302 | 赋值失败 |
| 1506 | 连接数据库失败 |
| 1527 | 部门不存在 |
| 1526 | 部门或成员id不能为空 |
| 1533 | 数据库执行失败 |
其他：
- 所有表单api调用频率限制为1000次/分钟。
示例
def test():
ret=form.getdeptinfo(["5ba0a4cefe5cfd97ba12a4c2","569b845d6fa928d1de40aeb4"])
print(ret)
ret=form.getdeptinfo("5ba0a4cefe5cfd97ba12a4c2")
print(ret)演示示例
- 暂无
安装包下载
- 暂无
相关视频
- 暂无