400-888-0545

O2OA前台API

Module

org

您可以通过this.org获取组织中的人员、人员属性、组织、组织属性、身份、群组和角色。

Syntax

//您可以在流程表单、内容管理表单、门户页面、视图和查询视图中,通过this来获取当前实例的org对象,如下:
var org = this.org;

Source

Methods

static

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

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

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、name、id、unique属性值,身份对象,或上述属性值和对象的数组。

  • asyncOrCallback Boolean | function

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

Returns

  • Promise IdentityData Array.

    当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": "2021-02-07 14:56:05",		//创建时间,自动生成,索引创建在约束中.
	"updateTime": "2021-02-07 14:56:05" 		//修改时间,自动生成,索引创建在约束中.
}

Source

static

listIdentityWithPerson(name, asyncOrCallbackopt) → {Promise|Array.}

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

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、name、id、unique属性值,人员对象,或上述属性值和对象的数组。

  • asyncOrCallback Boolean | function

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

Returns

  • Promise Array.

    当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

static

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

根据组织标识获取对应的身份对象数组: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、name、id、unique属性值,组织对象,或上述属性值和对象的数组。

  • nested Boolean

    true嵌套的所有身份成员;false直接身份成员;默认false。

  • asyncOrCallback Boolean | function

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

Returns

  • Promise Array.

    当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

static

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

根据组织标识获取对应的组织: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、name、id、unique属性值,组织对象,或上述属性值和对象的数组。

  • asyncOrCallback Boolean | function

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

Returns

  • Promise UnitData Array.

    当async为true时,返回 Promise。 否则返回组织,单个是Object,多个是Array。

{
	"matchKey": " ",		//匹配字段
	"subDirectUnitCount": 1,		//直接下级组织数量
	"subDirectIdentityCount": 1,		//直接下级身份数量
	"id": " ",		//数据库主键,自动生成.
	"name": "开发部",		//名称,可以重名.
	"unique": "kfb",		//唯一标识,不可重复,为空则使用自动填充值
	"distinguishedName": "开发部@kfb@U",		//识别名.以@U结尾.
	"typeList": [
		"部门"
	],		//组织类型.
	"pinyin": " ",		//name拼音,自动生成
	"pinyinInitial": " ",		//name拼音首字母,自动生成
	"description": " ",		//描述.
	"shortName": "kfb",		//组织简称。
	"level": 2,		//组织级别,1为最上层组织.自动计算.
	"levelName": "浙江兰德纵横/开发部",		//显示的层级名.
	"superior": "浙江兰德纵横@a706f5f0-4a3b-4785-8e1d-0a944bfad4eb@U",		//上级组织.
	"orderNumber": 1,		//排序号,升序排列,为空在最后
	"dingdingId": " ",		//钉钉部门ID.
	"dingdingHash": " ",		//钉钉部门哈希特征.
	"weLinkId": " ",		//WeLink部门ID.
	"weLinkHash": " ",		//WeLink部门哈希特征.
	"qiyeweixinId": " ",		//企业微信人员ID.
	"zhengwuDingdingId": " ",		//政务钉钉人员ID.
	"zhengwuDingdingHash": " ",		//政务钉钉人员哈希特征.
	"qiyeweixinHash": " ",		//企业微信人员哈希特征.
	"createTime": "2021-02-07 14:56:05",		//创建时间,自动生成,索引创建在约束中.
	"updateTime": "2021-02-07 14:56:05" 		//修改时间,自动生成,索引创建在约束中.
}

Source

static

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

根据组织标识获取下级组织的对象数组: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、name、id、unique属性值,组织对象,或上述属性值和对象的数组。

  • nested Boolean

    true嵌套的所有下级组织;false直接下级组织;默认false。

  • asyncOrCallback Boolean | function

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

Returns

  • Promise Array.

    当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,		//排序号
	"qiyeweixinId": " ",		//企业微信Id
	"dingdingId": " ",		//钉钉Id
	"zhengwuDingdingId": " ",		//政务钉钉Id
	"weLinkId": " " 		//华为WeLink Id
}

Source

static

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

根据组织标识批量获取上级组织的对象数组: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、name、id、unique属性值,组织对象,或上述属性值和对象的数组。

  • nested Boolean

    true嵌套的所有上级组织;false直接上级组织;默认false。

  • asyncOrCallback Boolean | function

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

Returns

  • Promise Array.

    当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,		//排序号
	"qiyeweixinId": " ",		//企业微信Id
	"dingdingId": " ",		//钉钉Id
	"zhengwuDingdingId": " ",		//政务钉钉Id
	"weLinkId": " " 		//华为WeLink Id
}

Source

static

getUnitByIdentity(name, flagopt, asyncOrCallbackopt) → {Promise|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" );

//异步执行,返回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、name、id、unique属性值,身份对象。

  • flag String | Number

    当值为数字的时候, 表示获取第几层的组织。
    当值为字符串的时候,表示获取指定类型的组织。
    当值为空的时候,表示获取直接所在组织。

  • asyncOrCallback Boolean | function

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

Returns

  • Promise UnitData Array.

    当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,		//排序号
	"qiyeweixinId": " ",		//企业微信Id
	"dingdingId": " ",		//钉钉Id
	"zhengwuDingdingId": " ",		//政务钉钉Id
	"weLinkId": " " 		//华为WeLink Id
}

Source

static

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

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

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、name、id、unique属性值,身份对象,或上述属性值和对象的数组。

  • asyncOrCallback Boolean | function

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

Returns

  • Promise Array.

    当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,		//排序号
	"qiyeweixinId": " ",		//企业微信Id
	"dingdingId": " ",		//钉钉Id
	"zhengwuDingdingId": " ",		//政务钉钉Id
	"weLinkId": " " 		//华为WeLink Id
}

Source

static

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

根据个人标识批量获取组织对象成员: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、name、id、unique属性值,人员对象,或上述属性值和对象的数组。

  • asyncOrCallback Boolean | function

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

Returns

  • Promise Array.

    当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,		//排序号
	"qiyeweixinId": " ",		//企业微信Id
	"dingdingId": " ",		//钉钉Id
	"zhengwuDingdingId": " ",		//政务钉钉Id
	"weLinkId": " " 		//华为WeLink Id
}

Source

static

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

根据个人标识批量查询所在组织及所有上级组织: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、name、id、unique属性值,人员对象,或上述属性值和对象的数组。

  • asyncOrCallback Boolean | function

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

Returns

  • Promise Array.

    当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,		//排序号
	"qiyeweixinId": " ",		//企业微信Id
	"dingdingId": " ",		//钉钉Id
	"zhengwuDingdingId": " ",		//政务钉钉Id
	"weLinkId": " " 		//华为WeLink Id
}

Source

static

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

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

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

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

Returns

  • Promise Array.

    当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,		//排序号
	"qiyeweixinId": " ",		//企业微信Id
	"dingdingId": " ",		//钉钉Id
	"zhengwuDingdingId": " ",		//政务钉钉Id
	"weLinkId": " " 		//华为WeLink Id
}

Source

static

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

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

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、name、id、unique属性值,身份对象。

  • asyncOrCallback Boolean | function

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

Returns

  • Promise Array.

    当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,		//排序号
	"qiyeweixinId": " ",		//企业微信Id
	"dingdingId": " ",		//钉钉Id
	"zhengwuDingdingId": " ",		//政务钉钉Id
	"weLinkId": " " 		//华为WeLink Id
}

Source

static

listTopUnit(asyncOrCallbackopt) → {Promise|Array.}

列式所有顶层组织。

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

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

Returns

  • Promise Array.

    当async为true时,返回 Promise。 否则返回顶层组织数组。

{
	"matchKey": " ",		//匹配字段
	"subDirectUnitCount": 1,		//直接下级组织数量
	"subDirectIdentityCount": 1,		//直接下级身份数量
	"id": " ",		//数据库主键,自动生成.
	"name": "开发部",		//名称,可以重名.
	"unique": "kfb",		//唯一标识,不可重复,为空则使用自动填充值
	"distinguishedName": "开发部@kfb@U",		//识别名.以@U结尾.
	"typeList": [
		"部门"
	],		//组织类型.
	"pinyin": " ",		//name拼音,自动生成
	"pinyinInitial": " ",		//name拼音首字母,自动生成
	"description": " ",		//描述.
	"shortName": "kfb",		//组织简称。
	"level": 2,		//组织级别,1为最上层组织.自动计算.
	"levelName": "浙江兰德纵横/开发部",		//显示的层级名.
	"superior": "浙江兰德纵横@a706f5f0-4a3b-4785-8e1d-0a944bfad4eb@U",		//上级组织.
	"orderNumber": 1,		//排序号,升序排列,为空在最后
	"dingdingId": " ",		//钉钉部门ID.
	"dingdingHash": " ",		//钉钉部门哈希特征.
	"weLinkId": " ",		//WeLink部门ID.
	"weLinkHash": " ",		//WeLink部门哈希特征.
	"qiyeweixinId": " ",		//企业微信人员ID.
	"zhengwuDingdingId": " ",		//政务钉钉人员ID.
	"zhengwuDingdingHash": " ",		//政务钉钉人员哈希特征.
	"qiyeweixinHash": " ",		//企业微信人员哈希特征.
	"createTime": "2021-02-07 14:56:05",		//创建时间,自动生成,索引创建在约束中.
	"updateTime": "2021-02-07 14:56:05" 		//修改时间,自动生成,索引创建在约束中.
}

Source

static

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

根据人员标识获取对应的人员对象或数组: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、name、id、unique属性值,人员对象,或上述属性值和对象的数组。

  • asyncOrCallback Boolean | function

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

Returns

  • Promise PersonData Array.

    当async为true时,返回 Promise。 否则返回人员,单个是Object,多个是Array。

{
	"matchKey": " ",		//匹配字段
	"id": " ",		//数据库主键
	"name": "李四",		//个人名称
	"genderType": " ",//可选值:f,m,d,		//性别,m:男,f:女,d:未知
	"signature": " ",		//签名
	"description": " ",		//说明
	"employee": "1111",		//员工号
	"unique": "lisi",		//唯一标识
	"distinguishedName": "李四@lisi@P",		//识别名
	"orderNumber": 14214946,		//排序号
	"superior": " ",		//主管
	"mail": " ",		//邮件地址
	"weixin": " ",		//微信号
	"qq": " ",		//qq号
	"mobile": "85252281460",		//手机号
	"officePhone": " ",		//办公电话
	"boardDate": "2021-02-07 14:56:05",		//入职时间
	"birthday": "2021-02-07 14:56:05",		//生日
	"age": 1,		//年龄
	"qiyeweixinId": " ",		//企业微信Id
	"dingdingId": " ",		//钉钉Id
	"zhengwuDingdingId": " ",		//政务钉钉Id
	"weLinkId": " " 		//华为WeLink id
}

Source

static

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

根据人员标识获取下级人员的对象数组: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、name、id、unique属性值,人员对象,或上述属性值和对象的数组。

  • nested Boolean

    true嵌套的所有下级人员;false直接下级人员;默认false。

  • asyncOrCallback Boolean | function

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

Returns

  • Promise Array.

    当async为true时,返回 Promise。 否则返回人员数组。

{
	"matchKey": " ",		//匹配字段
	"id": " ",		//数据库主键
	"name": "李四",		//个人名称
	"genderType": " ",//可选值:f,m,d,		//性别,m:男,f:女,d:未知
	"signature": " ",		//签名
	"description": " ",		//说明
	"employee": "1111",		//员工号
	"unique": "lisi",		//唯一标识
	"distinguishedName": "李四@lisi@P",		//识别名
	"orderNumber": 14214946,		//排序号
	"superior": " ",		//主管
	"mail": " ",		//邮件地址
	"weixin": " ",		//微信号
	"qq": " ",		//qq号
	"mobile": "85252281460",		//手机号
	"officePhone": " ",		//办公电话
	"boardDate": "2021-02-07 14:56:05",		//入职时间
	"birthday": "2021-02-07 14:56:05",		//生日
	"age": 1,		//年龄
	"qiyeweixinId": " ",		//企业微信Id
	"dingdingId": " ",		//钉钉Id
	"zhengwuDingdingId": " ",		//政务钉钉Id
	"weLinkId": " " 		//华为WeLink id
}

Source

static

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

根据人员标识获取上级人员的对象数组: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、name、id、unique属性值,人员对象,或上述属性值和对象的数组。

  • nested Boolean

    true嵌套的所有上级人员;false直接上级人员;默认false。

  • asyncOrCallback Boolean | function

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

Returns

  • Promise Array.

    当async为true时,返回 Promise。 否则返回人员数组。

{
	"matchKey": " ",		//匹配字段
	"id": " ",		//数据库主键
	"name": "李四",		//个人名称
	"genderType": " ",//可选值:f,m,d,		//性别,m:男,f:女,d:未知
	"signature": " ",		//签名
	"description": " ",		//说明
	"employee": "1111",		//员工号
	"unique": "lisi",		//唯一标识
	"distinguishedName": "李四@lisi@P",		//识别名
	"orderNumber": 14214946,		//排序号
	"superior": " ",		//主管
	"mail": " ",		//邮件地址
	"weixin": " ",		//微信号
	"qq": " ",		//qq号
	"mobile": "85252281460",		//手机号
	"officePhone": " ",		//办公电话
	"boardDate": "2021-02-07 14:56:05",		//入职时间
	"birthday": "2021-02-07 14:56:05",		//生日
	"age": 1,		//年龄
	"qiyeweixinId": " ",		//企业微信Id
	"dingdingId": " ",		//钉钉Id
	"zhengwuDingdingId": " ",		//政务钉钉Id
	"weLinkId": " " 		//华为WeLink id
}

Source

static

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

根据群组标识获取人员对象成员: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

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

Returns

  • Promise Array.

    当async为true时,返回 Promise。 否则返回人员对象数组。

{
	"matchKey": " ",		//匹配字段
	"id": " ",		//数据库主键
	"name": "李四",		//个人名称
	"genderType": " ",//可选值:f,m,d,		//性别,m:男,f:女,d:未知
	"signature": " ",		//签名
	"description": " ",		//说明
	"employee": "1111",		//员工号
	"unique": "lisi",		//唯一标识
	"distinguishedName": "李四@lisi@P",		//识别名
	"orderNumber": 14214946,		//排序号
	"superior": " ",		//主管
	"mail": " ",		//邮件地址
	"weixin": " ",		//微信号
	"qq": " ",		//qq号
	"mobile": "85252281460",		//手机号
	"officePhone": " ",		//办公电话
	"boardDate": "2021-02-07 14:56:05",		//入职时间
	"birthday": "2021-02-07 14:56:05",		//生日
	"age": 1,		//年龄
	"qiyeweixinId": " ",		//企业微信Id
	"dingdingId": " ",		//钉钉Id
	"zhengwuDingdingId": " ",		//政务钉钉Id
	"weLinkId": " " 		//华为WeLink id
}

Source

static

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

根据角色标识获取人员对象数组: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

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

Returns

  • Promise Array.

    当async为true时,返回 Promise。 否则返回人员对象数组。

{
	"matchKey": " ",		//匹配字段
	"id": " ",		//数据库主键
	"name": "李四",		//个人名称
	"genderType": " ",//可选值:f,m,d,		//性别,m:男,f:女,d:未知
	"signature": " ",		//签名
	"description": " ",		//说明
	"employee": "1111",		//员工号
	"unique": "lisi",		//唯一标识
	"distinguishedName": "李四@lisi@P",		//识别名
	"orderNumber": 14214946,		//排序号
	"superior": " ",		//主管
	"mail": " ",		//邮件地址
	"weixin": " ",		//微信号
	"qq": " ",		//qq号
	"mobile": "85252281460",		//手机号
	"officePhone": " ",		//办公电话
	"boardDate": "2021-02-07 14:56:05",		//入职时间
	"birthday": "2021-02-07 14:56:05",		//生日
	"age": 1,		//年龄
	"qiyeweixinId": " ",		//企业微信Id
	"dingdingId": " ",		//钉钉Id
	"zhengwuDingdingId": " ",		//政务钉钉Id
	"weLinkId": " " 		//华为WeLink id
}

Source

static

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

根据身份标识获取人员对象成员: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、name、id、unique属性值,身份对象,或上述属性值和对象的数组。

  • asyncOrCallback Boolean | function

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

Returns

  • Promise Array.

    当async为true时,返回 Promise。 否则返回人员对象数组。

{
	"matchKey": " ",		//匹配字段
	"id": " ",		//数据库主键
	"name": "李四",		//个人名称
	"genderType": " ",//可选值:f,m,d,		//性别,m:男,f:女,d:未知
	"signature": " ",		//签名
	"description": " ",		//说明
	"employee": "1111",		//员工号
	"unique": "lisi",		//唯一标识
	"distinguishedName": "李四@lisi@P",		//识别名
	"orderNumber": 14214946,		//排序号
	"superior": " ",		//主管
	"mail": " ",		//邮件地址
	"weixin": " ",		//微信号
	"qq": " ",		//qq号
	"mobile": "85252281460",		//手机号
	"officePhone": " ",		//办公电话
	"boardDate": "2021-02-07 14:56:05",		//入职时间
	"birthday": "2021-02-07 14:56:05",		//生日
	"age": 1,		//年龄
	"qiyeweixinId": " ",		//企业微信Id
	"dingdingId": " ",		//钉钉Id
	"zhengwuDingdingId": " ",		//政务钉钉Id
	"weLinkId": " " 		//华为WeLink id
}

Source

static

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

根据组织标识获取人员对象成员: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、name、id、unique属性值,组织对象,或上述属性值和对象的数组。

  • nested Boolean

    是否嵌套获取组织以及下级组织的人员,true表示嵌套,flase表示获取直接组织。默认为false

  • asyncOrCallback Boolean | function

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

Returns

  • Promise Array.

    当async为true时,返回 Promise。 否则返回人员对象数组。

{
	"matchKey": " ",		//匹配字段
	"id": " ",		//数据库主键
	"name": "李四",		//个人名称
	"genderType": " ",//可选值:f,m,d,		//性别,m:男,f:女,d:未知
	"signature": " ",		//签名
	"description": " ",		//说明
	"employee": "1111",		//员工号
	"unique": "lisi",		//唯一标识
	"distinguishedName": "李四@lisi@P",		//识别名
	"orderNumber": 14214946,		//排序号
	"superior": " ",		//主管
	"mail": " ",		//邮件地址
	"weixin": " ",		//微信号
	"qq": " ",		//qq号
	"mobile": "85252281460",		//手机号
	"officePhone": " ",		//办公电话
	"boardDate": "2021-02-07 14:56:05",		//入职时间
	"birthday": "2021-02-07 14:56:05",		//生日
	"age": 1,		//年龄
	"qiyeweixinId": " ",		//企业微信Id
	"dingdingId": " ",		//钉钉Id
	"zhengwuDingdingId": " ",		//政务钉钉Id
	"weLinkId": " " 		//华为WeLink id
}

Source

static

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

根据人员属性名称和属性值获取人员对象成员: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

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

Returns

  • Promise Array.

    当async为true时,返回 Promise。 否则返回人员对象数组。

{
	"matchKey": " ",		//匹配字段
	"id": " ",		//数据库主键
	"name": "李四",		//个人名称
	"genderType": " ",//可选值:f,m,d,		//性别,m:男,f:女,d:未知
	"signature": " ",		//签名
	"description": " ",		//说明
	"employee": "1111",		//员工号
	"unique": "lisi",		//唯一标识
	"distinguishedName": "李四@lisi@P",		//识别名
	"orderNumber": 14214946,		//排序号
	"superior": " ",		//主管
	"mail": " ",		//邮件地址
	"weixin": " ",		//微信号
	"qq": " ",		//qq号
	"mobile": "85252281460",		//手机号
	"officePhone": " ",		//办公电话
	"boardDate": "2021-02-07 14:56:05",		//入职时间
	"birthday": "2021-02-07 14:56:05",		//生日
	"age": 1,		//年龄
	"qiyeweixinId": " ",		//企业微信Id
	"dingdingId": " ",		//钉钉Id
	"zhengwuDingdingId": " ",		//政务钉钉Id
	"weLinkId": " " 		//华为WeLink id
}

Source

static

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

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

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、name、id、unique属性值,组织对象。

  • asyncOrCallback Boolean | function

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

Returns

  • Promise Array.

    当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": "2021-02-07 14:56:05",		//创建时间,自动生成,索引创建在约束中.
	"updateTime": "2021-02-07 14:56:05" 		//修改时间,自动生成,索引创建在约束中.
}

Source

static

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

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

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、name、id、unique属性值,身份对象,或上述属性值和对象的数组。

  • asyncOrCallback Boolean | function

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

Returns

  • Promise Array.

    当async为true时,返回 Promise。 否则返回职务名称数组。

Source

static

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

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

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、name、id、unique属性值,组织对象,或上述属性值和对象的数组。

  • asyncOrCallback Boolean | function

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

Returns

  • Promise Array.

    当async为true时,返回 Promise。 否则返回职务名称数组。

Source

static

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

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

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、name、id、unique属性值,组织对象,或上述属性值和对象的数组。

  • asyncOrCallback Boolean | function

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

Returns

  • Promise Array.

    当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 
		}
	] 		//身份对象
}

Source

static

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

根据群组标识获取对应的群组对象或数组: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

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

Returns

  • Promise GroupData Array.

    当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": [
		" "
	],		//组织成员
	"identityList": [
		" "
	],		//身份成员
	"subDirectGroupCount": 1,		//直接下级组织数量
	"subDirectPersonCount": 1,		//直接下级用户数量
	"subDirectIdentityCount": 1,		//直接下级身份数量
	"subDirectOrgCount": 1 		//直接下级组织数量
}

Source

static

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

根据群组标识获取下级群组的对象数组: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

    true嵌套的所有下级群组;false直接下级群组;默认false。

  • asyncOrCallback Boolean | function

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

Returns

  • Promise Array.

    当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": [
		" "
	],		//组织成员
	"identityList": [
		" "
	],		//身份成员
	"subDirectGroupCount": 1,		//直接下级组织数量
	"subDirectPersonCount": 1,		//直接下级用户数量
	"subDirectIdentityCount": 1,		//直接下级身份数量
	"subDirectOrgCount": 1 		//直接下级组织数量
}

Source

static

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

根据群组标识获取上级群组的对象数组: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

    true嵌套的所有上级群组;false直接上级群组;默认false。

  • asyncOrCallback Boolean | function

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

Returns

  • Promise Array.

    当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": [
		" "
	],		//组织成员
	"identityList": [
		" "
	],		//身份成员
	"subDirectGroupCount": 1,		//直接下级组织数量
	"subDirectPersonCount": 1,		//直接下级用户数量
	"subDirectIdentityCount": 1,		//直接下级身份数量
	"subDirectOrgCount": 1 		//直接下级组织数量
}

Source

static

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

根据人员标识获取所有的群组对象数组。如果群组具有群组(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、name、id、unique属性值,人员对象,或上述属性值和对象的数组。

  • asyncOrCallback Boolean | function

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

Returns

  • Promise Array.

    当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": [
		" "
	],		//组织成员
	"identityList": [
		" "
	],		//身份成员
	"subDirectGroupCount": 1,		//直接下级组织数量
	"subDirectPersonCount": 1,		//直接下级用户数量
	"subDirectIdentityCount": 1,		//直接下级身份数量
	"subDirectOrgCount": 1 		//直接下级组织数量
}

Source

static

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

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

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

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

Returns

  • Promise RoleData Array.

    当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

static

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

根据人员标识获取所有的角色对象数组。如果角色具有群组(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、name、id、unique属性值,人员对象,或上述属性值和对象的数组。

  • asyncOrCallback Boolean | function

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

Returns

  • Promise Array.

    当async为true时,返回 Promise。 否则返回角色对象数组。

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

Source

static

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

人员是否拥有角色。

Syntax

//同步执行,返回判断结果。
var groupList = 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、name、id、unique属性值,人员对象。

  • roleList RoleFlag | Array.<RoleFlag>

    角色的distinguishedName、name、id、unique属性值,角色对象;或上述属性值和对象的数组。

  • asyncOrCallback Boolean | function

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

Returns

  • Promise Boolean

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

Source

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

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

Returns

  • Promise Boolean

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

Source

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、name、id、unique属性值,人员对象。

  • attr String

    属性名称。

  • values Array.

    属性值,必须为数组。

  • success function

    执行成功的回调。

  • failure function

    执行失败的回调。

  • async Boolean

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

Source

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、name、id、unique属性值,人员对象。

  • attr String

    属性名称。

  • values Array.

    属性值,必须为数组。

  • success function

    执行成功的回调。

  • failure function

    执行失败的回调。

  • async Boolean

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

Source

static

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

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

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、name、id、unique属性值,人员对象。

  • attr String

    属性名称。

  • asyncOrCallback Boolean | function

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

Returns

  • Array.

    当async为true时,返回 Promise。 否则返回属性值数组, 如:

    [ value1, value2 ]

Source

static

listPersonAttributeName(name, asyncOrCallbackopt) → {Array.}

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

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、name、id、unique属性值,人员对象,或上述属性值和对象的数组。

  • asyncOrCallback Boolean | function

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

Returns

  • Array.

    当async为true时,返回 Promise。 否则返回人员属性名称数组, 如:

    [ attributeName1, attributeName2 ]

Source

static

listPersonAllAttribute(name, asyncOrCallbackopt) → {Array.}

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

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、name、id、unique属性值,人员对象,或上述属性值和对象的数组。

  • asyncOrCallback Boolean | function

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

Returns

  • Array.

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

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

Source

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、name、id、unique属性值,组织对象。

  • attribute String

    属性名称。

  • valueArray Array.

    属性值,必须为数组。

  • success function

    执行成功的回调。

  • failure function

    执行失败的回调。

  • async Boolean

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

Source

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、name、id、unique属性值,组织对象。

  • attribute String

    属性名称。

  • valueArray Array.

    属性值,必须为数组。

  • success function

    执行成功的回调。

  • failure function

    执行失败的回调。

  • async Boolean

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

Source

static

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

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

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、name、id、unique属性值,组织对象。

  • attr String

    属性名称。

  • asyncOrCallback Boolean | function

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

Returns

  • Array.

    当async为true时,返回 Promise。 否则返回属性值数组, 如:

    [ value1, value2 ]

Source

static

listUnitAttributeName(name, asyncOrCallbackopt) → {Array.}

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

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、name、id、unique属性值,组织对象,或上述属性值和对象的数组。

  • asyncOrCallback Boolean | function

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

Returns

  • Array.

    当async为true时,返回 Promise。 否则返回组织属性名称数组, 如:

    [ attributeName1, attributeName2 ]

Source

static

listUnitAllAttribute(name, asyncOrCallbackopt) → {Array.}

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

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、name、id、unique属性值,组织对象,或上述属性值和对象的数组。

  • asyncOrCallback Boolean | function

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

Returns

  • Array.

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

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

Source