> For the complete documentation index, see [llms.txt](https://o2oa.gitbook.io/course/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://o2oa.gitbook.io/course/ping-tai-shi-shi/zu-zhi-guan-li/untitled/qun-zu-xin-xi.md).

# 群组信息

### **1. 获取群组的对象数组：getGroup**

| **函数说明**                                                                                                        | var groupObj =  this.org.getGroup(name); |
| --------------------------------------------------------------------------------------------------------------- | ---------------------------------------- |
| **参数说明**                                                                                                        | name : (string)必选，群组名                    |
| **返回值**                                                                                                         | groupArray: 返回群组的对象数组                    |
| **脚本示例**                                                                                                        |                                          |
| <p>var name = "人力组";</p><p>var groupObj = this.org.getGroup(name);</p><p>return groupObj.distinguishedName;</p> |                                          |

### **２. 查询下级群组列表：listSubGroup**

| **函数说明**                                                                                                                                                                                       | var groupObj =  this.org.listSubGroup (name, \[true\|false]);              |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------- |
| **参数说明**                                                                                                                                                                                       | <p>name : （string）必选，群组名</p><p>nested  布尔  true嵌套下级；false直接下级；默认false；</p> |
| **返回值**                                                                                                                                                                                        | groupArray: 返回群组的对象数组                                                      |
| **脚本示例**                                                                                                                                                                                       |                                                                            |
| <p>var name = "人力组";</p><p>var groupObj= this.org. listSubGroup (name, true);</p><p>if(groupObj.length<1){</p><p>   return "";</p><p>} else {</p><p>   return groupObj\[0].unique;</p><p>}</p> |                                                                            |

### &#xD;**３. 查询上级群组列表：listSupGroup**

| **函数说明**                                         | var groupObj =  this.org.listSupGroup(name, \[true\|false]);               |
| ------------------------------------------------ | -------------------------------------------------------------------------- |
| **参数说明**                                         | <p>name : （string）必选，群组名</p><p>nested  布尔  true嵌套上级；false直接上级；默认false；</p> |
| **返回值**                                          | groupArray: 返回群组的对象数组                                                      |
| **脚本示例**                                         |                                                                            |
| var groupObj = this.org.listSupGroup("人力组",true) |                                                                            |

&#xFF14;**. 查询人员所在群组（嵌套）：listGroupWithPerson**

| **函数说明**                                                 | var groupObj =  this.org.this.org.listGroupWithPerson(name, \[true\|false]); |
| -------------------------------------------------------- | ---------------------------------------------------------------------------- |
| **参数说明**                                                 | <p>name : （string）必选，群组名</p><p>nested  布尔  true嵌套下级；false直接下级；默认false；</p>   |
| **返回值**                                                  | groupArray: 返回群组的对象数组                                                        |
| **脚本示例**                                                 |                                                                              |
| var groupObj = this.org.listGroupWithPerson ("人力组",true) |                                                                              |

### **５. 群组是否拥有角色：groupHasRole**

| **函数说明**                                  | var groupObj = this.org.groupHasRole (name, role); |
| ----------------------------------------- | -------------------------------------------------- |
| **参数说明**                                  | <p>name : （string）必选，群组名</p><p>role需要查询的角色名称</p>   |
| **返回值**                                   | true, false                                        |
| **脚本示例**                                  |                                                    |
| this.org.groupHasRole ("人力组", "Manager"); |                                                    |