O2OA教程-业务开发与设计-前端开发API说明-组织架构管理之组织信息操作

随声附和 提交于 2020-03-02 18:05:29

组织信息: unit操作

获取组织管理架构org对象

你可以通过org对象获取组织中的人员、人员属性、组织、组织属性、身份、群组和角色

Syntax:

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

var org = this.org;

组织信息: unit操作

getUnit

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

Syntax:

var unitList = this.org.getUnit( unit );

Arguments:

> unit : (string JsonObject or array)必选。

可以是组织的distinguishedName、name、id、unique属性值,组织对象,或者是上述属性值和对象的数组。

//以下均为合法参数
//组织属性值
"开发部@kfb@U" //组织标识名
"cce8bc22-225a-4f85-8132-7374d546886e" //id
"kfb" //组织唯一标识
"开发部" //组织名称
//对象
{ "distinguishedName": "开发部@kfb@U" } //组织识别名
{ "unique": "cce8bc22-225a-4f85-8132-7374d546886e" } //组织唯一标识
{ "unique": "kfb" } //组织唯一标识
{ "name": "开发部" } //组织对象
//上述属性组和对象数组
[ "开发部", "综合部" ] //名称数组
[ { "name": "开发部" }, { "name": "综合部" } ] //名称数组
...其他属性值或对象数组

Return:

> unit array : (Array)组织对象数组。

unit对象为JSON格式数据,其格式和主要数据如下:

{
"name": "开发部", //组织名称
"unique": "kfb",  //组织唯一标识
"distinguishedName": "开发部@kfb@U", //组织识别名
"typeList": [   //组织类型
"部门"
],
"description": "", //组织描述
"shortName": "kfb", //组织简称
"level": 2, //组织层级
"levelName": "浙江兰德纵横/开发部", //层级名
"superior": "浙江兰德纵横@a706f5f0-4a3b-4785-8e1d-0a944bfad4eb@U" //上级组织
}

listSubUnit

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

Syntax:

var unitList = this.org.listSubUnit( unit , nested );

Arguments:

> unit : (string JsonObject or array)必选。

可以是组织的distinguishedName、name、id、unique属性值,组织对象,或者是上述属性值和对象的数组。

> nested : (boolean)可选,true嵌套的所有组织;false直接组织;默认false

//以下均为合法参数
//组织属性值
"开发部@kfb@U" //组织标识名
"cce8bc22-225a-4f85-8132-7374d546886e" //id
"kfb" //组织唯一标识
"开发部" //组织名称
//对象
{ "distinguishedName": "开发部@kfb@U" } //组织识别名
{ "unique": "cce8bc22-225a-4f85-8132-7374d546886e" } //组织唯一标识
{ "unique": "kfb" } //组织唯一标识
{ "name": "开发部" } //组织对象
//上述属性组和对象数组
[ "开发部", "综合部" ] //名称数组
[ { "name": "开发部" }, { "name": "综合部" } ] //名称数组
...其他属性值或对象数组

Return:

> unit array : (Array)组织对象数组。

unit对象为JSON格式数据,其格式和主要数据如下:

{
"name": "开发部", //组织名称
"unique": "kfb",  //组织唯一标识
"distinguishedName": "开发部@kfb@U", //组织识别名
"typeList": [   //组织类型
"部门"
],
"description": "", //组织描述
"shortName": "kfb", //组织简称
"level": 2, //组织层级
"levelName": "浙江兰德纵横/开发部", //层级名
"superior": "浙江兰德纵横@a706f5f0-4a3b-4785-8e1d-0a944bfad4eb@U" //上级组织
}

listSupUnit

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

Syntax:

var unitList = this.org.listSupUnit( unit , nested );

Arguments:

> unit : (string JsonObject or array)必选。

可以是组织的distinguishedName、name、id、unique属性值,组织对象,或者是上述属性值和对象的数组。

> nested : (boolean)可选,true嵌套的所有组织;false直接组织;默认false

//以下均为合法参数
//组织属性值
"开发部@kfb@U" //组织标识名
"cce8bc22-225a-4f85-8132-7374d546886e" //id
"kfb" //组织唯一标识
"开发部" //组织名称
//对象
{ "distinguishedName": "开发部@kfb@U" } //组织识别名
{ "unique": "cce8bc22-225a-4f85-8132-7374d546886e" } //组织唯一标识
{ "unique": "kfb" } //组织唯一标识
{ "name": "开发部" } //组织对象
//上述属性组和对象数组
[ "开发部", "综合部" ] //名称数组
[ { "name": "开发部" }, { "name": "综合部" } ] //名称数组
...其他属性值或对象数组

Return:

> unit array : (Array)组织对象数组。

unit对象为JSON格式数据,其格式和主要数据如下:

{
"name": "开发部", //组织名称
"unique": "kfb",  //组织唯一标识
"distinguishedName": "开发部@kfb@U", //组织识别名
"typeList": [   //组织类型
"部门"
],
"description": "", //组织描述
"shortName": "kfb", //组织简称
"level": 2, //组织层级
"levelName": "浙江兰德纵横/开发部", //层级名
"superior": "浙江兰德纵横@a706f5f0-4a3b-4785-8e1d-0a944bfad4eb@U" //上级组织
}

getUnitByIdentity

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

Syntax:

var unitList = this.org.getUnitByIdentity( identity, flag );

Arguments:

> identity : (string or JsonObject)必选。

可以是身份的distinguishedName、name、id、unique属性值,身份对象,或者是上述属性值和对象的数组。

> flag : (number or string)可选。  

当值为数字的时候, 表示获取第几层的组织。

当值为字符串的时候,表示获取指定类型的组织。

当值为空的时候,表示获取直接所在组织。

//以下均为合法参数
//身份属性值
"李四@23dd1b53-feed-485d-8c9c-1a4e64ff58a2@I" //身份识别名
"23dd1b53-feed-485d-8c9c-1a4e64ff58a2" //id
"lisi_i" //身份唯一标识
"李四" //名称
//对象
{ "distinguishedName": "李四@23dd1b53-feed-485d-8c9c-1a4e64ff58a2@I" } //身份识别名
{ "unique": "23dd1b53-feed-485d-8c9c-1a4e64ff58a2" } //身份唯一标识
{ "unique": "lisi_i" } //身份唯一标识
{ "name": "李四" } //名称对象

Return:

> unit array : (Array)组织对象数组。

unit对象为JSON格式数据,其格式和主要数据如下:

{
"name": "开发部", //组织名称
"unique": "kfb",  //组织唯一标识
"distinguishedName": "开发部@kfb@U", //组织识别名
"typeList": [   //组织类型
"部门"
],
"description": "", //组织描述
"shortName": "kfb", //组织简称
"level": 2, //组织层级
"levelName": "浙江兰德纵横/开发部", //层级名
"superior": "浙江兰德纵横@a706f5f0-4a3b-4785-8e1d-0a944bfad4eb@U" //上级组织
}

listAllSupUnitWithIdentity

列出身份所在组织的所有上级组织。

Syntax:

var unitList = this.org.listAllSupUnitWithIdentity( identity );

Arguments:

> identity : (string JsonObject or array)必选。

可以是身份的distinguishedName、name、id、unique属性值,身份对象,或者是上述属性值和对象的数组。

//以下均为合法参数
//身份属性值
"李四@23dd1b53-feed-485d-8c9c-1a4e64ff58a2@I" //身份识别名
"23dd1b53-feed-485d-8c9c-1a4e64ff58a2" //id
"lisi_i" //身份唯一标识
"李四" //名称
//对象
{ "distinguishedName": "李四@23dd1b53-feed-485d-8c9c-1a4e64ff58a2@I" } //身份识别名
{ "unique": "23dd1b53-feed-485d-8c9c-1a4e64ff58a2" } //身份唯一标识
{ "unique": "lisi_i" } //身份唯一标识
{ "name": "李四" } //名称对象
//上述属性组和对象数组
[ "张三", "李四" ] //名称数组
[ { "name": "李四" }, { "name": "张三" } ] //名称数组
...其他属性值或对象数组

Return:

> unit array : (Array)群组对象数组。

unit对象为JSON格式数据,其格式和主要数据如下:

{
"name": "开发部", //组织名称
"unique": "kfb",  //组织唯一标识
"distinguishedName": "开发部@kfb@U", //组织识别名
"typeList": [   //组织类型
"部门"
],
"description": "", //组织描述
"shortName": "kfb", //组织简称
"level": 2, //组织层级
"levelName": "浙江兰德纵横/开发部", //层级名
"superior": "浙江兰德纵横@a706f5f0-4a3b-4785-8e1d-0a944bfad4eb@U" //上级组织
}

listUnitWithPerson

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

Syntax:

var unitList = this.org.listUnitWithPerson( person );

Arguments:

> person : (string JsonObject or array)必选。

可以是人员的distinguishedName、name、id、unique属性值,人员对象,或者是上述属性值和对象的数组。

//以下均为合法参数
//人员属性值
"李四@lisi@P" //人员别名
"cce8bc22-225a-4f85-8132-7374d546886e" //id
"lisi" //人员唯一标识
"李四" //人员名称
//对象
{ "distinguishedName": "李四@lisi@P" } //人员识别名
{ "unique": "cce8bc22-225a-4f85-8132-7374d546886e" } //人员唯一标识
{ "unique": "lisi" } //人员唯一标识
{ "name": "李四" } //名称对象
//上述属性组和对象数组
[ "张三", "李四" ] //名称数组
[ { "name": "李四" }, { "name": "张三" } ] //名称数组
...其他属性值或对象数组

Return:

> unit array : (Array)组织对象数组。

unit对象为JSON格式数据,其格式和主要数据如下:

{
"name": "开发部", //组织名称
"unique": "kfb",  //组织唯一标识
"distinguishedName": "开发部@kfb@U", //组织识别名
"typeList": [   //组织类型
"部门"
],
"description": "", //组织描述
"shortName": "kfb", //组织简称
"level": 2, //组织层级
"levelName": "浙江兰德纵横/开发部", //层级名
"superior": "浙江兰德纵横@a706f5f0-4a3b-4785-8e1d-0a944bfad4eb@U" //上级组织
}

listAllSupUnitWithPerson

列出人员所在组织的所有上级组织。

Syntax:

var unitList = this.org.listAllSupUunitnitWithPerson( person );

Arguments:

> person : (string JsonObjector array)必选。

可以是人员的distinguishedName、name、id、unique属性值,人员对象,或者是上述属性值和对象的数组。

//以下均为合法参数
//人员属性值
"李四@lisi@P" //人员别名
"cce8bc22-225a-4f85-8132-7374d546886e" //id
"lisi" //人员唯一标识
"李四" //人员名称
//对象
{ "distinguishedName": "李四@lisi@P" } //人员识别名
{ "unique": "cce8bc22-225a-4f85-8132-7374d546886e" } //人员唯一标识
{ "unique": "lisi" } //人员唯一标识
{ "name": "李四" } //名称对象
//上述属性组和对象数组
[ "张三", "李四" ] //名称数组
[ { "name": "李四" }, { "name": "张三" } ] //名称数组
...其他属性值或对象数组

Return:

> unit array : (Array)组织对象数组。

unit对象为JSON格式数据,其格式和主要数据如下:

{
"name": "开发部", //组织名称
"unique": "kfb",  //组织唯一标识
"distinguishedName": "开发部@kfb@U", //组织识别名
"typeList": [   //组织类型
"部门"
],
"description": "", //组织描述
"shortName": "kfb", //组织简称
"level": 2, //组织层级
"levelName": "浙江兰德纵横/开发部", //层级名
"superior": "浙江兰德纵横@a706f5f0-4a3b-4785-8e1d-0a944bfad4eb@U" //上级组织
}

listUnitWithAttribute

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

Syntax:

var unitList = this.org.listUnitWithAttribute( attributeName, attributeValue );

Arguments:

> attributeName : (string )必选。组织属性名称。

> attributeValue : (string )必选。组织属性值。

Return:

> unit array : (Array)组织对象数组。

unit对象为JSON格式数据,其格式和主要数据如下:

{
"name": "开发部", //组织名称
"unique": "kfb",  //组织唯一标识
"distinguishedName": "开发部@kfb@U", //组织识别名
"typeList": [   //组织类型
"部门"
],
"description": "", //组织描述
"shortName": "kfb", //组织简称
"level": 2, //组织层级
"levelName": "浙江兰德纵横/开发部", //层级名
"superior": "浙江兰德纵横@a706f5f0-4a3b-4785-8e1d-0a944bfad4eb@U" //上级组织
}

listUnitWithDuty

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

Syntax:

var unitList = this.org.listUnitWithDuty( dutyName, identity );

Arguments:

> dutyName : (string)必选。组织职务名称。

> identity : (string or JsonObject)必选。

可以是身份的distinguishedName、name、id、unique属性值,身份对象。

//以下均为合法参数
//身份属性值
"李四@23dd1b53-feed-485d-8c9c-1a4e64ff58a2@I" //身份识别名
"23dd1b53-feed-485d-8c9c-1a4e64ff58a2" //id
"lisi_i" //身份唯一标识
"李四" //名称
//对象
{ "distinguishedName": "李四@23dd1b53-feed-485d-8c9c-1a4e64ff58a2@I" } //身份识别名
{ "unique": "23dd1b53-feed-485d-8c9c-1a4e64ff58a2" } //身份唯一标识
{ "unique": "lisi_i" } //身份唯一标识
{ "name": "李四" } //名称对象

Return:

> unit array : (Array)组织对象数组。

unit对象为JSON格式数据,其格式和主要数据如下:

{
"name": "开发部", //组织名称
"unique": "kfb",  //组织唯一标识
"distinguishedName": "开发部@kfb@U", //组织识别名
"typeList": [   //组织类型
"部门"
],
"description": "", //组织描述
"shortName": "kfb", //组织简称
"level": 2, //组织层级
"levelName": "浙江兰德纵横/开发部", //层级名
"superior": "浙江兰德纵横@a706f5f0-4a3b-4785-8e1d-0a944bfad4eb@U" //上级组织
}

listTopUnit

列出顶层组织。

Syntax:

var unitList = this.org.listTopUnit();

Return:

> unit array : (Array)组织对象数组。

unit对象为JSON格式数据,其格式和主要数据如下:

{
"name": "开发部", //组织名称
"unique": "kfb",  //组织唯一标识
"distinguishedName": "开发部@kfb@U", //组织识别名
"typeList": [   //组织类型
"部门"
],
"description": "", //组织描述
"shortName": "kfb", //组织简称
"level": 2, //组织层级
"levelName": "浙江兰德纵横/开发部", //层级名
"superior": "浙江兰德纵横@a706f5f0-4a3b-4785-8e1d-0a944bfad4eb@U" //上级组织
}
易学教程内所有资源均来自网络或用户发布的内容,如有违反法律规定的内容欢迎反馈
该文章没有解决你所遇到的问题?点击提问,说说你的问题,让更多的人一起探讨吧!