您可以通过this.org获取组织中的人员、人员属性、组织、组织属性、身份、群组和角色。后端调用都是同步的。
methods
static
getgroup(name) → {groupdata|array.}
根据群组标识获取对应的群组对象或数组：group对象或数组
syntax
//返回群组，单个是object，多个是array。
var grouplist = this.org.getgroup( name );parameters
returns
-
groupdataarray.返回群组，单个是object，多个是array。
{
"matchkey": " ", //匹配字段
"id": " ", //群组id
"name": "工作汇报读者", //群组名称
"unique": "reportreader", //群组标识
"description": "可查看所有部门所有状态的工作汇报", //说明
"distinguishedname": "工作汇报读者@reportreader@g", //识别名
"ordernumber": 13699599, //排序号
"personlist": [
"张三@zhangsan@p"
"李四@lisi@p"
], //个人成员
"grouplist": [
"所有部门领导@alldepartleader@g"
"所有部门汇报管理员@alldepartreportmanager@g"
], //群组成员
"unitlist": [
"开发部@kfb@u"
], //组织成员
"identitylist": [
"王五@kfb_wangwu@i"
"赵六@kfb_zhaoliu@i"
], //身份成员
"subdirectgroupcount": 1, //直接下级组织数量
"subdirectpersoncount": 1, //直接下级用户数量
"subdirectidentitycount": 1, //直接下级身份数量
"subdirectorgcount": 1 //直接下级组织数量
}source
static
listsubgroup(name, nestedopt) → {array.}
根据群组标识获取下级群组的对象数组：group对象数组。
syntax
//返回嵌套下级群组数组。
var grouplist = this.org.listsubgroup( name, true );parameters
-
name
groupflag|array.<groupflag>群组的distinguishedname、name、id、unique属性值，群组对象，或上述属性值和对象的数组。
-
nested
boolean
true嵌套的所有下级群组；false直接下级群组；默认false。
returns
-
array.返回群组数组。
{
"matchkey": " ", //匹配字段
"id": " ", //群组id
"name": "工作汇报读者", //群组名称
"unique": "reportreader", //群组标识
"description": "可查看所有部门所有状态的工作汇报", //说明
"distinguishedname": "工作汇报读者@reportreader@g", //识别名
"ordernumber": 13699599, //排序号
"personlist": [
"张三@zhangsan@p"
"李四@lisi@p"
], //个人成员
"grouplist": [
"所有部门领导@alldepartleader@g"
"所有部门汇报管理员@alldepartreportmanager@g"
], //群组成员
"unitlist": [
"开发部@kfb@u"
], //组织成员
"identitylist": [
"王五@kfb_wangwu@i"
"赵六@kfb_zhaoliu@i"
], //身份成员
"subdirectgroupcount": 1, //直接下级组织数量
"subdirectpersoncount": 1, //直接下级用户数量
"subdirectidentitycount": 1, //直接下级身份数量
"subdirectorgcount": 1 //直接下级组织数量
}source
static
listsupgroup(name, nestedopt) → {array.}
根据群组标识获取上级群组的对象数组：group对象数组。
syntax
//返回嵌套上级群组数组。
var grouplist = this.org.listsupgroup( name, true );parameters
-
name
groupflag|array.<groupflag>群组的distinguishedname、name、id、unique属性值，群组对象，或上述属性值和对象的数组。
-
nested
boolean
true嵌套的所有上级群组；false直接上级群组；默认false。
returns
-
array.返回群组数组。
{
"matchkey": " ", //匹配字段
"id": " ", //群组id
"name": "工作汇报读者", //群组名称
"unique": "reportreader", //群组标识
"description": "可查看所有部门所有状态的工作汇报", //说明
"distinguishedname": "工作汇报读者@reportreader@g", //识别名
"ordernumber": 13699599, //排序号
"personlist": [
"张三@zhangsan@p"
"李四@lisi@p"
], //个人成员
"grouplist": [
"所有部门领导@alldepartleader@g"
"所有部门汇报管理员@alldepartreportmanager@g"
], //群组成员
"unitlist": [
"开发部@kfb@u"
], //组织成员
"identitylist": [
"王五@kfb_wangwu@i"
"赵六@kfb_zhaoliu@i"
], //身份成员
"subdirectgroupcount": 1, //直接下级组织数量
"subdirectpersoncount": 1, //直接下级用户数量
"subdirectidentitycount": 1, //直接下级身份数量
"subdirectorgcount": 1 //直接下级组织数量
}source
static
listgroupwithperson(name) → {array.}
根据人员标识获取所有的群组对象数组。如果群组具有群组（group）成员，且群组成员中包含该人员，那么该群组也被返回。
syntax
//返回群组数组。
var grouplist = this.org.listgroupwithperson( name );parameters
-
name
personflag|array.<personflag>人员的distinguishedname、id、unique属性值，人员对象，或上述属性值和对象的数组。
returns
-
array.返回群组对象数组。
{
"matchkey": " ", //匹配字段
"id": " ", //群组id
"name": "工作汇报读者", //群组名称
"unique": "reportreader", //群组标识
"description": "可查看所有部门所有状态的工作汇报", //说明
"distinguishedname": "工作汇报读者@reportreader@g", //识别名
"ordernumber": 13699599, //排序号
"personlist": [
"张三@zhangsan@p"
"李四@lisi@p"
], //个人成员
"grouplist": [
"所有部门领导@alldepartleader@g"
"所有部门汇报管理员@alldepartreportmanager@g"
], //群组成员
"unitlist": [
"开发部@kfb@u"
], //组织成员
"identitylist": [
"王五@kfb_wangwu@i"
"赵六@kfb_zhaoliu@i"
], //身份成员
"subdirectgroupcount": 1, //直接下级组织数量
"subdirectpersoncount": 1, //直接下级用户数量
"subdirectidentitycount": 1, //直接下级身份数量
"subdirectorgcount": 1 //直接下级组织数量
}source
static
grouphasrole(name, rolelist) → {boolean}
群组是否拥有角色。
syntax
//返回判断结果。
var grouplist = this.org.grouphasrole( name, rolelist );parameters
-
name
groupflag群组的distinguishedname、name、id、unique属性值，群组对象。
-
rolelist
roleflag|array.<roleflag>角色的distinguishedname、name、id、unique属性值，角色对象；或上述属性值和对象的数组。
returns
-
boolean如果群组拥有角色返回true, 否则返回false。
source
static
getrole(name) → {roledata|array.}
根据角色标识获取对应的角色对象或数组。
syntax
//返回角色，单个为对象，多个为数组。
var rolelist = this.org.getrole( name );parameters
returns
-
roledataarray.返回角色，单个为object，多个为array。
{
"name": "manager", //角色名称
"unique": "managersystemrole", //唯一标识
"description": " ", //说明
"distinguishedname": "manager@managersystemrole@r", //识别名
"ordernumber": 7897556, //排序号
"personlist": [
"张三@zhangsan@p"
"李四@lisi@p"
], //成员个人
"grouplist": [
"测试群组@ceshizu@g"
] //成员群组
}source
static
listrolewithperson(name) → {array.}
根据人员标识获取所有的角色对象数组。如果角色具有群组（group）成员，且群组中包含该人员，那么该角色也被返回。
syntax
//返回角色数组。
var rolelist = this.org.listrolewithperson( name );parameters
-
name
personflag|array.<personflag>人员的distinguishedname、id、unique属性值，人员对象，或上述属性值和对象的数组。
returns
-
array.返回角色对象数组。
{
"name": "manager", //角色名称
"unique": "managersystemrole", //唯一标识
"description": " ", //说明
"distinguishedname": "manager@managersystemrole@r", //识别名
"ordernumber": 7897556, //排序号
"personlist": [
"张三@zhangsan@p"
"李四@lisi@p"
], //成员个人
"grouplist": [
"测试群组@ceshizu@g"
] //成员群组
}source
static
personhasrole(name, rolelist) → {boolean}
人员是否拥有角色。
syntax
//返回判断结果。
var grouplist = this.org.personhasrole( name, rolelist );parameters
-
name
personflag人员的distinguishedname、id、unique属性值，人员对象。
-
rolelist
roleflag|array.<roleflag>角色的distinguishedname、name、id、unique属性值，角色对象；或上述属性值和对象的数组。
returns
-
boolean如果人员拥有角色返回true, 否则返回false。
source
static
getpersondata(name) → {persondata}
根据人员标识获取对应的人员对象,附带身份,身份所在的组织,个人所在群组,个人拥有角色.
syntax
//返回人员对象。
var person = this.org.getpersondata( name );parameters
-
name
string人员的distinguishedname、id、unique属性值，人员名称。
returns
-
persondata返回人员对象。
{
"woidentitylist": [ //身份对象
{
"wounit": { //身份所在组织
"id": "e56ef746-a923-494b-bdfe-81ab65c523da",
"name": "综合部",
"unique": "zhb",
"distinguishedname": "综合部@zhb@u",
"typelist": [
"department"
],
"pinyin": "zonghebu",
"pinyininitial": "zhb",
"description": "",
"shortname": "da",
"level": 2,
"levelname": "演示公司/综合部",
"levelordernumber": "0053522524/0053522721",
"superior": "0f98a161-df27-45f0-833b-e29105ba82f7",
"ordernumber": 53522721,
"controllerlist": [
"5a272f71-02b3-4abb-a0e4-f11e23d9b824"
],
"createtime": "2019-09-12 11:25:21",
"updatetime": "2022-08-01 15:36:39"
},
"wounitdutylist": [ //身份拥有的职务
{
"wounit": { //该职务绑定的组织
"id": "e56ef746-a923-494b-bdfe-81ab65c523da",
"name": "综合部",
"unique": "zhb",
"distinguishedname": "综合部@zhb@u",
"typelist": [
"department"
],
"pinyin": "zonghebu",
"pinyininitial": "zhb",
"description": "",
"shortname": "da",
"level": 2,
"levelname": "演示公司/综合部",
"levelordernumber": "0053522524/0053522721",
"superior": "0f98a161-df27-45f0-833b-e29105ba82f7",
"ordernumber": 53522721,
"controllerlist": [
"5a272f71-02b3-4abb-a0e4-f11e23d9b824"
],
"createtime": "2019-09-12 11:25:21",
"updatetime": "2022-08-01 15:36:39"
},
"id": "d14dbd1a-1db8-492b-9cf3-f1a2117f815d",
"pinyin": "bumenlingdao",
"pinyininitial": "bmld",
"description": "",
"name": "部门领导",
"unique": "d14dbd1a-1db8-492b-9cf3-f1a2117f815d",
"distinguishedname": "部门领导@d14dbd1a-1db8-492b-9cf3-f1a2117f815d@ud",
"unit": "e56ef746-a923-494b-bdfe-81ab65c523da",
"ordernumber": 173379080,
"identitylist": [
"b7c7db79-0241-4989-b31a-fbba5c17ada2"
],
"createtime": "2023-06-30 16:51:21",
"updatetime": "2023-06-30 16:51:30"
}
],
"id": "b7c7db79-0241-4989-b31a-fbba5c17ada2",
"pinyin": "zhangsan",
"pinyininitial": "zs",
"description": "",
"name": "张三",
"unique": "zhb_zhangsan",
"distinguishedname": "张三@zhb_zhangsan@i",
"person": "97941ea3-e3eb-4db7-aaf6-1263b048d909",
"unit": "e56ef746-a923-494b-bdfe-81ab65c523da",
"unitname": "综合部",
"unitlevel": 2,
"unitlevelname": "演示公司/综合部",
"ordernumber": 144603421,
"major": true, //是否为主身份
"createtime": "2022-08-01 15:37:01",
"updatetime": "2022-08-01 15:37:01"
}
], //身份对象
"worolelist": [
{
"id": "4de87a00-66a2-4c6a-94d7-4a2afdeb9e42",
"pinyin": "bssmanager",
"pinyininitial": "bssmanager",
"name": "bssmanager",
"unique": "bssmanagersystemrole",
"distinguishedname": "bssmanager@bssmanagersystemrole@r",
"ordernumber": 15329841,
"personlist": [
"97941ea3-e3eb-4db7-aaf6-1263b048d909"
],
"grouplist": [],
"createtime": "2018-06-27 10:17:21",
"updatetime": "2023-06-30 16:52:00"
}
], //角色对象
"wogrouplist": [
{
"id": "f2637ec1-d3be-4076-8dde-df88892cb4da",
"pinyin": "yunweiqunzu",
"pinyininitial": "ywqz",
"description": "",
"name": "运维群组",
"unique": "f2637ec1-d3be-4076-8dde-df88892cb4da",
"distinguishedname": "运维群组@f2637ec1-d3be-4076-8dde-df88892cb4da@g",
"ordernumber": 97928948,
"personlist": [
"3455b82a-399c-4ee4-b9b9-e70ae40fbaf1",
"5d2699d4-e411-4027-a87e-435371823d5d",
"97941ea3-e3eb-4db7-aaf6-1263b048d909"
],
"grouplist": [],
"unitlist": [],
"identitylist": [],
"createtime": "2021-02-07 10:29:09",
"updatetime": "2023-06-30 16:52:19"
}
], //群组对象
"wopersonattributelist": [
{
"id": "acc8a5ec-8e76-4a3a-9a0e-f8d4d9001c42",
"pinyin": "shuxingyi",
"pinyininitial": "sxy",
"description": "属性描述",
"name": "属性一",
"unique": "acc8a5ec-8e76-4a3a-9a0e-f8d4d9001c42",
"distinguishedname": "属性一@acc8a5ec-8e76-4a3a-9a0e-f8d4d9001c42@pa",
"person": "97941ea3-e3eb-4db7-aaf6-1263b048d909",
"ordernumber": 24943622,
"attributelist": [
"1"
],
"createtime": "2018-10-16 16:47:02",
"updatetime": "2023-06-30 16:50:43"
}
], //个人属性对象
"id": "97941ea3-e3eb-4db7-aaf6-1263b048d909", //数据库主键,自动生成.
"gendertype": "m", //性别.男:m,女:f,未知:d
"iconmdpi": " ", //icon base64编码后的文本（中等尺寸图像）.
"iconldpi": " ", //icon base64编码后的文本（小尺寸图像）.
"signature": " ", //个性签名.
"pinyin": "zhangsan", //name拼音,自动生成
"pinyininitial": "zs", //name拼音首字母,自动生成
"description": " ", //描述.
"name": "张三", //名称,可重名.
"nickname": " ", //昵称.
"employee": "1111", //工号,不可重复.
"unique": "zhangsan", //唯一标识,不可重复,为空则使用自动填充值
"distinguishedname": "张三@zhangsan@p", //识别名,自动填充,@p结尾.
"ordernumber": 14214946, //排序号,升序排列,为空在最后
"controllerlist": [
"3455b82a-399c-4ee4-b9b9-e70ae40fbaf1"
"8e527447-635c-4775-8107-239096fc3ec4"
], //个人管理者.默认为创建者。
"superior": " ", //汇报对象.
"passwordexpiredtime": "2023-11-21 15:02:35", //用户密码到期时间.
"changepasswordtime": "2023-04-04", //用户密码最后修改时间.
"lastlogintime": "2023-04-07", //最后登录时间.
"lastloginaddress": " ", //最后登录地址.
"lastloginclient": " ", //最后登录客户端类型,web,android或者ios.
"ipaddress": " ", //允许登录的ip.
"mail": " ", //邮件地址.
"weixin": " ", //微信号.
"qq": " ", //qq号.
"mobile": "13812345678", //必填,手机号.
"hiddenmobile": true, //是否隐藏手机号.
"officephone": " ", //办公电话.
"boarddate": "2023-11-21 15:02:35", //入职时间.
"birthday": "2023-11-21 15:02:35", //生日.
"age": 1, //年龄
"dingdingid": " ", //钉钉人员id.
"dingdinghash": " ", //钉钉人员哈希特征.
"welinkid": " ", //welikn人员id.
"welinkhash": " ", //welink人员哈希特征.
"zhengwudingdingid": " ", //政务钉钉人员id.
"andfxid": " ", //移动办公人员id.
"zhengwudingdinghash": " ", //政务钉钉人员哈希特征.
"qiyeweixinid": " ", //企业微信人员id.
"qiyeweixinhash": " ", //企业微信人员哈希特征.
"andfxhash": " ", //移动办公人员哈希特征.
"mpwxopenid": " ", //微信公众号人员openid.
"open1id": " ", //oauth登录id1.
"open2id": " ", //oauth登录id2.
"open3id": " ", //oauth登录id3.
"open4id": " ", //oauth登录id4.
"open5id": " ", //oauth登录id5.
"failuretime": "2022-12-15 14:10:23", //登录失败记录时间.
"failurecount": 2, //登录失败次数
"language": " ", //国际化语言,如：zh-cn,zh,en,zh_tw等.
"topunitlist": [
" "
], //所属顶层组织.
"subjectsecurityclearance": 1, //主体秘级标识.
"createtime": "2018-06-14 12:35:46", //创建时间,自动生成,索引创建在约束中.
"updatetime": "2023-04-07 17:56:32" //修改时间,自动生成,索引创建在约束中.
}source
static
getperson(name, findcnopt) → {persondata|array.}
根据人员标识获取对应的人员对象或数组：person对象或数组
syntax
//返回人员，单个是对象，多个是数组。
var personlist = this.org.getperson( name );parameters
-
name
personflag|array.<personflag>人员的distinguishedname、id、unique属性值，人员对象，或上述属性值和对象的数组。
-
findcn
boolean
是否需要额外查找中文名称（如张三），默认false。如果为true，除匹配unique和distingiushedname外，还会在名称的第一段中查找所有匹配到的人（精确匹配）。
returns
-
persondataarray.返回人员，单个是object，多个是array。
{
"matchkey": " ", //匹配字段
"id": " ", //数据库主键
"name": "李四", //个人名称
"nickname": " ", //昵称
"gendertype": "m", //性别,m:男,f:女,d:未知
"signature": " ", //签名
"description": " ", //说明
"employee": "1111", //员工号
"unique": "lisi", //唯一标识
"distinguishedname": "李四@lisi@p", //识别名
"ordernumber": 14214946, //排序号
"superior": " ", //主管
"mail": " ", //邮件地址
"weixin": " ", //微信号
"qq": " ", //qq号
"mobile": "85252281460", //手机号
"officephone": " ", //办公电话
"boarddate": "2023-11-21 15:02:35", //入职时间
"birthday": "2023-11-21 15:02:35", //生日
"age": 1, //年龄
"qiyeweixinid": " ", //企业微信id
"dingdingid": " ", //钉钉id
"zhengwudingdingid": " ", //政务钉钉id
"welinkid": " ", //华为welink id
"subjectsecurityclearance": 1 //主体密级标识.
}source
static
listsubperson(name, nestedopt) → {array.}
根据人员标识获取下级人员的对象数组：person对象数组。该上下级关系被人员的汇报对象值（superior）决定。
syntax
//返回嵌套下级人员数组。
var personlist = this.org.listsubperson( name, true );parameters
-
name
personflag|array.<personflag>人员的distinguishedname、id、unique属性值，人员对象，或上述属性值和对象的数组。
-
nested
boolean
true嵌套的所有下级人员；false直接下级人员；默认false。
returns
-
array.返回人员数组。
{
"matchkey": " ", //匹配字段
"id": " ", //数据库主键
"name": "李四", //个人名称
"nickname": " ", //昵称
"gendertype": "m", //性别,m:男,f:女,d:未知
"signature": " ", //签名
"description": " ", //说明
"employee": "1111", //员工号
"unique": "lisi", //唯一标识
"distinguishedname": "李四@lisi@p", //识别名
"ordernumber": 14214946, //排序号
"superior": " ", //主管
"mail": " ", //邮件地址
"weixin": " ", //微信号
"qq": " ", //qq号
"mobile": "85252281460", //手机号
"officephone": " ", //办公电话
"boarddate": "2023-11-21 15:02:35", //入职时间
"birthday": "2023-11-21 15:02:35", //生日
"age": 1, //年龄
"qiyeweixinid": " ", //企业微信id
"dingdingid": " ", //钉钉id
"zhengwudingdingid": " ", //政务钉钉id
"welinkid": " ", //华为welink id
"subjectsecurityclearance": 1 //主体密级标识.
}source
static
listsupperson(name, nestedopt) → {array.}
根据人员标识获取上级人员的对象数组：person对象数组。该上下级关系被人员的汇报对象值（superior）决定。
syntax
//返回嵌套上级人员数组。
var personlist = this.org.listsupperson( name, true );parameters
-
name
personflag|array.<personflag>人员的distinguishedname、id、unique属性值，人员对象，或上述属性值和对象的数组。
-
nested
boolean
true嵌套的所有上级人员；false直接上级人员；默认false。
returns
-
array.返回人员数组。
{
"matchkey": " ", //匹配字段
"id": " ", //数据库主键
"name": "李四", //个人名称
"nickname": " ", //昵称
"gendertype": "m", //性别,m:男,f:女,d:未知
"signature": " ", //签名
"description": " ", //说明
"employee": "1111", //员工号
"unique": "lisi", //唯一标识
"distinguishedname": "李四@lisi@p", //识别名
"ordernumber": 14214946, //排序号
"superior": " ", //主管
"mail": " ", //邮件地址
"weixin": " ", //微信号
"qq": " ", //qq号
"mobile": "85252281460", //手机号
"officephone": " ", //办公电话
"boarddate": "2023-11-21 15:02:35", //入职时间
"birthday": "2023-11-21 15:02:35", //生日
"age": 1, //年龄
"qiyeweixinid": " ", //企业微信id
"dingdingid": " ", //钉钉id
"zhengwudingdingid": " ", //政务钉钉id
"welinkid": " ", //华为welink id
"subjectsecurityclearance": 1 //主体密级标识.
}source
static
listpersonwithgroup(name) → {array.}
根据群组标识获取人员对象成员：person对象数组。
syntax
//返回人员数组。
var personlist = this.org.listpersonwithgroup( group );parameters
returns
-
array.返回人员对象数组。
{
"matchkey": " ", //匹配字段
"id": " ", //数据库主键
"name": "李四", //个人名称
"nickname": " ", //昵称
"gendertype": "m", //性别,m:男,f:女,d:未知
"signature": " ", //签名
"description": " ", //说明
"employee": "1111", //员工号
"unique": "lisi", //唯一标识
"distinguishedname": "李四@lisi@p", //识别名
"ordernumber": 14214946, //排序号
"superior": " ", //主管
"mail": " ", //邮件地址
"weixin": " ", //微信号
"qq": " ", //qq号
"mobile": "85252281460", //手机号
"officephone": " ", //办公电话
"boarddate": "2023-11-21 15:02:35", //入职时间
"birthday": "2023-11-21 15:02:35", //生日
"age": 1, //年龄
"qiyeweixinid": " ", //企业微信id
"dingdingid": " ", //钉钉id
"zhengwudingdingid": " ", //政务钉钉id
"welinkid": " ", //华为welink id
"subjectsecurityclearance": 1 //主体密级标识.
}source
static
listpersonwithrole(name) → {array.}
根据角色标识获取人员对象数组：person对象数组。
syntax
//返回人员数组。
var personlist = this.org.listpersonwithrole( role );parameters
returns
-
array.返回人员对象数组。
{
"matchkey": " ", //匹配字段
"id": " ", //数据库主键
"name": "李四", //个人名称
"nickname": " ", //昵称
"gendertype": "m", //性别,m:男,f:女,d:未知
"signature": " ", //签名
"description": " ", //说明
"employee": "1111", //员工号
"unique": "lisi", //唯一标识
"distinguishedname": "李四@lisi@p", //识别名
"ordernumber": 14214946, //排序号
"superior": " ", //主管
"mail": " ", //邮件地址
"weixin": " ", //微信号
"qq": " ", //qq号
"mobile": "85252281460", //手机号
"officephone": " ", //办公电话
"boarddate": "2023-11-21 15:02:35", //入职时间
"birthday": "2023-11-21 15:02:35", //生日
"age": 1, //年龄
"qiyeweixinid": " ", //企业微信id
"dingdingid": " ", //钉钉id
"zhengwudingdingid": " ", //政务钉钉id
"welinkid": " ", //华为welink id
"subjectsecurityclearance": 1 //主体密级标识.
}source
static
listpersonwithidentity(name) → {array.}
根据身份标识获取人员对象成员：person对象数组。
syntax
//返回人员数组。
var personlist = this.org.listpersonwithidentity( identity );parameters
-
name
identityflag|array.<identityflag>身份的distinguishedname、id、unique属性值，身份对象，或上述属性值和对象的数组。
returns
-
array.返回人员对象数组。
{
"matchkey": " ", //匹配字段
"id": " ", //数据库主键
"name": "李四", //个人名称
"nickname": " ", //昵称
"gendertype": "m", //性别,m:男,f:女,d:未知
"signature": " ", //签名
"description": " ", //说明
"employee": "1111", //员工号
"unique": "lisi", //唯一标识
"distinguishedname": "李四@lisi@p", //识别名
"ordernumber": 14214946, //排序号
"superior": " ", //主管
"mail": " ", //邮件地址
"weixin": " ", //微信号
"qq": " ", //qq号
"mobile": "85252281460", //手机号
"officephone": " ", //办公电话
"boarddate": "2023-11-21 15:02:35", //入职时间
"birthday": "2023-11-21 15:02:35", //生日
"age": 1, //年龄
"qiyeweixinid": " ", //企业微信id
"dingdingid": " ", //钉钉id
"zhengwudingdingid": " ", //政务钉钉id
"welinkid": " ", //华为welink id
"subjectsecurityclearance": 1 //主体密级标识.
}source
static
getpersonwithidentity(name) → {persondata|array.}
根据身份标识获取人员对象：person对象数组。
syntax
//返回人员，单个是object，多个是array。
var personlist = this.org.listpersonwithidentity( identity );parameters
-
name
identityflag|array.<identityflag>身份的distinguishedname、id、unique属性值，身份对象，或上述属性值和对象的数组。
returns
-
persondataarray.返回人员对象，单个是object，多个是array。
{
"matchkey": " ", //匹配字段
"id": " ", //数据库主键
"name": "李四", //个人名称
"nickname": " ", //昵称
"gendertype": "m", //性别,m:男,f:女,d:未知
"signature": " ", //签名
"description": " ", //说明
"employee": "1111", //员工号
"unique": "lisi", //唯一标识
"distinguishedname": "李四@lisi@p", //识别名
"ordernumber": 14214946, //排序号
"superior": " ", //主管
"mail": " ", //邮件地址
"weixin": " ", //微信号
"qq": " ", //qq号
"mobile": "85252281460", //手机号
"officephone": " ", //办公电话
"boarddate": "2023-11-21 15:02:35", //入职时间
"birthday": "2023-11-21 15:02:35", //生日
"age": 1, //年龄
"qiyeweixinid": " ", //企业微信id
"dingdingid": " ", //钉钉id
"zhengwudingdingid": " ", //政务钉钉id
"welinkid": " ", //华为welink id
"subjectsecurityclearance": 1 //主体密级标识.
}source
static
listpersonwithunit(name, nestedopt) → {array.}
根据组织标识获取人员对象成员：person对象数组。
syntax
//返回组织的直接人员数组。
var personlist = this.org.listpersonwithunit( unit );
//返回组织的以及嵌套下级组织所有的人员数组。
var personlist = this.org.listpersonwithunit( unit, true );parameters
-
name
unitflag|array.<unitflag>组织的distinguishedname、id、unique属性值，组织对象，或上述属性值和对象的数组。
-
nested
boolean
是否嵌套获取组织以及下级组织的人员，true表示嵌套，flase表示获取直接组织。默认为false
returns
-
array.返回人员对象数组。
{
"matchkey": " ", //匹配字段
"id": " ", //数据库主键
"name": "李四", //个人名称
"nickname": " ", //昵称
"gendertype": "m", //性别,m:男,f:女,d:未知
"signature": " ", //签名
"description": " ", //说明
"employee": "1111", //员工号
"unique": "lisi", //唯一标识
"distinguishedname": "李四@lisi@p", //识别名
"ordernumber": 14214946, //排序号
"superior": " ", //主管
"mail": " ", //邮件地址
"weixin": " ", //微信号
"qq": " ", //qq号
"mobile": "85252281460", //手机号
"officephone": " ", //办公电话
"boarddate": "2023-11-21 15:02:35", //入职时间
"birthday": "2023-11-21 15:02:35", //生日
"age": 1, //年龄
"qiyeweixinid": " ", //企业微信id
"dingdingid": " ", //钉钉id
"zhengwudingdingid": " ", //政务钉钉id
"welinkid": " ", //华为welink id
"subjectsecurityclearance": 1 //主体密级标识.
}source
static
appendpersonattribute(person, attr, values, successopt, failureopt)
添加人员属性值(在属性中添加values值，如果没有此属性，则创建一个)
syntax
//添加人员属性值
this.org.appendpersonattribute( person, attribute, valuearray);parameters
-
person
personflag人员的distinguishedname、id、unique属性值，人员对象。
-
attr
string属性名称。
-
values
array.属性值，必须为数组。
-
success
function
执行成功的回调。
-
failure
function
执行失败的回调。
source
static
setpersonattribute(person, attr, values, successopt, failureopt)
设置人员属性值(将属性值修改为values，如果没有此属性，则创建一个)
syntax
//添加人员属性值
this.org.setpersonattribute( person, attribute, valuearray);parameters
-
person
personflag人员的distinguishedname、id、unique属性值，人员对象。
-
attr
string属性名称。
-
values
array.属性值，必须为数组。
-
success
function
执行成功的回调。
-
failure
function
执行失败的回调。
source
static
getpersonattribute(person, attr) → {array.}
根据人员和属性名称获取属性值数组。
syntax
//返回该人员的属性值数组。
var attributelist = this.org.getpersonattribute( person, attr );parameters
-
person
personflag人员的distinguishedname、id、unique属性值，人员对象。
-
attr
string属性名称。
returns
-
array.返回属性值数组， 如：
[ value1, value2 ]
source
static
listpersonattributename(name) → {array.}
列出人员所有属性的名称数组。
syntax
//返回人员所有属性的名称数组。
var attributenamelist = this.org.listpersonattributename( person );parameters
-
name
personflag|array.<personflag>人员的distinguishedname、id、unique属性值，人员对象，或上述属性值和对象的数组。
returns
-
array.返回人员属性名称数组， 如：
[ attributename1, attributename2 ]
source
static
getidentity(name) → {identitydata|array.}
根据身份标识获取对应的身份对象或数组
syntax
//返回身份，单个是对象，多个是数组。
var identitylist = this.org.getidentity( name );parameters
-
name
identityflag|array.<identityflag>身份的distinguishedname、id、unique属性值，身份对象，或上述属性值和对象的数组。
returns
-
identitydataarray.返回身份，单个是object，多个是array。
{
"matchkey": " ", //匹配字段
"id": " ", //数据库主键,自动生成.
"pinyin": " ", //name拼音,自动生成
"pinyininitial": " ", //name拼音首字母,自动生成
"description": " ", //描述.
"name": "李四", //名称,可重名.
"unique": "23dd1b53-feed-485d-8c9c-1a4e64ff58a2", //唯一标识,不可重复,为空则使用自动填充值
"distinguishedname": "李四@23dd1b53-feed-485d-8c9c-1a4e64ff58a2@i", //识别名.
"person": "李四@lisi@p", //身份所属个人,存放个人 id,不为空.
"unit": "开发部@kfb@u", //属性所属组织,不可为空.
"unitname": "开发部", //组织名称.
"unitlevel": 2, //组织级别.
"unitlevelname": "浙江兰德纵横/开发部", //显示的层级名.
"ordernumber": 24920439, //排序号,升序排列,为空在最后
"major": true, //主身份标识
"createtime": "2023-11-21 15:02:35", //创建时间,自动生成,索引创建在约束中.
"updatetime": "2023-11-21 15:02:35" //修改时间,自动生成,索引创建在约束中.
}source
static
listidentitywithperson(name) → {array.}
根据人员标识获取对应的身份对象数组。
syntax
//返回身份对象数组。
var identitylist = this.org.listidentitywithperson( person );parameters
-
name
personflag|array.<personflag>人员的distinguishedname、id、unique属性值，人员对象，或上述属性值和对象的数组。
returns
-
array.返回身份对象数组。
{
"matchkey": " ", //匹配字段
"name": "李四", //身份名称
"unique": "23dd1b53-feed-485d-8c9c-1a4e64ff58a2", //身份标识
"description": " ", //说明
"distinguishedname": "李四@23dd1b53-feed-485d-8c9c-1a4e64ff58a2@i", //识别名
"person": "李四@lisi@p", //人员
"unit": "开发部@kfb@u", //组织
"unitname": "开发部", //组织名称
"unitlevel": 2, //组织级别
"unitlevelname": "浙江兰德纵横/开发部", //组织级别名
"ordernumber": 24920439, //排序号
"major": true //是否是设定的主身份
}source
static
listidentitywithunit(name, nestedopt) → {array.}
根据组织标识获取对应的身份对象数组：identity对象数组。
syntax
//返回直接组织身份对象数组。
var identitylist = this.org.listidentitywithunit( unit );
//返回嵌套组织身份对象数组。
var identitylist = this.org.listidentitywithunit( unit, true );parameters
-
name
unitflag|array.<unitflag>组织的distinguishedname、id、unique属性值，组织对象，或上述属性值和对象的数组。
-
nested
boolean
true嵌套的所有身份成员；false直接身份成员；默认false。
returns
-
array.返回身份对象数组。
{
"matchkey": " ", //匹配字段
"name": "李四", //身份名称
"unique": "23dd1b53-feed-485d-8c9c-1a4e64ff58a2", //身份标识
"description": " ", //说明
"distinguishedname": "李四@23dd1b53-feed-485d-8c9c-1a4e64ff58a2@i", //识别名
"person": "李四@lisi@p", //人员
"unit": "开发部@kfb@u", //组织
"unitname": "开发部", //组织名称
"unitlevel": 2, //组织级别
"unitlevelname": "浙江兰德纵横/开发部", //组织级别名
"ordernumber": 24920439, //排序号
"major": true //是否是设定的主身份
}source
static
getunit(name, findcnopt) → {unitdata|array.}
根据组织标识获取对应的组织：unit对象或数组
syntax
//返回组织，单个是对象，多个是数组。
var unitlist = this.org.getunit( name );parameters
-
name
unitflag|array.<unitflag>组织的distinguishedname、id、unique属性值，组织对象，或上述属性值和对象的数组。]
-
findcn
boolean
是否需要额外查找中文名称（如综合部），默认false。如果为true，除匹配unique和distingiushedname外，还会在名称的第一段中查找所有匹配到的部门（精确匹配）。
returns
-
unitdataarray.单个是object，多个是array。
{
"matchkey": " ", //匹配字段
"subdirectunitcount": 1, //直接下级组织数量
"subdirectidentitycount": 1, //直接下级身份数量
"subdirectdutycount": 1, //直接下级职务数量
"id": " ", //数据库主键,自动生成.
"name": "开发部", //名称,可以重名.
"unique": "kfb", //唯一标识,不可重复,为空则使用自动填充值
"distinguishedname": "开发部@kfb@u", //识别名.以@u结尾.
"typelist": [
"部门"
], //组织类型.
"pinyin": " ", //name拼音,自动生成
"pinyininitial": " ", //name拼音首字母,自动生成
"description": " ", //描述.
"shortname": "kfb", //组织简称。
"level": 2, //组织级别,1为最上层组织.自动计算.
"levelname": "浙江兰德纵横/开发部", //显示的层级名.
"levelordernumber": " ", //层级排序号,使用/进行分割.将逐级unit中的ordernumber的integer值扩充到在organization配置中指定位数的文本值,前填充0
"superior": "浙江兰德纵横@a706f5f0-4a3b-4785-8e1d-0a944bfad4eb@u", //上级组织.
"ordernumber": 1, //排序号,升序排列,为空在最后
"dingdingid": " ", //钉钉部门id.
"dingdinghash": " ", //钉钉部门哈希特征.
"welinkid": " ", //welink部门id.
"welinkhash": " ", //welink部门哈希特征.
"qiyeweixinid": " ", //企业微信人员id.
"zhengwudingdingid": " ", //政务钉钉人员id.
"andfxid": " ", //移动办公组织id.
"zhengwudingdinghash": " ", //政务钉钉人员哈希特征.
"qiyeweixinhash": " ", //企业微信人员哈希特征.
"andfxhash": " ", //移动办公组织哈希特征.
"createtime": "2023-11-21 15:02:35", //创建时间,自动生成,索引创建在约束中.
"updatetime": "2023-11-21 15:02:35" //修改时间,自动生成,索引创建在约束中.
}source
static
listsubunit(name, nestedopt) → {array.}
根据组织标识获取下级组织的对象数组：unit对象数组。
syntax
//返回嵌套下级组织数组。
var unitlist = this.org.listsubunit( name, true );parameters
-
name
unitflag|array.<unitflag>组织的distinguishedname、id、unique属性值，组织对象，或上述属性值和对象的数组。
-
nested
boolean
true嵌套的所有下级组织；false直接下级组织；默认false。
returns
-
array.返回组织数组。
{
"name": "开发部", //组织名称
"unique": "kfb", //唯一标识
"distinguishedname": "开发部@kfb@u", //识别名
"typelist": [
"部门"
], //组织类型
"description": " ", //说明
"shortname": "kfb", //简称
"level": 2, //组织层次
"levelname": "浙江兰德纵横/开发部", //组织层次名
"superior": "浙江兰德纵横@a706f5f0-4a3b-4785-8e1d-0a944bfad4eb@u", //上级组织
"ordernumber": 1, //排序号
"levelordernumber": " ", //层级排序号
"qiyeweixinid": " ", //企业微信id
"dingdingid": " ", //钉钉id
"zhengwudingdingid": " ", //政务钉钉id
"welinkid": " " //华为welink id
}source
static
listsupunit(name, nestedopt) → {array.}
根据组织标识批量获取上级组织的对象数组：unit对象数组。
syntax
//返回嵌套上级组织数组。
var unitlist = this.org.listsupunit( name, true );parameters
-
name
unitflag|array.<unitflag>组织的distinguishedname、id、unique属性值，组织对象，或上述属性值和对象的数组。
-
nested
boolean
true嵌套的所有上级组织；false直接上级组织；默认false。
returns
-
array.返回组织数组。
{
"name": "开发部", //组织名称
"unique": "kfb", //唯一标识
"distinguishedname": "开发部@kfb@u", //识别名
"typelist": [
"部门"
], //组织类型
"description": " ", //说明
"shortname": "kfb", //简称
"level": 2, //组织层次
"levelname": "浙江兰德纵横/开发部", //组织层次名
"superior": "浙江兰德纵横@a706f5f0-4a3b-4785-8e1d-0a944bfad4eb@u", //上级组织
"ordernumber": 1, //排序号
"levelordernumber": " ", //层级排序号
"qiyeweixinid": " ", //企业微信id
"dingdingid": " ", //钉钉id
"zhengwudingdingid": " ", //政务钉钉id
"welinkid": " " //华为welink id
}source
static
getunitbyidentity(name, flagopt) → {unitdata|array.}
根据个人身份获取组织：unit对象或数组。
syntax
//返回直接所在组织，单个为对象，多个为数组。
var unitlist = this.org.getunitbyidentity( name );
//返回第一层组织，单个为对象，多个为数组。
var unitlist = this.org.getunitbyidentity( name, 1 );
* //返回类型为company的组织，单个为对象，多个为数组。
var unitlist = this.org.getunitbyidentity( name, "company" );parameters
-
name
identityflag身份的distinguishedname、id、unique属性值，身份对象。
-
flag
string|number
当值为数字的时候， 表示获取第几层的组织。
当值为字符串的时候，表示获取指定类型的组织。
当值为空的时候，表示获取直接所在组织。
returns
-
unitdataarray.返回对应组织，单个为对象，多个为数组。
{
"name": "开发部", //组织名称
"unique": "kfb", //唯一标识
"distinguishedname": "开发部@kfb@u", //识别名
"typelist": [
"部门"
], //组织类型
"description": " ", //说明
"shortname": "kfb", //简称
"level": 2, //组织层次
"levelname": "浙江兰德纵横/开发部", //组织层次名
"superior": "浙江兰德纵横@a706f5f0-4a3b-4785-8e1d-0a944bfad4eb@u", //上级组织
"ordernumber": 1, //排序号
"levelordernumber": " ", //层级排序号
"qiyeweixinid": " ", //企业微信id
"dingdingid": " ", //钉钉id
"zhengwudingdingid": " ", //政务钉钉id
"welinkid": " " //华为welink id
}source
static
listallsupunitwithidentity(name) → {array.}
批量查询身份所在的组织,并递归查找其上级组织对象.
syntax
//返回组织数组。
var unitlist = this.org.listallsupunitwithidentity( name );parameters
-
name
identityflag|array.<identityflag>身份的distinguishedname、id、unique属性值，身份对象，或上述属性值和对象的数组。
returns
-
array.返回组织数组。
{
"name": "开发部", //组织名称
"unique": "kfb", //唯一标识
"distinguishedname": "开发部@kfb@u", //识别名
"typelist": [
"部门"
], //组织类型
"description": " ", //说明
"shortname": "kfb", //简称
"level": 2, //组织层次
"levelname": "浙江兰德纵横/开发部", //组织层次名
"superior": "浙江兰德纵横@a706f5f0-4a3b-4785-8e1d-0a944bfad4eb@u", //上级组织
"ordernumber": 1, //排序号
"levelordernumber": " ", //层级排序号
"qiyeweixinid": " ", //企业微信id
"dingdingid": " ", //钉钉id
"zhengwudingdingid": " ", //政务钉钉id
"welinkid": " " //华为welink id
}source
static
listunitwithperson(name) → {array.}
根据个人标识批量获取组织对象成员：unit对象数组。
syntax
//返回组织数组。
var unitlist = this.org.listunitwithperson( name );parameters
-
name
personflag|array.<personflag>人员的distinguishedname、id、unique属性值，人员对象，或上述属性值和对象的数组。
returns
-
array.返回组织数组。
{
"name": "开发部", //组织名称
"unique": "kfb", //唯一标识
"distinguishedname": "开发部@kfb@u", //识别名
"typelist": [
"部门"
], //组织类型
"description": " ", //说明
"shortname": "kfb", //简称
"level": 2, //组织层次
"levelname": "浙江兰德纵横/开发部", //组织层次名
"superior": "浙江兰德纵横@a706f5f0-4a3b-4785-8e1d-0a944bfad4eb@u", //上级组织
"ordernumber": 1, //排序号
"levelordernumber": " ", //层级排序号
"qiyeweixinid": " ", //企业微信id
"dingdingid": " ", //钉钉id
"zhengwudingdingid": " ", //政务钉钉id
"welinkid": " " //华为welink id
}source
static
listallsupunitwithperson(name) → {array.}
根据个人标识批量查询所在组织及所有上级组织：unit对象数组。
syntax
//返回组织数组。
var unitlist = this.org.listallsupunitwithperson( name );parameters
-
name
personflag|array.<personflag>人员的distinguishedname、id、unique属性值，人员对象，或上述属性值和对象的数组。
returns
-
array.返回个人所在组织及所有上级组织。
{
"name": "开发部", //组织名称
"unique": "kfb", //唯一标识
"distinguishedname": "开发部@kfb@u", //识别名
"typelist": [
"部门"
], //组织类型
"description": " ", //说明
"shortname": "kfb", //简称
"level": 2, //组织层次
"levelname": "浙江兰德纵横/开发部", //组织层次名
"superior": "浙江兰德纵横@a706f5f0-4a3b-4785-8e1d-0a944bfad4eb@u", //上级组织
"ordernumber": 1, //排序号
"levelordernumber": " ", //层级排序号
"qiyeweixinid": " ", //企业微信id
"dingdingid": " ", //钉钉id
"zhengwudingdingid": " ", //政务钉钉id
"welinkid": " " //华为welink id
}source
static
listunitwithattribute(attributename, attributevalue) → {array.}
根据组织属性，获取所有符合的组织。
syntax
//返回组织数组。
var unitlist = this.org.listunitwithattribute( attributename, attributename );parameters
-
attributename
string组织属性名称。
-
attributevalue
string组织属性值。
returns
-
array.返回组织数组。
{
"name": "开发部", //组织名称
"unique": "kfb", //唯一标识
"distinguishedname": "开发部@kfb@u", //识别名
"typelist": [
"部门"
], //组织类型
"description": " ", //说明
"shortname": "kfb", //简称
"level": 2, //组织层次
"levelname": "浙江兰德纵横/开发部", //组织层次名
"superior": "浙江兰德纵横@a706f5f0-4a3b-4785-8e1d-0a944bfad4eb@u", //上级组织
"ordernumber": 1, //排序号
"levelordernumber": " ", //层级排序号
"qiyeweixinid": " ", //企业微信id
"dingdingid": " ", //钉钉id
"zhengwudingdingid": " ", //政务钉钉id
"welinkid": " " //华为welink id
}source
static
listunitwithduty(dutyname, identity) → {array.}
根据组织职务，获取所有符合的组织。
syntax
//返回组织数组。
var unitlist = this.org.listunitwithduty( dutyname, identity );parameters
-
dutyname
string组织职务名称。
-
identity
identityflag身份的distinguishedname、id、unique属性值，身份对象。
returns
-
array.返回组织数组。
{
"name": "开发部", //组织名称
"unique": "kfb", //唯一标识
"distinguishedname": "开发部@kfb@u", //识别名
"typelist": [
"部门"
], //组织类型
"description": " ", //说明
"shortname": "kfb", //简称
"level": 2, //组织层次
"levelname": "浙江兰德纵横/开发部", //组织层次名
"superior": "浙江兰德纵横@a706f5f0-4a3b-4785-8e1d-0a944bfad4eb@u", //上级组织
"ordernumber": 1, //排序号
"levelordernumber": " ", //层级排序号
"qiyeweixinid": " ", //企业微信id
"dingdingid": " ", //钉钉id
"zhengwudingdingid": " ", //政务钉钉id
"welinkid": " " //华为welink id
}source
static
getduty(dutyname, unit) → {array.}
根据职务名称和组织名称获取身份。
syntax
//返回身份数组。
var identitylist = this.org.getduty( dutyname, unit );parameters
-
dutyname
string组织职务名称。
-
unit
unitflag组织的distinguishedname、id、unique属性值，组织对象。
returns
-
array.返回身份数组。
{
"id": " ", //数据库主键,自动生成.
"pinyin": " ", //name拼音,自动生成
"pinyininitial": " ", //name拼音首字母,自动生成
"description": " ", //描述.
"name": "李四", //名称,同一组织下不可重名.
"unique": "23dd1b53-feed-485d-8c9c-1a4e64ff58a2", //唯一标识,不可重复,为空则使用自动填充值
"distinguishedname": "李四@23dd1b53-feed-485d-8c9c-1a4e64ff58a2@i", //识别名,自动填充,@ud结尾.
"unit": "开发部@kfb@u", //组织职务所属组织,不可为空.
"ordernumber": 24920439, //排序号,升序排列,为空在最后
"identitylist": [
" "
], //组织职务身份成员,多值.
"createtime": "2023-11-21 15:02:35", //创建时间,自动生成,索引创建在约束中.
"updatetime": "2023-11-21 15:02:35" //修改时间,自动生成,索引创建在约束中.
}source
static
listdutynamewithidentity(identity) → {array.}
批量获取身份的所有职务名称。
syntax
//返回职务名称数组。
var dutynamelist = this.org.listdutynamewithidentity( identity );parameters
-
identity
identityflag|array.<identityflag>身份的distinguishedname、id、unique属性值，身份对象，或上述属性值和对象的数组。
returns
-
array.返回职务名称数组。
source
static
listdutynamewithunit(unit) → {array.}
批量获取组织的所有职务名称。
syntax
//返回职务名称数组。
var dutynamelist = this.org.listdutynamewithunit( unit );parameters
returns
-
array.返回职务名称数组。
source
static