O2OA API: org | O2OA开发平台

static

getIdentity(name, asyncOrCallbackopt) → {Promise|IdentityData|Array.<IdentityData>}

根据身份标识获取对应的身份对象或数组

Syntax

//同步执行，返回身份，单个是对象，多个是数组。
var identityList = this.org.getIdentity( name );

//异步执行，返回Promise对象
var promise = this.org.getIdentity( name, true);
promise.then(function(identityList){
    //identityList 为返回的身份，单个是对象，多个是数组。
})

//异步执行，在回调方法中获取身份
this.org.getIdentity( name, function(identityList){
    //identityList 为返回的身份，单个是对象，多个是数组。
})

Parameters

name IdentityFlag | Array.<IdentityFlag>
身份的distinguishedName、id、unique属性值，身份对象，或上述属性值和对象的数组。
asyncOrCallback Boolean | function <optional>

当参数为boolean，表示是否异步执行，默认为false。当参数为function，表示回调方法。

Returns

Promise IdentityData Array.<IdentityData>
当async为true时，返回 Promise。否则返回身份，单个是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

o2_core/o2/xScript/ViewEnvironment.js , line 802

static

listIdentityWithPerson(name, asyncOrCallbackopt, findCNopt) → {Promise|Array.<IdentityData>}

根据人员标识获取对应的身份对象数组。

Syntax

//同步执行，返回身份对象数组。
var identityList = this.org.listIdentityWithPerson( person );

//异步执行，返回Promise对象
var promise = this.org.listIdentityWithPerson( person, true);
promise.then(function(identityList){
    //identityList 返回的身份对象数组。
})

//异步执行，在回调方法中获取
this.org.listIdentityWithPerson( person, function(identityList){
    //identityList 返回的身份对象数组。
})

Parameters

name PersonFlag | Array.<PersonFlag>
人员的distinguishedName、id、unique属性值，人员对象，或上述属性值和对象的数组。
asyncOrCallback Boolean | function <optional>

当参数为boolean，表示是否异步执行，默认为false。当参数为function，表示回调方法。
findCN Boolean <optional>

是否需要额外查找中文名称（如张三），默认false。如果为true，除匹配unique和distingiushedName外，还会在身份的第一段中查找所有匹配到的身份（精确匹配）。

Returns

Promise Array.<IdentityData>
当async为true时，返回 Promise。否则返回身份对象数组。

{
	"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

o2_core/o2/xScript/ViewEnvironment.js , line 844

static

listIdentityWithUnit(name, nestedopt, asyncOrCallbackopt) → {Promise|Array.<IdentityData>}

根据组织标识获取对应的身份对象数组：identity对象数组。

Syntax

//同步执行，返回直接组织身份对象数组。
var identityList = this.org.listIdentityWithUnit( unit );


//同步执行，返回嵌套组织身份对象数组。
var identityList = this.org.listIdentityWithUnit( unit, true );

//异步执行，返回Promise对象
var promise = this.org.listIdentityWithUnit( unit, false, true);
promise.then(function(identityList){
    //identityList 返回直接组织身份对象数组。
})

//异步执行，在回调方法中获取
this.org.listIdentityWithUnit( unit, false, function(identityList){
    //identityList 返回直接组织身份对象数组。
})

Parameters

name UnitFlag | Array.<UnitFlag>
组织的distinguishedName、id、unique属性值，组织对象，或上述属性值和对象的数组。
nested Boolean <optional>

true嵌套的所有身份成员；false直接身份成员；默认false。
asyncOrCallback Boolean | function <optional>

当参数为boolean，表示是否异步执行，默认为false。当参数为function，表示回调方法。

Returns

Promise Array.<IdentityData>
当async为true时，返回 Promise。否则返回身份对象数组。

{
	"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

o2_core/o2/xScript/ViewEnvironment.js , line 890

static

getUnit(name, asyncOrCallbackopt, findCNopt) → {Promise|UnitData|Array.<UnitData>}

根据组织标识获取对应的组织：unit对象或数组

Syntax

//同步执行，返回组织，单个是对象，多个是数组。
var unitList = this.org.getUnit( name );

//异步执行，返回Promise对象
var promise = this.org.getUnit( name, true);
promise.then(function(unitList){
    //unitList 为返回的组织，单个是对象，多个是数组。
})

//异步执行，在回调方法中获取组织
this.org.getUnit( name, function(unitList){
    //unitList 为返回的组织，单个是对象，多个是数组。
})

Parameters

name UnitFlag | Array.<UnitFlag>
组织的distinguishedName、id、unique属性值，组织对象，或上述属性值和对象的数组。
asyncOrCallback Boolean | function <optional>

当参数为boolean，表示是否异步执行，默认为false。当参数为function，表示回调方法。
findCN Boolean <optional>

是否需要额外查找中文名称（如综合部），默认false。如果为true，除匹配unique和distingiushedName外，还会在名称的第一段中查找所有匹配到的部门（精确匹配）。

Returns

Promise UnitData Array.<UnitData>
当async为true时，返回 Promise。否则返回组织，单个是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

o2_core/o2/xScript/ViewEnvironment.js , line 954

static

listSubUnit(name, nestedopt, asyncOrCallbackopt) → {Promise|Array.<UnitData>}

根据组织标识获取下级组织的对象数组：unit对象数组。

Syntax

//同步执行，返回嵌套下级组织数组。
var unitList = this.org.listSubUnit( name, true );

//异步执行，返回Promise对象
var promise = this.org.listSubUnit( name, false, true);
promise.then(function(unitList){
    //unitList 为返回的直接下级组织数组。
})

//异步执行，在回调方法中获取
this.org.listSubUnit( name, true, function(unitList){
    //unitList 为返回嵌套下级组织数组。
})

Parameters

name UnitFlag | Array.<UnitFlag>
组织的distinguishedName、id、unique属性值，组织对象，或上述属性值和对象的数组。
nested Boolean <optional>

true嵌套的所有下级组织；false直接下级组织；默认false。
asyncOrCallback Boolean | function <optional>

当参数为boolean，表示是否异步执行，默认为false。当参数为function，表示回调方法。

Returns

Promise Array.<UnitData>
当async为true时，返回 Promise。否则返回组织数组。

{
	"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

o2_core/o2/xScript/ViewEnvironment.js , line 1001

static

listSupUnit(name, nestedopt, asyncOrCallbackopt) → {Promise|Array.<UnitData>}

根据组织标识批量获取上级组织的对象数组：unit对象数组。

Syntax

//同步执行，返回嵌套上级组织数组。
var unitList = this.org.listSupUnit( name, true );

//异步执行，返回Promise对象
var promise = this.org.listSupUnit( name, false, true);
promise.then(function(unitList){
    //unitList 为返回的直接上级组织数组。
})

//异步执行，在回调方法中获取
this.org.listSupUnit( name, true, function(unitList){
    //unitList 为返回嵌套上级组织数组。
})

Parameters

name UnitFlag | Array.<UnitFlag>
组织的distinguishedName、id、unique属性值，组织对象，或上述属性值和对象的数组。
nested Boolean <optional>

true嵌套的所有上级组织；false直接上级组织；默认false。
asyncOrCallback Boolean | function <optional>

当参数为boolean，表示是否异步执行，默认为false。当参数为function，表示回调方法。

Returns

Promise Array.<UnitData>
当async为true时，返回 Promise。否则返回组织数组。

{
	"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

o2_core/o2/xScript/ViewEnvironment.js , line 1050

static

getUnitByIdentity(name, flagopt, asyncOrCallbackopt) → {Promise|UnitData|Array.<UnitData>}

根据个人身份获取组织：unit对象或数组。

Syntax

//同步执行，返回直接所在组织，单个为对象，多个为数组。
var unitList = this.org.getUnitByIdentity( name );

//同步执行，返回第一层组织，单个为对象，多个为数组。
var unitList = this.org.getUnitByIdentity( name, 1 );

* //同步执行，返回类型为company的组织，单个为对象，多个为数组。
var unitList = this.org.getUnitByIdentity( name, "company" );

//异步执行，返回Promise对象
var promise = this.org.getUnitByIdentity( name, null, true);
promise.then(function(unitList){
    //unitList 返回直接所在组织，单个为对象，多个为数组。
})

//异步执行，在回调方法中获取
this.org.getUnitByIdentity( name, 1, function(unitList){
    //unitList 返回第一层组织，单个为对象，多个为数组。
})

Parameters

name IdentityFlag
身份的distinguishedName、id、unique属性值，身份对象。
flag String | Number <optional>

当值为数字的时候，表示获取第几层的组织。
当值为字符串的时候，表示获取指定类型的组织。
当值为空的时候，表示获取直接所在组织。
asyncOrCallback Boolean | function <optional>

当参数为boolean，表示是否异步执行，默认为false。当参数为function，表示回调方法。

Returns

Promise UnitData Array.<UnitData>
当async为true时，返回 Promise。否则返回对应组织，单个为对象，多个为数组。

{
	"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

o2_core/o2/xScript/ViewEnvironment.js , line 1117

static

listAllSupUnitWithIdentity(name, asyncOrCallbackopt) → {Promise|Array.<UnitData>}

批量查询身份所在的组织,并递归查找其上级组织对象.

Syntax

//同步执行，返回组织数组。
var unitList = this.org.listAllSupUnitWithIdentity( name );

//异步执行，返回Promise对象
var promise = this.org.listAllSupUnitWithIdentity( name, true);
promise.then(function(unitList){
    //unitList 返回组织数组。
})

//异步执行，在回调方法中获取
this.org.listAllSupUnitWithIdentity( name, function(unitList){
    //unitList 返回组织数组。
})

Parameters

name IdentityFlag | Array.<IdentityFlag>
身份的distinguishedName、id、unique属性值，身份对象，或上述属性值和对象的数组。
asyncOrCallback Boolean | function <optional>

当参数为boolean，表示是否异步执行，默认为false。当参数为function，表示回调方法。

Returns

Promise Array.<UnitData>
当async为true时，返回 Promise。否则返回组织数组。

{
	"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

o2_core/o2/xScript/ViewEnvironment.js , line 1214

static

listUnitWithPerson(name, asyncOrCallbackopt) → {Promise|Array.<UnitData>}

根据个人标识批量获取组织对象成员：Unit对象数组。

Syntax

//同步执行，返回组织数组。
var unitList = this.org.listUnitWithPerson( name );

//异步执行，返回Promise对象
var promise = this.org.listUnitWithPerson( name, true);
promise.then(function(unitList){
    //unitList 返回组织数组。
})

//异步执行，在回调方法中获取
this.org.listUnitWithPerson( name, function(unitList){
    //unitList 返回组织数组。
})

Parameters

name PersonFlag | Array.<PersonFlag>
人员的distinguishedName、id、unique属性值，人员对象，或上述属性值和对象的数组。
asyncOrCallback Boolean | function <optional>

当参数为boolean，表示是否异步执行，默认为false。当参数为function，表示回调方法。

Returns

Promise Array.<UnitData>
当async为true时，返回 Promise。否则返回组织数组。

{
	"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

o2_core/o2/xScript/ViewEnvironment.js , line 1255

static

listAllSupUnitWithPerson(name, asyncOrCallbackopt) → {Promise|Array.<UnitData>}

根据个人标识批量查询所在组织及所有上级组织：Unit对象数组。

Syntax

//同步执行，返回组织数组。
var unitList = this.org.listAllSupUnitWithPerson( name );

//异步执行，返回Promise对象
var promise = this.org.listAllSupUnitWithPerson( name, true);
promise.then(function(unitList){
    //unitList 返回组织数组。
})

//异步执行，在回调方法中获取
this.org.listAllSupUnitWithPerson( name, function(unitList){
    //unitList 返回组织数组。
})

Parameters

name PersonFlag | Array.<PersonFlag>
人员的distinguishedName、id、unique属性值，人员对象，或上述属性值和对象的数组。
asyncOrCallback Boolean | function <optional>

当参数为boolean，表示是否异步执行，默认为false。当参数为function，表示回调方法。

Returns

Promise Array.<UnitData>
当async为true时，返回 Promise。否则返回个人所在组织及所有上级组织。

{
	"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

o2_core/o2/xScript/ViewEnvironment.js , line 1296

static

listUnitWithAttribute(attributeName, attributeValue, asyncOrCallbackopt) → {Promise|Array.<UnitData>}

根据组织属性，获取所有符合的组织。

Syntax

//同步执行，返回组织数组。
var unitList = this.org.listUnitWithAttribute( attributeName, attributeName );

//异步执行，返回Promise对象
var promise = this.org.listUnitWithAttribute( attributeName, attributeName, true);
promise.then(function(unitList){
    //unitList 返回组织数组。
})

//异步执行，在回调方法中获取
this.org.listUnitWithAttribute( attributeName, attributeName, function(unitList){
    //unitList 返回组织数组。
})

Parameters

attributeName String
组织属性名称。
attributeValue String
组织属性值。
asyncOrCallback Boolean | function <optional>

当参数为boolean，表示是否异步执行，默认为false。当参数为function，表示回调方法。

Returns

Promise Array.<UnitData>
当async为true时，返回 Promise。否则返回组织数组。

{
	"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

o2_core/o2/xScript/ViewEnvironment.js , line 1337

static

listUnitWithDuty(dutyName, identity, asyncOrCallbackopt) → {Promise|Array.<UnitData>}

根据组织职务，获取所有符合的组织。

Syntax

//同步执行，返回组织数组。
var unitList = this.org.listUnitWithDuty( dutyName, identity );

//异步执行，返回Promise对象
var promise = this.org.listUnitWithDuty( dutyName, identity, true);
promise.then(function(unitList){
    //unitList 返回组织数组。
})

//异步执行，在回调方法中获取
this.org.listUnitWithDuty( dutyName, identity, function(unitList){
    //unitList 返回组织数组。
})

Parameters

dutyName String
组织职务名称。
identity IdentityFlag
身份的distinguishedName、id、unique属性值，身份对象。
asyncOrCallback Boolean | function <optional>

当参数为boolean，表示是否异步执行，默认为false。当参数为function，表示回调方法。

Returns

Promise Array.<UnitData>
当async为true时，返回 Promise。否则返回组织数组。

{
	"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

o2_core/o2/xScript/ViewEnvironment.js , line 1379

static

listTopUnit(asyncOrCallbackopt) → {Promise|Array.<UnitData>}

列式所有顶层组织。

Syntax

//同步执行，返回顶层组织数组。
var unitList = this.org.listTopUnit();

//异步执行，返回Promise对象
var promise = this.org.listTopUnit(true);
promise.then(function(unitList){
    //unitList 返回顶层组织数组。
})

//异步执行，在回调方法中获取
this.org.listTopUnit(function(unitList){
    //unitList 返回顶层组织数组。
})

Parameters

asyncOrCallback Boolean | function <optional>

当参数为boolean，表示是否异步执行，默认为false。当参数为function，表示回调方法。

Returns

Promise Array.<UnitData>
当async为true时，返回 Promise。否则返回顶层组织数组。

{
	"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

o2_core/o2/xScript/ViewEnvironment.js , line 1421

static

getPersonData(name, asyncOrCallbackopt) → {Promise|PersonData}

根据人员标识获取对应的人员对象，附带身份,身份所在的组织,个人所在群组,个人拥有角色.

Syntax

//同步执行，返回人员对象。
var person = this.org.getPersonData( name );

//异步执行，返回Promise对象
var promise = this.org.getPersonData( name, true);
promise.then(function(person){
    //personList 为返回的人员对象。
})

//异步执行，在回调方法中获取人员
this.org.getPersonData( name, function(person){
    //personList 为返回的人员对象。
})

Parameters

name String
人员的distinguishedName、id、unique属性值，人员名称。
asyncOrCallback Boolean | function <optional>

当参数为boolean，表示是否异步执行，默认为false。当参数为function，表示回调方法。

Returns

Promise PersonData
当async为true时，返回 Promise。否则返回人员对象。

{
	"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

o2_core/o2/xScript/ViewEnvironment.js , line 1462

static

getPerson(name, asyncOrCallbackopt, findCNopt) → {Promise|PersonData|Array.<PersonData>}

根据人员标识获取对应的人员对象或数组：person对象或数组

Syntax

//同步执行，返回人员，单个是对象，多个是数组。
var personList = this.org.getPerson( name );

//异步执行，返回Promise对象
var promise = this.org.getPerson( name, true);
promise.then(function(personList){
    //personList 为返回的人员，单个是对象，多个是数组。
})

//异步执行，在回调方法中获取人员
this.org.getPerson( name, function(personList){
    //personList 为返回的人员，单个是对象，多个是数组。
})

Parameters

name PersonFlag | Array.<PersonFlag>
人员的distinguishedName、id、unique属性值，人员对象，或上述属性值和对象的数组。
asyncOrCallback Boolean | function <optional>

当参数为boolean，表示是否异步执行，默认为false。当参数为function，表示回调方法。
findCN Boolean <optional>

是否需要额外查找中文名称（如张三），默认false。如果为true，除匹配unique和distingiushedName外，还会在名称的第一段中查找所有匹配到的人（精确匹配）。

Returns

Promise PersonData Array.<PersonData>
当async为true时，返回 Promise。否则返回人员，单个是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

o2_core/o2/xScript/ViewEnvironment.js , line 1501

static

listSubPerson(name, nestedopt, asyncOrCallbackopt) → {Promise|Array.<PersonData>}

根据人员标识获取下级人员的对象数组：person对象数组。该上下级关系被人员的汇报对象值（superior）决定。

Syntax

//同步执行，返回嵌套下级人员数组。
var personList = this.org.listSubPerson( name, true );

//异步执行，返回Promise对象
var promise = this.org.listSubPerson( name, false, true);
promise.then(function(personList){
    //personList 为返回的直接下级人员数组。
})

//异步执行，在回调方法中获取
this.org.listSubPerson( name, true, function(personList){
    //personList 为返回嵌套下级人员数组。
})

Parameters

name PersonFlag | Array.<PersonFlag>
人员的distinguishedName、id、unique属性值，人员对象，或上述属性值和对象的数组。
nested Boolean <optional>

true嵌套的所有下级人员；false直接下级人员；默认false。
asyncOrCallback Boolean | function <optional>

当参数为boolean，表示是否异步执行，默认为false。当参数为function，表示回调方法。

Returns

Promise Array.<PersonData>
当async为true时，返回 Promise。否则返回人员数组。

{
	"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

o2_core/o2/xScript/ViewEnvironment.js , line 1551

static

listSupPerson(name, nestedopt, asyncOrCallbackopt) → {Promise|Array.<PersonData>}

根据人员标识获取上级人员的对象数组：person对象数组。该上下级关系被人员的汇报对象值（superior）决定。

Syntax

//同步执行，返回嵌套上级人员数组。
var personList = this.org.listSupPerson( name, true );

//异步执行，返回Promise对象
var promise = this.org.listSupPerson( name, false, true);
promise.then(function(personList){
    //personList 为返回的直接上级人员数组。
})

//异步执行，在回调方法中获取
this.org.listSupPerson( name, true, function(personList){
    //personList 为返回嵌套上级人员数组。
})

Parameters

name PersonFlag | Array.<PersonFlag>
人员的distinguishedName、id、unique属性值，人员对象，或上述属性值和对象的数组。
nested Boolean <optional>

true嵌套的所有上级人员；false直接上级人员；默认false。
asyncOrCallback Boolean | function <optional>

当参数为boolean，表示是否异步执行，默认为false。当参数为function，表示回调方法。

Returns

Promise Array.<PersonData>
当async为true时，返回 Promise。否则返回人员数组。

{
	"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

o2_core/o2/xScript/ViewEnvironment.js , line 1600

static

listPersonWithGroup(name, asyncOrCallbackopt) → {Promise|Array.<PersonData>}

根据群组标识获取人员对象成员：person对象数组。

Syntax

//同步执行，返回人员数组。
var personList = this.org.listPersonWithGroup( group );

//异步执行，返回Promise对象
var promise = this.org.listPersonWithGroup( group, true);
promise.then(function(personList){
    //personList 为返回的人员数组。
})

//异步执行，在回调方法中获取
this.org.listPersonWithGroup( group, function(personList){
    //personList 为返回的人员数组。
})

Parameters

name GroupFlag | Array.<GroupFlag>
群组的distinguishedName、name、id、unique属性值，群组对象，或上述属性值和对象的数组。
asyncOrCallback Boolean | function <optional>

当参数为boolean，表示是否异步执行，默认为false。当参数为function，表示回调方法。

Returns

Promise Array.<PersonData>
当async为true时，返回 Promise。否则返回人员对象数组。

{
	"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

o2_core/o2/xScript/ViewEnvironment.js , line 1647

static

listPersonWithRole(name, asyncOrCallbackopt) → {Promise|Array.<PersonData>}

根据角色标识获取人员对象数组：person对象数组。

Syntax

//同步执行，返回人员数组。
var personList = this.org.listPersonWithRole( role );

//异步执行，返回Promise对象
var promise = this.org.listPersonWithRole( role, true);
promise.then(function(personList){
    //personList 为返回的人员数组。
})

//异步执行，在回调方法中获取
this.org.listPersonWithRole( role, function(personList){
    //personList 为返回的人员数组。
})

Parameters

name RoleFlag | Array.<RoleFlag>
角色的distinguishedName、name、id、unique属性值，角色对象，或上述属性值和对象的数组。
asyncOrCallback Boolean | function <optional>

当参数为boolean，表示是否异步执行，默认为false。当参数为function，表示回调方法。

Returns

Promise Array.<PersonData>
当async为true时，返回 Promise。否则返回人员对象数组。

{
	"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

o2_core/o2/xScript/ViewEnvironment.js , line 1689

static

listPersonWithIdentity(name, asyncOrCallbackopt) → {Promise|Array.<PersonData>}

根据身份标识获取人员对象成员：person对象数组。

Syntax

//同步执行，返回人员数组。
var personList = this.org.listPersonWithIdentity( identity );

//异步执行，返回Promise对象
var promise = this.org.listPersonWithIdentity( identity, true);
promise.then(function(personList){
    //personList 为返回的人员数组。
})

//异步执行，在回调方法中获取
this.org.listPersonWithIdentity( identity, function(personList){
    //personList 为返回的人员数组。
})

Parameters

name IdentityFlag | Array.<IdentityFlag>
身份的distinguishedName、id、unique属性值，身份对象，或上述属性值和对象的数组。
asyncOrCallback Boolean | function <optional>

当参数为boolean，表示是否异步执行，默认为false。当参数为function，表示回调方法。

Returns

Promise Array.<PersonData>
当async为true时，返回 Promise。否则返回人员对象数组。

{
	"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

o2_core/o2/xScript/ViewEnvironment.js , line 1731

static

listPersonWithUnit(name, nestedopt, asyncOrCallbackopt) → {Promise|Array.<PersonData>}

根据组织标识获取人员对象成员：person对象数组。

Syntax

//同步执行，返回组织的直接人员数组。
var personList = this.org.listPersonWithUnit( unit );

//同步执行，返回组织的以及嵌套下级组织所有的人员数组。
var personList = this.org.listPersonWithUnit( unit, true );

//异步执行，返回Promise对象
var promise = this.org.listPersonWithUnit( unit, false, true);
promise.then(function(personList){
    //personList 为返回的组织的直接人员数组。
})

//异步执行，在回调方法中获取
this.org.listPersonWithUnit( unit, false, function(personList){
    //personList 为返回的群组的直接人员数组。
})

Parameters

name UnitFlag | Array.<UnitFlag>
组织的distinguishedName、id、unique属性值，组织对象，或上述属性值和对象的数组。
nested Boolean <optional>

是否嵌套获取组织以及下级组织的人员，true表示嵌套，flase表示获取直接组织。默认为false
asyncOrCallback Boolean | function <optional>

当参数为boolean，表示是否异步执行，默认为false。当参数为function，表示回调方法。

Returns

Promise Array.<PersonData>
当async为true时，返回 Promise。否则返回人员对象数组。

{
	"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

o2_core/o2/xScript/ViewEnvironment.js , line 1788

static

listPersonWithAttribute(name, value, asyncOrCallbackopt) → {Promise|Array.<PersonData>}

根据人员属性名称和属性值获取人员对象成员：person对象数组。

Syntax

//同步执行，返回拥有对应属性名和属性值人员数组。
var personList = this.org.listPersonWithAttribute( name, value );

//异步执行，返回Promise对象
var promise = this.org.listPersonWithAttribute( name, value, true);
promise.then(function(personList){
    //personList 返回拥有对应属性名和属性值人员数组。
})

//异步执行，在回调方法中获取
this.org.listPersonWithAttribute( name, value, function(personList){
    //personList 返回拥有对应属性名和属性值人员数组。
})

Parameters

name String
人员属性名称。
value String
人员属性值。
asyncOrCallback Boolean | function <optional>

当参数为boolean，表示是否异步执行，默认为false。当参数为function，表示回调方法。

Returns

Promise Array.<PersonData>
当async为true时，返回 Promise。否则返回人员对象数组。

{
	"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

o2_core/o2/xScript/ViewEnvironment.js , line 1840

static

getDuty(dutyName, unit, asyncOrCallbackopt) → {Promise|Array.<IdentityData>}

根据职务名称和组织名称获取身份。

Syntax

//同步执行，返回身份数组。
var identityList = this.org.getDuty( dutyName, unit );

//异步执行，返回Promise对象
var promise = this.org.getDuty( dutyName, unit, true);
promise.then(function(identityList){
    //identityList 返回身份数组。
})

//异步执行，在回调方法中获取
this.org.getDuty( dutyName, unit, function(unitList){
    //unitList 返回身份数组。
})

Parameters

dutyName String
组织职务名称。
unit UnitFlag
组织的distinguishedName、id、unique属性值，组织对象。
asyncOrCallback Boolean | function <optional>

当参数为boolean，表示是否异步执行，默认为false。当参数为function，表示回调方法。

Returns

Promise Array.<IdentityData>
当async为true时，返回 Promise。否则返回身份数组。

{
	"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

o2_core/o2/xScript/ViewEnvironment.js , line 1900

static

listDutyNameWithIdentity(identity, asyncOrCallbackopt) → {Promise|Array.<String>}

批量获取身份的所有职务名称。

Syntax

//同步执行，返回职务名称数组。
var dutyNameList = this.org.listDutyNameWithIdentity( identity );

//异步执行，返回Promise对象
var promise = this.org.listDutyNameWithIdentity( identity, true);
promise.then(function(dutyNameList){
    //dutyNameList 返回职务名称数组。
})

//异步执行，在回调方法中获取
this.org.listDutyNameWithIdentity( identity, function(dutyNameList){
    //dutyNameList 返回职务名称数组。
})

Parameters

identity IdentityFlag | Array.<IdentityFlag>
身份的distinguishedName、id、unique属性值，身份对象，或上述属性值和对象的数组。
asyncOrCallback Boolean | function <optional>

当参数为boolean，表示是否异步执行，默认为false。当参数为function，表示回调方法。

Returns

Promise Array.<String>
当async为true时，返回 Promise。否则返回职务名称数组。

Source

o2_core/o2/xScript/ViewEnvironment.js , line 1943

static

listDutyNameWithUnit(unit, asyncOrCallbackopt) → {Promise|Array.<String>}

批量获取组织的所有职务名称。

Syntax

//同步执行，返回职务名称数组。
var dutyNameList = this.org.listDutyNameWithUnit( unit );

//异步执行，返回Promise对象
var promise = this.org.listDutyNameWithUnit( unit, true);
promise.then(function(dutyNameList){
    //dutyNameList 返回职务名称数组。
})

//异步执行，在回调方法中获取
this.org.listDutyNameWithUnit( unit, function(dutyNameList){
    //dutyNameList 返回职务名称数组。
})

Parameters

unit UnitFlag | Array.<UnitFlag>
组织的distinguishedName、id、unique属性值，组织对象，或上述属性值和对象的数组。
asyncOrCallback Boolean | function <optional>

当参数为boolean，表示是否异步执行，默认为false。当参数为function，表示回调方法。

Returns

Promise Array.<String>
当async为true时，返回 Promise。否则返回职务名称数组。

Source

o2_core/o2/xScript/ViewEnvironment.js , line 1983

static

listUnitAllDuty(unit, asyncOrCallbackopt) → {Promise|Array.<Object>}

批量获取组织的所有职务。

Syntax

//同步执行，返回职务数组。
var dutyList = this.org.listUnitAllDuty( unit );

//异步执行，返回Promise对象
var promise = this.org.listUnitAllDuty( unit, true);
promise.then(function(dutyList){
    //dutyList 返回职务数组。
})

//异步执行，在回调方法中获取
this.org.listUnitAllDuty( unit, function(dutyList){
    //dutyList 返回职务数组。
})

Parameters

unit UnitFlag | Array.<UnitFlag>
组织的distinguishedName、id、unique属性值，组织对象，或上述属性值和对象的数组。
asyncOrCallback Boolean | function <optional>

当参数为boolean，表示是否异步执行，默认为false。当参数为function，表示回调方法。

Returns

Promise Array.<Object>
当async为true时，返回 Promise。否则返回职务数组

{
	"name": "部门领导",		//个人属性名称
	"unit": "开发部@kfb@U",		//组织
	"identityList": [
		{
			"matchKey": " ",		//匹配字段
			"name": " ",		//身份名称
			"unique": " ",		//身份标识
			"description": " ",		//说明
			"distinguishedName": " ",		//识别名
			"person": " ",		//人员
			"unit": " ",		//组织
			"unitName": " ",		//组织名称
			"unitLevel": 1,		//组织级别
			"unitLevelName": " ",		//组织级别名
			"orderNumber": 1,		//排序号
			"major": true,		//是否是设定的主身份
			"serialVersionUID": 1,
			"serialVersionUID": 1
		}
	] 		//身份对象
}

Source

o2_core/o2/xScript/ViewEnvironment.js , line 2023

static

getGroup(name, asyncOrCallbackopt) → {Promise|GroupData|Array.<GroupData>}

根据群组标识获取对应的群组对象或数组：group对象或数组

Syntax

//同步执行，返回群组，单个是Object，多个是Array。
var groupList = this.org.getGroup( name );

//异步执行，返回Promise对象
var promise = this.org.getGroup( name, true);
promise.then(function(groupList){
    //groupList 为返回的群组，单个是Object，多个是Array。
})

//异步执行，在回调方法中获取群组
this.org.getGroup( name, function(groupList){
    //groupList 为返回的群组，单个是Object，多个是Array。
})

Parameters

name GroupFlag | Array.<GroupFlag>
群组的distinguishedName、name、id、unique属性值，群组对象，或上述属性值和对象的数组。
asyncOrCallback Boolean | function <optional>

当参数为boolean，表示是否异步执行，默认为false。当参数为function，表示回调方法。

Returns

Promise GroupData Array.<GroupData>
当async为true时，返回 Promise。否则返回群组，单个是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

o2_core/o2/xScript/ViewEnvironment.js , line 2066

static

listSubGroup(name, nestedopt, asyncOrCallbackopt) → {Promise|Array.<GroupData>}

根据群组标识获取下级群组的对象数组：group对象数组。

Syntax

//同步执行，返回嵌套下级群组数组。
var groupList = this.org.listSubGroup( name, true );

//异步执行，返回Promise对象
var promise = this.org.listSubGroup( name, false, true);
promise.then(function(groupList){
    //groupList 为返回的直接下级群组数组。
})

//异步执行，在回调方法中获取群组
this.org.listSubGroup( name, true, function(groupList){
    //groupList 为返回嵌套下级群组数组。
})

Parameters

name GroupFlag | Array.<GroupFlag>
群组的distinguishedName、name、id、unique属性值，群组对象，或上述属性值和对象的数组。
nested Boolean <optional>

true嵌套的所有下级群组；false直接下级群组；默认false。
asyncOrCallback Boolean | function <optional>

当参数为boolean，表示是否异步执行，默认为false。当参数为function，表示回调方法。

Returns

Promise Array.<GroupData>
当async为true时，返回 Promise。否则返回群组数组。

{
	"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

o2_core/o2/xScript/ViewEnvironment.js , line 2115

static

listSupGroup(name, nestedopt, asyncOrCallbackopt) → {Promise|Array.<GroupData>}

根据群组标识获取上级群组的对象数组：group对象数组。

Syntax

//同步执行，返回嵌套上级群组数组。
var groupList = this.org.listSupGroup( name, true );

//异步执行，返回Promise对象
var promise = this.org.listSupGroup( name, false, true);
promise.then(function(groupList){
    //groupList 为返回的直接上级群组数组。
})

//异步执行，在回调方法中获取群组
this.org.listSupGroup( name, true, function(groupList){
    //groupList 为返回嵌套上级群组数组。
})

Parameters

name GroupFlag | Array.<GroupFlag>
群组的distinguishedName、name、id、unique属性值，群组对象，或上述属性值和对象的数组。
nested Boolean <optional>

true嵌套的所有上级群组；false直接上级群组；默认false。
asyncOrCallback Boolean | function <optional>

当参数为boolean，表示是否异步执行，默认为false。当参数为function，表示回调方法。

Returns

Promise Array.<GroupData>
当async为true时，返回 Promise。否则返回群组数组。

{
	"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

o2_core/o2/xScript/ViewEnvironment.js , line 2176

static

listGroupWithPerson(name, asyncOrCallbackopt) → {Promise|Array.<GroupData>}

根据人员标识获取所有的群组对象数组。如果群组具有群组（group）成员，且群组成员中包含该人员，那么该群组也被返回。

Syntax

//同步执行，返回群组数组。
var groupList = this.org.listGroupWithPerson( name );

//异步执行，返回Promise对象
var promise = this.org.listGroupWithPerson( name, true);
promise.then(function(groupList){
    //groupList 为返回的群组数组。
})

//异步执行，在回调方法中获取群组
this.org.listGroupWithPerson( name, function(groupList){
    //groupList 为返回的群组数组。
})

Parameters

name PersonFlag | Array.<PersonFlag>
人员的distinguishedName、id、unique属性值，人员对象，或上述属性值和对象的数组。
asyncOrCallback Boolean | function <optional>

当参数为boolean，表示是否异步执行，默认为false。当参数为function，表示回调方法。

Returns

Promise Array.<GroupData>
当async为true时，返回 Promise。否则返回群组对象数组。

{
	"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

o2_core/o2/xScript/ViewEnvironment.js , line 2231

static

listGroupWithIdentity(identity, asyncOrCallbackopt) → {Promise|Array.<GroupData>}

根据身份标识获取所有的群组对象数组。如果群组具有群组（group）成员，且群组成员中包含该身份，那么该群组也被返回。

Syntax

//同步执行，返回群组数组。
var groupList = this.org.listGroupWithIdentity( identity );

//异步执行，返回Promise对象
var promise = this.org.listGroupWithIdentity( identity, true);
promise.then(function(groupList){
    //groupList 为返回的群组数组。
})

//异步执行，在回调方法中获取群组
this.org.listGroupWithPerson( identity, function(groupList){
    //groupList 为返回的群组数组。
})

Parameters

identity IdentityFlag | Array.<IdentityFlag>
身份的distinguishedName、id、unique属性值，身份对象，或上述属性值和对象的数组。
asyncOrCallback Boolean | function <optional>

当参数为boolean，表示是否异步执行，默认为false。当参数为function，表示回调方法。

Returns

Promise Array.<GroupData>
当async为true时，返回 Promise。否则返回群组对象数组。

{
	"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

o2_core/o2/xScript/ViewEnvironment.js , line 2276

static

getRole(name, asyncOrCallbackopt) → {Promise|RoleData|Array.<RoleData>}

根据角色标识获取对应的角色对象或数组。

Syntax

//同步执行，返回角色，单个为对象，多个为数组。
var roleList = this.org.getRole( name );

//异步执行，返回Promise对象
var promise = this.org.getRole( name, true);
promise.then(function(roleList){
    //roleList 为返回的角色，单个为对象，多个为数组。
})

//异步执行，在回调方法中获取角色，单个为对象，多个为数组
this.org.getRole( name, function(roleList){
    //roleList 为返回判断结果。
})

Parameters

name RoleFlag | Array.<RoleFlag>
角色的distinguishedName、name、id、unique属性值，角色对象；或上述属性值和对象的数组。
asyncOrCallback Boolean | function <optional>

当参数为boolean，表示是否异步执行，默认为false。当参数为function，表示回调方法。

Returns

Promise RoleData Array.<RoleData>
当async为true时，返回 Promise。否则返回角色，单个为Object，多个为Array。

{
	"name": "Manager",		//角色名称
	"unique": "ManagerSystemRole",		//唯一标识
	"description": " ",		//说明
	"distinguishedName": "Manager@ManagerSystemRole@R",		//识别名
	"orderNumber": 7897556,		//排序号
	"personList": [
		"张三@zhangsan@P"
		"李四@lisi@P"
	],		//成员个人
	"groupList": [
		"测试群组@ceshizu@G"
	] 		//成员群组
}

Source

o2_core/o2/xScript/ViewEnvironment.js , line 2320

static

listRoleWithPerson(name, asyncOrCallbackopt) → {Promise|Array.<RoleData>}

根据人员标识获取所有的角色对象数组。如果角色具有群组（group）成员，且群组中包含该人员，那么该角色也被返回。

Syntax

//同步执行，返回角色数组。
var roleList = this.org.listRoleWithPerson( name );

//异步执行，返回Promise对象
var promise = this.org.listRoleWithPerson( name, true);
promise.then(function(roleList){
    //roleList 为返回的角色数组。
})

//异步执行，在回调方法中获取角色
this.org.listRoleWithPerson( name, function(roleList){
    //roleList 为返回的角色数组。
})

Parameters

name PersonFlag | Array.<PersonFlag>
人员的distinguishedName、id、unique属性值，人员对象，或上述属性值和对象的数组。
asyncOrCallback Boolean | function <optional>

当参数为boolean，表示是否异步执行，默认为false。当参数为function，表示回调方法。

Returns

Promise Array.<RoleData>
当async为true时，返回 Promise。否则返回角色对象数组。

{
	"name": "Manager",		//角色名称
	"unique": "ManagerSystemRole",		//唯一标识
	"description": " ",		//说明
	"distinguishedName": "Manager@ManagerSystemRole@R",		//识别名
	"orderNumber": 7897556,		//排序号
	"personList": [
		"张三@zhangsan@P"
		"李四@lisi@P"
	],		//成员个人
	"groupList": [
		"测试群组@ceshizu@G"
	] 		//成员群组
}

Source

o2_core/o2/xScript/ViewEnvironment.js , line 2367

static

personHasRole(name, roleList, asyncOrCallbackopt) → {Promise|Boolean}

人员是否拥有角色。

Syntax

//同步执行，返回判断结果。
var flag = this.org.personHasRole( name, roleList );

//异步执行，返回Promise对象
var promise = this.org.personHasRole( name, roleList, true);
promise.then(function(flag){
    //flag 为返回判断结果。
})

//异步执行，在回调方法中获取判断结果
this.org.personHasRole( name, roleList, function(flag){
    //flag 为返回判断结果。
})

Parameters

name PersonFlag
人员的distinguishedName、id、unique属性值，人员对象。
roleList RoleFlag | Array.<RoleFlag>
角色的distinguishedName、name、id、unique属性值，角色对象；或上述属性值和对象的数组。
asyncOrCallback Boolean | function <optional>

当参数为boolean，表示是否异步执行，默认为false。当参数为function，表示回调方法。

Returns

Promise Boolean
当async为true时，返回 Promise。否则如果人员拥有角色返回true, 否则返回false。

Source

o2_core/o2/xScript/ViewEnvironment.js , line 2414

static

groupHasRole(name, roleList, asyncOrCallbackopt) → {Promise|Boolean}

群组是否拥有角色。

Syntax

//同步执行，返回判断结果。
var groupList = this.org.groupHasRole( name, roleList );

//异步执行，返回Promise对象
var promise = this.org.groupHasRole( name, roleList, true);
promise.then(function(flag){
    //flag 为返回判断结果。
})

//异步执行，在回调方法中获取判断结果
this.org.groupHasRole( name, roleList, function(flag){
    //flag 为返回判断结果。
})

Parameters

name GroupFlag
群组的distinguishedName、name、id、unique属性值，群组对象。
roleList RoleFlag | Array.<RoleFlag>
角色的distinguishedName、name、id、unique属性值，角色对象；或上述属性值和对象的数组。
asyncOrCallback Boolean | function <optional>

当参数为boolean，表示是否异步执行，默认为false。当参数为function，表示回调方法。

Returns

Promise Boolean
当async为true时，返回 Promise。否则如果群组拥有角色返回true, 否则返回false。

Source

o2_core/o2/xScript/ViewEnvironment.js , line 2461

static

appendPersonAttribute(person, attr, values, successopt, failureopt, asyncopt)

添加人员属性值(在属性中添加values值，如果没有此属性，则创建一个)

Syntax

//同步执行
this.org.appendPersonAttribute( person, attribute, valueArray);

//异步执行
this.org.appendPersonAttribute( person, attribute, valueArray, function(){
    //执行成功的回调
}, null, true);

Parameters

person PersonFlag
人员的distinguishedName、id、unique属性值，人员对象。
attr String
属性名称。
values Array.<String>
属性值，必须为数组。
success function <optional>

执行成功的回调。
failure function <optional>

执行失败的回调。
async Boolean <optional>

当参数为boolean，表示是否异步执行，默认为false。

Source

o2_core/o2/xScript/ViewEnvironment.js , line 2510

static

setPersonAttribute(person, attr, values, successopt, failureopt, asyncopt)

设置人员属性值(将属性值修改为values，如果没有此属性，则创建一个)

Syntax

//同步执行
this.org.setPersonAttribute( person, attribute, valueArray);

//异步执行
this.org.setPersonAttribute( person, attribute, valueArray, function(){
    //执行成功的回调
}, null, true);

Parameters

person PersonFlag
人员的distinguishedName、id、unique属性值，人员对象。
attr String
属性名称。
values Array.<String>
属性值，必须为数组。
success function <optional>

执行成功的回调。
failure function <optional>

执行失败的回调。
async Boolean <optional>

当参数为boolean，表示是否异步执行，默认为false。

Source

o2_core/o2/xScript/ViewEnvironment.js , line 2554

static

getPersonAttribute(person, attr, asyncOrCallbackopt) → {Array.<String>}

根据人员和属性名称获取属性值数组。

Syntax

//同步执行，返回该人员的属性值数组。
var attributeList = this.org.getPersonAttribute( person, attr );

//异步执行，返回Promise对象
var promise = this.org.getPersonAttribute( person, attr, true);
promise.then(function(attributeList){
    //attributeList 为返回该人员的属性值数组。
})

//异步执行，在回调方法中获取
this.org.getPersonAttribute( person, attr, function(attributeList){
    //attributeList 为返回该人员的属性值数组。
})

Parameters

person PersonFlag
人员的distinguishedName、id、unique属性值，人员对象。
attr String
属性名称。
asyncOrCallback Boolean | function <optional>

当参数为boolean，表示是否异步执行，默认为false。当参数为function，表示回调方法。

Returns

Array.<String>
当async为true时，返回 Promise。否则返回属性值数组，如：
```
[ value1, value2 ]
```

Source

o2_core/o2/xScript/ViewEnvironment.js , line 2598

static

listPersonAttributeName(name, asyncOrCallbackopt) → {Array.<String>}

列出人员所有属性的名称数组。

Syntax

//同步执行，返回人员所有属性的名称数组。
var attributeNameList = this.org.listPersonAttributeName( person );

//异步执行，返回Promise对象
var promise = this.org.listPersonAttributeName( person, true);
promise.then(function(attributeNameList){
    //attributeNameList 为人员所有属性的名称数组。
})

//异步执行，在回调方法中获取
this.org.listPersonAttributeName( person, function(attributeNameList){
    //attributeNameList 为人员所有属性的名称数组。
})

Parameters

name PersonFlag | Array.<PersonFlag>
人员的distinguishedName、id、unique属性值，人员对象，或上述属性值和对象的数组。
asyncOrCallback Boolean | function <optional>

当参数为boolean，表示是否异步执行，默认为false。当参数为function，表示回调方法。

Returns

Array.<String>
当async为true时，返回 Promise。否则返回人员属性名称数组，如：
```
[ attributeName1, attributeName2 ]
```

Source

o2_core/o2/xScript/ViewEnvironment.js , line 2641

static

listPersonAllAttribute(name, asyncOrCallbackopt) → {Array.<Object>}

列出人员的所有属性对象数组。

Syntax

//同步执行，返回人员所有属性的对象数组。
var attributeObjectList = this.org.listPersonAllAttribute( person );

//异步执行，返回Promise对象
var promise = this.org.listPersonAllAttribute( person, true);
promise.then(function(attributeObjectList){
    //attributeObjectList 为人员所有属性的对象数组。
})

//异步执行，在回调方法中获取
this.org.listPersonAllAttribute( person, function(attributeObjectList){
    //attributeObjectList 为人员所有属性的对象数组。
})

Parameters

name PersonFlag | Array.<PersonFlag>
人员的distinguishedName、id、unique属性值，人员对象，或上述属性值和对象的数组。
asyncOrCallback Boolean | function <optional>

当参数为boolean，表示是否异步执行，默认为false。当参数为function，表示回调方法。

Returns

Array.<Object>

当async为true时，返回 Promise。否则返回人员属性对象数组，如：

[{
   "name": "住址",
   "person": "张三@zhangsan@P",
   "attributeList": [
       "杭州市","绍兴市"
   ]
}]

Source

o2_core/o2/xScript/ViewEnvironment.js , line 2682

static

appendUnitAttribute(unit, attribute, valueArray, successopt, failureopt, asyncopt)

添加组织属性值(在属性中添加values值，如果没有此属性，则创建一个)

Syntax

//同步执行
this.org.appendUnitAttribute( unit, attribute, valueArray);

//异步执行
this.org.appendUnitAttribute( unit, attribute, valueArray, function(){
    //执行成功的回调
}, null, true);

Parameters

unit UnitFlag
组织的distinguishedName、id、unique属性值，组织对象。
attribute String
属性名称。
valueArray Array.<String>
属性值，必须为数组。
success function <optional>

执行成功的回调。
failure function <optional>

执行失败的回调。
async Boolean <optional>

当参数为boolean，表示是否异步执行，默认为false。

Source

o2_core/o2/xScript/ViewEnvironment.js , line 2731

static

setUnitAttribute(unit, attribute, valueArray, successopt, failureopt, asyncopt)

设置组织属性值(将属性值修改为values，如果没有此属性，则创建一个)

Syntax

//同步执行
this.org.setUnitAttribute( unit, attribute, valueArray);

//异步执行
this.org.setUnitAttribute( unit, attribute, valueArray, function(){
    //执行成功的回调
}, null, true);

Parameters

unit UnitFlag
组织的distinguishedName、id、unique属性值，组织对象。
attribute String
属性名称。
valueArray Array.<String>
属性值，必须为数组。
success function <optional>

执行成功的回调。
failure function <optional>

执行失败的回调。
async Boolean <optional>

当参数为boolean，表示是否异步执行，默认为false。

Source

o2_core/o2/xScript/ViewEnvironment.js , line 2785

static

getUnitAttribute(unit, attr, asyncOrCallbackopt) → {Array.<String>}

根据组织标识和属性名称获取对应属性值。

Syntax

//同步执行，返回该组织的属性值数组。
var attributeList = this.org.getUnitAttribute( unit, attr );

//异步执行，返回Promise对象
var promise = this.org.getUnitAttribute( unit, attr, true);
promise.then(function(attributeList){
    //attributeList 为返回该组织的属性值数组。
})

//异步执行，在回调方法中获取
this.org.getUnitAttribute( unit, attr, function(attributeList){
    //attributeList 为返回该组织的属性值数组。
})

Parameters

unit UnitFlag
组织的distinguishedName、id、unique属性值，组织对象。
attr String
属性名称。
asyncOrCallback Boolean | function <optional>

当参数为boolean，表示是否异步执行，默认为false。当参数为function，表示回调方法。

Returns

Array.<String>
当async为true时，返回 Promise。否则返回属性值数组，如：
```
[ value1, value2 ]
```

Source

o2_core/o2/xScript/ViewEnvironment.js , line 2838

static

listUnitAttributeName(name, asyncOrCallbackopt) → {Array.<String>}

列出组织所有属性的名称数组。

Syntax

//同步执行，返回组织所有属性的名称数组。
var attributeNameList = this.org.listUnitAttributeName( unit );

//异步执行，返回Promise对象
var promise = this.org.listUnitAttributeName( unit, true);
promise.then(function(attributeNameList){
    //attributeNameList 为组织所有属性的名称数组。
})

//异步执行，在回调方法中获取
this.org.listUnitAttributeName( unit, function(attributeNameList){
    //attributeNameList 为组织所有属性的名称数组。
})

Parameters

name UnitFlag | Array.<UnitFlag>
组织的distinguishedName、id、unique属性值，组织对象，或上述属性值和对象的数组。
asyncOrCallback Boolean | function <optional>

当参数为boolean，表示是否异步执行，默认为false。当参数为function，表示回调方法。

Returns

Array.<String>
当async为true时，返回 Promise。否则返回组织属性名称数组，如：
```
[ attributeName1, attributeName2 ]
```

Source

o2_core/o2/xScript/ViewEnvironment.js , line 2881

static

listUnitAllAttribute(name, asyncOrCallbackopt) → {Array.<Object>}

列出组织的所有属性对象数组。

Syntax

//同步执行，返回组织所有属性的对象数组。
var attributeObjectList = this.org.listUnitAllAttribute( unit );

//异步执行，返回Promise对象
var promise = this.org.listUnitAllAttribute( unit, true);
promise.then(function(attributeObjectList){
    //attributeObjectList 为组织所有属性的对象数组。
})

//异步执行，在回调方法中获取
this.org.listUnitAllAttribute( unit, function(attributeObjectList){
    //attributeObjectList 为组织所有属性的对象数组。
})

Parameters

name UnitFlag | Array.<UnitFlag>
组织的distinguishedName、id、unique属性值，组织对象，或上述属性值和对象的数组。
asyncOrCallback Boolean | function <optional>

当参数为boolean，表示是否异步执行，默认为false。当参数为function，表示回调方法。

Returns

Array.<Object>

当async为true时，返回 Promise。否则返回组织属性对象数组，如：

[{
   "name": "部门类别",
   "unit": "开发部@kfb@U",
   "attributeList": [
       "生产部门",
       "二级部门"
   ]
}]

Source

o2_core/o2/xScript/ViewEnvironment.js , line 2922

org

Syntax

Source

Methods

getIdentity(name, asyncOrCallbackopt) → {Promise|IdentityData|Array.<IdentityData>}

Syntax

Parameters

Returns

Source

listIdentityWithPerson(name, asyncOrCallbackopt, findCNopt) → {Promise|Array.<IdentityData>}

Syntax

Parameters

Returns

Source

listIdentityWithUnit(name, nestedopt, asyncOrCallbackopt) → {Promise|Array.<IdentityData>}

Syntax

Parameters

Returns

Source

getUnit(name, asyncOrCallbackopt, findCNopt) → {Promise|UnitData|Array.<UnitData>}

Syntax

Parameters

Returns

Source

listSubUnit(name, nestedopt, asyncOrCallbackopt) → {Promise|Array.<UnitData>}

Syntax

Parameters

Returns

Source

listSupUnit(name, nestedopt, asyncOrCallbackopt) → {Promise|Array.<UnitData>}

Syntax

Parameters

Returns

Source

getUnitByIdentity(name, flagopt, asyncOrCallbackopt) → {Promise|UnitData|Array.<UnitData>}

Syntax

Parameters

Returns

Source

listAllSupUnitWithIdentity(name, asyncOrCallbackopt) → {Promise|Array.<UnitData>}

Syntax

Parameters

Returns

Source

listUnitWithPerson(name, asyncOrCallbackopt) → {Promise|Array.<UnitData>}

Syntax

Parameters

Returns

Source

listAllSupUnitWithPerson(name, asyncOrCallbackopt) → {Promise|Array.<UnitData>}

Syntax

Parameters

Returns

Source

listUnitWithAttribute(attributeName, attributeValue, asyncOrCallbackopt) → {Promise|Array.<UnitData>}

Syntax

Parameters

Returns

Source

listUnitWithDuty(dutyName, identity, asyncOrCallbackopt) → {Promise|Array.<UnitData>}

Syntax

Parameters

Returns

Source

listTopUnit(asyncOrCallbackopt) → {Promise|Array.<UnitData>}

Syntax

Parameters

Returns

Source

getPersonData(name, asyncOrCallbackopt) → {Promise|PersonData}

Syntax

Parameters

Returns

Source

getPerson(name, asyncOrCallbackopt, findCNopt) → {Promise|PersonData|Array.<PersonData>}

Syntax

Parameters

Returns

Source

listSubPerson(name, nestedopt, asyncOrCallbackopt) → {Promise|Array.<PersonData>}