11111

云审审批参与人-友户通版实现接口

1 设计器参与人与SDK对应接口实现

参与人	controller	type	QueryImpl	SDK接口实现类
用户	BpmIdentityCtrl	user	YHTUserQueryImpl	根据关键字分页查询用户UserCenterUtils.searchUserList(YHTUserQueryImplparam) com.yonyou.iuap.tenant.sdk.UserCenterUserCenter.pageUsers
岗位	BpmIdentityCtrl	post	YHTPostQueryImpl	BdCenterUtils.getPostsByParam(this,systemCode) PostServiceImpl.pagination
用户组	BpmIdentityCtrl	usergroup	YHTUserGroupQueryImpl	BdCenterUtils.getUserGroupsByParam(this,systemCode) RoleCenter.pageRoles
部门/部门负责人	BpmIdentityCtrl	dept	YHTOrgQueryImp	条件查询,不带分页BdCenterUtils.getOrgsByParam(this,systemCode) AdminOrgServiceImpl.list

2   云审-友户通提供SDK接口实现

2.1   用户关联关系查询 BdLinkService

com.yonyou.iuap.bd.lnk.service.itf.BdLinkService

方法调用处 To see

YHTUserLinkQueryImpl#innerExecuteList

BdCenterUtils#getUserlinksByParam(BpmUserLinkQueryImpl param, String systemCode)

2.1.1 用户/组织,部门,岗位关联关系查询接口

String listLinkByCondition(String linkType,String bdType, List<String> ids, boolean ptJobInclude)

参数说明

参数	参数类型	是否必须	说明
linkType	String		用户关联类型 user_dept_link 用户部门关联关系 user_org_link 用户组织关联关系 user_post_link 用户岗位关系关系 dept_principal_user_link 用户部门负责人 org_principal_user_link 用户组织负责人 director_user_link 用户上级部门负责人
bdType	String		dept 部门 user 用户 org 组织 post 岗位 director 上级部门负责人
ids	List		用户,组织,部门,岗位ID
ptJobInclude	boolean		是否包含兼职信息

接口说明:

用于查询用户相关联的组织,部门,岗位相关联人员信息,不查询角色相关联的信息

1. bdType 为 user 查询接口为用户的部门/组织,岗位,部门/组织负责人,上级部门负责人

1.1) linkType 空 查询用户的部门/组织/岗位/上级部门负责人信息

1.2) linkType user_dept_link 用户的部门

1.3) linkType user_org_link 用户的组织

1.4) linkType user_post_link 用户的岗位

1.5) linkType dept_principal_user_link 用户的部门负责人

1.6) linkType org_principal_user_link 用户的组织负责人

1.7) linkType director_user_link 用户的上级部门负责

2. bdType 为 dept 查询部门下的用户,或者部门负责人

2.1) linkType user_dept_link  部门下用户

2.2) linkType dept_principal_user_link 部门负责人

3. bdType 为 org 查询组织下的用户,或者组织负责人

3.1) linkType user_org_link 组织下用户

3.2) linkType org_principal_user_link 组织负责人

4. bdType 为 pos t查询岗位下的用户

4.1) linkType user_post_link 查询岗位下的用户

5. bdType 为 director 查询上级部门负责人

5.1) linkType director_user_link 查询上级部门负责人

返回数据格式说明:

返回格式一:

bdType	linkType	相应查询结果
user	null	1.1

{
  "ptjob": [],//兼职信息
  "mainjob": [ //主职信息
    {
      "directoruserid": "directoruserid",//上级部门负责人
      "deptid": " deptid ",//用户部门ID
      "postid": "postid",// 用户岗位ID
      "userid": "userid",// 用户ID
      "orgid": "orgid"// 用户组织ID
    }
  ]
}

返回格式二:

bdType	linkType	相应查询结果
user	user_dept_link user_org_link user_post_link dept_principal_user_link org_principal_user_link director_user_link	1.2 1.3 1.4 1.5 1.6 1.7

{
  "ptjob": [],
  "mainjob": [
    {
      "userId_1": "userId_linkId_1_1",
      "userId_2": [
        "userId_linkId_2_1",
        "userId_linkId_2_2"
      ]
    }
  ]
}

返回格式三:

bdType	linkType	相应查询结果
dept org post director	user_dept_link dept_principal_user_link user_org_link org_principal_user_link user_post_link director_user_link

{
  "ptjob": [],
  "mainjob": [
    {
      "targetId_2": [
        "userId_2_1",
        "userId_2_2"
      ],
      "targetId_1": "userId_1_1"
    }
  ]
}

2.2 用户查询接口 com.yonyou.yht.sdk.UserCenter

方法调用处 To see

com.yonyou.bpm.core.cmdimpl.YHTUserQueryImpl#innerExecuteList,getUserFromYHT

com.yonyou.bpm.util.UserCenterUtils# searchUserList(YHTUserQueryImpl param)

2.2.1 userIds,userName 分页查询用户

String searchUser(String[] ids, String userName, String pageSize, String pageNum, String sortType, String isIn,String sysid, String secretKey)

参数说明:

参数	参数类型	是否必须	说明
idsuserIds	StringString		用户ID集合
userNamebdType	StringString		用户名
pageSize	List		分页信息
pageNum	String		分页信息
sortType	String
isIn	String
sysid	String
secretKey	String

返回数据格式说明:

{
  "users": {
    "number": 1,
    "numberOfElements": 10,
    "size": 10,
    "totalPages": 3,
    "sort": "sort",
    "content": [//用户实体集合
      {
        "mail": "mail",
        "userAvator": "avator",
        "userMobile": "userMobile",  // 手机号
        "userEmail": "email",        // 邮箱
        "userName": "userName",      // 用户名
        "userId": "userId",          // userId
        "userCode": "userCode",      // 用户code
        "status": 0
      }
    ],
    "totalElements": 23
  },
  "status": 1
}

2.2.2 userCode 查询用户

String getUserByCode(String userCode)

返回数据格式说明: yht只用到userId

{
  "userCode": " userCode",
  "flag": 1,
  "mail": "mail",
  "userMobile": "userMobile",
  "userEmail": "userEmail",
  "userId": "userId",
  "status": 1
}

2.2.3 userId  查询用户

getUserById(String userId, String sysid, String secretKey)

返回数据格式说明:

{
  "msg": "",
  "user": { //用户实体
    "mail": "mail",
    "userMobile": "userMobile",
    "userEmail": "userEmail",
    "userId": "userId",
    "userCode": "userCode"
  },
  "status": 1
}

2.2.4   userCodes  查询用户集合

getUserByCodes(String[] codes, String sysid, String secretKey)

返回数据格式说明:

{
  "msg": "",
  "users": [ //用户实体集合
    {
      "mail": "mail",
      "userMobile": "userMobile",
      "userEmail": "userEmail",
      "userId": "userId",
      "userCode": "userCode"
    }
  ],
  "status": 1
}

2.2.5  name  模糊查询用户 分页

com.yonyou.iuap.tenant.sdk.UserCenter

searchUserList(String tenantId, String pageSize, String pageNum, String name, String sortType)

pageUsers(String tenantId, String pageSize, String pageNum, String name, String sortType)

返回数据格式说明:

{
  "data": {
    "total": 20,
    "totalPage": 2,
    "pageSize": 2,
    "pageNum": 3,
    "content": [ //用户实体集合
      {
        "mail": "mail",
        "userMobile": "userMobile",
        "userEmail": "userEmail",
        "userId": "userId",
        "userCode": "userCode"
      }
    ]
  },
  "state": 1
}

2.2.6  mobile/email   查询用户

getUserByContacts(String mobile, String email)

返回数据格式说明:

{
  "msg": "",
  "users": [
    {
      "mail": "mail",
      "userMobile": "userMobile",
      "userEmail": "userEmail",
      "userId": "userId",
      "userCode": "userCode"
    }
  ],
  "status": 1
}

2.3  组织/部门查询接口 AdminOrgServiceImpl

方法调用处 To see

YHTOrgQueryImpl#innerExecuteList

BdCenterUtils#getOrgsByParam(YHTOrgQueryImpl param, String systemCode)

2.3.1   组织/部门ID 查询 组织/部门

AdminOrg getById(String id)

AdminOrg 属性说明

参数	说明
orgtypeuserIds	组织类型 0 部门 1 组织

2.3.2  分页查询 组织/部门

Page<AdminOrg> pagination(Condition condition, Sorter sorter, int pageIndex, int pageSize)

参数说明:

参数	参数类型	是否必须	说明
condition	Condition		查询条件condition.conditionList< ConditionVO>
sorter	Sorter		排序属性sorter.orders

查询参数实体 ConditionVO 说明

属性	属性说明	可能取值
field	查询字段	id(=),id(in 1,2,3),code(=),code(in a,b), code(like),name(=),name(like)parentid(=),parentid(like), orgtype(=1组织2部门)
value	字段值
operator	查询字段匹配关系	=,in,like
logicsymbol	logicsymbol	and

2.3.3 不分页查询 组织/部门

List<AdminOrg> list(Condition condition, Sorter sorter)

2.4   岗位查询接口 PostServiceImpl

2.4.1 分页查询 岗位

Page<Post> pagination(Condition condition, Sorter sorter,int pageIndex, int pageSize)

方法调用处 To see

com.yonyou.bpm.core.cmdimpl.YHTPostQueryImpl#innerExecuteList

com.yonyou.bpm.util.BdCenterUtils#getPostsByParam

返回数据说明: 实体 com.yonyou.iuap.bd.pub.param.Page

Page 关键字段说明

字段	字段类型	是否必须	说明
pageSize	Integer		一页查询个数
currentPage	Integer		当前页码
total	Integer		结果总数
content	List		查询岗位结果集合

岗位关键字段说明

字段	字段类型	是否必须	说明
id	String		id
code	String		code
content	String		name

---

---

2.4.2 不分页查询 岗位

List<Post> list(Condition condition, Sorter sorter)

2.5  角色查询接口  RoleCenter

2.5.1   分页查询租户下的角色

RoleCenter  String pageRoles(String systemCode, String tenantId, String pageSize, String pageNum, String sortType)

返回数据格式说明:

{
  "data": [
    {
      "roleName": "roleName",
      "roleId": "roleId",
      "roleCode": "roleCode"
    }
  ],
  "status": 1
}

2.5.2 查询租户下的角色 不分页

String queryRoles(String systemCode, String tenantId)

返回数据格式说明:

{
  "content": [
    {
      "roleName": "roleName",
      "roleId": "roleId",
      "roleCode": "roleCode"
    }
  ]
}

2.6 用户角色关联查询接口 UserRoleCenter

方法调用处 To see

YHTUserLinkQueryImpl#innerExecuteList

BdCenterUtils#getUserlinksByParam(BpmUserLinkQueryImpl param, String systemCode)

2.6.1 由userId查询用户关联的角色roleIds

String queryRoleByUser(String userId, String tenantId, String systemCode)

返回数据格式说明:

{
  "data": [
    "roleId1",
    "roleId2"
  ],
  "status": 1
}

2.6.2  由roleID查询该角色下的用户userIds

String queryUserByRole(String roleId)

返回数据格式说明:

{
  "data": [
    "userId1",
    "userId2"
  ],
  "status": 1
}