O2OA教程-安装管理及配置-常用脚本

431 阅读6分钟

一、人员信息

1. 获取人员信息:getPerson

函数说明 var personObj = this.org.getPerson(name)
参数说明 name : (string)必选,人员的distinguishedName | id | unique |name
返回值 personObj 返回人员的对象
脚本示例
var personObj = this.org.getPerson("林玲@linling@P");
return personObj.mobile;

2. 查询下级人员:listSubPerson

函数说明 var person_array = this.org.listSubPerson (name,[true|false])
参数说明 name : (string)必选,人员的distinguishedName | id | unique | name nested 布尔 true嵌套下级;false直接下级;默认false;
返回值 person_array 返回人员的对象数组
脚本示例
var person_array = this.org.listSubPerson ("林林@linlin@P");

3. 查询上级人员:listSupPerson

函数说明 var person_array = this.org.listSubPerson (name,[true|false])
参数说明 name : (string)必选,人员的distinguishedName | id | unique | name nested 布尔 true嵌套上级;false直接上级;默认false;
返回值 person_array 返回人员的对象数组
脚本示例
var person_array = this.org.listSupPerson("林林@linlin@P");

4. 获取群组的所有人员:listPersonWithGroup

函数说明 var person_array = this.org.listPersonWithGroup(name);
参数说明 name : (string)必选,群组名
返回值 person_array 返回人员的对象数组
脚本示例
var person_array = this.org.listPersonWithGroup ("人力组");

5. 获取角色的所有人员:listPersonWithRole

函数说明 var person_array = this.org.listPersonWithRole(name);
参数说明 name : (string)必选,角色名
返回值 person_array 返回人员的对象数组
脚本示例
var person_array = this.org.listPersonWithRole("Manager");

6.获取指定身份的所有人员:listPersonWithIdentity

函数说明 var person_array = this.org.listPersonWithIdentity(name);
参数说明 name : (string)必选,身份唯一编码
返回值 person_array 返回人员的对象数组
脚本示例
var person_array = this.org.listPersonWithIdentity("李杰@114849cc-eb77-4217-bd15-00b449acbdbb@I");

7. 查询组织成员的人员:listPersonWithUnit

函数说明 var person_array = this.org.listPersonWithUnit (name,[true|false]);
参数说明 name : (string)必选,组织的DN或者唯一编码 nested 布尔 true嵌套的所有成员;false直接成员;默认false;
返回值 person_array 返回人员的对象数组
脚本示例
var name ="内控管理部@2462e85b-ebad-4cfe-b264-866e80c349bf@U";
var person_array = this.org.listPersonWithUnit(name,true);

二、组织信息

1. 查询组织的下级:listSubUnit

函数说明 var unitList=this.org.listSubUnit (name,[true|false]);
参数说明 name : (String|Array)必选,组织唯一编码 nested 布尔 true嵌套下级;false直接下级;默认false
返回值 unitArray 返回组织的对象数组
脚本示例
var dn = "人社事业部@e0c84b01-ef35-482f-946b-93e040848af5@U";
var unitArray = this.org.listSubUnit(dn);
return unitArray.length;

2. 查询组织的上级:listSupUnit

函数说明 var unitList=this.org.listSupUnit(name,[true|false]);
参数说明 name : (String|Array)必选,组织唯一编码 nested 布尔 true嵌套上级;false直接上级;默认false
返回值 unitArray 返回组织的对象数组
脚本示例
var dn = "人社事业部@e0c84b01-ef35-482f-946b-93e040848af5@U";
var unitArray = this.org.listSupUnit(dn);
return unitArray.length;

3.根据个人身份获取组织:getUnitByIdentity

函数说明 var unitList=this.org.getUnitByIdentity (name,flag);
参数说明 name : (String|Array)必选,个人唯一编码
flag:
数字 -- 表示获取第几层的组织
字符串 -- 表示获取指定类型的组织
空字符串 -- 表示获取直接所在的组织
返回值 unitArray 返回组织的对象数组
脚本示例
var dn = "李义@5d10c11e-54cd-458d-9c34-5ba1a371a4d9@I";
var unitArray = this.org.getUnitByIdentity(dn, "一级部门");
return unitArray.name;

4.列出身份所在组织的所有上级组织:listAllSupUnitWithIdentity

函数说明 var unitList= this.org.listAllSupUnitWithIdentity (name);
参数说明 name : (String|Array)必选,身份唯一编码
返回值 unitArray 返回组织的对象数组
脚本示例
var dn = "李义@5d10c11e-54cd-458d-9c34-5ba1a371a4d9@I";
var unitArray = this.org.listAllSupUnitWithIdentity (dn);
return unitArray.length;

5. 获取人员所在的所有组织:listUnitWithPerson

函数说明 var unitList= this.org.listUnitWithPerson (name);
参数说明 name : (String|Array)必选,身份唯一编码
返回值 unitArray 返回组织的对象数组
脚本示例
var dn = "李义@5d10c11e-54cd-458d-9c34-5ba1a371a4d9@I";
var unitArray = this.org.listAllSupUnitWithIdentity (dn);
return unitArray.length;

6.列出个人所在组织的所有上级组织:listAllSupUnitWithPerson

函数说明 var unitList= this.org.listAllSupUnitWithPerson (name);
参数说明 name : (String Array)必选,个人唯一编码
返回值 unitArray 返回组织的对象数组
脚本示例
var dn = "李义@5d10c11e-54cd-458d-9c34-5ba1a371a4d9@I";
var unitArray = this.org.listAllSupUnitWithPerson (dn);
return unitArray.length;

7.根据组织属性获取所有符合的组织:listUnitWithAttribute

函数说明 var unitList= this.org.listUnitWithAttribute(name,attribute);
参数说明 name : (String|Array)属性名 attribute 属性值
返回值 unitArray 返回组织的对象数组
脚本示例
var name= ""; var attribute = "";
var unitArray = this.org.listUnitWithAttribute (name,attribute );
return unitArray.length;

8. 根据组织职务获取所有符合的组织:listUnitWithDuty

函数说明 var unitList= this.org. listUnitWithDuty (name,id);
参数说明 name : (String|Array)组织职务名 id 身份id(也可以是身份对象)
返回值 unitArray 返回组织的对象数组
脚本示例
var name = "总经理";
var id = "身份id";
var unitArray = this.org.listUnitWithDuty (name,id);
return unitArray.length;

三、群主信息

1. 获取群组的对象数组:getGroup

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

2. 查询下级群组列表:listSubGroup

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

3. 查询上级群组列表:listSupGroup

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

4. 查询人员所在群组(嵌套):listGroupWithPerson

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

5. 群组是否拥有角色:groupHasRole

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

四、角色信息

1. 获取角色信息:getRole

函数说明 var roleObj= this.org.getRole(name);
参数说明 name : (string)必选,角色名
返回值 roleObj: 返回角色的对象数组。
脚本示例
var name = "Manager";
var roleObj = this.org.getRole (name);
return roleObj.distinguishedName;

2. 人员所有角色(嵌套):listRoleWithPerson

函数说明 var roleObj= this.org.listRoleWithPerson (name);
参数说明 name : (string)必选,个人
返回值 roleObj: 返回角色的对象数组。
脚本示例
var roleObj = this.org.listRoleWithPerson (“李杰@lijie@P”);

3. 人员是否拥有角色:personHasRole

函数说明 var roleObj= this.org.personHasRole(name,role)
参数说明 name : (string)必选,人员的distinguishedName | id | unique | nameRole:角色名
返回值 true, false
脚本示例
var hasRole = this.org. personHasRole("林林@linlin@P","Manager");
return hasRole;