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)演示示例
- 暂无
安装包下载
- 暂无
相关视频
- 暂无