1. 组织模型管理
本接口用来获取组织模型基本信息 组织模型服务支持获取人员,岗位,职务,部门,单位等数据。 1.1. 更新接口返回值说明新增修改部门、岗位、职务级别和人员时的返回值。 1.1.1. 返回值示例成功示例:创建人员 {
'successMsgs': [
{
'code': 'SUCCESS',
'ent': {
'orgAccountId': -2332227039700957700,
'id': 7998660249083069000,
'name': '新建人员',
'code': 'A002',
'createTime': 1398417138169,
'updateTime': 1398417138169,
'sortId': 20,
'isDeleted': false,
'enabled': false,
'status': 1,
'description': '描述',
'orgLevelId': 3176188816548514000,
'orgPostId': -2779802668474544000,
'orgDepartmentId': 8422701464295851000,
'type': 1,
'isInternal': true,
'isLoginable': true,
'isVirtual': false,
'isAssigned': true,
'isAdmin': false,
'isValid': false,
'state': 1,
'properties': {
'birthday': 1398096000000,
'postalcode': '',
'emailaddress': '',
'extPostLevel': '',
'website': '',
'address': '',
'officenumber': '',
'gender': '1',
'telnumber': '',
'blog': '',
'imageid': ''
},
'second_post': [ ],
'concurrent_post': [ ],
'valid': false,
'telNumber': null,
'birthday': 1398096000000,
'officeNum': null,
'emailAddress': null,
'gender': 1,
'loginName': 'newUser'
'
}
}
],
'errorMsgs': [ ],
'success': true
} 失败示例:创建岗位:
1.1.2. 返回值说明
1.1.3. 状态码
1.2. 部门管理部门管理服务支持获取,创建,修改,删除部门数据。 1.2.1. 部门对象部门对象示例 {
'orgAccountId': 967547186016371000, 【必填】
'id': 7313901301646381000,
'name': '部门名称', 【必填】
'enabled': true,
'sortId': 2,
'isGroup': false,
'superior': 967547186016371000, 【必填】
'path': '000000050002',
'code': '',
'createTime': 1394418149000,
'updateTime': 1394418149000,
'isDeleted': false,
'status': 1,
'description': '',
'shortName': null,
'secondName': null,
'isInternal': true,
'levelScope': -1,
'type': 'Department',
'properties': {
'unitCategory': null,
'fax': null,
'unitMail': null,
'accessLevels': null,
'customLoginUrl': null,
'ldapOu': null,
'address': null,
'chiefLeader': null,
'zipCode': null,
'telephone': null,
'permissionType': null,
'isCustomLoginUrl': null,
'ipAddress': null
},
'superiorName': '',
'sortIdType': '1',
'entityType': 'Department',
'depManager': null,
'depAdmin': null,
'posts': [ ],
'valid': true,
'group': false,
'customLogin': false,
'parentPath': '00000005',
'customLoginUrl': null
} 部门对象属性说明
部门创建更新返回对象示例部门创建/更新成功返回对象示例
部门创建/更新失败返回对象示例 {
'successMsgs': [ ],
'errorMsgs': [
{
'code': 'POST_REPEAT_NAME',
'ent': {
'orgAccountId': 967547186016371000,
'id': -255377732695800220,
'name': '部门名称',
'code': '999',
'createTime': 1394418123000,
'updateTime': 1394418123000,
'sortId': 1,
'isDeleted': false,
'enabled': true,
'status': 1,
'description': '',
'path': '000000050001',
'shortName': null,
'secondName': null,
'isInternal': true,
'isGroup': false,
'levelScope': -1,
'type': 'Department',
'properties': {
'unitCategory': null,
'fax': null,
'unitMail': null,
'accessLevels': null,
'customLoginUrl': null,
'ldapOu': null,
'address': null,
'chiefLeader': null,
'zipCode': null,
'telephone': null,
'permissionType': null,
'isCustomLoginUrl': null,
'ipAddress': null
},
'superior': 967547186016371000,
'superiorName': '',
'sortIdType': '1',
'entityType': 'Department',
'depManager': null,
'depAdmin': null,
'posts': [
-1438182393845429500
],
'valid': true,
'group': false,
'customLogin': false,
'parentPath': '00000005',
'customLoginUrl': null
}
}
],
'success': false
} 1.2.2. 按部门ID取部门信息开发者可以通过【部门ID】来获取部门信息。 接口调用请求说明:
返回说明: 正常情况下,会返回的是JSON格式部门信息,JSON数据包参考:部门对象示例 参数说明 请参考:部门对象属性说明 如果录入的部门ID错误或者为空时,返回JSON格式部门信息的为空. 1.2.3. 按部门编码取部门信息开发者可以通过【部门编码】来获取部门信息。 接口调用请求说明: http请求方式:GET
http://ip:port/seeyon/rest/orgDepartment/code/{code}
返回说明: 正常情况下,会返回的是JSON格式部门信息,JSON数据包参考:部门对象示例 参数说明 请参考:部门对象属性说明 如果录入的部门编码错误或者为空时,返回JSON格式部门信息的为空. 1.2.4. 获取指定单位的所有部门(不包含停用)开发者可以通过【单位ID】来获取单位下所有部门信息(不包含停用部门)。 接口调用请求说明:
返回说明 正常情况下,会返回的是JSON格式部门信息,JSON数据包参考:部门对象示例 参数说明 请参考:部门对象属性说明 如果录入的单位ID错误或者为空时,返回JSON格式部门信息的为空. 1.2.5. 获取指定单位的所有部门数量(不包含停用)开发者可以通过【单位ID】来获取部门的数量(不包含停用部门)。 接口调用请求说明: http请求方式:GET
http://ip:port/seeyon/rest/orgDepartments/count/{accountId}
返回说明 正常情况下,会返回的是JSON格式部门信息,JSON数据包参考:部门对象示例 参数说明 请参考:部门对象属性说明 正常情况下,会返回的是Integer类型的数值。 如果录入的单位ID错误或者为空时,返回信息为空。 1.2.6. 获取指定单位的所有部门(包含停用)开发者可以通过【单位ID】来获取单位下所有部门信息(包含停用部门)。 接口调用请求说明:
返回说明 正常情况下,会返回的是JSON格式部门信息,JSON数据包参考:部门对象示例 参数说明 请参考:部门对象属性说明 如果录入的单位ID错误或者为空时,返回JSON格式部门信息的为空. 1.2.7. 创建部门开发者可以将部门相关参数组装为JSON类型,来创建部门信息。 接口请求说明: http请求方式:POST
http://ip:port/seeyon/rest/orgDepartment
组装新建部门JSON数据,请参照:部门对象示例只需要将示例对象中标明为【必填】(不包括ID)参数组装即可。 正常情况下,创建成功会返回成功的标识以及JSON格式部门信息,返回JSON数据信息请参考:部门创建更新返回对象示例 如果创建失败,同样会返回失败的标识,并且在【'errorMsgs'】参数中给出创建失败的原因以及JSON信息。 1.2.8. 批量创建部门(Since:V61)将需要创建的多个部门Map放入List中批量创建部门信息。【注意:单位下必须没有启用的部门,才能够进行批量创建】 接口请求说明:
创建数据示例: List reslist=new ArrayList();
Map newDep = new HashMap() {
{
put('orgAccountId', '5269865115340261356'); //单位ID
put('code', 'auto1');//编号
put('name', 'REST创建');//名称
put('description', '描述');
put('enabled','true');//启用是否
put('superior', '5269865115340261356');//父级ID
}
};
Map newDep2 = new HashMap() {
...
}
reslist.add(newDep);
reslist.add(newDep2);
client.post('/orgDepartment/addDepartments',reslist, String.class); 返回说明 创建部门成功则返回JSON格式部门信息。 1.2.9. 按部门Id修改部门信息开发者可以通过部门ID修改对应的部门信息。 接口请求说明:
创建数据示例: {
'Id': 需修改的部门ID, 【必填】
'code': 要修改部门参数, 【必填】
} 返回说明 正常情况下,创建成功会返回成功的标识以及JSON格式部门信息,返回JSON数据信息请参考:部门创建更新返回对象示例 部门ID不存在,那么返回信息为空。 如果失败,同样会返回失败的标识,并且在【'errorMsgs'】参数中给出创建失败的原因以及JSON信息。 1.2.10. 批量修改部门(Since:V61)将需要修改的多个部门Map放入List中批量创建部门信息。 接口请求说明:
创建数据示例: List reslist=new ArrayList();
Map res = new HashMap();
res.put('id','-7591078065748751151');
res.put('description','批量修改');
reslist.add(res);
client.post('/orgDepartment/updateDepartments',reslist, String.class); 返回说明 修改部门成功则返回JSON格式部门信息。 1.2.11. 按部门Id删除部门开发者可以通过部门ID删除对应的部门信息。 接口请求说明:
返回说明 因为删除目前接口采用异步模式,暂无返回值信息。 1.2.12. 按部门Id启用/停用部门开发者可以通过部门ID以及enabled字段信息来启用禁用对应的部门信息。 接口请求说明: http请求方式:PUT
http://ip:port/seeyon/rest/orgDepartment/{id}/enabled/{enabled}
创建数据示例: 组装修改部门启用/禁用JSON数据的参数只需要部门的ID以及enabled参数信息即可,示例如下:
1.2.13. 获取指定部门下的所有子部门开发者可以通过【部门ID】来获取指定部门下所有部门信息。 接口调用请求说明: http请求方式:GET
http://ip:port/seeyon/rest/orgDepartments/children/{parentId}?firstLayer=false/true;
返回说明 正常情况下,会返回的是JSON格式部门信息,JSON数据包参考:部门对象示例 参数说明 请参考:部门对象属性说明 如果录入的单位ID错误或者为空时,返回JSON格式部门信息的为空. 1.2.14. 获取指定部门父级部门开发者可以通过【部门ID】来获取指定部门父级部门信息。 接口调用请求说明:
返回说明 正常情况下,会返回的是JSON格式部门信息,JSON数据包参考:部门对象示例 参数说明 请参考:部门对象属性说明 如果录入的单位ID错误或者为空时,返回JSON格式部门信息的为空. 1.2.15. 按部门编码修改部门信息(Since:V6.0)开发者可以通过部门编码修改对应的部门信息。 接口请求说明: http请求方式:PUT
http://ip:port/seeyon/rest/orgDepartment 创建数据示例:
返回说明 正常情况下,创建成功会返回成功的标识以及JSON格式部门信息,返回JSON数据信息请参考:部门创建更新返回对象示例 部门编码不存在,那么返回信息为空。 如果失败,同样会返回失败的标识,并且在【'errorMsgs'】参数中给出创建失败的原因以及JSON信息。 1.2.16. 按照部门编码启用/停用部门信息(Since:V6.0)开发者可以通过部门编码以及enabled字段信息来启用禁用对应的部门信息。 接口请求说明: http请求方式:PUT
http://ip:port/seeyon/rest/orgDepartment/code/{code}/enabled/{enabled}
创建数据示例: 组装修改部门启用/禁用JSON数据的参数只需要部门的ID以及enabled参数信息即可,示例如下:
返回说明 正常情况下,创建成功会返回成功的标识以及JSON格式部门信息,返回JSON数据信息请参考:部门创建更新返回对象示例 如果创建失败,同样会返回失败的标识,并且在【'errorMsgs'】参数中给出创建失败的原因以及JSON信息。 1.2.17. 按照部门编码删除部门(Since:V6.0)开发者可以通过部门编码删除对应的部门信息。 接口请求说明 http请求方式:DELETE
http://ip:port/seeyon/rest/orgDepartment/code/{code}
返回说明 因为删除目前接口采用异步模式,暂无返回值信息。 1.2.18. 按照单位编码获取所有部门信息(包含停用部门)(Since:V6.0)开发者可以通过【单位编码】来获取单位下所有部门信息(包含停用部门)。 接口调用请求说明:
返回说明 正常情况下,会返回的是JSON格式部门信息,JSON数据包参考:部门对象示例 参数说明 请参考:部门对象属性说明 如果录入的单位编码错误或者为空时,返回JSON格式部门信息的为空. 1.2.19. 按部门编码获取所有所有子部门(Since:V6.0)开发者可以通过【部门编码】来获取指定部门下所有子部门信息。 接口调用请求说明; http请求方式:GET
http://ip:port/seeyon/rest/orgDepartments/children/code/{parentCode}
返回说明 正常情况下,会返回的是JSON格式部门信息,JSON数据包参考:部门对象示例 参数说明 请参考:部门对象属性说明 如果录入的部门编码错误或者为空时,返回JSON格式部门信息的为空. 1.2.20. 根据部门编码获取部门兼职人员信息(Since:V6.0)开发者可以通过【部门编码】来获取指定部门下所有兼职人员信息。 接口调用请求说明:
返回说明 正常情况下,会返回的是JSON格式部门信息,JSON数据包参考:部门对象示例 参数说明 请参考:部门对象属性说明 如果录入的部门编码错误或者为空时,返回JSON格式部门信息的为空. 1.2.21. 根据部门ID查看部门岗位(Since:V6.0)根据部门ID查看当前部门所设置的岗位。 接口调用请求说明: http请求方式:GET
http://ip:port/seeyon/rest/orgDepartment/departmentpost/{departmentid}
返回说明 正常情况下,会返回的是JSON格式部门信息,JSON数据包参考:部门对象示例 参数说明 请参考:部门对象属性说明 如果录入的错误或者为空时,返回JSON格式部门信息的为空. 1.2.22. 根据部门ID跟新部门岗位(Since:V6.0)根据部门ID更新当前部门所设置的岗位。 接口调用请求说明:
返回说明 正常情况下,会返回的是JSON格式部门信息,JSON数据包参考:部门对象示例 参数说明 请参考:部门对象属性说明 如果录入错误或者为空时,返回JSON格式部门信息的为空. 1.2.23. 根据部门ID查看部门[部门主管、分管领导、部门管理员、部门公文收发员](Since:V6.0)根据部门ID查看当前部门的部门主管、分管领导、部门管理员、部门公文收发员。 接口调用请求说明: http请求方式:GET
http://ip:port/seeyon/rest/orgDepartment/departmentmanagerinfo/{departmentid}/{accountid} 返回说明 正常情况下,会返回的是JSON格式部门信息,JSON数据包参考:部门对象示例 参数说明 请参考:部门对象属性说明 如果录入错误或者为空时,返回JSON格式部门信息的为空. 1.2.24. 更新部门管理角色[主管,领导,管理员,公文收发员](Since:V6.0)推荐使用新接口按照编码更新部门管理角色[主管,领导,管理员,公文收发员](Since:V7.1)) 修改部门管理角色信息。 接口调用请求说明:
返回说明 正常情况下,会返回的是JSON格式部门信息,JSON数据包参考:部门对象示例 参数说明 请参考:部门对象属性说明 如果录入错误或者为空时,返回JSON格式部门信息的为空. 1.2.25. 按照编码更新部门管理角色[主管,领导,管理员,公文收发员](Since:V7.1)根据编码修改部门管理角色信息。 接口调用请求说明: http请求方式:PUT
http://ip:port/seeyon/rest/orgDepartment/role
修改部门角色信息参数:
Map data = new HashMap();
data.put('accountCode', 'u1'); // 单位编码
data.put('departmentCode', 'd1');// 部门编码
Map m1 = new HashMap();// 角色人员信息
m1.put('DepManager', '10010001,20013001');// 部门主管编码
m1.put('DepLeader', 'zhangsan,lisi');// 部门领导编码
data.put('roleMember', m1);
client.put('orgDepartment/role', data, String.class);// 发送请求 返回说明 正常情况下,返回JSON格式部门信息,JSON数据包详情请参考:部门对象示例 参数说明 请参考:部门对象属性说明 返回成功示例:
返回失败示例: {
'code' : 1001,// 不同错误返回不同的错误状态码
'data' : 'accountCode',
'message' : '单位编码不能为空!'
} 1.2.26. 按照部门编码获取部门主管、分管领导、部门管理员、部门公文收发员(Since:V6.0)开发者可以通过【部门编码】来获取指定部门下部门主管、分管领导、部门管理员、部门公文收发员。 接口调用请求说明:
返回说明 正常情况下,会返回的是JSON格式部门信息,JSON数据包参考:部门对象示例 参数说明 请参考:部门对象属性说明 如果录入的部门编码错误或者为空时,返回JSON格式部门信息的为空. 1.3. 岗位管理岗位管理服务支持获取,创建,修改,删除岗位数据。 1.3.1. 岗位对象示例{
'orgAccountId' : -6611845740562398180,【必填】
'id' : 3975462922290545021,
'name' : '测试岗位',【必填】
'code' : '2',
'createTime' : 1476065603000,
'updateTime' : 1476065603000,
'sortId' : 2,
'isDeleted' : false,
'enabled' : true,
'status' : 1,
'description' : '',
'typeId' : 1,
'valid' : true,
'entityType' : 'Post'
} 1.3.2. 岗位对象属性说明
1.3.3. 岗位创建更新返回对象示例岗位创建/更新成功返回对象示例
岗位创建/更新失败返回对象示例 {
'successMsgs': [ ],
'errorMsgs': [
{
'code': 'POST_REPEAT_NAME',
'ent': {
'orgAccountId': 967547186016371000,
'id': -4595331224678873600,
'name': '岗位名称',
'code': '',
'createTime': 1398235224015,
'updateTime': 1398235224015,
'sortId': 1,
'isDeleted': false,
'enabled': true,
'status': 1,
'description': '描述',
'typeId': -1,
'valid': true,
'entityType': 'Post'
}
}
],
'success': false
} 1.3.4. 按岗位Id取岗位信息开发者可以通过【岗位ID】来获取岗位信息。 接口调用请求说明
返回说明 正常情况下,会返回的是JSON格式岗位信息,JSON数据包参考:岗位对象示例 参数说明 请参考:岗位对象属性说明 如果录入的部门ID错误或者为空时,返回JSON格式岗位信息的为空. 1.3.5. 获取指定单位的所有岗位(不包含停用)开发者可以通过【单位ID】来获取当前单位下的所有岗位信息(不包含停用岗位)。 接口调用请求说明 http请求方式:GET
http://ip:port/seeyon/rest/orgPosts/{accountId}
返回说明 正常情况下,会返回的是JSON格式岗位信息,JSON数据包参考:岗位对象示例 参数说明 请参考:岗位对象属性说明 如果录入的部门ID错误或者为空时,返回JSON格式岗位信息的为空. 1.3.6. 获取指定单位的所有岗位数量(不包含停用)开发者可以通过【单位ID】来获取岗位的数量(不包含停用岗位)。 接口调用请求说明
返回说明 正常情况下,会返回的是Integer类型的数值。 如果录入的单位ID错误或者为空时,返回信息为空。 1.3.7. 获取指定单位的所有岗位(包含停用)开发者可以通过【单位ID】来获取当前单位下的所有岗位信息(包含停用岗位)。 接口调用请求说明 http请求方式:GET
http://ip:port/seeyon/rest/orgPosts/all/{accountId}
返回说明 正常情况下,会返回的是JSON格式岗位信息,JSON数据包参考:岗位对象示例 参数说明 请参考:岗位对象属性说明 如果录入的部门ID错误或者为空时,返回JSON格式岗位信息的为空. 1.3.8. 获取指定单位的所有岗位数量(包含停用)开发者可以通过【单位ID】来获取岗位的数量(包含停用岗位)。 接口调用请求说明
返回说明 正常情况下,会返回的是Integer类型的数值。 如果录入的单位ID错误或者为空时,返回信息为空。 1.3.9. 创建岗位开发者可以将岗位相关参数组装为JSON类型,来创建岗位信息。 接口请求说明 http请求方式:POST
http://ip:port/seeyon/rest/orgPost 创建数据示例:
组装新建岗位JSON数据,请参照:岗位对象示例只需要将示例对象中标明为【必填】参数组装即可。 新建岗位JSON数据参数的具体字段含义请参见岗位对象属性说明 返回说明 正常情况下,创建成功会返回成功的标识以及JSON格式岗位信息,JSON数据信息请参考:岗位创建更新返回对象示例 如果岗位创建失败,同样会返回失败的标识,并且在【'errorMsgs'】参数中给出创建失败的原因以及JSON格式岗位信息。 1.3.10. 批量创建岗位(Since:V61)将需要创建的多个岗位Map放入List中批量创建岗位信息。 接口请求说明
创建数据示例: List postList=new ArrayList();
Map newPost = new HashMap() {
{
put('orgAccountId', '5269865115340261356'); //单位ID
put('name','addrestPost1'); //岗位名称
put('code','rest1'); //编码
put('description','xxxxxxd'); //描述
put('levelId','1'); //岗位类别ID
}
};
Map newPost2 = new HashMap() {
...
}
postList.add(newPost);
postList.add(newPost2);
client.post('orgPost/addPosts' ,res, String.class); 返回说明 创建岗位成功则返回JSON格式岗位信息。 1.3.11. 按岗位Id修改岗位信息开发者可以通过岗位ID修改对应的岗位信息。 接口请求说明
创建数据示例: 组装修改岗位JSON数据的参数只需要岗位的ID以及需要修改参数信息即可,示例如下: {
'Id': 需修改的岗位ID, 【必填】
'description': 要修改的参数, 【必填】
} 返回说明 正常情况下,成功会返回成功的标识以及JSON格式岗位信息,JSON数据信息请参考:岗位创建更新返回对象示例 如果岗位创建失败,同样会返回失败的标识,并且在【'errorMsgs'】参数中给出创建失败的原因以及JSON格式岗位信息. 1.3.12. 按岗位Id批量修改岗位信息(Since:V61)将需要修改的多个岗位Map放入List中批量修改岗位信息。 接口请求说明
创建数据示例: List postList=new ArrayList();
Map postmody = new HashMap();
postmody.put('id','1727044139605774299');
postmody.put('description','REST修改');
postList.add(postmody);
client.post('/orgPost/updatePosts' ,postList, String.class); 返回说明 修改岗位成功则返回JSON格式岗位信息。 1.3.13. 按岗位Id删除岗位信息开发者可以通过岗位ID删除对应的岗位信息。 接口请求说明
返回说明 因为删除目前接口采用异步模式,暂无返回值信息。 1.3.14. 按岗位Id启用/禁用岗位开发者可以通过岗位ID以及enabled字段信息来启用禁用对应的岗位信息。 接口请求说明 http请求方式:PUT
http://ip:port/seeyon/rest/orgPost/{id}/enabled/{enabled}
创建数据示例: 组装修改岗位启用/禁用JSON数据的参数只需要岗位的ID以及enabled参数信息即可,示例如下:
返回说明 正常情况下,成功会返回成功的标识以及JSON格式岗位信息,JSON数据信息请参考:岗位创建更新返回对象示例 如果岗位创建失败,同样会返回失败的标识,并且在【'errorMsgs'】参数中给出创建失败的原因以及JSON格式岗位信息. 1.3.15. 按岗位编码停用/启用岗位(Since:V6.0)开发者可以通过岗位编码以及enabled字段信息来启用禁用对应的岗位信息。 接口请求说明 http请求方式:PUT
http://ip:port/seyon/rest/orgPost/code/{code}/enabled/{enabled}
返回说明 正常情况下,成功会返回成功的标识以及JSON格式岗位信息,JSON数据信息请参考:岗位创建更新返回对象示例 如果岗位创建失败,同样会返回失败的标识,并且在【'errorMsgs'】参数中给出创建失败的原因以及JSON格式岗位信息. 1.3.16. 按岗位编码删除岗位开发者可以通过岗位ID删除对应的岗位信息。 接口请求说明
返回说明 因为删除目前接口采用异步模式,暂无返回值信息。 1.3.17. 按岗位编码修改岗位开发者可以通过岗位编码修改对应的岗位信息。 接口请求说明 http请求方式:PUT
http://ip:port/seeyon/rest/orgPost 创建数据示例: 组装修改岗位JSON数据的参数只需要岗位的编码以及需要修改参数信息即可,示例如下:
返回说明 正常情况下,成功会返回成功的标识以及JSON格式岗位信息,JSON数据信息请参考:岗位创建更新返回对象示例 如果岗位创建失败,同样会返回失败的标识,并且在【'errorMsgs'】参数中给出创建失败的原因以及JSON格式岗位信息. 1.4. 职务管理职务管理服务支持获取,创建,修改,删除职务数据。 1.4.1. 职务对象职务对象示例{
'orgAccountId': 967547186016371000, 【必填】
'name': '职务', 【必填】
'code': '', 【必填】
'description': '', 【必填】
'levelId': 1, 【必填】
'sortId': 0, 【必填】
'id': 6294808909395413000,【非必填】
'createTime': 1394418219000, 【非必填】
'updateTime': 1394418219000, 【非必填】
'isDeleted': false, 【非必填】
'enabled': true, 【非必填】
'status': 1, 【非必填】
'groupLevelId': -3648300496484547000, 【非必填】
'valid': true, 【非必填】
'entityType': 'Level'【非必填】
} 职务对象属性说明
职务创建更新返回对象示例岗位创建/更新成功返回对象示例
岗位创建/更新失败返回对象示例 {
'successMsgs': [ ],
'errorMsgs': [
{
'code': 'POST_REPEAT_NAME',
'ent': {
'orgAccountId': 967547186016371000,
'id': -8210141186763832000,
'name': '职务',
'code': '',
'createTime': 1398325590589,
'updateTime': 1398325590589,
'sortId': 1,
'isDeleted': false,
'enabled': true,
'status': 1,
'description': 'xxxxx',
'levelId': 1,
'groupLevelId': null,
'valid': true,
'entityType': 'Level'
}
}
],
'success': false
} 1.4.2. 按职务级别Id取职务级别信息开发者可以通过【职务ID】来获取职务信息。 接口调用请求说明
返回说明 正常情况下,会返回的是JSON格式职务信息,JSON数据包参考:职务对象示例 参数说明 请参考:职务对象属性说明 如果录入的职务ID错误或者为空时,返回JSON格式职务信息的为空. 1.4.3. 获取指定单位的所有职务级别(不包含停用)开发者可以通过【单位ID】来获取单位下所有职务信息(不包含停用职务)。 接口调用请求说明 http请求方式:GET
http://ip:port/seeyon/rest/orgLevels/{accountId}
返回说明 正常情况下,会返回的是JSON格式职务信息,JSON数据包参考:职务对象示例 参数说明 请参考:职务对象属性说明 如果录入的职务ID错误或者为空时,返回JSON格式职务信息的为空. 1.4.4. 获取指定单位的所有职务级别(包含停用)开发者可以通过【单位ID】来获取单位下所有职务信息(包含停用职务)。 接口调用请求说明
返回说明 正常情况下,会返回的是JSON格式职务信息,JSON数据包参考:职务对象示例 参数说明 请参考:职务对象属性说明 如果录入的职务ID错误或者为空时,返回JSON格式职务信息的为空. 1.4.5. 创建职务级别开发者可以将职务相关参数组装为JSON类型,来创建岗位信息。 接口请求说明 http请求方式:POST
http://ip:port/seeyon/rest/orgLevel
创建数据示例: 组装新建职务JSON数据,请参照:职务对象示例只需要将示例对象中标明为【必填】参数组装即可。 新建职务JSON数据参数的具体字段含义请参见:职务对象属性说明 返回说明 正常情况下,成功会返回成功的标识以及JSON格式职务信息,JSON数据信息请参考:职务创建更新返回对象示例 如果职务创建失败,同样会返回失败的标识,并且在【'errorMsgs'】参数中给出创建失败的原因以及JSON格式职务信息. 1.4.6. 按职务级别Id修改职务级别信息开发者可以通过职务ID修改对应的职务信息。 接口请求说明
创建数据示例: 组装修改职务JSON数据的参数只需要职务的ID以及需要修改职务参数信息即可,示例如下: {
'Id': 需修改的职务ID, 【必填】
'description': 要修改职务参数, 【必填】
} 返回说明 正常情况下,成功会返回成功的标识以及JSON格式职务信息,JSON数据信息请参考:职务创建更新返回对象示例 如果职务创建失败,同样会返回失败的标识,并且在【'errorMsgs'】参数中给出创建失败的原因以及JSON格式职务信息. 1.4.7. 按职务级别Id删除职务级别开发者可以通过职务ID删除对应的职务信息。 接口请求说明
返回说明 因为删除目前接口采用异步模式,暂无返回值信息。 1.4.8. 按职务级别Id启用/禁用职务级别开发者可以通过职务ID以及enabled字段信息来启用禁用对应的职务信息。 接口请求说明: http请求方式:PUT
http://ip:port/seeyon/rest/orgLevel/{id}/enabled/{enabled}
创建数据示例: 组装修改职务启用/禁用JSON数据的参数只需要职务的ID以及enabled参数信息即可,示例如下:
返回说明 正常情况下,成功会返回成功的标识以及JSON格式职务信息,JSON数据信息请参考:职务创建更新返回对象示例 如果职务创建失败,同样会返回失败的标识,并且在【'errorMsgs'】参数中给出创建失败的原因以及JSON格式职务信息. 1.4.9. 按职务级别编码启用/禁用职务级别开发者可以通过职务比那么以及enabled字段信息来启用禁用对应的职务信息。 接口请求说明: http请求方式:PUT
http://ip:port/seeyon/rest/orgLevel/code/{code}/enabled/{enabled}
返回说明 正常情况下,成功会返回成功的标识以及JSON格式职务信息,JSON数据信息请参考:职务创建更新返回对象示例 如果职务创建失败,同样会返回失败的标识,并且在【'errorMsgs'】参数中给出创建失败的原因以及JSON格式职务信息. 1.4.10. 按职务级别编码删除职务开发者可以通过职务编码删除对应的职务信息。 接口请求说明:
返回说明 因为删除目前接口采用异步模式,暂无返回值信息。 1.4.11. 按职务编码修改职务开发者可以通过职务编码修改对应的职务信息。 接口请求说明: http请求方式:PUT
http://ip:port/seeyon/rest/orgLevel 创建数据示例: 组装修改职务JSON数据的参数只需要职务的ID以及需要修改职务参数信息即可,示例如下:
返回说明 正常情况下,成功会返回成功的标识以及JSON格式职务信息,JSON数据信息请参考:职务创建更新返回对象示例 如果职务创建失败,同样会返回失败的标识,并且在【'errorMsgs'】参数中给出创建失败的原因以及JSON格式职务信息. 1.5. 单位管理单位管理服务支持获取,修改,删除单位信息。 1.5.1. 单位对象单位对象示例{
'orgAccountId': 1340327733561737700,
'id': 1340327733561737700,
'name': '单位名称', 【必填】
'code': '1', 【必填】
'sortId': 2, 【必填】
'shortName': '单位', 【必填】
'createTime': 1381371586000,
'updateTime': 1381371586000,
'isDeleted': false,
'enabled': true,
'status': 1,
'description': '',
'path': '00000001',
'secondName': '',
'isInternal': true,
'isGroup': false,
'levelScope': -1,
'type': 'Account',
'properties': {
'unitCategory': null,
'fax': '',
'unitMail': '',
'accessLevels': null,
'customLoginUrl': null,
'ldapOu': '',
'address': '',
'chiefLeader': '',
'zipCode': '',
'telephone': '',
'permissionType': 0,
'isCustomLoginUrl': null,
'ipAddress': ''
},
'superior': -1730833917365171700,
'superiorName': '',
'sortIdType': '1',
'isCanAccess': true,
'accessIds': [ ],
'accessScopeLevels': [ ],
'childrenAccounts': [ ],
'entityType': 'Account',
'valid': true,
'group': false,
'customLogin': false,
'parentPath': '0000',
'customLoginUrl': null
} 单位对象属性说明
1.5.2. 按单位名称取单位信息开发者可以通过【单位名称】来获取单位信息 接口请求说明:
注意: 因为单位名称是汉字所以,需要汉字做UTF-8 encode中文编码,示例如下: String name = URLEncoder.encode('单位名称', 'UTF-8');
返回说明 正常情况下,会返回的是JSON格式单位信息,JSON数据包参考:单位对象示例 参数说明 请参考:单位对象属性说明 如果录入的单位名称错误或者为空时,返回JSON格式单位信息的为空. 1.5.3. 按单位Id取单位的信息开发者可以通过【单位ID】来获取单位信息 接口请求说明:
返回说明 正常情况下,会返回的是JSON格式单位信息,JSON数据包参考:单位对象示例 参数说明 请参考:单位对象属性说明 如果录入的单位名称错误或者为空时,返回JSON格式单位信息的为空. 1.5.4. 取指定单位的管理员通过单位Id取得单位的管理员(人员)信息 接口请求说明: http请求方式:GET
http://ip:port/seeyon/rest/orgAccount/administrator/{id}
例如
http://127.0.0.1/seeyon/rest/orgAccount/administrator/2700994180139011164
返回说明 正常情况下,会返回的是JSON格式单位信息,JSON数据包参考:单位对象示例 参数说明 请参考:单位对象属性说明 如果录入的单位ID错误或者为空时,返回null,否则返回单位管理员的人员信息。 1.5.5. 新增单位(Since:V5.6 )【V6.0 增加单位管理员】创建单位信息。【注意:此接口只能集团版使用.】 接口请求说明:
增加单位管理员后,创建单位格式:
Map newDep = new HashMap() {
{
put('name', 'addAccount6'); //单位名称
put('code', '16'); //编码
put('description', 'xxxxxxd'); //描述
put('shortName', 'test6'); //简称
put('sortId', '8'); //排序ID
put('Superior', '-1730833917365171641'); //上级ID
}
};
//管理员信息
List reslist=new ArrayList();
Map resfg=new HashMap();
resfg.put('loginName', 'add6');//管理员登录名
resfg.put('password', '111111');//管理员密码
reslist.add(resfg);
newDep.put('admin', reslist); 返回说明 正常情况下,会返回的是JSON格式单位信息,JSON数据包参考:单位对象示例 参数说明 请参考:单位对象属性说明 如果录入的单位ID错误或者为空时,返回null. 1.5.6. 取所有单位信息开发者获取所有单位信息。 接口请求说明:
返回说明 正常情况下,会返回的是JSON格式单位信息,JSON数据包参考:单位对象示例 参数说明 请参考:单位对象属性说明 1.5.7. 按单位Id删除单位开发者可以通过单位ID删除对应的单位信息。 接口请求说明: http请求方式:DELETE
http://ip:port/seeyon/rest/orgAccount/{id}
返回说明 因为删除目前接口采用异步模式,暂无返回值信息。 1.5.8. 按单位Id修改单位信息【V6.0 增加修改单位LDAP目录设置】开发者可以通过单位ID修改对应的单位信息。 接口请求说明:
创建数据示例: 组装修改单位JSON数据的参数只需要单位的ID以及需要修改单位参数信息即可,示例如下: {
'Id': 需修改的单位ID, 【必填】
'description': 要修改单位参数, 【必填】
}
V5.6-V6.0 增加修改单位LDAP目录设置
Map res = new HashMap();
HashMap properties=new HashMap();
properties.put('ldapOu', 'dc=seeyon,dc=com');
res.put('properties',properties); 返回说明 正常情况下,会返回的是JSON格式单位信息,JSON数据包参考:单位对象示例 参数说明 请参考:单位对象属性说明 单位ID不存在,那么返回信息为空。 更新失败,同样会返回失败的标识,并且在【'errorMsgs'】参数中给出创建失败的原因以及JSON格式信息. 1.5.9. 获取指定单位下级单位(Since:V5.6)开发者可以通过指定单位ID来获取下级单位列表. 接口请求说明:
返回说明 正常情况下,会返回的是JSON格式单位信息,JSON数据包参考:单位对象示例 参数说明 请参考:单位对象属性说明 如果录入的单位ID错误或者为空时,返回null 1.5.10. 获取指定单位上级单位(Since:V5.6)开发者可以通过指定单位ID来获取上级单位列表. 接口请求说明: http请求方式:GET
http://ip:port/seeyon/rest/orgAccounts/parent/{id}
返回说明 正常情况下,会返回的是JSON格式单位信息,JSON数据包参考:单位对象示例 参数说明 请参考:单位对象属性说明 如果录入的单位ID错误或者为空时,返回null 1.5.11. 按单位编码修改单位信息(Since:V6.0)开发者可以通过单位编码修改对应的单位信息。 接口请求说明:
创建数据示例: 组装修改单位JSON数据的参数只需要单位的编码以及需要修改单位参数信息即可,示例如下: field字段指定根据code来匹配单位,根据条件得到多个结果则会报错。
{
'Id': {'field':'code'}, 【必填】
'code':要修改的单位编码,【必填】
'description': 要修改单位参数, 【必填】
} 返回说明 正常情况下,会返回的是JSON格式单位信息,JSON数据包参考:单位对象示例 参数说明 请参考:单位对象属性说明 1.5.12. 按单位编码获取单位信息开发者可以通过【单位Code】来获取单位信息。 接口请求说明:
返回说明 正常情况下,会返回的是JSON格式单位信息,JSON数据包参考:单位对象示例 参数说明 请参考:单位对象属性说明 1.6. 人员管理人员的创建、修改、删除和查找接口。 1.6.1. 人员对象人员对象示例{
'id': 710000480641633900,
'name': 's1', 【必填】
'code': '001',
'createTime':1398216937707,
'updateTime': 1398160905847,
'sortId': 1,
'isDeleted': false,
'enabled': true,
'status': 1,
'description': '说明',
'orgAccountId': -2332227039700957700, 【必填】
'orgLevelId': 3176188816548514000, 【必填】
'orgPostId': -2779802668474544000, 【必填】
'orgDepartmentId': 8422701464295851000, 【必填】
'isInternal': true,
'isLoginable': true,
'isAssigned': true,
'isAdmin': false,
'isValid': true,
'state': 1,
'second_post': [{'memberId':710000480641633932,'depId':8422701464295850729,'postId':-6172367662268331356}],
'concurrent_post': [ ],
'telNumber': '13366666666',
'birthday': 1398096000000,
'officeNum': '010-88888888',
'emailAddress': 'seeyon@',
'gender': 1,
'loginName': 's1',
'location': '工作地',
'reporter': '汇报人',
'hiredate': '入职时间
} 人员对象属性说明
1.6.2. 按登录名取人员信息按照登录名获取人员信息。 接口请求说明:
参数说明:
返回说明 正常情况下,会返回的是JSON格式人员信息,JSON数据包参考:人员对象示例 参数说明 请参考:人员对象属性说明 1.6.3. 按Id取人员信息按照人员的Id获取人员信息 接口请求说明: http请求方式:GET
http://ip:port/seeyon/rest/orgMember/{memberId}
如
http://127.0.0.1/seeyon/rest/orgMember/710000480641633932 参数说明:
返回说明 正常情况下,会返回的是JSON格式人员信息,JSON数据包参考:人员对象示例 参数说明 请参考:人员对象属性说明 1.6.4. 按编码取人员信息按照人员的code获取人员信息 接口请求说明:
参数说明:
返回说明 正常情况下,会返回的是JSON格式人员信息,JSON数据包参考:人员对象示例 参数说明 请参考:人员对象属性说明 1.6.5. 按手机号码取人员信息按照人员的手机号码获取人员信息 接口请求说明: http请求方式:GET
http://ip:port/seeyon/rest/orgMember/telephone/{telephoneNumber}
如
127.0.0.1/seeyon/rest/orgMember/telephone/13366666666 参数说明:
返回说明 正常情况下,会返回的是JSON格式人员信息,JSON数据包参考:人员对象示例 参数说明 请参考:人员对象属性说明 1.6.6. 取得指定单位的所有人员(不包含停用人员)取得指定单位的所有人员(不包含停用人员) 接口请求说明:
参数说明:
返回说明 返回JSON格式的人员对象数组。 [
{
'orgAccountId': -2332227039700957700,
'id': 710000480641633900,
'name': 's1',
'loginName': 's1'
// ...
},
{
'orgAccountId': -2332227039700957700,
'id': -889216812767428100,
'name': 's2',
'loginName': 's2'
// ...
}
] 返回值说明 正常情况下,会返回的是JSON格式人员信息,JSON数据包参考:人员对象示例 参数说明 请参考:人员对象属性说明 1.6.7. 取得指定单位的所有人员(包含停用人员)取得指定单位的所有人员(包含停用人员) 接口请求说明:
参数说明:
返回说明 正常情况下,会返回的是JSON格式人员信息,JSON数据包参考:人员对象示例 参数说明 请参考:人员对象属性说明 1.6.8. 取得指定单位的所有人员总数(不包含停用人员)取得指定单位的所有人员总数(不包含停用人员) 接口请求说明: http请求方式:GET
http://ip:port/seeyon/rest/orgMembers/count/{accountId}
如
http://127.0.0.1/seeyon/rest/orgMembers/count/-2332227039700957764 参数说明:
返回说明 正常情况下,会返回的是JSON格式人员信息,JSON数据包参考:人员对象示例 参数说明 请参考:人员对象属性说明 1.6.9. 取得指定单位的所有人员总数(包含停用人员)取得指定单位的所有人员总数(包含停用人员) 接口请求说明:
参数说明:
返回说明 返回JSON整数。 1.6.10. 取得指定部门的所有人员取指定部门的所有人员,不包含停用人员。 接口请求说明: http请求方式:GET
http://ip:port/seeyon/rest/orgMembers/department/{departmentId}
如
http://127.0.0.1/seeyon/rest/orgMembers/department/8422701464295850729?firstLayer=false 参数说明:
返回说明 返回JSON格式的人员对象数组。
返回值说明 正常情况下,会返回的是JSON格式人员信息,JSON数据包参考:人员对象示例 参数说明 请参考:人员对象属性说明 1.6.11. 取得指定岗位的所有人员取指定岗位的所有人员,不包含停用人员。 接口请求说明: http请求方式:GET
http://ip:port/seeyon/rest/orgMembers/post/{postId}
如
http://127.0.0.1/seeyon/rest/orgMembers/post/-2779802668474544380 参数说明:
返回说明 返回JSON格式的人员对象数组。
返回值说明 正常情况下,会返回的是JSON格式人员信息,JSON数据包参考:人员对象示例 参数说明 请参考:人员对象属性说明 1.6.12. 取得指定职务级别的所有人员取指定职务级别的所有人员,不包含停用人员。 接口请求说明: http请求方式:GET
http://ip:port/seeyon/rest/orgMembers/level/{levelId}
如
http://127.0.0.1/seeyon/rest/orgMembers/level/3176188816548513663 参数说明:
返回说明 返回JSON格式的人员对象数组。
返回值说明 正常情况下,会返回的是JSON格式人员信息,JSON数据包参考:人员对象示例 参数说明 请参考:人员对象属性说明 1.6.13. 按姓名取人员信息按照人员的姓名查找人员。 接口请求说明: http请求方式:GET
http://ip:port/seeyon/rest/orgMembers/name/{name}
如
http://127.0.0.1/seeyon/rest/orgMembers/name/%E5%A7%93%E5%90%8D 参数说明:
返回说明 正常情况下,会返回的是JSON格式人员信息,JSON数据包参考:人员对象示例 参数说明 请参考:人员对象属性说明 1.6.14. 新建人员(V6.0增加了副岗信息)创建人员。 接口请求说明:
参数说明: 使用HTTP请求的Body传入JSON格式的人员信息 {
Map newMember = new HashMap() {
{
put('orgAccountId', '-4532703988283521957'); //单位ID
put('orgDepartmentId', '3034473275669826764');//部门ID
put('orgLevelId', '-4560829651911226401');//职务ID
put('orgPostId', '-1185154002310052488');//岗位ID
put('code', '26');//编号
put('name', '夏强6');//姓名
// put('sortId', 1);//排序号 V5.6最新版本后可以不用录入此参数
put('telNumber', '13551001572');//移动电话
put('officeNum', '');//办公电话
put('emailAddress', '');//电子邮件
put('gender', '1');//性别
put('telNumber', '13922600261');//电话
put('officeNum', null);//固话
put('password', '123456');//密码
put('loginName', 'rest6');//登录名
put('birthday', '-1497600000');//出生日期'birthday':567964800000
}
};
//副岗信息
List reslist=new ArrayList();
Map resfg=new HashMap();
//resfg.put('memberId', '-4584455978690592711');//需要设置 副岗人员ID
resfg.put('deptId', '3034473275669826764');//指定副岗所在部门ID(副岗范围是部门下已经存在人员所设置的主岗中来选择)
resfg.put('postId', '-8953437412957663435');//指定副岗ID
resfg.put('orgAccountId', '-4532703988283521957');//单位ID
reslist.add(resfg);
newMember.put('second_post', reslist);
} V7.1支持通过单位、部门、职务和岗位编码设置人员信息,包括副岗中的单位、部门、职务和岗位,且兼容之前通过id设置人员信息。使用编码设置人员信息示例如下:
返回说明 返回JSON格式。 success为true则创建成功 {
'successMsgs': [
{
'code': 'SUCCESS',
'ent': {
'orgAccountId': -2332227039700957700,
'id': 7998660249083069000,
'name': '新建人员',
'code': 'A002',
'createTime': 1398417138169,
'updateTime': 1398417138169,
'sortId': 20,
'isDeleted': false,
'enabled': false,
'status': 1,
'description': '描述',
'orgLevelId': 3176188816548514000,
'orgPostId': -2779802668474544000,
'orgDepartmentId': 8422701464295851000,
'type': 1,
'isInternal': true,
'isLoginable': true,
'isVirtual': false,
'isAssigned': true,
'isAdmin': false,
'isValid': false,
'state': 1,
'properties': {
'birthday': 1398096000000,
'postalcode': '',
'emailaddress': '',
'extPostLevel': '',
'website': '',
'address': '',
'officenumber': '',
'gender': '1',
'telnumber': '',
'blog': '',
'imageid': ''
},
'second_post': [ ],
'concurrent_post': [ ],
'valid': false,
'telNumber': null,
'birthday': 1398096000000,
'officeNum': null,
'emailAddress': null,
'gender': 1,
'loginName': 'newUser'
}
}
],
'errorMsgs': [ ],
'success': true
} 1.6.15. 批量新建人员(Since:V61)批量创建人员。 接口请求说明:
参数说明: 将批量新建人员(Since:V61))中人员Map放入List中即可。 List members=new ArrayList();
Map newMember = new HashMap() {
...
}
members.add(newMember);
client.post('orgMember/updateMembers',members,String.class); V7.1支持通过单位、部门、职务和岗位编码设置人员信息,详情请参考新建人员(V6.0增加了副岗信息))中的编码使用说明。 返回说明 创建人员成功则返回JSON格式人员信息。 1.6.16. 按Id修改人员信息【V6.0增加了副岗信息,以及修改人员LDAP目录设置】按人员Id修改人员信息 接口请求说明:
参数说明: 使用HTTP请求的Body传入JSON格式的人员信息 id必填,支持新建人员参数说明中所有参数,必须至少指定一项 {
'id': 7115200831996735909, //【必填】
'sortId': 20,
'orgAccountId': 144, //【必填】
'enabled': true
} 5.6版以后支持按编码修改人员信息,此处id的类型由Long改为对象,field字段指定根据code来匹配人员,根据条件得到多个结果则会报错。
V5.6后增加了副岗信息信息的修改,具体参数请参照创建人员中副岗信息。 V5.6-V6.0增加了人员LDAP目录设置 res.put('ldapbind', 'cn=paul.chen,ou=users,dc=seeyon,dc=com')
V7.1支持通过单位、部门、职务和岗位编码设置人员信息,详情请参考新建人员(V6.0增加了副岗信息))中的编码使用说明。 返回说明 返回JSON格式。 指定人员未存在返回null。 返回结果的说明参见新建人员。 1.6.17. 按Id批量修改人员信息(Since:V61)通过人员Id批量修改人员信息 接口请求说明:
参数说明: 将需要修改的多人Map放入List中即可。 人员id必填 List members=new ArrayList();
Map newMember1 = new HashMap() {
{
put('id','-8823594534827504520');
put('orgAccountId',144);
put('description', '批量修改');
}
};
Map newMember2 = new HashMap() {
...
}
members.add(newMember1);
members.add(newMember2);
client.post('orgMember/updateMembers',members,String.class); V7.1支持通过单位、部门、职务和岗位编码设置人员信息,详情请参考新建人员(V6.0增加了副岗信息))中的编码使用说明。 返回说明 更新人员成功则返回JSON格式人员信息。 1.6.18. 按Id启用/停用人员按人员Id修改人员启用和停用状态 接口请求说明:
参数说明:
返回说明 返回JSON格式。 指定人员未存在返回null。 返回结果的说明参见新建人员。 1.6.19. 按Id删除人员按人员Id删除人员 接口请求说明: http请求方式:DELETE
http://ip:port/seeyon/rest/orgMember/{memberId}
如
http://127.0.0.1/seeyon/rest/orgMember/-757960293000589356 参数说明:
返回说明 返回JSON格式。 指定人员未存在返回null。 返回结果的说明参见新建人员。 1.6.20. 验证人员有效性(Since:V5.6)开发者可以通过【人员登录名和密码】来验证当前人员有效性。 接口请求说明:
参数说明:
返回说明 返回true为有效,false为无效。 1.6.21. 获取当前部门及其下级部门人员总数开发者可以通过【部门ID】来获取指定部门下所有人员总数。 接口请求说明: http请求方式:GET
http://ip:port/seeyon/rest/orgMembers/department/count/{departmentId}?firstLayer=false/true; 参数说明:
返回说明 返回JSON整数。 1.6.22. 批量新增/更新人员信息开发者可以批量更新和新增人员。 接口请求说明:
参数说明: 新建与更新的人员参数同 请求多人信息可以存放在List中传递。 V7.1支持通过单位、部门、职务和岗位编码设置人员信息,详情请参考新建人员(V6.0增加了副岗信息))中的编码使用说明。 返回说明 正常情况下,会返回的是JSON格式人员信息,JSON数据包参考:人员对象示例 参数说明 请参考:人员对象属性说明 1.6.23. 批量删除人员开发者可以批量删除人员。 接口请求说明: http请求方式:PUT
http://ip:port/seeyon/rest/orgMembers/batchdelete 参数说明:
返回说明 返回JSON格式。 指定人员未存在返回null。 返回结果的说明参见新建人员。 1.6.24. 人员离职 (Since:V7.0)开发者可以处理离职人员。 接口请求说明: http请求方式:PUT
http://ip:port/seeyon/rest/orgMember/leave/{memberId}/{agentMemberId}
例如:
http://ip:port/seeyon/rest/orgMember/leave/12315646574656/7894561616687111 参数说明:
返回说明 返回JSON格式。 组织模型实体操作息类。 1.7. 外部单位服务管理外部单位服务管理(Since:V6.0)外部单位服务支持获取当前单位下所建立的外部单位信息。 1.7.1. 外部单位对象实例外部单位对象实例{
'orgAccountId' : 3781960798631511882,
'id' : -1970889903265267124,
'name' : '外部单位1',
'code' : '001',
'createTime' : 1441953236000,
'updateTime' : 1441953236000,
'sortId' : 1,
'isDeleted' : false,
'enabled' : true,
'status' : 1,
'description' : '',
'path' : '0000000100010001',
'shortName' : null,
'secondName' : null,
'isInternal' : false,
'isGroup' : false,
'levelScope' : -1,
'type' : 'Department',
'properties' : {
'unitCategory' : null,
'fax' : null,
'unitMail' : null,
'accessLevels' : null,
'customLoginUrl' : null,
'ldapOu' : null,
'address' : null,
'chiefLeader' : null,
'zipCode' : null,
'telephone' : null,
'permissionType' : null,
'isCustomLoginUrl' : null,
'ipAddress' : null
},
'superior' : -1770506021266306174,
'superiorName' : '',
'sortIdType' : '1',
'entityType' : 'Department',
'depManager' : null,
'depAdmin' : null,
'posts' : [ ],
'wholeName' : '部门1,外部单位1',
'valid' : true,
'group' : false,
'customLogin' : false,
'parentPath' : '000000010001',
'customLoginUrl' : null
} 对象属性说明
1.7.2. 按照单位ID获取外部单位列表可以通过【单位ID】来获取所属的外部单位信息。 接口请求说明:
参数说明:
返回说明 正常情况下,会返回的是JSON格式外部单位信息,JSON数据包参考:外部单位对象实例. 参数说明 请参考:对象属性说明 1.8. 外部人员服务管理外部人员服务管理(Since:V6.0)外部人员服务支持获取外部人员信息,以及增加和删除外部人员信息。 1.8.1. 外部人员对象外部人员对象实例{
'orgAccountId' : 3781960798631511882,
'id' : 5948516634567462597,
'name' : '外部人员名称',【必填】
'code' : 'wb1',
'createTime' : 1441953325000,
'updateTime' : 1441953325000,
'sortId' : 1,
'isDeleted' : false,
'enabled' : true,
'status' : 1,
'description' : '说明1',
'orgLevelId' : -1,
'orgPostId' : -1,
'orgDepartmentId' : -1970889903265267124,【必填】
'type' : 1,
'isInternal' : false,
'isLoginable' : true,
'isVirtual' : false,
'isAssigned' : true,
'isAdmin' : false,
'isValid' : true,
'state' : 1,
'properties' : {
'postalcode' : '',
'birthday' : 684518400000,
'website' : '',
'postAddress' : '',
'officenumber' : '028-85965587',
'eduBack' : 0,
'telnumber' : '135587745896',
'blog' : '',
'imageid' : '',
'politics' : 0,
'degree' : '',
'idnum' : '',
'weixin' : '',
'emailaddress' : 'wb@qq.com',
'address' : '',
'extPostLevel' : 'p:外部主岗,l:外部职务,',
'gender' : 1,
'weibo' : ''
},
'second_post' : [ ],
'concurrent_post' : [ ],
'address' : null,
'valid' : true,
'loginName' : 'wb1',
'entityType' : 'Member',
'emailAddress' : 'wb@qq.com',
'officeNum' : '028-85965587',
'postalcode' : null,
'telNumber' : '135587745896',
'birthday' : 684518400000,
'weibo' : null,
'weixin' : null,
'idNum' : null,
'degree' : null,
'postAddress' : null,
'gender' : 1,
'blog' : null,
'website' : null
} 对象属性说明
1.8.2. 按照外部单位ID获取,外单位所有人员可以通过【外部单位ID】来获取所属的外部单位下的外部人员。 接口请求说明:
参数说明:
返回说明 正常情况下,会返回的是JSON格式外部人员信息,JSON数据包参考:外部人员对象实例 参数说明 请参考:对象属性说明 1.8.3. 按照单位ID获取,当前单位下所有外部人员可以通过【单位ID】来获取所属的外部单位下的外部人员。 接口请求说明: http请求方式:GET
http://ip:port/seeyon/rest/externalMembers/accountId/{accountId} 参数说明:
返回说明 正常情况下,会返回的是JSON格式外部人员信息,JSON数据包参考:外部人员对象实例 参数说明 请参考:对象属性说明 1.8.4. 按照外部人员登录名获取人员信息可以通过【外部人员登录名】来获取所属的外部人员信息。 接口请求说明:
参数说明:
返回说明 正常情况下,会返回的是JSON格式外部人员信息,JSON数据包参考:外部人员对象实例 参数说明 请参考:对象属性说明 1.8.5. 按照外部人员ID获取人员信息可以通过【外部人员ID】来获取所属的外部人员信息 接口请求说明: http请求方式:GET
http://ip:port/seeyon/rest/externalMembers/externalMemberId/{externalMemberId}?accountId={accountId} 参数说明:
返回说明 正常情况下,会返回的是JSON格式外部人员信息,JSON数据包参考:外部人员对象实例 参数说明 请参考:对象属性说明 1.8.6. 新增外部人员创建外部人员信息。 接口请求说明:
Map newMember = new HashMap() {
{
put('orgAccountId', '3781960798631511882'); //单位ID---
put('extAccountName', '外部单位1,'); //单位名称---
put('orgDepartmentId', '-1970889903265267124');//部门ID--
put('extWorkScopeValue', 'Department|-1770506021266306174');//--工作范围对应部门
put('extRoles', '外部人员权限');//权限 --
put('extRoleIds', '4649394686314365441');//权限ID
put('extWorkScope', '部门1,');//--工作范围对应部门
put('code', '568');//编号--
put('name', 'cs55');//姓名--
put('sortId', 4);//排序号 --
put('isInternal', false);//
put('isChangePWD', true);//
put('isLoginNameModifyed', false);//
put('isNewLdap', false);//
put('isNewMember', false);//
put('loginName', 'exo55');//--
put('password', '123456');//--
put('password2', '123456');//--
put('primaryLanguange', 'zh_CN');//--
put('enabled', true);//--=
put('orgPostId', -1);//
put('orgLevelId', -1);//
put('telnumber', '13551001572');//移动电话--
put('officenumber', '1111111111');//办公电话--
put('emailaddress', 'xxx@sohu.com');//电子邮件--
put('extgender', '1');//性别--
put('extAccountName', '-1970889903265267124');//所在外单位--
put('birthday', '2015-09-01');//出生日期'birthday':567964800000
put('extbirthday', '-1497600000');//出生日期'birthday':567964800000
put('extdescription', 'cccccccc');//extdescription
}
};
newMember.put('extlevelName', '外部职务');//职务ID--
newMember.put('extprimaryPost', '外部岗位');//岗位ID-- 返回说明 成功,返回的是新创建人员的ID。 失败,返回空。 1.8.7. 通过ID删除外部人员可以通过【外部人员ID】来删除的外部人员信息。 接口请求说明:
参数说明:
返回说明 正常情况下,删除成功返回true,失败返回FALSE。 1.9. 兼职服务管理兼职服务管理(Since:V5.6 -V6.0)兼职服务管理支持对于单位兼职信息的查询与新建等操作。 1.9.1. 兼职服务对象兼职对象实例{
'id': '-4657363023839605508',
'concurrentRel': {
'key': 'Member_Post',
'id': '-4657363023839605508', //兼职ID
'orgAccountId': '-1956420195551131697', //单位ID
'sortId': '1', //排序
'createTime': '2016-03-16 09:47',
'updateTime': '2016-03-16 09:47',
'sourceId': '-2833598432627637498', //
'objective6Id': '1',
'objective0Id': '-7058041343460749784', //部门ID
'objective1Id': '-7680462456906494208', //岗位ID
'objective5Id': 'Concurrent',
'objective2Id': '2572864152117856133', //职务ID
'objective3Id': null,
'objective4Id': null,
'objective7Id': '-2674129842350898190,'//权限ID
},
'conMemberName': '李世民(V56SP1)',
'souAccountName': 'V56SP1',
'souPAnames': '程序员(V56SP1)',
'conPostCode': '1',
'tarAccountName': 'addAccount2',
'tarDPAnames': 'add2-管理部-add2-行政岗位ie',
'conSortId': '1'
} 对象属性说明
1.9.2. 获取兼职列表获取兼职列表信息(以翻页模式返回) 接口请求说明:
参数说明:
返回说明 正常情况下,会返回的是JSON格式兼职信息,JSON数据包参考:兼职对象实例 参数说明 请参考:对象属性说明 1.9.3. 通过code获取对外单位兼职信息**通过CODE 获取对外单位兼职信息 接口请求说明: http请求方式:GET
http://ip:port/seeyon/rest/orgPartTimeJob/foreignlist?condition=type%3D\'input\',condition%3D\'cCode\',value%3D\'(code)\'&accountid={accountid} 参数说明:
返回说明 正常情况下,会返回的是JSON格式兼职信息,JSON数据包参考:兼职对象实例 参数说明 请参考:对象属性说明 #1.9.4. 通过code获取对内单位兼职信息通过CODE 获取对本单位兼职信息 接口请求说明:
参数说明:
返回说明 正常情况下,会返回的是JSON格式兼职信息,JSON数据包参考:兼职对象实例 参数说明 请参考:对象属性说明 1.10. #1.10.1. 通过ID获取兼职信息通过ID 获取兼职信息 接口请求说明: http请求方式:GET
http://ip:port/seeyon/rest/orgPartTimeJob/{id} 参数说明:
返回说明 正常情况下,会返回的是JSON格式兼职信息,JSON数据包参考:兼职对象实例 参数说明 请参考:对象属性说明 1.10.2. 新增兼职新建兼职信息 接口请求说明:
新增所需参数:: res.put('id', '-1');//
res.put('cMemberId', '-5904186531465311839');//r人员ID
res.put('cAccountId', '-1956420195551131697');//兼职单位ID
res.put('cDeptId', '-7058041343460749784');//兼职部门ID
res.put('cPostId', '-7680462456906494208');//兼职岗位ID
res.put('cLevelId', '2572864152117856133');//兼职职务ID
res.put('cRoleIds', '-2674129842350898190');//兼职权限ID
res.put('cMember', '2015(56sp1)');//人名(原单位简称)
res.put('sortId', '');
res.put('code', '4');
res.put('primaryPost', '技术(56sp1)');//原岗位名称(原单位简称)
res.put('cAccount', 'addAccount2');//兼职单位名称
res.put('cDept', 'add2-管理部(test2)');//兼职单位部门名称(兼职单位简称)
res.put('cPost', 'add2-行政岗位ie(test2)');//兼职单位部门名称(兼职单位简称)
res.put('cLevel', 'dd2-经理职务');//兼职单位职务名称
res.put('cRoles', '普通人员权限');//兼职单位权限名称 返回说明 正常情况下,会返回的是JSON格式兼职信息,JSON数据包参考:兼职对象实例 参数说明 请参考:对象属性说明 1.10.3. 按照兼职ID删除兼职按照兼职ID删除兼职 接口请求说明:
参数说明:
返回说明 正常情况下,会返回的是JSON格式兼职信息,JSON数据包参考:兼职对象实例 参数说明 请参考:对象属性说明 1.10.4. 修改兼职信息修改兼职信息 接口请求说明: http请求方式:PUT
http://ip:port/seeyon/rest/orgPartTimeJob 修改相关参数:
返回说明 正常情况下,会返回的是JSON格式兼职信息,JSON数据包参考:兼职对象实例 参数说明 请参考:对象属性说明 1.11. 权限服务管理权限服务管理支持对于权限信息的查询等操作。 1.11.1. 权限对象权限对象实例{
'type': 2,
'valid': true,
'entityType': 'Role',
'category': '1',
'showName': '普通人员权限',
'bond': 1,
'isBenchmark': true,
'name': 'GeneralStaff',
'id': '1438771049297169890',
'description': '',
'status': 1,
'code': 'GeneralStaff',
'isDeleted': false,
'orgAccountId': '-4532703988283521957',
'enabled': true,
'sortId': '1',
'createTime': '2015-12-24 16:53',
'updateTime': '2013-03-20 00:00'
} 对象属性说明
1.11.2. 根据单位ID获取权限列表根据单位ID获取权限列表 接口请求说明:
参数说明:
返回说明 正常情况下,会返回的是JSON格式权限信息,JSON数据包参考:权限对象实例 参数说明 请参考:对象属性说明 1.11.3. 添加部门角色(Since:V61)以集团管理员是身份添加部门角色. 接口请求说明 http请求方式:POST
http://ip:port/seeyon/rest/role/addDepartMentRole 创建数据示例:
返回说明 创建角色成功则返回角色ID。 1.11.4. 获取部门下的所有部门角色(Since:V61)根据部门id,获取部门下的所有部门角色 接口请求说明 http请求方式:GET
http://ip:port/seeyon/rest/role/departmentRole/{departmentId} 参数说明:
返回说明 请求成功,返回部门下对应角色JSON信息。 1.11.5. 获取部门下对应的角色人员(Since:V61)根据部门id 和角色id 获取部门下对应的角色人员. 接口请求说明
参数说明:
返回说明 请求成功,返回部门下对应角色人员的JSON信息。 1.11.6. 更新部门下对应的角色人员(Since:V61)根据部门id 和角色id 更新部门下对应的角色人员. 接口请求说明 http请求方式:POST
http://ip:port/seeyon/rest/role/updateDepartmentRoleMember 创建数据示例:
返回说明 跟新角色人员成功则返回成功提示。 |
|