组织概述
第三方系统与平台集成,其必须要实现账号的统一管理,这要求第三方平台与jpaas平台实现组织架构的统一,平台建议采用与第三方的组织架构的一致是通过同步来实现的。同步需要采用接口调用方式来实现接口的统一管理,需要获得平台的接口调用授权。如何获取系统的调用授权请参考:
http://doc.redxun.cn/docs/jpaas/externalCall 。
同步用户组
接口路径:api/api-user/restApi/user/addOrUpateGroupss
参数:
请求体:
{
"tenantId": "webApp",
"groups":[
{
"id":"1",
"code":"testGroup01",
"name":"测试用户组01",
"parentId":"0"
},
{
"id":"2",
"code":"testGroup02",
"name":"测试用户组02",
"parentId":"1"
}
]
}
参数名 | 参数值 | 必要性 |
---|---|---|
tenantId | 租户id,默认webApp | 是 |
groups | 用户组列表 | 是 |
id | 用户组ID,唯一标识 | 是 |
code | 用户组业务主键,唯一标识 | 是 |
name | 用户组名称 | 是 |
parentId | 上级用户组id,顶级为0 | 是 |
接口功能:用户组同步功能包括新增和更新功能。
(1)、根据用户组id和用户组业务主键查询平台是否存在数据,不存在则新增,否在为更新。
(2)、新增为新建一条维度为1的组织数据
(3)、更新时除更新传过来的数据外,也会对此组织下的所有子组织进行路径(path)的更新
删除用户组
接口路径:api/api-user/restApi/user/deleteGroups
参数:
请求体:
{
"tenantId": "webApp",
"groupIds":"1,2"
}
参数名 | 参数值 | 必要性 |
---|---|---|
tenantId | 租户id,默认webApp | 是 |
groupIds | 用户组ID列表 | 是 |
接口功能:根据用户组ID进行删除用户组。
(1)、删除用户组的同时,也会删除此用户组关联的【用户关系】、【组关系】。
(2)、用户所属的主部门为此用户组,则不删除该条关联的用户关系记录。
同步用户
接口路径:api/api-user/restApi/user/addOrUpateUsers
参数:
请求体:
{
"tenantId": "webApp",
"users":[
{
"userId":"10001",
"account":"zhangsan",
"fullname":"张三",
"sex":"male",
"email":"358****@qq.com",
"mobile":"1307763****",
"qq":"358****",
"address":"广东省广州市海珠区",
"wxOpenId":"zhangsan",
"depId":"1",
"status":"1",
"relations":[{"relationType":"1","dimId":"1","part1":"2"},{"relationType":"3","dimId":"","part1":"1297745181147734017"}]
}
]
}
参数名 | 参数值 | 必要性 |
---|---|---|
tenantId | 租户id,默认webApp | 是 |
users | 用户对象列表 | 是 |
account | 用户账号,唯一标识 | 是 |
fullname | 用户名称 | 是 |
sex | 性别:male(男)、female(女) | 是 |
电子邮箱 | 是 | |
mobile | 手机号 | 是 |
否 | ||
address | 通讯地址 | 否 |
wxOpenId | 用户所在企业微信账号 | 否 |
depId | 用户主部门 | 否 |
status | 用户状态:1(在职) 0(离职) | 是 |
relations | 用户关系 | 否 |
relationType | 关系类型Id | 是 |
dimId | 用户组维度Id | 否 |
part1 | 当前方Id | 是 |
接口功能:用户同步功能包括新增和更新功能。
(1)、根据用户账号查询平台是否存在数据,不存在则新增,否在为更新。
(2)、新增时用户初始化密码为1,如果存在主部们和所属用户组数据,则新建对应用户组关系数据。
(3)、更新时除更新传过来的数据外,如果存在主部们和所属用户组数据,则更新维度为1的用户组关系数据
(4)、用户关系:用户和组、用户和用户(指定上级),需配置关系类型与当前方id,用户与用户时不需要指定维度id
例如上方请求体中,用户关系中配置的是用户的行政组织与上级
(5)、指定用户与组关系时,用户组不能为主部门,否则无效。
删除用户
接口路径:api/api-user/restApi/user/deleteUsers
参数:
请求体:
{
"tenantId": "webApp",
"userAccounts":"zhangsan,lisi,wangwu"
}
参数名 | 参数值 | 必要性 |
---|---|---|
tenantId | 租户id,默认webApp | 是 |
userAccounts | 用户账号列表 | 是 |
接口功能:根据用户账号进行删除用户。
(1)、删除用户的同时,也会删除此用户关联用户组所有关系。
查询所有用户
接口路径:api/api-user/restApi/user/getUsers
参数:
请求体:
{
"pageNo": 1,
"pageSize": 10,
"params": {},
"sortField": "",
"sortOrder": "asc"
}
参数名 | 参数值 | 必要性 |
---|---|---|
pageNo | 当前页码 | |
pageSize | 分页大小 | |
params | 条件,例:Q_FULLNAME__S_LK | |
sortField | 排序字段 | |
sortOrder | 排序(asc/desc) |
接口功能:查询所有的用户。
查询所有用户组
接口路径:api/api-user/restApi/user/getGroups
参数:
请求体:
{
"pageNo": 1,
"pageSize": 10,
"params": {},
"sortField": "",
"sortOrder": "asc"
}
参数名 | 参数值 | 必要性 |
---|---|---|
pageNo | 当前页码 | |
pageSize | 分页大小 | |
params | 条件,例:Q_NAME__S_LK | |
sortField | 排序字段 | |
sortOrder | 排序(asc/desc) |
接口功能:查询所有的用户组。
定制任务调用
基于以上接口的调用,开发者可以根据参考以下定时任务的编写处理:
http://doc.redxun.cn/docs/jpaas/schedulerJob