O2OA API

Module

org

您可以通过this.org获取组织中的人员、人员属性、组织、组织属性、身份、群组和角色。后端调用都是同步的。

Properties

  • group GroupFactory

    后端的GroupFactory实例，可用于获取group群组相关数据
  • identity IdentityFactory

    后端的IdentityFactory实例，可用于获取identity身份相关数据
  • person PersonFactory

    后端的PersonFactory实例，可用于获取person人员相关数据
  • personAttribute PersonAttributeFactory

    后端的GroupFactory实例，可用于获取personAttribute人员属性相关数据
  • role RoleFactory

    后端的RoleFactory实例，可用于获取role角色相关数据
  • unit UnitFactory

    后端的UnitFactory实例，可用于获取unit相关数据
  • unitAttribute UnitAttributeFactory

    后端的UnitAttributeFactory实例，可用于获取unitAttribute组织属性相关数据
  • unitDuty UnitDutyFactory

    后端的UnitDutyFactory实例，可用于获取unitDuty组织属性相关数据

Since

  • v9.0.4

Syntax

//您可以通过以下引用来获取当前实例的org对象，如下：
this.org;
globalThis.org;
org

Example

//通过后端java类，来获取当前人所在的部门名称
const unit = org.unit();
const unitNames = unit.listWithPerson("张三@xxx@P");

Methods

static

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

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

Syntax

//返回群组，单个是Object，多个是Array。
const groupList = this.org.getGroup( name );

Parameters

  • name GroupFlag | Array.<GroupFlag>

    群组的distinguishedName、name、id、unique属性值，群组对象，或上述属性值和对象的数组。

Returns

  • GroupData Array.<GroupData>

    返回群组，单个是Object，多个是Array。

{
	"matchKey": " ",		//匹配字段
	"id": " ",		//群组id
	"name": "工作汇报读者",		//群组名称
	"unique": "ReportReader",		//群组标识
	"description": "可查看所有部门所有状态的工作汇报",		//说明
	"distinguishedName": "工作汇报读者@ReportReader@G",		//识别名
	"orderNumber": 13699599,		//排序号
	"personList": [
		"张三@zhangsan@P"
		"李四@lisi@P"
	],		//个人成员
	"groupList": [
		"所有部门领导@AllDepartLeader@G"
		"所有部门汇报管理员@AllDepartReportManager@G"
	],		//群组成员
	"unitList": [
		"开发部@kfb@U"
	],		//组织成员
	"identityList": [
		"王五@kfb_wangwu@I"
		"赵六@kfb_zhaoliu@I"
	],		//身份成员
	"subDirectGroupCount": 1,		//直接下级组织数量
	"subDirectPersonCount": 1,		//直接下级用户数量
	"subDirectIdentityCount": 1,		//直接下级身份数量
	"subDirectOrgCount": 1 		//直接下级组织数量
}

Source

static

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

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

Syntax

//返回嵌套下级群组数组。
const groupList = this.org.listSubGroup( name, true );

Parameters

  • name GroupFlag | Array.<GroupFlag>

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

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

Returns

  • Array.<GroupData>

    返回群组数组。

{
	"matchKey": " ",		//匹配字段
	"id": " ",		//群组id
	"name": "工作汇报读者",		//群组名称
	"unique": "ReportReader",		//群组标识
	"description": "可查看所有部门所有状态的工作汇报",		//说明
	"distinguishedName": "工作汇报读者@ReportReader@G",		//识别名
	"orderNumber": 13699599,		//排序号
	"personList": [
		"张三@zhangsan@P"
		"李四@lisi@P"
	],		//个人成员
	"groupList": [
		"所有部门领导@AllDepartLeader@G"
		"所有部门汇报管理员@AllDepartReportManager@G"
	],		//群组成员
	"unitList": [
		"开发部@kfb@U"
	],		//组织成员
	"identityList": [
		"王五@kfb_wangwu@I"
		"赵六@kfb_zhaoliu@I"
	],		//身份成员
	"subDirectGroupCount": 1,		//直接下级组织数量
	"subDirectPersonCount": 1,		//直接下级用户数量
	"subDirectIdentityCount": 1,		//直接下级身份数量
	"subDirectOrgCount": 1 		//直接下级组织数量
}

Source

static

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

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

Syntax

//返回嵌套上级群组数组。
const groupList = this.org.listSupGroup( name, true );

Parameters

  • name GroupFlag | Array.<GroupFlag>

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

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

Returns

  • Array.<GroupData>

    返回群组数组。

{
	"matchKey": " ",		//匹配字段
	"id": " ",		//群组id
	"name": "工作汇报读者",		//群组名称
	"unique": "ReportReader",		//群组标识
	"description": "可查看所有部门所有状态的工作汇报",		//说明
	"distinguishedName": "工作汇报读者@ReportReader@G",		//识别名
	"orderNumber": 13699599,		//排序号
	"personList": [
		"张三@zhangsan@P"
		"李四@lisi@P"
	],		//个人成员
	"groupList": [
		"所有部门领导@AllDepartLeader@G"
		"所有部门汇报管理员@AllDepartReportManager@G"
	],		//群组成员
	"unitList": [
		"开发部@kfb@U"
	],		//组织成员
	"identityList": [
		"王五@kfb_wangwu@I"
		"赵六@kfb_zhaoliu@I"
	],		//身份成员
	"subDirectGroupCount": 1,		//直接下级组织数量
	"subDirectPersonCount": 1,		//直接下级用户数量
	"subDirectIdentityCount": 1,		//直接下级身份数量
	"subDirectOrgCount": 1 		//直接下级组织数量
}

Source

static

listGroupWithPerson(name) → {Array.<GroupData>}

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

Syntax

//返回群组数组。
const groupList = this.org.listGroupWithPerson( name );

Parameters

  • name PersonFlag | Array.<PersonFlag>

    人员的distinguishedName、id、unique属性值，人员对象，或上述属性值和对象的数组。

Returns

  • Array.<GroupData>

    返回群组对象数组。

{
	"matchKey": " ",		//匹配字段
	"id": " ",		//群组id
	"name": "工作汇报读者",		//群组名称
	"unique": "ReportReader",		//群组标识
	"description": "可查看所有部门所有状态的工作汇报",		//说明
	"distinguishedName": "工作汇报读者@ReportReader@G",		//识别名
	"orderNumber": 13699599,		//排序号
	"personList": [
		"张三@zhangsan@P"
		"李四@lisi@P"
	],		//个人成员
	"groupList": [
		"所有部门领导@AllDepartLeader@G"
		"所有部门汇报管理员@AllDepartReportManager@G"
	],		//群组成员
	"unitList": [
		"开发部@kfb@U"
	],		//组织成员
	"identityList": [
		"王五@kfb_wangwu@I"
		"赵六@kfb_zhaoliu@I"
	],		//身份成员
	"subDirectGroupCount": 1,		//直接下级组织数量
	"subDirectPersonCount": 1,		//直接下级用户数量
	"subDirectIdentityCount": 1,		//直接下级身份数量
	"subDirectOrgCount": 1 		//直接下级组织数量
}

Source

static

groupHasRole(name, roleList) → {Boolean}

群组是否拥有角色。

Syntax

//返回判断结果。
const groupList = this.org.groupHasRole( name, roleList );

Parameters

  • name GroupFlag

    群组的distinguishedName、name、id、unique属性值，群组对象。
  • roleList RoleFlag | Array.<RoleFlag>

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

Returns

  • Boolean

    如果群组拥有角色返回true, 否则返回false。

Source

static

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

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

Syntax

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

Parameters

  • name RoleFlag | Array.<RoleFlag>

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

Returns

  • RoleData Array.<RoleData>

    返回角色，单个为Object，多个为Array。

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

Source

static

listRoleWithPerson(name) → {Array.<RoleData>}

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

Syntax

//返回角色数组。
const roleList = this.org.listRoleWithPerson( name );

Parameters

  • name PersonFlag | Array.<PersonFlag>

    人员的distinguishedName、id、unique属性值，人员对象，或上述属性值和对象的数组。

Returns

  • Array.<RoleData>

    返回角色对象数组。

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

Source

static

personHasRole(name, roleList) → {Boolean}

人员是否拥有角色。

Syntax

//返回判断结果。
const groupList = this.org.personHasRole( name, roleList );

Parameters

  • name PersonFlag

    人员的distinguishedName、id、unique属性值，人员对象。
  • roleList RoleFlag | Array.<RoleFlag>

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

Returns

  • Boolean

    如果人员拥有角色返回true, 否则返回false。

Source

static

getPersonData(name) → {PersonData}

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

Syntax

//返回人员对象。
const person = this.org.getPersonData( name );

Parameters

  • name String

    人员的distinguishedName、id、unique属性值，人员名称。

Returns

  • PersonData

    返回人员对象。

{
	"woIdentityList": [   //身份对象
      {
        "woUnit": { //身份所在组织
          "id": "e56ef746-a923-494b-bdfe-81ab65c523da",
          "name": "综合部",
          "unique": "zhb",
          "distinguishedName": "综合部@zhb@U",
          "typeList": [
            "department"
          ],
          "pinyin": "zonghebu",
          "pinyinInitial": "zhb",
          "description": "",
          "shortName": "da",
          "level": 2,
          "levelName": "演示公司/综合部",
          "levelOrderNumber": "0053522524/0053522721",
          "superior": "0f98a161-df27-45f0-833b-e29105ba82f7",
          "orderNumber": 53522721,
          "controllerList": [
            "5a272f71-02b3-4abb-a0e4-f11e23d9b824"
          ],
          "createTime": "2019-09-12 11:25:21",
          "updateTime": "2022-08-01 15:36:39"
        },
        "woUnitDutyList": [ //身份拥有的职务
          {
            "woUnit": { //该职务绑定的组织
              "id": "e56ef746-a923-494b-bdfe-81ab65c523da",
              "name": "综合部",
              "unique": "zhb",
              "distinguishedName": "综合部@zhb@U",
              "typeList": [
                "department"
              ],
              "pinyin": "zonghebu",
              "pinyinInitial": "zhb",
              "description": "",
              "shortName": "da",
              "level": 2,
              "levelName": "演示公司/综合部",
              "levelOrderNumber": "0053522524/0053522721",
              "superior": "0f98a161-df27-45f0-833b-e29105ba82f7",
              "orderNumber": 53522721,
              "controllerList": [
                "5a272f71-02b3-4abb-a0e4-f11e23d9b824"
              ],
              "createTime": "2019-09-12 11:25:21",
              "updateTime": "2022-08-01 15:36:39"
            },
            "id": "d14dbd1a-1db8-492b-9cf3-f1a2117f815d",
            "pinyin": "bumenlingdao",
            "pinyinInitial": "bmld",
            "description": "",
            "name": "部门领导",
            "unique": "d14dbd1a-1db8-492b-9cf3-f1a2117f815d",
            "distinguishedName": "部门领导@d14dbd1a-1db8-492b-9cf3-f1a2117f815d@UD",
            "unit": "e56ef746-a923-494b-bdfe-81ab65c523da",
            "orderNumber": 173379080,
            "identityList": [
              "b7c7db79-0241-4989-b31a-fbba5c17ada2"
            ],
            "createTime": "2023-06-30 16:51:21",
            "updateTime": "2023-06-30 16:51:30"
          }
        ],
        "id": "b7c7db79-0241-4989-b31a-fbba5c17ada2",
        "pinyin": "zhangsan",
        "pinyinInitial": "zs",
        "description": "",
        "name": "张三",
        "unique": "zhb_zhangsan",
        "distinguishedName": "张三@zhb_zhangsan@I",
        "person": "97941ea3-e3eb-4db7-aaf6-1263b048d909",
        "unit": "e56ef746-a923-494b-bdfe-81ab65c523da",
        "unitName": "综合部",
        "unitLevel": 2,
        "unitLevelName": "演示公司/综合部",
        "orderNumber": 144603421,
        "major": true, //是否为主身份
        "createTime": "2022-08-01 15:37:01",
        "updateTime": "2022-08-01 15:37:01"
      }
    ],		//身份对象
	"woRoleList": [
      {
        "id": "4de87a00-66a2-4c6a-94d7-4a2afdeb9e42",
        "pinyin": "bssmanager",
        "pinyinInitial": "bssmanager",
        "name": "BSSManager",
        "unique": "BSSManagerSystemRole",
        "distinguishedName": "BSSManager@BSSManagerSystemRole@R",
        "orderNumber": 15329841,
        "personList": [
          "97941ea3-e3eb-4db7-aaf6-1263b048d909"
        ],
        "groupList": [],
        "createTime": "2018-06-27 10:17:21",
        "updateTime": "2023-06-30 16:52:00"
      }
    ],		//角色对象
	"woGroupList": [
      {
        "id": "f2637ec1-d3be-4076-8dde-df88892cb4da",
        "pinyin": "yunweiqunzu",
        "pinyinInitial": "ywqz",
        "description": "",
        "name": "运维群组",
        "unique": "f2637ec1-d3be-4076-8dde-df88892cb4da",
        "distinguishedName": "运维群组@f2637ec1-d3be-4076-8dde-df88892cb4da@G",
        "orderNumber": 97928948,
        "personList": [
          "3455b82a-399c-4ee4-b9b9-e70ae40fbaf1",
          "5d2699d4-e411-4027-a87e-435371823d5d",
          "97941ea3-e3eb-4db7-aaf6-1263b048d909"
        ],
        "groupList": [],
        "unitList": [],
        "identityList": [],
        "createTime": "2021-02-07 10:29:09",
        "updateTime": "2023-06-30 16:52:19"
      }
    ],		//群组对象
	"woPersonAttributeList": [
      {
        "id": "acc8a5ec-8e76-4a3a-9a0e-f8d4d9001c42",
        "pinyin": "shuxingyi",
        "pinyinInitial": "sxy",
        "description": "属性描述",
        "name": "属性一",
        "unique": "acc8a5ec-8e76-4a3a-9a0e-f8d4d9001c42",
        "distinguishedName": "属性一@acc8a5ec-8e76-4a3a-9a0e-f8d4d9001c42@PA",
        "person": "97941ea3-e3eb-4db7-aaf6-1263b048d909",
        "orderNumber": 24943622,
        "attributeList": [
          "1"
        ],
        "createTime": "2018-10-16 16:47:02",
        "updateTime": "2023-06-30 16:50:43"
      }
    ],		//个人属性对象
	"id": "97941ea3-e3eb-4db7-aaf6-1263b048d909",		//数据库主键,自动生成.
	"genderType": "m",		//性别.男:m,女:f,未知:d
	"iconMdpi": " ",		//icon Base64编码后的文本（中等尺寸图像）.
	"iconLdpi": " ",		//icon Base64编码后的文本（小尺寸图像）.
	"signature": " ",		//个性签名.
	"pinyin": "zhangsan",		//name拼音,自动生成
	"pinyinInitial": "zs",		//name拼音首字母,自动生成
	"description": " ",		//描述.
	"name": "张三",		//名称,可重名.
	"nickName": " ",		//昵称.
	"employee": "1111",		//工号,不可重复.
	"unique": "zhangsan",		//唯一标识,不可重复,为空则使用自动填充值
	"distinguishedName": "张三@zhangsan@P",		//识别名,自动填充,@P结尾.
	"orderNumber": 14214946,		//排序号,升序排列,为空在最后
	"controllerList": [
		"3455b82a-399c-4ee4-b9b9-e70ae40fbaf1"
		"8e527447-635c-4775-8107-239096fc3ec4"
	],		//个人管理者.默认为创建者。
	"superior": " ",		//汇报对象.
	"passwordExpiredTime": "2024-12-24 14:11:00",		//用户密码到期时间.
	"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": "2024-12-24 14:11:00",		//入职时间.
	"birthday": "2024-12-24 14:11:00",		//生日.
	"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,		//主体秘级标识.
	"status": " ",		//状态：0|正常、1|锁定、2|禁用.
	"lockExpireTime": "2024-12-24 14:11:00",		//锁定到期时间.
	"statusDes": " ",		//状态描述.
	"createTime": "2018-06-14 12:35:46",		//创建时间,自动生成,索引创建在约束中.
	"updateTime": "2023-04-07 17:56:32" 		//修改时间,自动生成,索引创建在约束中.
}

Source

static

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

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

Syntax

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

Parameters

  • name PersonFlag | Array.<PersonFlag>

    人员的distinguishedName、id、unique属性值，人员对象，或上述属性值和对象的数组。
  • findCN Boolean <optional>

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

Returns

  • PersonData Array.<PersonData>

    返回人员，单个是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": "2024-12-24 14:11:00",		//入职时间
	"birthday": "2024-12-24 14:11:00",		//生日
	"age": 1,		//年龄
	"qiyeweixinId": " ",		//企业微信Id
	"dingdingId": " ",		//钉钉Id
	"zhengwuDingdingId": " ",		//政务钉钉Id
	"weLinkId": " ",		//华为WeLink id
	"subjectSecurityClearance": 1 		//主体密级标识.
}

Source

static

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

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

Syntax

//返回嵌套下级人员数组。
const personList = this.org.listSubPerson( name, true );

Parameters

  • name PersonFlag | Array.<PersonFlag>

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

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

Returns

  • Array.<PersonData>

    返回人员数组。

{
	"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": "2024-12-24 14:11:00",		//入职时间
	"birthday": "2024-12-24 14:11:00",		//生日
	"age": 1,		//年龄
	"qiyeweixinId": " ",		//企业微信Id
	"dingdingId": " ",		//钉钉Id
	"zhengwuDingdingId": " ",		//政务钉钉Id
	"weLinkId": " ",		//华为WeLink id
	"subjectSecurityClearance": 1 		//主体密级标识.
}

Source

static

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

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

Syntax

//返回嵌套上级人员数组。
const personList = this.org.listSupPerson( name, true );

Parameters

  • name PersonFlag | Array.<PersonFlag>

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

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

Returns

  • Array.<PersonData>

    返回人员数组。

{
	"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": "2024-12-24 14:11:00",		//入职时间
	"birthday": "2024-12-24 14:11:00",		//生日
	"age": 1,		//年龄
	"qiyeweixinId": " ",		//企业微信Id
	"dingdingId": " ",		//钉钉Id
	"zhengwuDingdingId": " ",		//政务钉钉Id
	"weLinkId": " ",		//华为WeLink id
	"subjectSecurityClearance": 1 		//主体密级标识.
}

Source

static

listPersonWithGroup(name) → {Array.<PersonData>}

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

Syntax

//返回人员数组。
const personList = this.org.listPersonWithGroup( group );

Parameters

  • name GroupFlag | Array.<GroupFlag>

    群组的distinguishedName、name、id、unique属性值，群组对象，或上述属性值和对象的数组。

Returns

  • Array.<PersonData>

    返回人员对象数组。

{
	"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": "2024-12-24 14:11:00",		//入职时间
	"birthday": "2024-12-24 14:11:00",		//生日
	"age": 1,		//年龄
	"qiyeweixinId": " ",		//企业微信Id
	"dingdingId": " ",		//钉钉Id
	"zhengwuDingdingId": " ",		//政务钉钉Id
	"weLinkId": " ",		//华为WeLink id
	"subjectSecurityClearance": 1 		//主体密级标识.
}

Source

static

listPersonWithRole(name) → {Array.<PersonData>}

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

Syntax

//返回人员数组。
const personList = this.org.listPersonWithRole( role );

Parameters

  • name RoleFlag | Array.<RoleFlag>

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

Returns

  • Array.<PersonData>

    返回人员对象数组。

{
	"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": "2024-12-24 14:11:00",		//入职时间
	"birthday": "2024-12-24 14:11:00",		//生日
	"age": 1,		//年龄
	"qiyeweixinId": " ",		//企业微信Id
	"dingdingId": " ",		//钉钉Id
	"zhengwuDingdingId": " ",		//政务钉钉Id
	"weLinkId": " ",		//华为WeLink id
	"subjectSecurityClearance": 1 		//主体密级标识.
}

Source

static

listPersonWithIdentity(name) → {Array.<PersonData>}

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

Syntax

//返回人员数组。
const personList = this.org.listPersonWithIdentity( identity );

Parameters

  • name IdentityFlag | Array.<IdentityFlag>

    身份的distinguishedName、id、unique属性值，身份对象，或上述属性值和对象的数组。

Returns

  • Array.<PersonData>

    返回人员对象数组。

{
	"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": "2024-12-24 14:11:00",		//入职时间
	"birthday": "2024-12-24 14:11:00",		//生日
	"age": 1,		//年龄
	"qiyeweixinId": " ",		//企业微信Id
	"dingdingId": " ",		//钉钉Id
	"zhengwuDingdingId": " ",		//政务钉钉Id
	"weLinkId": " ",		//华为WeLink id
	"subjectSecurityClearance": 1 		//主体密级标识.
}

Source

static

getPersonWithIdentity(name) → {PersonData|Array.<PersonData>}

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

Syntax

//返回人员，单个是Object，多个是Array。
const personList = this.org.listPersonWithIdentity( identity );

Parameters

  • name IdentityFlag | Array.<IdentityFlag>

    身份的distinguishedName、id、unique属性值，身份对象，或上述属性值和对象的数组。

Returns

  • PersonData Array.<PersonData>

    返回人员对象，单个是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": "2024-12-24 14:11:00",		//入职时间
	"birthday": "2024-12-24 14:11:00",		//生日
	"age": 1,		//年龄
	"qiyeweixinId": " ",		//企业微信Id
	"dingdingId": " ",		//钉钉Id
	"zhengwuDingdingId": " ",		//政务钉钉Id
	"weLinkId": " ",		//华为WeLink id
	"subjectSecurityClearance": 1 		//主体密级标识.
}

Source

static

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

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

Syntax

//返回组织的直接人员数组。
const personList = this.org.listPersonWithUnit( unit );

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

Parameters

  • name UnitFlag | Array.<UnitFlag>

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

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

Returns

  • Array.<PersonData>

    返回人员对象数组。

{
	"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": "2024-12-24 14:11:00",		//入职时间
	"birthday": "2024-12-24 14:11:00",		//生日
	"age": 1,		//年龄
	"qiyeweixinId": " ",		//企业微信Id
	"dingdingId": " ",		//钉钉Id
	"zhengwuDingdingId": " ",		//政务钉钉Id
	"weLinkId": " ",		//华为WeLink id
	"subjectSecurityClearance": 1 		//主体密级标识.
}

Source

static

appendPersonAttribute(person, attr, values)

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

Syntax

//添加人员属性值
this.org.appendPersonAttribute( person, attribute, valueArray);

Parameters

  • person PersonFlag

    人员的distinguishedName、id、unique属性值，人员对象。
  • attr String

    属性名称。
  • values Array.<String>

    属性值，必须为数组。

Source

static

setPersonAttribute(person, attr, values)

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

Syntax

//添加人员属性值
this.org.setPersonAttribute( person, attribute, valueArray);

Parameters

  • person PersonFlag

    人员的distinguishedName、id、unique属性值，人员对象。
  • attr String

    属性名称。
  • values Array.<String>

    属性值，必须为数组。

Source

static

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

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

Syntax

//返回该人员的属性值数组。
const attributeList = this.org.getPersonAttribute( person, attr );

Parameters

  • person PersonFlag

    人员的distinguishedName、id、unique属性值，人员对象。
  • attr String

    属性名称。

Returns

  • Array.<String>

    返回属性值数组， 如：

    [ value1, value2 ]

Source

static

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

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

Syntax

//返回人员所有属性的名称数组。
const attributeNameList = this.org.listPersonAttributeName( person );

Parameters

  • name PersonFlag | Array.<PersonFlag>

    人员的distinguishedName、id、unique属性值，人员对象，或上述属性值和对象的数组。

Returns

  • Array.<String>

    返回人员属性名称数组， 如：

    [ attributeName1, attributeName2 ]

Source

static

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

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

Syntax

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

Parameters

  • name IdentityFlag | Array.<IdentityFlag>

    身份的distinguishedName、id、unique属性值，身份对象，或上述属性值和对象的数组。

Returns

  • IdentityData Array.<IdentityData>

    返回身份，单个是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": "2024-12-24 14:11:00",		//创建时间,自动生成,索引创建在约束中.
	"updateTime": "2024-12-24 14:11:00" 		//修改时间,自动生成,索引创建在约束中.
}

Source

static

listIdentityWithPerson(name) → {Array.<IdentityData>}

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

Syntax

//返回身份对象数组。
const identityList = this.org.listIdentityWithPerson( person );

Parameters

  • name PersonFlag | Array.<PersonFlag>

    人员的distinguishedName、id、unique属性值，人员对象，或上述属性值和对象的数组。

Returns

  • Array.<IdentityData>

    返回身份对象数组。

{
	"matchKey": " ",		//匹配字段
	"name": "李四",		//身份名称
	"unique": "23dd1b53-feed-485d-8c9c-1a4e64ff58a2",		//身份标识
	"description": " ",		//说明
	"distinguishedName": "李四@23dd1b53-feed-485d-8c9c-1a4e64ff58a2@I",		//识别名
	"person": "李四@lisi@P",		//人员
	"unit": "开发部@kfb@U",		//组织
	"unitName": "开发部",		//组织名称
	"unitLevel": 2,		//组织级别
	"unitLevelName": "浙江兰德纵横/开发部",		//组织级别名
	"orderNumber": 24920439,		//排序号
	"major": true 		//是否是设定的主身份
}

Source

static

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

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

Syntax

//返回直接组织身份对象数组。
const identityList = this.org.listIdentityWithUnit( unit );

//返回嵌套组织身份对象数组。
const identityList = this.org.listIdentityWithUnit( unit, true );

Parameters

  • name UnitFlag | Array.<UnitFlag>

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

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

Returns

  • Array.<IdentityData>

    返回身份对象数组。

{
	"matchKey": " ",		//匹配字段
	"name": "李四",		//身份名称
	"unique": "23dd1b53-feed-485d-8c9c-1a4e64ff58a2",		//身份标识
	"description": " ",		//说明
	"distinguishedName": "李四@23dd1b53-feed-485d-8c9c-1a4e64ff58a2@I",		//识别名
	"person": "李四@lisi@P",		//人员
	"unit": "开发部@kfb@U",		//组织
	"unitName": "开发部",		//组织名称
	"unitLevel": 2,		//组织级别
	"unitLevelName": "浙江兰德纵横/开发部",		//组织级别名
	"orderNumber": 24920439,		//排序号
	"major": true 		//是否是设定的主身份
}

Source

static

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

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

Syntax

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

Parameters

  • name UnitFlag | Array.<UnitFlag>

    组织的distinguishedName、id、unique属性值，组织对象，或上述属性值和对象的数组。]
  • findCN Boolean <optional>

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

Returns

  • UnitData Array.<UnitData>

    单个是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": "2024-12-24 14:11:00",		//创建时间,自动生成,索引创建在约束中.
	"updateTime": "2024-12-24 14:11:00" 		//修改时间,自动生成,索引创建在约束中.
}

Source

static

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

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

Syntax

//返回嵌套下级组织数组。
const unitList = this.org.listSubUnit( name, true );

Parameters

  • name UnitFlag | Array.<UnitFlag>

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

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

Returns

  • Array.<UnitData>

    返回组织数组。

{
	"name": "开发部",		//组织名称
	"unique": "kfb",		//唯一标识
	"distinguishedName": "开发部@kfb@U",		//识别名
	"typeList": [
		"部门"
	],		//组织类型
	"description": " ",		//说明
	"shortName": "kfb",		//简称
	"level": 2,		//组织层次
	"levelName": "浙江兰德纵横/开发部",		//组织层次名
	"superior": "浙江兰德纵横@a706f5f0-4a3b-4785-8e1d-0a944bfad4eb@U",		//上级组织
	"orderNumber": 1,		//排序号
	"levelOrderNumber": " ",		//层级排序号
	"qiyeweixinId": " ",		//企业微信Id
	"dingdingId": " ",		//钉钉Id
	"zhengwuDingdingId": " ",		//政务钉钉Id
	"weLinkId": " " 		//华为WeLink Id
}

Source

static

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

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

Syntax

//返回嵌套上级组织数组。
const unitList = this.org.listSupUnit( name, true );

Parameters

  • name UnitFlag | Array.<UnitFlag>

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

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

Returns

  • Array.<UnitData>

    返回组织数组。

{
	"name": "开发部",		//组织名称
	"unique": "kfb",		//唯一标识
	"distinguishedName": "开发部@kfb@U",		//识别名
	"typeList": [
		"部门"
	],		//组织类型
	"description": " ",		//说明
	"shortName": "kfb",		//简称
	"level": 2,		//组织层次
	"levelName": "浙江兰德纵横/开发部",		//组织层次名
	"superior": "浙江兰德纵横@a706f5f0-4a3b-4785-8e1d-0a944bfad4eb@U",		//上级组织
	"orderNumber": 1,		//排序号
	"levelOrderNumber": " ",		//层级排序号
	"qiyeweixinId": " ",		//企业微信Id
	"dingdingId": " ",		//钉钉Id
	"zhengwuDingdingId": " ",		//政务钉钉Id
	"weLinkId": " " 		//华为WeLink Id
}

Source

static

getUnitByIdentity(name, flagopt) → {UnitData}

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

Syntax

//返回直接所在组织。
const unit = this.org.getUnitByIdentity( name );

//返回第一层组织。
const unit = this.org.getUnitByIdentity( name, 1 );

* //返回类型为company的最近上级组织。
const unit = this.org.getUnitByIdentity( name, "company" );

Parameters

  • name IdentityFlag

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

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

Returns

  • UnitData

    返回对应的组织对象。

{
	"name": "开发部",		//组织名称
	"unique": "kfb",		//唯一标识
	"distinguishedName": "开发部@kfb@U",		//识别名
	"typeList": [
		"部门"
	],		//组织类型
	"description": " ",		//说明
	"shortName": "kfb",		//简称
	"level": 2,		//组织层次
	"levelName": "浙江兰德纵横/开发部",		//组织层次名
	"superior": "浙江兰德纵横@a706f5f0-4a3b-4785-8e1d-0a944bfad4eb@U",		//上级组织
	"orderNumber": 1,		//排序号
	"levelOrderNumber": " ",		//层级排序号
	"qiyeweixinId": " ",		//企业微信Id
	"dingdingId": " ",		//钉钉Id
	"zhengwuDingdingId": " ",		//政务钉钉Id
	"weLinkId": " " 		//华为WeLink Id
}

Source

static

listAllSupUnitWithIdentity(name) → {Array.<UnitData>}

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

Syntax

//返回组织数组。
const unitList = this.org.listAllSupUnitWithIdentity( name );

Parameters

  • name IdentityFlag | Array.<IdentityFlag>

    身份的distinguishedName、id、unique属性值，身份对象，或上述属性值和对象的数组。

Returns

  • Array.<UnitData>

    返回组织数组。

{
	"name": "开发部",		//组织名称
	"unique": "kfb",		//唯一标识
	"distinguishedName": "开发部@kfb@U",		//识别名
	"typeList": [
		"部门"
	],		//组织类型
	"description": " ",		//说明
	"shortName": "kfb",		//简称
	"level": 2,		//组织层次
	"levelName": "浙江兰德纵横/开发部",		//组织层次名
	"superior": "浙江兰德纵横@a706f5f0-4a3b-4785-8e1d-0a944bfad4eb@U",		//上级组织
	"orderNumber": 1,		//排序号
	"levelOrderNumber": " ",		//层级排序号
	"qiyeweixinId": " ",		//企业微信Id
	"dingdingId": " ",		//钉钉Id
	"zhengwuDingdingId": " ",		//政务钉钉Id
	"weLinkId": " " 		//华为WeLink Id
}

Source

static

listUnitWithPerson(name) → {Array.<UnitData>}

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

Syntax

//返回组织数组。
const unitList = this.org.listUnitWithPerson( name );

Parameters

  • name PersonFlag | Array.<PersonFlag>

    人员的distinguishedName、id、unique属性值，人员对象，或上述属性值和对象的数组。

Returns

  • Array.<UnitData>

    返回组织数组。

{
	"name": "开发部",		//组织名称
	"unique": "kfb",		//唯一标识
	"distinguishedName": "开发部@kfb@U",		//识别名
	"typeList": [
		"部门"
	],		//组织类型
	"description": " ",		//说明
	"shortName": "kfb",		//简称
	"level": 2,		//组织层次
	"levelName": "浙江兰德纵横/开发部",		//组织层次名
	"superior": "浙江兰德纵横@a706f5f0-4a3b-4785-8e1d-0a944bfad4eb@U",		//上级组织
	"orderNumber": 1,		//排序号
	"levelOrderNumber": " ",		//层级排序号
	"qiyeweixinId": " ",		//企业微信Id
	"dingdingId": " ",		//钉钉Id
	"zhengwuDingdingId": " ",		//政务钉钉Id
	"weLinkId": " " 		//华为WeLink Id
}

Source

static

listAllSupUnitWithPerson(name) → {Array.<UnitData>}

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

Syntax

//返回组织数组。
const unitList = this.org.listAllSupUnitWithPerson( name );

Parameters

  • name PersonFlag | Array.<PersonFlag>

    人员的distinguishedName、id、unique属性值，人员对象，或上述属性值和对象的数组。

Returns

  • Array.<UnitData>

    返回个人所在组织及所有上级组织。

{
	"name": "开发部",		//组织名称
	"unique": "kfb",		//唯一标识
	"distinguishedName": "开发部@kfb@U",		//识别名
	"typeList": [
		"部门"
	],		//组织类型
	"description": " ",		//说明
	"shortName": "kfb",		//简称
	"level": 2,		//组织层次
	"levelName": "浙江兰德纵横/开发部",		//组织层次名
	"superior": "浙江兰德纵横@a706f5f0-4a3b-4785-8e1d-0a944bfad4eb@U",		//上级组织
	"orderNumber": 1,		//排序号
	"levelOrderNumber": " ",		//层级排序号
	"qiyeweixinId": " ",		//企业微信Id
	"dingdingId": " ",		//钉钉Id
	"zhengwuDingdingId": " ",		//政务钉钉Id
	"weLinkId": " " 		//华为WeLink Id
}

Source

static

listUnitWithAttribute(name, attribute) → {Array.<UnitData>}

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

Syntax

//返回组织数组。
const unitList = this.org.listUnitWithAttribute( attributeName, attributeName );

Parameters

  • name String

    组织属性名称。
  • attribute String

    组织属性值。

Returns

  • Array.<UnitData>

    返回组织数组。

{
	"name": "开发部",		//组织名称
	"unique": "kfb",		//唯一标识
	"distinguishedName": "开发部@kfb@U",		//识别名
	"typeList": [
		"部门"
	],		//组织类型
	"description": " ",		//说明
	"shortName": "kfb",		//简称
	"level": 2,		//组织层次
	"levelName": "浙江兰德纵横/开发部",		//组织层次名
	"superior": "浙江兰德纵横@a706f5f0-4a3b-4785-8e1d-0a944bfad4eb@U",		//上级组织
	"orderNumber": 1,		//排序号
	"levelOrderNumber": " ",		//层级排序号
	"qiyeweixinId": " ",		//企业微信Id
	"dingdingId": " ",		//钉钉Id
	"zhengwuDingdingId": " ",		//政务钉钉Id
	"weLinkId": " " 		//华为WeLink Id
}

Source

static

listUnitWithDuty(name, id) → {Array.<UnitData>}

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

Syntax

//返回组织数组。
const unitList = this.org.listUnitWithDuty( dutyName, identity );

Parameters

  • name String

    组织职务名称。
  • id IdentityFlag

    身份的distinguishedName、id、unique属性值，身份对象。

Returns

  • Array.<UnitData>

    返回组织数组。

{
	"name": "开发部",		//组织名称
	"unique": "kfb",		//唯一标识
	"distinguishedName": "开发部@kfb@U",		//识别名
	"typeList": [
		"部门"
	],		//组织类型
	"description": " ",		//说明
	"shortName": "kfb",		//简称
	"level": 2,		//组织层次
	"levelName": "浙江兰德纵横/开发部",		//组织层次名
	"superior": "浙江兰德纵横@a706f5f0-4a3b-4785-8e1d-0a944bfad4eb@U",		//上级组织
	"orderNumber": 1,		//排序号
	"levelOrderNumber": " ",		//层级排序号
	"qiyeweixinId": " ",		//企业微信Id
	"dingdingId": " ",		//钉钉Id
	"zhengwuDingdingId": " ",		//政务钉钉Id
	"weLinkId": " " 		//华为WeLink Id
}

Source

static

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

列式所有顶层组织。

Syntax

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

Returns

  • Promise Array.<UnitData>

    当async为true时，返回

{
	"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": "2024-12-24 14:11:00",		//创建时间,自动生成,索引创建在约束中.
	"updateTime": "2024-12-24 14:11:00" 		//修改时间,自动生成,索引创建在约束中.
}

Source

static

getDuty(duty, id) → {Array.<IdentityData>}

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

Syntax

//返回身份数组。
const identityList = this.org.getDuty( dutyName, unit );

Parameters

  • duty String

    组织职务名称。
  • id UnitFlag

    组织的distinguishedName、id、unique属性值，组织对象。

Returns

  • Array.<IdentityData>

    返回身份数组。

{
	"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": "2024-12-24 14:11:00",		//创建时间,自动生成,索引创建在约束中.
	"updateTime": "2024-12-24 14:11:00" 		//修改时间,自动生成,索引创建在约束中.
}

Source

static

listDutyNameWithIdentity(id) → {Array.<String>}

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

Syntax

//返回职务名称数组。
const dutyNameList = this.org.listDutyNameWithIdentity( identity );

Parameters

  • id IdentityFlag | Array.<IdentityFlag>

    身份的distinguishedName、id、unique属性值，身份对象，或上述属性值和对象的数组。

Returns

  • Array.<String>

    返回职务名称数组。

Source

static

listDutyNameWithUnit(name) → {Array.<String>}

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

Syntax

//返回职务名称数组。
const dutyNameList = this.org.listDutyNameWithUnit( unit );

Parameters

  • name UnitFlag | Array.<UnitFlag>

    组织的distinguishedName、id、unique属性值，组织对象，或上述属性值和对象的数组。

Returns

  • Array.<String>

    返回职务名称数组。

Source

static

listUnitAllDuty(name) → {Array.<Object>}

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

Syntax

//返回职务数组。
const dutyList = this.org.listUnitAllDuty( unit );

Parameters

  • name UnitFlag

    组织的distinguishedName、id、unique属性值，组织对象。

Returns

  • Array.<Object>

    返回职务数组

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

static

appendUnitAttribute(unit, attr, values)

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

Syntax

this.org.appendUnitAttribute( unit, attribute, valueArray);

Parameters

  • unit UnitFlag

    组织的distinguishedName、id、unique属性值，组织对象。
  • attr String

    属性名称。
  • values Array.<String>

    属性值，必须为数组。

Source

static

setUnitAttribute(unit, attr, values)

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

Syntax

this.org.setUnitAttribute( unit, attribute, valueArray);

Parameters

  • unit UnitFlag

    组织的distinguishedName、id、unique属性值，组织对象。
  • attr String

    属性名称。
  • values Array.<String>

    属性值，必须为数组。

Source

static

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

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

Syntax

//返回该组织的属性值数组。
const attributeList = this.org.getUnitAttribute( unit, attr );

Parameters

  • unit UnitFlag

    组织的distinguishedName、id、unique属性值，组织对象。
  • attr String

    属性名称。

Returns

  • Array.<String>

    返回属性值数组， 如：

    [ value1, value2 ]

Source

static

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

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

Syntax

//返回组织所有属性的名称数组。
const attributeNameList = this.org.listUnitAttributeName( unit );

Parameters

  • name UnitFlag | Array.<UnitFlag>

    组织的distinguishedName、id、unique属性值，组织对象，或上述属性值和对象的数组。

Returns

  • Array.<String>

    返回组织属性名称数组， 如：

    [ attributeName1, attributeName2 ]

Source

static

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

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

Syntax

//返回组织所有属性的对象数组。
const attributeObjectList = this.org.listUnitAllAttribute( unit );

Parameters

  • name UnitFlag | Array.<UnitFlag>

    组织的distinguishedName、id、unique属性值，组织对象，或上述属性值和对象的数组。

Returns

  • Array.<Object>

    返回组织属性对象数组，如：

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

Source

results matching

    No results matching ''