参数说明
参数参数类型是否必须说明linkTypeString用户关联类型user_dept_link 用户部门关联关系user_org_link 用户组织关联关系
user_post_link 用户岗位关系关系
dept_principal_user_link 用户部门负责人
org_principal_user_link 用户组织负责人
director_user_link 用户上级部门负责人bdTypeStringdept 部门user 用户org 组织post 岗位director 上级部门负责人idsList用户,组织,部门,岗位IDptJobIncludeboolean是否包含兼职信息
接口说明:
用于查询用户相关联的组织,部门,岗位相关联人员信息,不查询角色相关联的信息
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 用户的上级部门负责
bdType 为 dept 查询部门下的用户,或者部门负责人2.1) linkType user_dept_link 部门下用户
2.2) linkType dept_principal_user_link 部门负责人
bdType 为 org 查询组织下的用户,或者组织负责人3.1) linkType user_org_link 组织下用户
3.2) linkType org_principal_user_link 组织负责人
bdType 为 pos t查询岗位下的用户4.1) linkType user_post_link 查询岗位下的用户
bdType 为 director 查询上级部门负责人5.1) linkType director_user_link 查询上级部门负责人
返回数据格式说明:
bdTypelinkType相应查询结果数据格式usernull1.1{ “ptjob”: [],//兼职信息 “mainjob”: [ //主职信息 { “directoruserid”: “directoruserid”,//上级部门负责人 “deptid”: " deptid ",//用户部门ID “postid”: “postid”,// 用户岗位ID “userid”: “userid”,// 用户ID “orgid”: “orgid”// 用户组织ID } ] }useruser_dept_link user_org_link user_post_link dept_principal_user_link org_principal_user_link director_user_link1.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” ] } ] } }dept org post directoruser_dept_link dept_principal_user_linkuser_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,getUserFromYHTcom.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)参数说明:
参数参数类型是否必须说明idsuserIdsStringString用户ID集合userNamebdTypeStringString用户名pageSizeList分页信息pageNumString分页信息sortTypeStringisInStringsysidStringsecretKeyString返回数据格式说明:
{ "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 查询用户 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 seeYHTOrgQueryImpl#innerExecuteListBdCenterUtils#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)参数说明:
参数参数类型是否必须说明conditionCondition查询条件condition.conditionList< ConditionVO>sorterSorter排序属性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,likelogicsymbollogicsymboland2.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 seecom.yonyou.bpm.core.cmdimpl.YHTPostQueryImpl#innerExecuteListcom.yonyou.bpm.util.BdCenterUtils#getPostsByParam返回数据说明: 实体 com.yonyou.iuap.bd.pub.param.Page
Page 关键字段说明
字段字段类型是否必须说明pageSizeInteger一页查询个数currentPageInteger当前页码totalInteger结果总数contentList查询岗位结果集合岗位关键字段说明
字段字段类型是否必须说明idStringidcodeStringcodecontentStringname 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```javaString 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}