form.getdeptall
功能说明
描述
获取指定部门中所包括的所有子级部门列表。（包含部门信息，部门成员，子部门，子部门成员，以及子子部门，子子部门成员等所有的信息）
函数原型
form.getdeptall(deptid="")复制
参数
| 名称 | 类型 | 描述 |
|---|---|---|
| deptid | 字符型 | 需要获取信息的部门id，默认为空表示获取所有信息 |
返回值
| 类型 | 描述 |
|---|---|
| 数组：列表型 | 获取成功返回多维数组，获取失败则返回空数组 |
- 数据格式：
[{"remark":"","category":0,"innerid":"bb1","type":"user","ismanager":True,"name":"bobo1","id":"5b68110f7cf2885b5e19e66a","title":"教授",'maindept': {'id': '5e8591f321dd595f7427f8c0','name': '人事部'},"jobtitle": [{"deptid": "5e8591f321dd595f7427f8c0","deptname": "人事部","title": "职称名称"}]},{"remark":"","category":0,"innerid":"bb2","type":"user","ismanager":True,"name":"bobo2","id":"547a48c50eccde5ac8c0883b","title":"教授",'maindept': {'id': '5e8591f321dd595f7427f8c0','name': '人事部'},"jobtitle": [{"deptid": "5e8591f321dd595f7427f8c0","deptname": "人事部","title": "职称名称"}]},{"manager":["5b68110f7cf2885b5e19e66a","547a48c50eccde5ac8c0883b"],"child":[{"remark":"","category":0,"innerid":"bb1","type":"user","ismanager":True,"name":"bobo1","id":"5b68110f7cf2885b5e19e66a","title":"教授",'maindept': {'id': '5e8591f321dd595f7427f8c0','name': '人事部'},"jobtitle": [{"deptid": "5e8591f321dd595f7427f8c0","deptname": "人事部","title": "职称名称"}]},{"remark":"","category":0,"innerid":"bb2","type":"user","ismanager":True,"name":"bobo2","id":"547a48c50eccde5ac8c0883b","title":"教授",'maindept': {'id': '5e8591f321dd595f7427f8c0','name': '人事部'},"jobtitle": [{"deptid": "5e8591f321dd595f7427f8c0","deptname": "人事部","title": "职称名称"}]},{"manager":["547a48c50eccde5ac8c0883b","5b68110f7cf2885b5e19e66a"],"child":[{"remark":"","category":0,"innerid":"bb1","type":"user","ismanager":True,"name":"bobo1","id":"547a48c50eccde5ac8c0883b","title":"教授",'maindept': {'id': '5e8591f321dd595f7427f8c0','name': '人事部'},"jobtitle": [{"deptid": "5e8591f321dd595f7427f8c0","deptname": "人事部","title": "职称名称"}]},{"remark":"","category":0,"innerid":"bb2","type":"user","ismanager":True,"name":"bobo2","id":"5b68110f7cf2885b5e19e66a","title":"教授",'maindept': {'id': '5e8591f321dd595f7427f8c0','name': '人事部'},"jobtitle": [{"deptid": "5e8591f321dd595f7427f8c0","deptname": "人事部","title": "职称名称"}]}],"type":"dept","id":"5b99d5209064c4007a70d7f1","number":2"name":"子部门1"}],"type":"dept","id":"569b845d6fa928d1de40aeb4","number":1"corpid":"547a48acf0d9f61b4eb1cb61","name":"我的团队"}]复制
| 名称 | 描述 |
|---|---|
| id | 成员或部门的24位字符串id，可以在表单系统中查询 |
| number | 部门编号 |
| corpid | 团队id，只有最顶级部门才有此信息 |
| name | 成员或部门的名称 |
| category | 用户状态（-1表示被邀请的人尚未同意其邀请，同意后自动变为2，0表示团队创建者，2表示普通成员，-2表示已离职） |
| title | 用户的职称（旧职称字段已废弃） |
| jobtitle | 职称信息 |
| type | 当前元素是部门还是成员（user：成员，dept：部门） |
| remark | 成员的备注信息 |
| ismanager | True表示是当前的部门主管，False表示不是 |
| innerid | 企业内用户id |
| child | 子部门信息（包含了所有成员和部门） |
| manager | 部门的主管信息（可能有多个主管） |
| maindept | 主部门信息 |
备注
可能出现的错误信息，执行 getlasterror 函数获取具体详细信息：
- 错误编码=getlasterror()
- 错误信息=getlasterror(1)
| 错误编码 | 错误信息 |
|---|---|
| 1407 | api执行频率超出限制 |
| 1400 | 参数类型不正确 |
| 1302 | 赋值失败 |
| 1506 | 连接数据库失败 |
| 1527 | 部门不存在 |
| 1533 | 数据库执行失败 |
其他：
- 所有表单api调用频率限制为1000次/分钟。
示例
def test():ret=form.getdeptall("5c3baf51271ad97c11b6d809")print(ret)复制
演示示例
- 暂无
安装包下载
- 暂无
相关视频
- 暂无
目录