本接口用來(lái)獲取組織模型基本信息
組織模型服務(wù)支持獲取人員,崗位,職務(wù),部門,單位等數(shù)據(jù)。
新增修改部門、崗位、職務(wù)級(jí)別和人員時(shí)的返回值。
成功示例:創(chuàng)建人員
{
'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
}
失敗示例:創(chuàng)建崗位:
{
'successMsgs': [ ],
'errorMsgs': [
{
'code': 'POST_REPEAT_NAME',
'ent': {
'orgAccountId': -2332227039700957700,
'id': -1173263073011414000,
'name': 'P14',
'code': '',
'createTime': 1399194501350,
'updateTime': 1399194501350,
'sortId': 0,
'isDeleted': false,
'enabled': true,
'status': 1,
'description': '',
'typeId': -1,
'entityType': 'Post',
'valid': true
}
}
],
'success': false
}
參數(shù) | 說(shuō)明 |
---|---|
success | 執(zhí)行狀態(tài),true為執(zhí)行成功,false為失敗 |
successMsgs | success為true時(shí),返回值執(zhí)行的狀態(tài)碼和成功新建(更新)后的組織模型實(shí)體 |
errorMsgs | success為false時(shí),返回執(zhí)行的狀態(tài)碼和出錯(cuò)的組織模型實(shí)體 |
--code | 狀態(tài)碼,參見“狀態(tài)碼” |
--entity | 組織模型實(shí)體 |
參數(shù) | 說(shuō)明 |
---|---|
ACCOUNT_CUSTOM_LOGIN_URL_DUPLICATED | 單位自定義登錄頁(yè)地址不能重復(fù) |
ACCOUNT_EXIST_CHILDACCOUNT | 單位下存在未刪除的子單位 |
ACCOUNT_EXIST_CHILDACCOUNT_ENABLE | 單位存在有效子單位不允許停用 |
ACCOUNT_EXIST_DEPARTMENT | 單位下存在未刪除的部門 |
ACCOUNT_EXIST_DEPARTMENT_ENABLE | 單位存在有效的部門不允許停用 |
ACCOUNT_EXIST_ENTITY | 單位下存在未刪除的組織模型實(shí)體 |
ACCOUNT_EXIST_LEVEL | 單位下存在未刪除的職務(wù)級(jí)別 |
ACCOUNT_EXIST_LEVEL_ENABLE | 單位存在有效職務(wù)不允許停用 |
ACCOUNT_EXIST_MEMBER | 單位下存在未刪除的人員 |
ACCOUNT_EXIST_MEMBER_ENABLE | 單位內(nèi)存在有效人員不允許停用 |
ACCOUNT_EXIST_POST | 單位下存在未刪除的崗位 |
ACCOUNT_EXIST_POST_ENABLE | 單位存在有效崗位不允許停用 |
ACCOUNT_EXIST_ROLE | 單位下存在未刪除的單位自建角色 |
ACCOUNT_EXIST_ROLE_ENABLE | 單位存在有效角色不允許停用 |
ACCOUNT_EXIST_TEAM | 單位下存在未刪除的組 |
ACCOUNT_EXIST_TEAM_ENABLE | 單位存在有效組不允許停用 |
ACCOUNT_REPEAT_ADMIN_NAME | 單位管理員名稱重復(fù) |
ACCOUNT_REPEAT_CODE | 單位編碼重復(fù) |
ACCOUNT_REPEAT_NAME | 單位名稱重復(fù) |
ACCOUNT_REPEAT_SHORT_NAME | 單位名稱重復(fù) |
DEPARTMENT_EXIST_MEMBER | 部門存在成員 |
DEPARTMENT_EXIST_TEAM | 部門存在組 |
DEPARTMENT_PARENTDEPT_DISABLED | 父部門禁用 |
DEPARTMENT_PARENTDEPT_ISCHILD | 父部門是自己的子部門 |
DEPARTMENT_PARENTDEPT_SAME | 與父部門相同(檢查父部門是否是自己) |
DEPARTMENT_PARENTID_NULL | 父部門ID為空 |
DEPARTMENT_REPEAT_CODE | 部門編碼重復(fù) |
DEPARTMENT_REPEAT_NAME | 部門名稱重復(fù) |
DUTYLEVEL_EXIST_MEMBER | 政務(wù)版--職級(jí)存在成員 |
LEVEL_EXIST_MAPPING | 存在職務(wù)級(jí)別的映射 |
LEVEL_EXIST_MEMBER | 職務(wù)存在成員 |
LEVEL_REPEAT_NAME | 存在職務(wù)級(jí)別的映射 |
MEMBER_CANNOT_DELETE | 人員有公共信息管理員或者審核員等身份,或其他為清理事項(xiàng),刪除失敗 |
MEMBER_DEPARTMENT_DISABLED | 人員所在部門不可用 |
MEMBER_EXIST_SIGNET | 人員存在授權(quán)印章 |
MEMBER_LEVEL_DISABLED | 人員所在職務(wù)不可用 |
MEMBER_NOT_EXIST | 人員不存在(常用在修改和刪除時(shí)) |
MEMBER_POST_DISABLED | 人員所在崗位不可用 |
MEMBER_REPEAT_CODE | 人員編碼重復(fù) |
MEMBER_REPEAT_POST | 人員副崗和主崗重復(fù) |
OUT_PER_NUM | 添加的人員數(shù)量大于單位剩余的可注冊(cè)數(shù)量,不允許添加人員! |
POST_EXIST_BENCHMARK | 基準(zhǔn)崗位已引用 |
POST_EXIST_MEMBER | 崗位存在成員 |
POST_REPEAT_NAME | 崗位名稱重復(fù) |
PRINCIPAL_NOT_EXIST | 登錄名不存在 |
PRINCIPAL_REPEAT_NAME | 人員賬號(hào)名稱重復(fù) |
REPEAT_PATH | PATH重復(fù) |
ROLE_NOT_EXIST | 角色不存在 |
SUCCESS | 完全成功 |
部門管理服務(wù)支持獲取,創(chuàng)建,修改,刪除部門數(shù)據(jù)。
{
'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
}
參數(shù) | 說(shuō)明 |
---|---|
orgAccountId | 所屬單位ID |
id | ID |
name | 部門名稱 |
code | 部門代碼 |
sortId | 排序號(hào) |
shortName | 單位簡(jiǎn)稱 |
createTime | 創(chuàng)建時(shí)間 |
updateTime | 修改時(shí)間 |
isDeleted | 是否刪除 |
enabled | 是否啟用 |
status | 狀態(tài) |
description | 描述 |
path | 路徑 |
secondName | 外文名稱,對(duì)部門無(wú)效,保留字段 |
isInternal | 是否是內(nèi)部機(jī)構(gòu) |
isGroup | 是否是集團(tuán) |
levelScope | 只對(duì)type=account有效 |
type | 類型 |
fax | 傳真 |
unitMail | 郵件 |
address | 地址 |
chiefLeader | 負(fù)責(zé)人 |
zipCode | 郵編 |
telephone | 電話 |
superior | 上級(jí)部門Id,一級(jí)部門則為所屬單位Id |
sortIdType | |
isCanAccess | 是否允許訪問(wèn) |
entityType | 實(shí)體類型 |
valid | 是否合法 |
parentPath | 父部門的路徑 |
部門創(chuàng)建/更新成功返回對(duì)象示例
{
'successMsgs': [
{
'code': 'SUCCESS',
'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
}
}
],
'errorMsgs': [ ],
'success': true
}
部門創(chuàng)建/更新失敗返回對(duì)象示例
{
'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
}
開發(fā)者可以通過(guò)【部門ID】來(lái)獲取部門信息。
接口調(diào)用請(qǐng)求說(shuō)明:
http請(qǐng)求方式:GET
http://ip:port/seeyon/rest/orgDepartment/{id}
參數(shù) | 是否必須 | 說(shuō)明 |
---|---|---|
id | 是 | 部門ID |
返回說(shuō)明:
正常情況下,會(huì)返回的是JSON格式部門信息,JSON數(shù)據(jù)包參考:部門對(duì)象示例
參數(shù)說(shuō)明 請(qǐng)參考:部門對(duì)象屬性說(shuō)明
如果錄入的部門ID錯(cuò)誤或者為空時(shí),返回JSON格式部門信息的為空.
開發(fā)者可以通過(guò)【部門編碼】來(lái)獲取部門信息。
接口調(diào)用請(qǐng)求說(shuō)明:
http請(qǐng)求方式:GET
http://ip:port/seeyon/rest/orgDepartment/code/{code}
參數(shù) | 是否必須 | 說(shuō)明 |
---|---|---|
code | 是 | 部門編碼 |
返回說(shuō)明:
正常情況下,會(huì)返回的是JSON格式部門信息,JSON數(shù)據(jù)包參考:部門對(duì)象示例
參數(shù)說(shuō)明 請(qǐng)參考:部門對(duì)象屬性說(shuō)明
如果錄入的部門編碼錯(cuò)誤或者為空時(shí),返回JSON格式部門信息的為空.
開發(fā)者可以通過(guò)【單位ID】來(lái)獲取單位下所有部門信息(不包含停用部門)。
接口調(diào)用請(qǐng)求說(shuō)明:
http請(qǐng)求方式:GET
http://ip:port/seeyon/rest/orgDepartments/{accountId}
參數(shù) | 是否必須 | 說(shuō)明 |
---|---|---|
accountId | 是 | 單位ID |
返回說(shuō)明
正常情況下,會(huì)返回的是JSON格式部門信息,JSON數(shù)據(jù)包參考:部門對(duì)象示例
參數(shù)說(shuō)明 請(qǐng)參考:部門對(duì)象屬性說(shuō)明
如果錄入的單位ID錯(cuò)誤或者為空時(shí),返回JSON格式部門信息的為空.
開發(fā)者可以通過(guò)【單位ID】來(lái)獲取部門的數(shù)量(不包含停用部門)。
接口調(diào)用請(qǐng)求說(shuō)明:
http請(qǐng)求方式:GET
http://ip:port/seeyon/rest/orgDepartments/count/{accountId}
參數(shù) | 是否必須 | 說(shuō)明 |
---|---|---|
accountId | 是 | 單位ID |
返回說(shuō)明
正常情況下,會(huì)返回的是JSON格式部門信息,JSON數(shù)據(jù)包參考:部門對(duì)象示例
參數(shù)說(shuō)明 請(qǐng)參考:部門對(duì)象屬性說(shuō)明
正常情況下,會(huì)返回的是Integer類型的數(shù)值。
如果錄入的單位ID錯(cuò)誤或者為空時(shí),返回信息為空。
開發(fā)者可以通過(guò)【單位ID】來(lái)獲取單位下所有部門信息(包含停用部門)。
接口調(diào)用請(qǐng)求說(shuō)明:
http請(qǐng)求方式:GET
http://ip:port/seeyon/rest/orgDepartments/all/{accountId}
參數(shù) | 是否必須 | 說(shuō)明 |
---|---|---|
accountId | 是 | 單位ID |
返回說(shuō)明
正常情況下,會(huì)返回的是JSON格式部門信息,JSON數(shù)據(jù)包參考:部門對(duì)象示例
參數(shù)說(shuō)明 請(qǐng)參考:部門對(duì)象屬性說(shuō)明
如果錄入的單位ID錯(cuò)誤或者為空時(shí),返回JSON格式部門信息的為空.
開發(fā)者可以將部門相關(guān)參數(shù)組裝為JSON類型,來(lái)創(chuàng)建部門信息。
接口請(qǐng)求說(shuō)明:
http請(qǐng)求方式:POST
http://ip:port/seeyon/rest/orgDepartment
參數(shù) | 是否必須 | 說(shuō)明 |
---|---|---|
orgAccountId | 是 | 單位ID |
code | 是 | 編號(hào) |
name | 是 | 名稱 |
description | 否 | 描述 |
enabled | 是 | 是否啟用 |
superior | 是 | 父部門ID |
組裝新建部門JSON數(shù)據(jù),請(qǐng)參照:部門對(duì)象示例只需要將示例對(duì)象中標(biāo)明為【必填】(不包括ID)參數(shù)組裝即可。
正常情況下,創(chuàng)建成功會(huì)返回成功的標(biāo)識(shí)以及JSON格式部門信息,返回JSON數(shù)據(jù)信息請(qǐng)參考:部門創(chuàng)建更新返回對(duì)象示例
如果創(chuàng)建失敗,同樣會(huì)返回失敗的標(biāo)識(shí),并且在【'errorMsgs'】參數(shù)中給出創(chuàng)建失敗的原因以及JSON信息。
將需要?jiǎng)?chuàng)建的多個(gè)部門Map放入List中批量創(chuàng)建部門信息。【注意:?jiǎn)挝幌卤仨殯](méi)有啟用的部門,才能夠進(jìn)行批量創(chuàng)建】
接口請(qǐng)求說(shuō)明:
http請(qǐng)求方式:POST
http://ip:port/seeyon/rest/orgDepartment/addDepartments
創(chuàng)建數(shù)據(jù)示例:
List reslist=new ArrayList();
Map newDep = new HashMap() {
{
put('orgAccountId', '5269865115340261356'); //單位ID
put('code', 'auto1');//編號(hào)
put('name', 'REST創(chuàng)建');//名稱
put('description', '描述');
put('enabled','true');//啟用是否
put('superior', '5269865115340261356');//父級(jí)ID
}
};
Map newDep2 = new HashMap() {
...
}
reslist.add(newDep);
reslist.add(newDep2);
client.post('/orgDepartment/addDepartments',reslist, String.class);
返回說(shuō)明
創(chuàng)建部門成功則返回JSON格式部門信息。
開發(fā)者可以通過(guò)部門ID修改對(duì)應(yīng)的部門信息。
接口請(qǐng)求說(shuō)明:
http請(qǐng)求方式:PUT
http://ip:port/seeyon/rest/orgDepartment
創(chuàng)建數(shù)據(jù)示例:
{
'Id': 需修改的部門ID, 【必填】
'code': 要修改部門參數(shù), 【必填】
}
返回說(shuō)明
正常情況下,創(chuàng)建成功會(huì)返回成功的標(biāo)識(shí)以及JSON格式部門信息,返回JSON數(shù)據(jù)信息請(qǐng)參考:部門創(chuàng)建更新返回對(duì)象示例
部門ID不存在,那么返回信息為空。
如果失敗,同樣會(huì)返回失敗的標(biāo)識(shí),并且在【'errorMsgs'】參數(shù)中給出創(chuàng)建失敗的原因以及JSON信息。
將需要修改的多個(gè)部門Map放入List中批量創(chuàng)建部門信息。
接口請(qǐng)求說(shuō)明:
http請(qǐng)求方式:POST
http://ip:port/seeyon/rest/orgDepartment/updateDepartments
創(chuàng)建數(shù)據(jù)示例:
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);
返回說(shuō)明
修改部門成功則返回JSON格式部門信息。
開發(fā)者可以通過(guò)部門ID刪除對(duì)應(yīng)的部門信息。
接口請(qǐng)求說(shuō)明:
http請(qǐng)求方式:DELETE
http://ip:port/seeyon/rest/orgDepartment/{id}
參數(shù) | 是否必須 | 說(shuō)明 |
---|---|---|
id | 是 | 部門ID |
返回說(shuō)明
因?yàn)閯h除目前接口采用異步模式,暫無(wú)返回值信息。
開發(fā)者可以通過(guò)部門ID以及enabled字段信息來(lái)啟用禁用對(duì)應(yīng)的部門信息。
接口請(qǐng)求說(shuō)明:
http請(qǐng)求方式:PUT
http://ip:port/seeyon/rest/orgDepartment/{id}/enabled/{enabled}
參數(shù) | 是否必須 | 說(shuō)明 |
---|---|---|
id | 是 | 部門ID |
enabled | 是 | 部門是否啟用【true.啟動(dòng);false停止】 |
創(chuàng)建數(shù)據(jù)示例:
組裝修改部門啟用/禁用JSON數(shù)據(jù)的參數(shù)只需要部門的ID以及enabled參數(shù)信息即可,示例如下:
{
'Id': 部門ID, 【必填】
'enabled': true, 【必填】
}
開發(fā)者可以通過(guò)【部門ID】來(lái)獲取指定部門下所有部門信息。
接口調(diào)用請(qǐng)求說(shuō)明:
http請(qǐng)求方式:GET
http://ip:port/seeyon/rest/orgDepartments/children/{parentId}?firstLayer=false/true;
參數(shù) | 是否必須 | 說(shuō)明 |
---|---|---|
parentId | 是 | 部門ID |
firstLayer | 否 | true是只顯示直屬子部門,false是包含所有層級(jí)的部門 |
返回說(shuō)明
正常情況下,會(huì)返回的是JSON格式部門信息,JSON數(shù)據(jù)包參考:部門對(duì)象示例
參數(shù)說(shuō)明 請(qǐng)參考:部門對(duì)象屬性說(shuō)明
如果錄入的單位ID錯(cuò)誤或者為空時(shí),返回JSON格式部門信息的為空.
開發(fā)者可以通過(guò)【部門ID】來(lái)獲取指定部門父級(jí)部門信息。
接口調(diào)用請(qǐng)求說(shuō)明:
http請(qǐng)求方式:GET
http://ip:port/seeyon/rest/orgDepartments/parent/{departmentId}?firstLayer=false/true;
參數(shù) | 是否必須 | 說(shuō)明 |
---|---|---|
departmentId | 是 | 部門ID |
firstLayer | 否 | true是只顯示直屬子部門,false是包含所有層級(jí)的部門 |
返回說(shuō)明
正常情況下,會(huì)返回的是JSON格式部門信息,JSON數(shù)據(jù)包參考:部門對(duì)象示例
參數(shù)說(shuō)明 請(qǐng)參考:部門對(duì)象屬性說(shuō)明
如果錄入的單位ID錯(cuò)誤或者為空時(shí),返回JSON格式部門信息的為空.
開發(fā)者可以通過(guò)部門編碼修改對(duì)應(yīng)的部門信息。
接口請(qǐng)求說(shuō)明:
http請(qǐng)求方式:PUT
http://ip:port/seeyon/rest/orgDepartment
創(chuàng)建數(shù)據(jù)示例:
field字段指定根據(jù)code來(lái)匹配部門,根據(jù)條件得到多個(gè)結(jié)果則會(huì)報(bào)錯(cuò)。
{
'id': {'field':'code'}, 【必填】
'code': 要修改部門編碼, 【必填】
'description': 需要修改的參數(shù)【必填】
}
返回說(shuō)明
正常情況下,創(chuàng)建成功會(huì)返回成功的標(biāo)識(shí)以及JSON格式部門信息,返回JSON數(shù)據(jù)信息請(qǐng)參考:部門創(chuàng)建更新返回對(duì)象示例
部門編碼不存在,那么返回信息為空。
如果失敗,同樣會(huì)返回失敗的標(biāo)識(shí),并且在【'errorMsgs'】參數(shù)中給出創(chuàng)建失敗的原因以及JSON信息。
開發(fā)者可以通過(guò)部門編碼以及enabled字段信息來(lái)啟用禁用對(duì)應(yīng)的部門信息。
接口請(qǐng)求說(shuō)明:
http請(qǐng)求方式:PUT
http://ip:port/seeyon/rest/orgDepartment/code/{code}/enabled/{enabled}
參數(shù) | 是否必須 | 說(shuō)明 |
---|---|---|
code | 是 | 部門編碼 |
enabled | 是 | 部門是否啟用【true.啟動(dòng);false停止】 |
創(chuàng)建數(shù)據(jù)示例:
組裝修改部門啟用/禁用JSON數(shù)據(jù)的參數(shù)只需要部門的ID以及enabled參數(shù)信息即可,示例如下:
{
'code': 部門編碼, 【必填】
'enabled': true, 【必填】
}
返回說(shuō)明
正常情況下,創(chuàng)建成功會(huì)返回成功的標(biāo)識(shí)以及JSON格式部門信息,返回JSON數(shù)據(jù)信息請(qǐng)參考:部門創(chuàng)建更新返回對(duì)象示例
如果創(chuàng)建失敗,同樣會(huì)返回失敗的標(biāo)識(shí),并且在【'errorMsgs'】參數(shù)中給出創(chuàng)建失敗的原因以及JSON信息。
開發(fā)者可以通過(guò)部門編碼刪除對(duì)應(yīng)的部門信息。
接口請(qǐng)求說(shuō)明
http請(qǐng)求方式:DELETE
http://ip:port/seeyon/rest/orgDepartment/code/{code}
參數(shù) | 是否必須 | 說(shuō)明 |
---|---|---|
code | 是 | 部門編碼 |
返回說(shuō)明
因?yàn)閯h除目前接口采用異步模式,暫無(wú)返回值信息。
開發(fā)者可以通過(guò)【單位編碼】來(lái)獲取單位下所有部門信息(包含停用部門)。
接口調(diào)用請(qǐng)求說(shuō)明:
http請(qǐng)求方式:GET
http://ip:port/seeyon/rest/orgDepartment/code/{code}
返回說(shuō)明
正常情況下,會(huì)返回的是JSON格式部門信息,JSON數(shù)據(jù)包參考:部門對(duì)象示例
參數(shù)說(shuō)明 請(qǐng)參考:部門對(duì)象屬性說(shuō)明
如果錄入的單位編碼錯(cuò)誤或者為空時(shí),返回JSON格式部門信息的為空.
開發(fā)者可以通過(guò)【部門編碼】來(lái)獲取指定部門下所有子部門信息。
接口調(diào)用請(qǐng)求說(shuō)明;
http請(qǐng)求方式:GET
http://ip:port/seeyon/rest/orgDepartments/children/code/{parentCode}
參數(shù) | 是否必須 | 說(shuō)明 |
---|---|---|
parentCode | 是 | 部門編碼 |
返回說(shuō)明
正常情況下,會(huì)返回的是JSON格式部門信息,JSON數(shù)據(jù)包參考:部門對(duì)象示例
參數(shù)說(shuō)明 請(qǐng)參考:部門對(duì)象屬性說(shuō)明
如果錄入的部門編碼錯(cuò)誤或者為空時(shí),返回JSON格式部門信息的為空.
開發(fā)者可以通過(guò)【部門編碼】來(lái)獲取指定部門下所有兼職人員信息。
接口調(diào)用請(qǐng)求說(shuō)明:
http請(qǐng)求方式:GET
http://ip:port/seeyon/rest/orgDepartments/concurrentpost/code/{code}
參數(shù) | 是否必須 | 說(shuō)明 |
---|---|---|
code | 是 | 部門編碼 |
返回說(shuō)明
正常情況下,會(huì)返回的是JSON格式部門信息,JSON數(shù)據(jù)包參考:部門對(duì)象示例
參數(shù)說(shuō)明 請(qǐng)參考:部門對(duì)象屬性說(shuō)明
如果錄入的部門編碼錯(cuò)誤或者為空時(shí),返回JSON格式部門信息的為空.
根據(jù)部門ID查看當(dāng)前部門所設(shè)置的崗位。
接口調(diào)用請(qǐng)求說(shuō)明:
http請(qǐng)求方式:GET
http://ip:port/seeyon/rest/orgDepartment/departmentpost/{departmentid}
參數(shù) | 是否必須 | 說(shuō)明 |
---|---|---|
departmentid | 是 | 部門ID |
返回說(shuō)明
正常情況下,會(huì)返回的是JSON格式部門信息,JSON數(shù)據(jù)包參考:部門對(duì)象示例
參數(shù)說(shuō)明 請(qǐng)參考:部門對(duì)象屬性說(shuō)明
如果錄入的錯(cuò)誤或者為空時(shí),返回JSON格式部門信息的為空.
根據(jù)部門ID更新當(dāng)前部門所設(shè)置的崗位。
接口調(diào)用請(qǐng)求說(shuō)明:
http請(qǐng)求方式:PUT
http://ip:port/seeyon/rest/orgDepartment/departmentpost
更新部門崗位參數(shù):
Map res = new HashMap();
res.put('id', '3138456220332082763');//部門ID
res.put('deptpost', 'Post|-8953437412957663435,Post|-1185154002310052488');//崗位ID Post 第一個(gè)字母大寫
返回說(shuō)明
正常情況下,會(huì)返回的是JSON格式部門信息,JSON數(shù)據(jù)包參考:部門對(duì)象示例
參數(shù)說(shuō)明 請(qǐng)參考:部門對(duì)象屬性說(shuō)明
如果錄入錯(cuò)誤或者為空時(shí),返回JSON格式部門信息的為空.
根據(jù)部門ID查看當(dāng)前部門的部門主管、分管領(lǐng)導(dǎo)、部門管理員、部門公文收發(fā)員。
接口調(diào)用請(qǐng)求說(shuō)明:
http請(qǐng)求方式:GET
http://ip:port/seeyon/rest/orgDepartment/departmentmanagerinfo/{departmentid}/{accountid}
返回說(shuō)明
正常情況下,會(huì)返回的是JSON格式部門信息,JSON數(shù)據(jù)包參考:部門對(duì)象示例
參數(shù)說(shuō)明 請(qǐng)參考:部門對(duì)象屬性說(shuō)明
如果錄入錯(cuò)誤或者為空時(shí),返回JSON格式部門信息的為空.
推薦使用新接口按照編碼更新部門管理角色[主管,領(lǐng)導(dǎo),管理員,公文收發(fā)員](Since:V7.1))
修改部門管理角色信息。
接口調(diào)用請(qǐng)求說(shuō)明:
http請(qǐng)求方式:PUT
http://ip:port/seeyon/rest/orgDepartment/departmentmanagerinfo
修改部門角色信息參數(shù):
Map res = new HashMap();
res.put('id', '3034473275669826764');//(部門ID)
res.put('orgAccountId', '-4532703988283521957');//(單位ID)
res.put('deptrole0', 'Member|-3704582433472430042|部門主管(man)|-4532703988283521957|true');//部門主管-人員類型(member)/人員ID/人員名稱/單位ID/true
res.put('deptrole1', 'Member|1063984842976872115|部門領(lǐng)導(dǎo)(man)|-4532703988283521957|true');//部門分管領(lǐng)導(dǎo)
res.put('deptrole2', 'Member|-2833598432627637498|李世民|-4532703988283521957|true');//部門管理員
res.put('deptrole3', '');//如果不傳則置空//'Member|-2833598432627637498|李世民|-4532703988283521957|true,Member|6715603953152377707|部門公文收發(fā)(man)|-4532703988283521957|true');//部門公文收發(fā)員
//注意deptrole0 1 2 3 的順序 不能改變,順學(xué)對(duì)應(yīng)的就是角色順序
返回說(shuō)明
正常情況下,會(huì)返回的是JSON格式部門信息,JSON數(shù)據(jù)包參考:部門對(duì)象示例
參數(shù)說(shuō)明 請(qǐng)參考:部門對(duì)象屬性說(shuō)明
如果錄入錯(cuò)誤或者為空時(shí),返回JSON格式部門信息的為空.
根據(jù)編碼修改部門管理角色信息。
接口調(diào)用請(qǐng)求說(shuō)明:
http請(qǐng)求方式:PUT
http://ip:port/seeyon/rest/orgDepartment/role
修改部門角色信息參數(shù):
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');// 部門領(lǐng)導(dǎo)編碼
data.put('roleMember', m1);
client.put('orgDepartment/role', data, String.class);// 發(fā)送請(qǐng)求
返回說(shuō)明
正常情況下,返回JSON格式部門信息,JSON數(shù)據(jù)包詳情請(qǐng)參考:部門對(duì)象示例
參數(shù)說(shuō)明 請(qǐng)參考:部門對(duì)象屬性說(shuō)明
返回成功示例:
{
'code' : 0,
'data' : {
// 部門對(duì)象屬性
'orgAccountId' : 4096395336238448877,
......
},
'message' : '成功'
}
返回失敗示例:
{
'code' : 1001,// 不同錯(cuò)誤返回不同的錯(cuò)誤狀態(tài)碼
'data' : 'accountCode',
'message' : '單位編碼不能為空!'
}
開發(fā)者可以通過(guò)【部門編碼】來(lái)獲取指定部門下部門主管、分管領(lǐng)導(dǎo)、部門管理員、部門公文收發(fā)員。
接口調(diào)用請(qǐng)求說(shuō)明:
http請(qǐng)求方式:GET
http://ip:port/seeyon/rest/orgDepartments/visor/code/{code}
參數(shù) | 是否必須 | 說(shuō)明 |
---|---|---|
code | 是 | 部門編碼 |
返回說(shuō)明
正常情況下,會(huì)返回的是JSON格式部門信息,JSON數(shù)據(jù)包參考:部門對(duì)象示例
參數(shù)說(shuō)明 請(qǐng)參考:部門對(duì)象屬性說(shuō)明
如果錄入的部門編碼錯(cuò)誤或者為空時(shí),返回JSON格式部門信息的為空.
崗位管理服務(wù)支持獲取,創(chuàng)建,修改,刪除崗位數(shù)據(jù)。
{
'orgAccountId' : -6611845740562398180,【必填】
'id' : 3975462922290545021,
'name' : '測(cè)試崗位',【必填】
'code' : '2',
'createTime' : 1476065603000,
'updateTime' : 1476065603000,
'sortId' : 2,
'isDeleted' : false,
'enabled' : true,
'status' : 1,
'description' : '',
'typeId' : 1,
'valid' : true,
'entityType' : 'Post'
}
參數(shù) | 說(shuō)明 |
---|---|
orgAccountId | 所屬單位ID |
id | ID |
name | 崗位名稱 |
code | 崗位代碼 |
createTime | 創(chuàng)建時(shí)間 |
updateTime | 更改時(shí)間 |
sortId | 排序號(hào) |
isDeleted | 是否被刪除 |
enabled | 是否啟用 |
status | 狀態(tài) |
description | 描述 |
typeId | 類型ID |
valid | 是否合法 |
崗位創(chuàng)建/更新成功返回對(duì)象示例
{
'successMsgs': [
{
'code': 'SUCCESS',
'ent': {
'orgAccountId': 8422659649969606000,
'id': 6136971397059070000,
'name': '崗位名稱',
'code': '',
'createTime': 1381372238000,
'updateTime': 1381372238000,
'sortId': 16,
'isDeleted': false,
'enabled': true,
'status': 1,
'description': 'xxxxx',
'typeId': 1,
'valid': true,
'entityType': 'Post'
}
}
],
'errorMsgs': [ ],
'success': true
}
崗位創(chuàng)建/更新失敗返回對(duì)象示例
{
'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
}
開發(fā)者可以通過(guò)【崗位ID】來(lái)獲取崗位信息。
接口調(diào)用請(qǐng)求說(shuō)明
http請(qǐng)求方式:GET
http://ip:port/seeyon/rest/orgPost/{id}
參數(shù) | 是否必須 | 說(shuō)明 |
---|---|---|
id | 是 | 崗位ID |
返回說(shuō)明
正常情況下,會(huì)返回的是JSON格式崗位信息,JSON數(shù)據(jù)包參考:崗位對(duì)象示例
參數(shù)說(shuō)明 請(qǐng)參考:崗位對(duì)象屬性說(shuō)明
如果錄入的部門ID錯(cuò)誤或者為空時(shí),返回JSON格式崗位信息的為空.
開發(fā)者可以通過(guò)【單位ID】來(lái)獲取當(dāng)前單位下的所有崗位信息(不包含停用崗位)。
接口調(diào)用請(qǐng)求說(shuō)明
http請(qǐng)求方式:GET
http://ip:port/seeyon/rest/orgPosts/{accountId}
參數(shù) | 是否必須 | 說(shuō)明 |
---|---|---|
accountId | 是 | 單位ID |
返回說(shuō)明
正常情況下,會(huì)返回的是JSON格式崗位信息,JSON數(shù)據(jù)包參考:崗位對(duì)象示例
參數(shù)說(shuō)明 請(qǐng)參考:崗位對(duì)象屬性說(shuō)明
如果錄入的部門ID錯(cuò)誤或者為空時(shí),返回JSON格式崗位信息的為空.
開發(fā)者可以通過(guò)【單位ID】來(lái)獲取崗位的數(shù)量(不包含停用崗位)。
接口調(diào)用請(qǐng)求說(shuō)明
http請(qǐng)求方式:GET
http://ip:port/seeyon/rest/orgPosts/count/{accountId}
參數(shù) | 是否必須 | 說(shuō)明 |
---|---|---|
accountId | 是 | 單位ID |
返回說(shuō)明
正常情況下,會(huì)返回的是Integer類型的數(shù)值。
如果錄入的單位ID錯(cuò)誤或者為空時(shí),返回信息為空。
開發(fā)者可以通過(guò)【單位ID】來(lái)獲取當(dāng)前單位下的所有崗位信息(包含停用崗位)。
接口調(diào)用請(qǐng)求說(shuō)明
http請(qǐng)求方式:GET
http://ip:port/seeyon/rest/orgPosts/all/{accountId}
參數(shù) | 是否必須 | 說(shuō)明 |
---|---|---|
accountId | 是 | 單位ID |
返回說(shuō)明
正常情況下,會(huì)返回的是JSON格式崗位信息,JSON數(shù)據(jù)包參考:崗位對(duì)象示例
參數(shù)說(shuō)明 請(qǐng)參考:崗位對(duì)象屬性說(shuō)明
如果錄入的部門ID錯(cuò)誤或者為空時(shí),返回JSON格式崗位信息的為空.
開發(fā)者可以通過(guò)【單位ID】來(lái)獲取崗位的數(shù)量(包含停用崗位)。
接口調(diào)用請(qǐng)求說(shuō)明
http請(qǐng)求方式:GET
http://ip:port/seeyon/rest/orgPosts/all/count/{accountId}
參數(shù) | 是否必須 | 說(shuō)明 |
---|---|---|
accountId | 是 | 單位ID |
返回說(shuō)明
正常情況下,會(huì)返回的是Integer類型的數(shù)值。
如果錄入的單位ID錯(cuò)誤或者為空時(shí),返回信息為空。
開發(fā)者可以將崗位相關(guān)參數(shù)組裝為JSON類型,來(lái)創(chuàng)建崗位信息。
接口請(qǐng)求說(shuō)明
http請(qǐng)求方式:POST
http://ip:port/seeyon/rest/orgPost
創(chuàng)建數(shù)據(jù)示例:
參數(shù) | 是否必須 | 說(shuō)明 |
---|---|---|
orgAccountId | 是 | 單位ID |
code | 是 | 編號(hào) |
name | 是 | 名稱 |
description | 否 | 描述 |
typeId | 是 | 類型參數(shù)(管理類是1,技術(shù)類是2,營(yíng)銷類是3,職能類是4) |
組裝新建崗位JSON數(shù)據(jù),請(qǐng)參照:崗位對(duì)象示例只需要將示例對(duì)象中標(biāo)明為【必填】參數(shù)組裝即可。
新建崗位JSON數(shù)據(jù)參數(shù)的具體字段含義請(qǐng)參見崗位對(duì)象屬性說(shuō)明
返回說(shuō)明
正常情況下,創(chuàng)建成功會(huì)返回成功的標(biāo)識(shí)以及JSON格式崗位信息,JSON數(shù)據(jù)信息請(qǐng)參考:崗位創(chuàng)建更新返回對(duì)象示例
如果崗位創(chuàng)建失敗,同樣會(huì)返回失敗的標(biāo)識(shí),并且在【'errorMsgs'】參數(shù)中給出創(chuàng)建失敗的原因以及JSON格式崗位信息。
將需要?jiǎng)?chuàng)建的多個(gè)崗位Map放入List中批量創(chuàng)建崗位信息。
接口請(qǐng)求說(shuō)明
http請(qǐng)求方式:POST
http://ip:port/seeyon/rest/orgPost/addPosts
創(chuàng)建數(shù)據(jù)示例:
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);
返回說(shuō)明
創(chuàng)建崗位成功則返回JSON格式崗位信息。
開發(fā)者可以通過(guò)崗位ID修改對(duì)應(yīng)的崗位信息。
接口請(qǐng)求說(shuō)明
http請(qǐng)求方式:PUT
http://ip:port/seeyon/rest/orgPost
創(chuàng)建數(shù)據(jù)示例:
組裝修改崗位JSON數(shù)據(jù)的參數(shù)只需要崗位的ID以及需要修改參數(shù)信息即可,示例如下:
{
'Id': 需修改的崗位ID, 【必填】
'description': 要修改的參數(shù), 【必填】
}
返回說(shuō)明
正常情況下,成功會(huì)返回成功的標(biāo)識(shí)以及JSON格式崗位信息,JSON數(shù)據(jù)信息請(qǐng)參考:崗位創(chuàng)建更新返回對(duì)象示例
如果崗位創(chuàng)建失敗,同樣會(huì)返回失敗的標(biāo)識(shí),并且在【'errorMsgs'】參數(shù)中給出創(chuàng)建失敗的原因以及JSON格式崗位信息.
將需要修改的多個(gè)崗位Map放入List中批量修改崗位信息。
接口請(qǐng)求說(shuō)明
http請(qǐng)求方式:POST
http://ip:port/seeyon/rest/orgPost/updatePosts
創(chuàng)建數(shù)據(jù)示例:
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);
返回說(shuō)明
修改崗位成功則返回JSON格式崗位信息。
開發(fā)者可以通過(guò)崗位ID刪除對(duì)應(yīng)的崗位信息。
接口請(qǐng)求說(shuō)明
http請(qǐng)求方式:DELETE
http://ip:port/seeyon/rest/orgPost/{id}
參數(shù) | 是否必須 | 說(shuō)明 |
---|---|---|
id | 是 | 崗位ID |
返回說(shuō)明
因?yàn)閯h除目前接口采用異步模式,暫無(wú)返回值信息。
開發(fā)者可以通過(guò)崗位ID以及enabled字段信息來(lái)啟用禁用對(duì)應(yīng)的崗位信息。
接口請(qǐng)求說(shuō)明
http請(qǐng)求方式:PUT
http://ip:port/seeyon/rest/orgPost/{id}/enabled/{enabled}
參數(shù) | 是否必須 | 說(shuō)明 |
---|---|---|
id | 是 | 崗位ID |
enabled | 是 | 崗位是否啟用【true.啟動(dòng);false停止】 |
創(chuàng)建數(shù)據(jù)示例:
組裝修改崗位啟用/禁用JSON數(shù)據(jù)的參數(shù)只需要崗位的ID以及enabled參數(shù)信息即可,示例如下:
{
'Id': 需修改的崗位ID, 【必填】
'enabled': true, 【必填】
}
返回說(shuō)明
正常情況下,成功會(huì)返回成功的標(biāo)識(shí)以及JSON格式崗位信息,JSON數(shù)據(jù)信息請(qǐng)參考:崗位創(chuàng)建更新返回對(duì)象示例
如果崗位創(chuàng)建失敗,同樣會(huì)返回失敗的標(biāo)識(shí),并且在【'errorMsgs'】參數(shù)中給出創(chuàng)建失敗的原因以及JSON格式崗位信息.
開發(fā)者可以通過(guò)崗位編碼以及enabled字段信息來(lái)啟用禁用對(duì)應(yīng)的崗位信息。
接口請(qǐng)求說(shuō)明
http請(qǐng)求方式:PUT
http://ip:port/seyon/rest/orgPost/code/{code}/enabled/{enabled}
參數(shù) | 是否必須 | 說(shuō)明 |
---|---|---|
code | 是 | 崗位編碼 |
enabled | 是 | 崗位是否啟用【true.啟動(dòng);false停止】 |
返回說(shuō)明
正常情況下,成功會(huì)返回成功的標(biāo)識(shí)以及JSON格式崗位信息,JSON數(shù)據(jù)信息請(qǐng)參考:崗位創(chuàng)建更新返回對(duì)象示例
如果崗位創(chuàng)建失敗,同樣會(huì)返回失敗的標(biāo)識(shí),并且在【'errorMsgs'】參數(shù)中給出創(chuàng)建失敗的原因以及JSON格式崗位信息.
開發(fā)者可以通過(guò)崗位ID刪除對(duì)應(yīng)的崗位信息。
接口請(qǐng)求說(shuō)明
http請(qǐng)求方式:DELETE
http://ip:port/seeyon/rest/orgPost/code/{code}
參數(shù) | 是否必須 | 說(shuō)明 |
---|---|---|
code | 是 | 崗位編碼 |
返回說(shuō)明
因?yàn)閯h除目前接口采用異步模式,暫無(wú)返回值信息。
開發(fā)者可以通過(guò)崗位編碼修改對(duì)應(yīng)的崗位信息。
接口請(qǐng)求說(shuō)明
http請(qǐng)求方式:PUT
http://ip:port/seeyon/rest/orgPost
創(chuàng)建數(shù)據(jù)示例:
組裝修改崗位JSON數(shù)據(jù)的參數(shù)只需要崗位的編碼以及需要修改參數(shù)信息即可,示例如下:
field字段指定根據(jù)code來(lái)匹配人員,根據(jù)條件得到多個(gè)結(jié)果則會(huì)報(bào)錯(cuò)
{
'Id': {'field':'code'}, 【必填】
'code':需要修改的崗位編碼【必填】
'description': 要修改的參數(shù), 【必填】
}
返回說(shuō)明
正常情況下,成功會(huì)返回成功的標(biāo)識(shí)以及JSON格式崗位信息,JSON數(shù)據(jù)信息請(qǐng)參考:崗位創(chuàng)建更新返回對(duì)象示例
如果崗位創(chuàng)建失敗,同樣會(huì)返回失敗的標(biāo)識(shí),并且在【'errorMsgs'】參數(shù)中給出創(chuàng)建失敗的原因以及JSON格式崗位信息.
職務(wù)管理服務(wù)支持獲取,創(chuàng)建,修改,刪除職務(wù)數(shù)據(jù)。
{
'orgAccountId': 967547186016371000, 【必填】
'name': '職務(wù)', 【必填】
'code': '', 【必填】
'description': '', 【必填】
'levelId': 1, 【必填】
'sortId': 0, 【必填】
'id': 6294808909395413000,【非必填】
'createTime': 1394418219000, 【非必填】
'updateTime': 1394418219000, 【非必填】
'isDeleted': false, 【非必填】
'enabled': true, 【非必填】
'status': 1, 【非必填】
'groupLevelId': -3648300496484547000, 【非必填】
'valid': true, 【非必填】
'entityType': 'Level'【非必填】
}
參數(shù) | 說(shuō)明 |
---|---|
orgAccountId | 所屬單位ID |
id | ID |
name | 職務(wù)級(jí)別名稱 |
code | 職務(wù)級(jí)別代碼 |
createTime | 創(chuàng)建時(shí)間 |
updateTime | 更改時(shí)間 |
sortId | 排序 |
isDeleted | 是否被刪除 |
enabled | 是否啟用 |
status | 狀態(tài) |
description | 描述 |
valid | 是否合法 |
levelId | 職務(wù)級(jí)別序號(hào) |
groupLevelId | 映射的集團(tuán)職務(wù)級(jí)別號(hào) |
entityType | 類型 |
崗位創(chuàng)建/更新成功返回對(duì)象示例
{
'successMsgs': [
{
'code': 'SUCCESS',
'ent': {
'orgAccountId': 967547186016371000,
'id': -8210141186763832000,
'name': '職務(wù)',
'code': '',
'createTime': 1398325590589,
'updateTime': 1398325590589,
'sortId': 1,
'isDeleted': false,
'enabled': true,
'status': 1,
'description': 'xxxxx',
'levelId': 1,
'groupLevelId': null,
'valid': true,
'entityType': 'Level'
}
}
],
'errorMsgs': [ ],
'success': true
}
崗位創(chuàng)建/更新失敗返回對(duì)象示例
{
'successMsgs': [ ],
'errorMsgs': [
{
'code': 'POST_REPEAT_NAME',
'ent': {
'orgAccountId': 967547186016371000,
'id': -8210141186763832000,
'name': '職務(wù)',
'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
}
開發(fā)者可以通過(guò)【職務(wù)ID】來(lái)獲取職務(wù)信息。
接口調(diào)用請(qǐng)求說(shuō)明
http請(qǐng)求方式:GET
http://ip:port/seeyon/rest/orgLevel/{id}
參數(shù) | 是否必須 | 說(shuō)明 |
---|---|---|
id | 是 | 職務(wù)ID |
返回說(shuō)明
正常情況下,會(huì)返回的是JSON格式職務(wù)信息,JSON數(shù)據(jù)包參考:職務(wù)對(duì)象示例
參數(shù)說(shuō)明 請(qǐng)參考:職務(wù)對(duì)象屬性說(shuō)明
如果錄入的職務(wù)ID錯(cuò)誤或者為空時(shí),返回JSON格式職務(wù)信息的為空.
開發(fā)者可以通過(guò)【單位ID】來(lái)獲取單位下所有職務(wù)信息(不包含停用職務(wù))。
接口調(diào)用請(qǐng)求說(shuō)明
http請(qǐng)求方式:GET
http://ip:port/seeyon/rest/orgLevels/{accountId}
參數(shù) | 是否必須 | 說(shuō)明 |
---|---|---|
accountId | 是 | 單位ID |
返回說(shuō)明
正常情況下,會(huì)返回的是JSON格式職務(wù)信息,JSON數(shù)據(jù)包參考:職務(wù)對(duì)象示例
參數(shù)說(shuō)明 請(qǐng)參考:職務(wù)對(duì)象屬性說(shuō)明
如果錄入的職務(wù)ID錯(cuò)誤或者為空時(shí),返回JSON格式職務(wù)信息的為空.
開發(fā)者可以通過(guò)【單位ID】來(lái)獲取單位下所有職務(wù)信息(包含停用職務(wù))。
接口調(diào)用請(qǐng)求說(shuō)明
http請(qǐng)求方式:GET
http://ip:port/seeyon/rest/orgLevels/all/{accountId}
參數(shù) | 是否必須 | 說(shuō)明 |
---|---|---|
accountId | 是 | 單位ID |
返回說(shuō)明
正常情況下,會(huì)返回的是JSON格式職務(wù)信息,JSON數(shù)據(jù)包參考:職務(wù)對(duì)象示例
參數(shù)說(shuō)明 請(qǐng)參考:職務(wù)對(duì)象屬性說(shuō)明
如果錄入的職務(wù)ID錯(cuò)誤或者為空時(shí),返回JSON格式職務(wù)信息的為空.
開發(fā)者可以將職務(wù)相關(guān)參數(shù)組裝為JSON類型,來(lái)創(chuàng)建崗位信息。
接口請(qǐng)求說(shuō)明
http請(qǐng)求方式:POST
http://ip:port/seeyon/rest/orgLevel
參數(shù) | 是否必須 | 說(shuō)明 |
---|---|---|
orgAccountId | 是 | 單位ID |
code | 是 | 編號(hào) |
name | 是 | 名稱 |
description | 否 | 描述 |
創(chuàng)建數(shù)據(jù)示例:
組裝新建職務(wù)JSON數(shù)據(jù),請(qǐng)參照:職務(wù)對(duì)象示例只需要將示例對(duì)象中標(biāo)明為【必填】參數(shù)組裝即可。
新建職務(wù)JSON數(shù)據(jù)參數(shù)的具體字段含義請(qǐng)參見:職務(wù)對(duì)象屬性說(shuō)明
返回說(shuō)明
正常情況下,成功會(huì)返回成功的標(biāo)識(shí)以及JSON格式職務(wù)信息,JSON數(shù)據(jù)信息請(qǐng)參考:職務(wù)創(chuàng)建更新返回對(duì)象示例
如果職務(wù)創(chuàng)建失敗,同樣會(huì)返回失敗的標(biāo)識(shí),并且在【'errorMsgs'】參數(shù)中給出創(chuàng)建失敗的原因以及JSON格式職務(wù)信息.
開發(fā)者可以通過(guò)職務(wù)ID修改對(duì)應(yīng)的職務(wù)信息。
接口請(qǐng)求說(shuō)明
http請(qǐng)求方式:PUT
http://ip:port/seeyon/rest/orgLevel
創(chuàng)建數(shù)據(jù)示例:
組裝修改職務(wù)JSON數(shù)據(jù)的參數(shù)只需要職務(wù)的ID以及需要修改職務(wù)參數(shù)信息即可,示例如下:
{
'Id': 需修改的職務(wù)ID, 【必填】
'description': 要修改職務(wù)參數(shù), 【必填】
}
返回說(shuō)明
正常情況下,成功會(huì)返回成功的標(biāo)識(shí)以及JSON格式職務(wù)信息,JSON數(shù)據(jù)信息請(qǐng)參考:職務(wù)創(chuàng)建更新返回對(duì)象示例
如果職務(wù)創(chuàng)建失敗,同樣會(huì)返回失敗的標(biāo)識(shí),并且在【'errorMsgs'】參數(shù)中給出創(chuàng)建失敗的原因以及JSON格式職務(wù)信息.
開發(fā)者可以通過(guò)職務(wù)ID刪除對(duì)應(yīng)的職務(wù)信息。
接口請(qǐng)求說(shuō)明
http請(qǐng)求方式:DELETE
http://ip:port/seeyon/rest/orgLevel/{id}
參數(shù) | 是否必須 | 說(shuō)明 |
---|---|---|
id | 是 | 職務(wù)ID |
返回說(shuō)明
因?yàn)閯h除目前接口采用異步模式,暫無(wú)返回值信息。
開發(fā)者可以通過(guò)職務(wù)ID以及enabled字段信息來(lái)啟用禁用對(duì)應(yīng)的職務(wù)信息。
接口請(qǐng)求說(shuō)明:
http請(qǐng)求方式:PUT
http://ip:port/seeyon/rest/orgLevel/{id}/enabled/{enabled}
參數(shù) | 是否必須 | 說(shuō)明 |
---|---|---|
id | 是 | 職務(wù)ID |
enabled | 是 | 職務(wù)是否啟用【true.啟動(dòng);false停止】 |
創(chuàng)建數(shù)據(jù)示例:
組裝修改職務(wù)啟用/禁用JSON數(shù)據(jù)的參數(shù)只需要職務(wù)的ID以及enabled參數(shù)信息即可,示例如下:
{
'Id': 職務(wù)ID, 【必填】
'enabled': true, 【必填】
}
返回說(shuō)明
正常情況下,成功會(huì)返回成功的標(biāo)識(shí)以及JSON格式職務(wù)信息,JSON數(shù)據(jù)信息請(qǐng)參考:職務(wù)創(chuàng)建更新返回對(duì)象示例
如果職務(wù)創(chuàng)建失敗,同樣會(huì)返回失敗的標(biāo)識(shí),并且在【'errorMsgs'】參數(shù)中給出創(chuàng)建失敗的原因以及JSON格式職務(wù)信息.
開發(fā)者可以通過(guò)職務(wù)比那么以及enabled字段信息來(lái)啟用禁用對(duì)應(yīng)的職務(wù)信息。
接口請(qǐng)求說(shuō)明:
http請(qǐng)求方式:PUT
http://ip:port/seeyon/rest/orgLevel/code/{code}/enabled/{enabled}
參數(shù) | 是否必須 | 說(shuō)明 |
---|---|---|
code | 是 | 職務(wù)code |
enabled | 是 | 職務(wù)是否啟用【true.啟動(dòng);false停止】 |
返回說(shuō)明
正常情況下,成功會(huì)返回成功的標(biāo)識(shí)以及JSON格式職務(wù)信息,JSON數(shù)據(jù)信息請(qǐng)參考:職務(wù)創(chuàng)建更新返回對(duì)象示例
如果職務(wù)創(chuàng)建失敗,同樣會(huì)返回失敗的標(biāo)識(shí),并且在【'errorMsgs'】參數(shù)中給出創(chuàng)建失敗的原因以及JSON格式職務(wù)信息.
開發(fā)者可以通過(guò)職務(wù)編碼刪除對(duì)應(yīng)的職務(wù)信息。
接口請(qǐng)求說(shuō)明:
http請(qǐng)求方式:DELETE
http://ip:port/seeyon/rest/orgLevel/code/{code}
參數(shù) | 是否必須 | 說(shuō)明 |
---|---|---|
code | 是 | 職務(wù)編碼 |
返回說(shuō)明
因?yàn)閯h除目前接口采用異步模式,暫無(wú)返回值信息。
開發(fā)者可以通過(guò)職務(wù)編碼修改對(duì)應(yīng)的職務(wù)信息。
接口請(qǐng)求說(shuō)明:
http請(qǐng)求方式:PUT
http://ip:port/seeyon/rest/orgLevel
創(chuàng)建數(shù)據(jù)示例:
組裝修改職務(wù)JSON數(shù)據(jù)的參數(shù)只需要職務(wù)的ID以及需要修改職務(wù)參數(shù)信息即可,示例如下:
field字段指定根據(jù)code來(lái)匹配人員,根據(jù)條件得到多個(gè)結(jié)果則會(huì)報(bào)錯(cuò)。
{
'Id': {'field':'code'}, 【必填】
'code':需要修改的職務(wù)編碼,【必填】
'description': 要修改職務(wù)參數(shù), 【必填】
}
返回說(shuō)明
正常情況下,成功會(huì)返回成功的標(biāo)識(shí)以及JSON格式職務(wù)信息,JSON數(shù)據(jù)信息請(qǐng)參考:職務(wù)創(chuàng)建更新返回對(duì)象示例
如果職務(wù)創(chuàng)建失敗,同樣會(huì)返回失敗的標(biāo)識(shí),并且在【'errorMsgs'】參數(shù)中給出創(chuàng)建失敗的原因以及JSON格式職務(wù)信息.
單位管理服務(wù)支持獲取,修改,刪除單位信息。
{
'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
}
參數(shù) | 說(shuō)明 |
---|---|
orgAccountId | 所屬單位ID |
id | ID |
name | 單位名稱 |
code | 單位編碼 |
sortId | 排序號(hào) |
shortName | 單位簡(jiǎn)稱 |
createTime | 創(chuàng)建時(shí)間 |
updateTime | 修改時(shí)間 |
isDeleted | 是否刪除 |
enabled | 是否啟用 |
status | 狀態(tài) |
description | 描述 |
path | 路徑 |
secondName | 外文名稱 |
isInternal | 是否是內(nèi)部機(jī)構(gòu) |
isGroup | 是否是集團(tuán) |
levelScope | 只對(duì)type=account有效 |
type | 類型 |
unitCategory | 機(jī)構(gòu)類型 |
fax | 傳真 |
unitMail | 郵件 |
address | 地址 |
chiefLeader | 負(fù)責(zé)人 |
zipCode | 郵編 |
telephone | 電話 |
superior | 上級(jí)單位Id,如果當(dāng)前單位為集團(tuán)則值為-1 |
superiorName | |
sortIdType | |
isCanAccess | 是否可訪問(wèn) |
childrenAccounts | |
entityType | 實(shí)體類型 |
valid | 是否合法 |
parentPath | 父單位路徑 |
開發(fā)者可以通過(guò)【單位名稱】來(lái)獲取單位信息
接口請(qǐng)求說(shuō)明:
http請(qǐng)求方式:GET
http://ip:port/seeyon/rest/orgAccount/name/{name}
參數(shù) | 是否必須 | 說(shuō)明 |
---|---|---|
name | 是 | 單位名稱【UTF-8 encode中文編碼】 |
注意:
因?yàn)閱挝幻Q是漢字所以,需要漢字做UTF-8 encode中文編碼,示例如下:
String name = URLEncoder.encode('單位名稱', 'UTF-8');
返回說(shuō)明
正常情況下,會(huì)返回的是JSON格式單位信息,JSON數(shù)據(jù)包參考:?jiǎn)挝粚?duì)象示例
參數(shù)說(shuō)明 請(qǐng)參考:單位對(duì)象屬性說(shuō)明
如果錄入的單位名稱錯(cuò)誤或者為空時(shí),返回JSON格式單位信息的為空.
開發(fā)者可以通過(guò)【單位ID】來(lái)獲取單位信息
接口請(qǐng)求說(shuō)明:
http請(qǐng)求方式:GET
http://ip:port/seeyon/rest/orgAccount/{id}
參數(shù) | 是否必須 | 說(shuō)明 |
---|---|---|
ID | 是 | 單位ID |
返回說(shuō)明
正常情況下,會(huì)返回的是JSON格式單位信息,JSON數(shù)據(jù)包參考:?jiǎn)挝粚?duì)象示例
參數(shù)說(shuō)明 請(qǐng)參考:單位對(duì)象屬性說(shuō)明
如果錄入的單位名稱錯(cuò)誤或者為空時(shí),返回JSON格式單位信息的為空.
通過(guò)單位Id取得單位的管理員(人員)信息
接口請(qǐng)求說(shuō)明:
http請(qǐng)求方式:GET
http://ip:port/seeyon/rest/orgAccount/administrator/{id}
例如
http://127.0.0.1/seeyon/rest/orgAccount/administrator/2700994180139011164
參數(shù) | 是否必須 | 說(shuō)明 |
---|---|---|
ID | 是 | 單位ID |
返回說(shuō)明
正常情況下,會(huì)返回的是JSON格式單位信息,JSON數(shù)據(jù)包參考:?jiǎn)挝粚?duì)象示例
參數(shù)說(shuō)明 請(qǐng)參考:單位對(duì)象屬性說(shuō)明
如果錄入的單位ID錯(cuò)誤或者為空時(shí),返回null,否則返回單位管理員的人員信息。
創(chuàng)建單位信息。【注意:此接口只能集團(tuán)版使用.】
接口請(qǐng)求說(shuō)明:
http請(qǐng)求方式:POST
http://ip:port/seeyon/rest/orgAccount
參數(shù) | 是否必須 | 說(shuō)明 |
---|---|---|
name | 是 | 單位名稱 |
code | 是 | 單位編碼 |
description | 是 | 單位描述 |
shortName | 是 | 單位簡(jiǎn)稱 |
sortId | 是 | 單位序號(hào) |
superior | 是 | 單位父級(jí)單位ID |
增加單位管理員后,創(chuàng)建單位格式:
Map newDep = new HashMap() {
{
put('name', 'addAccount6'); //單位名稱
put('code', '16'); //編碼
put('description', 'xxxxxxd'); //描述
put('shortName', 'test6'); //簡(jiǎn)稱
put('sortId', '8'); //排序ID
put('Superior', '-1730833917365171641'); //上級(jí)ID
}
};
//管理員信息
List reslist=new ArrayList();
Map resfg=new HashMap();
resfg.put('loginName', 'add6');//管理員登錄名
resfg.put('password', '111111');//管理員密碼
reslist.add(resfg);
newDep.put('admin', reslist);
返回說(shuō)明
正常情況下,會(huì)返回的是JSON格式單位信息,JSON數(shù)據(jù)包參考:?jiǎn)挝粚?duì)象示例
參數(shù)說(shuō)明 請(qǐng)參考:單位對(duì)象屬性說(shuō)明
如果錄入的單位ID錯(cuò)誤或者為空時(shí),返回null.
開發(fā)者獲取所有單位信息。
接口請(qǐng)求說(shuō)明:
http請(qǐng)求方式:GET
http://ip:port/seeyon/rest/orgAccounts
返回說(shuō)明
正常情況下,會(huì)返回的是JSON格式單位信息,JSON數(shù)據(jù)包參考:?jiǎn)挝粚?duì)象示例
參數(shù)說(shuō)明 請(qǐng)參考:單位對(duì)象屬性說(shuō)明
開發(fā)者可以通過(guò)單位ID刪除對(duì)應(yīng)的單位信息。
接口請(qǐng)求說(shuō)明:
http請(qǐng)求方式:DELETE
http://ip:port/seeyon/rest/orgAccount/{id}
參數(shù) | 是否必須 | 說(shuō)明 |
---|---|---|
id | 是 | 單位ID |
返回說(shuō)明
因?yàn)閯h除目前接口采用異步模式,暫無(wú)返回值信息。
開發(fā)者可以通過(guò)單位ID修改對(duì)應(yīng)的單位信息。
接口請(qǐng)求說(shuō)明:
http請(qǐng)求方式:PUT
http://ip:port/seeyon/rest/orgAccount
創(chuàng)建數(shù)據(jù)示例:
組裝修改單位JSON數(shù)據(jù)的參數(shù)只需要單位的ID以及需要修改單位參數(shù)信息即可,示例如下:
{
'Id': 需修改的單位ID, 【必填】
'description': 要修改單位參數(shù), 【必填】
}
V5.6-V6.0 增加修改單位LDAP目錄設(shè)置
Map res = new HashMap();
HashMap properties=new HashMap();
properties.put('ldapOu', 'dc=seeyon,dc=com');
res.put('properties',properties);
返回說(shuō)明
正常情況下,會(huì)返回的是JSON格式單位信息,JSON數(shù)據(jù)包參考:?jiǎn)挝粚?duì)象示例
參數(shù)說(shuō)明 請(qǐng)參考:單位對(duì)象屬性說(shuō)明
單位ID不存在,那么返回信息為空。
更新失敗,同樣會(huì)返回失敗的標(biāo)識(shí),并且在【'errorMsgs'】參數(shù)中給出創(chuàng)建失敗的原因以及JSON格式信息.
開發(fā)者可以通過(guò)指定單位ID來(lái)獲取下級(jí)單位列表.
接口請(qǐng)求說(shuō)明:
http請(qǐng)求方式:GET
http://ip:port/seeyon/rest/orgAccounts/{id}
參數(shù) | 是否必須 | 說(shuō)明 |
---|---|---|
id | 是 | 單位ID |
返回說(shuō)明
正常情況下,會(huì)返回的是JSON格式單位信息,JSON數(shù)據(jù)包參考:?jiǎn)挝粚?duì)象示例
參數(shù)說(shuō)明 請(qǐng)參考:單位對(duì)象屬性說(shuō)明
如果錄入的單位ID錯(cuò)誤或者為空時(shí),返回null
開發(fā)者可以通過(guò)指定單位ID來(lái)獲取上級(jí)單位列表.
接口請(qǐng)求說(shuō)明:
http請(qǐng)求方式:GET
http://ip:port/seeyon/rest/orgAccounts/parent/{id}
參數(shù) | 是否必須 | 說(shuō)明 |
---|---|---|
id | 是 | 單位ID |
返回說(shuō)明
正常情況下,會(huì)返回的是JSON格式單位信息,JSON數(shù)據(jù)包參考:?jiǎn)挝粚?duì)象示例
參數(shù)說(shuō)明 請(qǐng)參考:單位對(duì)象屬性說(shuō)明
如果錄入的單位ID錯(cuò)誤或者為空時(shí),返回null
開發(fā)者可以通過(guò)單位編碼修改對(duì)應(yīng)的單位信息。
接口請(qǐng)求說(shuō)明:
http請(qǐng)求方式:PUT
http://ip:port/seeyon/rest/orgAccount
創(chuàng)建數(shù)據(jù)示例:
組裝修改單位JSON數(shù)據(jù)的參數(shù)只需要單位的編碼以及需要修改單位參數(shù)信息即可,示例如下:
field字段指定根據(jù)code來(lái)匹配單位,根據(jù)條件得到多個(gè)結(jié)果則會(huì)報(bào)錯(cuò)。
{
'Id': {'field':'code'}, 【必填】
'code':要修改的單位編碼,【必填】
'description': 要修改單位參數(shù), 【必填】
}
返回說(shuō)明
正常情況下,會(huì)返回的是JSON格式單位信息,JSON數(shù)據(jù)包參考:?jiǎn)挝粚?duì)象示例
參數(shù)說(shuō)明 請(qǐng)參考:單位對(duì)象屬性說(shuō)明
開發(fā)者可以通過(guò)【單位Code】來(lái)獲取單位信息。
接口請(qǐng)求說(shuō)明:
http請(qǐng)求方式:GET
http://ip:port/seeyon/rest/orgAccount/code/{code}
參數(shù) | 是否必須 | 說(shuō)明 |
---|---|---|
code | 是 | 單位編碼 |
返回說(shuō)明
正常情況下,會(huì)返回的是JSON格式單位信息,JSON數(shù)據(jù)包參考:?jiǎn)挝粚?duì)象示例
參數(shù)說(shuō)明 請(qǐng)參考:單位對(duì)象屬性說(shuō)明
人員的創(chuàng)建、修改、刪除和查找接口。
{
'id': 710000480641633900,
'name': 's1', 【必填】
'code': '001',
'createTime':1398216937707,
'updateTime': 1398160905847,
'sortId': 1,
'isDeleted': false,
'enabled': true,
'status': 1,
'description': '說(shuō)明',
'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@seeyon.com',
'gender': 1,
'loginName': 's1',
'location': '工作地',
'reporter': '匯報(bào)人',
'hiredate': '入職時(shí)間
}
參數(shù) | 說(shuō)明 |
---|---|
id | Id,唯一標(biāo)識(shí)人員 |
name | 姓名 |
loginName | 登錄名 |
code | 人員編碼 |
createTime | 創(chuàng)建時(shí)間 |
updateTime | 更新時(shí)間 |
sortId | 排序號(hào) |
description | 說(shuō)明 |
orgAccountId | 人員所屬單位Id |
orgLevelId | 人員職務(wù)級(jí)別Id |
orgPostId | 人員崗位Id |
orgDepartmentId | 人員所屬部門Id |
second_post | 副崗 |
concurrent_post | 兼職 |
enabled | 賬戶狀態(tài):true為啟用,false為停用 |
isDeleted | 刪除標(biāo)記:true為已刪除 |
isInternal | 是否內(nèi)部人員 |
isLoginable | 是否可登錄 |
isAssigned | 是否已分配人員 |
isAdmin | 是否管理員,集團(tuán)管理員、系統(tǒng)管理員、審計(jì)管理員或單位管理員返回true,否則為false |
isValid | 是否可用:已刪除、被停用、不可登錄、未分配或離職人員返回false,否則返回true |
state | 人員狀態(tài):1為在職,2 為離職 |
status | 實(shí)體狀態(tài):1為正常、2為申請(qǐng)停用、3為申請(qǐng)刪除、4為申請(qǐng)調(diào)離;此屬性不常用,一般返回1 |
telNumber | 手機(jī)號(hào)碼 |
birthday | 出生日期 |
officeNum | 辦公電話 |
emailAddress | 電子郵件 |
gender | 性別:-1為未指定、1為男、2為女 |
location | 工作地 |
reporter | 匯報(bào)人 |
hiredate | 入職時(shí)間 |
按照登錄名獲取人員信息。
接口請(qǐng)求說(shuō)明:
http請(qǐng)求方式:GET
http://ip:port/seeyon/rest/orgMember?loginName={loginName}
如
http://127.0.0.1/seeyon/rest/orgMember?loginName=s1
參數(shù)說(shuō)明:
參數(shù) | 是否必須 | 說(shuō)明 |
---|---|---|
loginName | 是 | 人員登錄名 |
返回說(shuō)明
正常情況下,會(huì)返回的是JSON格式人員信息,JSON數(shù)據(jù)包參考:人員對(duì)象示例
參數(shù)說(shuō)明 請(qǐng)參考:人員對(duì)象屬性說(shuō)明
按照人員的Id獲取人員信息
接口請(qǐng)求說(shuō)明:
http請(qǐng)求方式:GET
http://ip:port/seeyon/rest/orgMember/{memberId}
如
http://127.0.0.1/seeyon/rest/orgMember/710000480641633932
參數(shù)說(shuō)明:
參數(shù) | 是否必須 | 說(shuō)明 |
---|---|---|
memberId | 是 | 人員Id |
返回說(shuō)明
正常情況下,會(huì)返回的是JSON格式人員信息,JSON數(shù)據(jù)包參考:人員對(duì)象示例
參數(shù)說(shuō)明 請(qǐng)參考:人員對(duì)象屬性說(shuō)明
按照人員的code獲取人員信息
接口請(qǐng)求說(shuō)明:
http請(qǐng)求方式:GET
http://ip:port/seeyon/rest/orgMembers/code/{code}
如
http://127.0.0.1/seeyon/rest/orgMembers/code/001
參數(shù)說(shuō)明:
參數(shù) | 是否必須 | 說(shuō)明 |
---|---|---|
code | 是 | 人員編號(hào) |
返回說(shuō)明
正常情況下,會(huì)返回的是JSON格式人員信息,JSON數(shù)據(jù)包參考:人員對(duì)象示例
參數(shù)說(shuō)明 請(qǐng)參考:人員對(duì)象屬性說(shuō)明
按照人員的手機(jī)號(hào)碼獲取人員信息
接口請(qǐng)求說(shuō)明:
http請(qǐng)求方式:GET
http://ip:port/seeyon/rest/orgMember/telephone/{telephoneNumber}
如
127.0.0.1/seeyon/rest/orgMember/telephone/13366666666
參數(shù)說(shuō)明:
參數(shù) | 是否必須 | 說(shuō)明 |
---|---|---|
telephoneNumber | 是 | 手機(jī)號(hào)碼 |
返回說(shuō)明
正常情況下,會(huì)返回的是JSON格式人員信息,JSON數(shù)據(jù)包參考:人員對(duì)象示例
參數(shù)說(shuō)明 請(qǐng)參考:人員對(duì)象屬性說(shuō)明
取得指定單位的所有人員(不包含停用人員)
接口請(qǐng)求說(shuō)明:
http請(qǐng)求方式:GET
http://ip:port/seeyon/rest/orgMembers/{accountId}
如
http://127.0.0.1/seeyon/rest/orgMembers/-2332227039700957764
參數(shù)說(shuō)明:
參數(shù) | 是否必須 | 說(shuō)明 |
---|---|---|
accountId | 是 | 單位Id |
返回說(shuō)明
返回JSON格式的人員對(duì)象數(shù)組。
[
{
'orgAccountId': -2332227039700957700,
'id': 710000480641633900,
'name': 's1',
'loginName': 's1'
// ...
},
{
'orgAccountId': -2332227039700957700,
'id': -889216812767428100,
'name': 's2',
'loginName': 's2'
// ...
}
]
返回值說(shuō)明
正常情況下,會(huì)返回的是JSON格式人員信息,JSON數(shù)據(jù)包參考:人員對(duì)象示例
參數(shù)說(shuō)明 請(qǐng)參考:人員對(duì)象屬性說(shuō)明
取得指定單位的所有人員(包含停用人員)
接口請(qǐng)求說(shuō)明:
http請(qǐng)求方式:GET
http://ip:port/seeyon/rest/orgMembers/all/{accountId}
如
http://127.0.0.1/seeyon/rest/orgMembers/all/-2332227039700957764
參數(shù)說(shuō)明:
參數(shù) | 是否必須 | 說(shuō)明 |
---|---|---|
accountId | 是 | 單位Id |
返回說(shuō)明
正常情況下,會(huì)返回的是JSON格式人員信息,JSON數(shù)據(jù)包參考:人員對(duì)象示例
參數(shù)說(shuō)明 請(qǐng)參考:人員對(duì)象屬性說(shuō)明
取得指定單位的所有人員總數(shù)(不包含停用人員)
接口請(qǐng)求說(shuō)明:
http請(qǐng)求方式:GET
http://ip:port/seeyon/rest/orgMembers/count/{accountId}
如
http://127.0.0.1/seeyon/rest/orgMembers/count/-2332227039700957764
參數(shù)說(shuō)明:
參數(shù) | 是否必須 | 說(shuō)明 |
---|---|---|
accountId | 是 | 單位Id |
返回說(shuō)明
正常情況下,會(huì)返回的是JSON格式人員信息,JSON數(shù)據(jù)包參考:人員對(duì)象示例
參數(shù)說(shuō)明 請(qǐng)參考:人員對(duì)象屬性說(shuō)明
取得指定單位的所有人員總數(shù)(包含停用人員)
接口請(qǐng)求說(shuō)明:
http請(qǐng)求方式:GET
http://ip:port/seeyon/rest/orgMembers/all/count/{accountId}
如
http://127.0.0.1/seeyon/rest/orgMembers/all/count/-2332227039700957764
參數(shù)說(shuō)明:
參數(shù) | 是否必須 | 說(shuō)明 |
---|---|---|
accountId | 是 | 單位Id |
返回說(shuō)明
返回JSON整數(shù)。
取指定部門的所有人員,不包含停用人員。
接口請(qǐng)求說(shuō)明:
http請(qǐng)求方式:GET
http://ip:port/seeyon/rest/orgMembers/department/{departmentId}
如
http://127.0.0.1/seeyon/rest/orgMembers/department/8422701464295850729?firstLayer=false
參數(shù)說(shuō)明:
參數(shù) | 是否必須 | 說(shuō)明 |
---|---|---|
departmentId | 是 | 部門Id |
firstLayer | 否 | 只取當(dāng)前部門人員,不包含子部門,缺省為true |
返回說(shuō)明
返回JSON格式的人員對(duì)象數(shù)組。
[
{
'orgAccountId': -2332227039700957700,
'id': 710000480641633900,
'name': 's1',
'loginName': 's1'
// ...
},
{
'orgAccountId': -2332227039700957700,
'id': -889216812767428100,
'name': 's2',
'loginName': 's2'
// ...
}
]
返回值說(shuō)明
正常情況下,會(huì)返回的是JSON格式人員信息,JSON數(shù)據(jù)包參考:人員對(duì)象示例
參數(shù)說(shuō)明 請(qǐng)參考:人員對(duì)象屬性說(shuō)明
取指定崗位的所有人員,不包含停用人員。
接口請(qǐng)求說(shuō)明:
http請(qǐng)求方式:GET
http://ip:port/seeyon/rest/orgMembers/post/{postId}
如
http://127.0.0.1/seeyon/rest/orgMembers/post/-2779802668474544380
參數(shù)說(shuō)明:
參數(shù) | 是否必須 | 說(shuō)明 |
---|---|---|
postId | 是 | 崗位Id |
返回說(shuō)明
返回JSON格式的人員對(duì)象數(shù)組。
[
{
'orgAccountId': -2332227039700957700,
'id': 710000480641633900,
'name': 's1',
'loginName': 's1'
// ...
},
{
'orgAccountId': -2332227039700957700,
'id': -889216812767428100,
'name': 's2',
'loginName': 's2'
// ...
}
]
返回值說(shuō)明
正常情況下,會(huì)返回的是JSON格式人員信息,JSON數(shù)據(jù)包參考:人員對(duì)象示例
參數(shù)說(shuō)明 請(qǐng)參考:人員對(duì)象屬性說(shuō)明
取指定職務(wù)級(jí)別的所有人員,不包含停用人員。
接口請(qǐng)求說(shuō)明:
http請(qǐng)求方式:GET
http://ip:port/seeyon/rest/orgMembers/level/{levelId}
如
http://127.0.0.1/seeyon/rest/orgMembers/level/3176188816548513663
參數(shù)說(shuō)明:
參數(shù) | 是否必須 | 說(shuō)明 |
---|---|---|
leveld | 是 | 職務(wù)級(jí)別Id |
返回說(shuō)明
返回JSON格式的人員對(duì)象數(shù)組。
[
{
'orgAccountId': -2332227039700957700,
'id': 710000480641633900,
'name': 's1',
'loginName': 's1'
// ...
},
{
'orgAccountId': -2332227039700957700,
'id': -889216812767428100,
'name': 's2',
'loginName': 's2'
// ...
}
]
返回值說(shuō)明
正常情況下,會(huì)返回的是JSON格式人員信息,JSON數(shù)據(jù)包參考:人員對(duì)象示例
參數(shù)說(shuō)明 請(qǐng)參考:人員對(duì)象屬性說(shuō)明
按照人員的姓名查找人員。
接口請(qǐng)求說(shuō)明:
http請(qǐng)求方式:GET
http://ip:port/seeyon/rest/orgMembers/name/{name}
如
http://127.0.0.1/seeyon/rest/orgMembers/name/%E5%A7%93%E5%90%8D
參數(shù)說(shuō)明:
參數(shù) | 是否必須 | 說(shuō)明 |
---|---|---|
name | 是 | 人員姓名,中文必須使用UTF-8進(jìn)行編碼,如“姓名”編碼后為“%E5%A7%93%E5%90%8D” |
返回說(shuō)明
正常情況下,會(huì)返回的是JSON格式人員信息,JSON數(shù)據(jù)包參考:人員對(duì)象示例
參數(shù)說(shuō)明 請(qǐng)參考:人員對(duì)象屬性說(shuō)明
創(chuàng)建人員。
接口請(qǐng)求說(shuō)明:
http請(qǐng)求方式:POST
http://ip:port/seeyon/rest/orgMember
如
http://127.0.0.1/seeyon/rest/orgMember
參數(shù)說(shuō)明:
使用HTTP請(qǐng)求的Body傳入JSON格式的人員信息
{
Map newMember = new HashMap() {
{
put('orgAccountId', '-4532703988283521957'); //單位ID
put('orgDepartmentId', '3034473275669826764');//部門ID
put('orgLevelId', '-4560829651911226401');//職務(wù)ID
put('orgPostId', '-1185154002310052488');//崗位ID
put('code', '26');//編號(hào)
put('name', '夏強(qiáng)6');//姓名
// put('sortId', 1);//排序號(hào) V5.6最新版本后可以不用錄入此參數(shù)
put('telNumber', '13551001572');//移動(dòng)電話
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');//需要設(shè)置 副崗人員ID
resfg.put('deptId', '3034473275669826764');//指定副崗所在部門ID(副崗范圍是部門下已經(jīng)存在人員所設(shè)置的主崗中來(lái)選擇)
resfg.put('postId', '-8953437412957663435');//指定副崗ID
resfg.put('orgAccountId', '-4532703988283521957');//單位ID
reslist.add(resfg);
newMember.put('second_post', reslist);
}
V7.1支持通過(guò)單位、部門、職務(wù)和崗位編碼設(shè)置人員信息,包括副崗中的單位、部門、職務(wù)和崗位,且兼容之前通過(guò)id設(shè)置人員信息。使用編碼設(shè)置人員信息示例如下:
{
Map newMember = new HashMap() {
{
put('orgAccountId', new HashMap(){{put('code','1');}}); //單位編碼
put('orgDepartmentId', new HashMap(){{put('code','1');}});//部門編碼
put('orgLevelId', new HashMap(){{put('code','1');}});//職務(wù)編碼
put('orgPostId', new HashMap(){{put('code','1');}});//崗位編碼
}
};
}
返回說(shuō)明
返回JSON格式。
success為true則創(chuàng)建成功
{
'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
}
批量創(chuàng)建人員。
接口請(qǐng)求說(shuō)明:
http請(qǐng)求方式:POST
http://ip:port/seeyon/rest/orgMember/addMembers
如
http://127.0.0.1/seeyon/rest/orgMember/addMembers
參數(shù)說(shuō)明:
將批量新建人員(Since:V61))中人員Map放入List中即可。
List members=new ArrayList();
Map newMember = new HashMap() {
...
}
members.add(newMember);
client.post('orgMember/updateMembers',members,String.class);
V7.1支持通過(guò)單位、部門、職務(wù)和崗位編碼設(shè)置人員信息,詳情請(qǐng)參考新建人員(V6.0增加了副崗信息))中的編碼使用說(shuō)明。
返回說(shuō)明
創(chuàng)建人員成功則返回JSON格式人員信息。
按人員Id修改人員信息
接口請(qǐng)求說(shuō)明:
http請(qǐng)求方式:PUT
http://ip:port/seeyon/rest/orgMember
如
http://127.0.0.1/seeyon/rest/orgMember
參數(shù)說(shuō)明:
使用HTTP請(qǐng)求的Body傳入JSON格式的人員信息
id必填,支持新建人員參數(shù)說(shuō)明中所有參數(shù),必須至少指定一項(xiàng)
{
'id': 7115200831996735909, //【必填】
'sortId': 20,
'orgAccountId': 144, //【必填】
'enabled': true
}
5.6版以后支持按編碼修改人員信息,此處id的類型由Long改為對(duì)象,field字段指定根據(jù)code來(lái)匹配人員,根據(jù)條件得到多個(gè)結(jié)果則會(huì)報(bào)錯(cuò)。
{
'id': { 'field' : 'code' },
'code': '001',
'password': 'abcdef'
}
V5.6后增加了副崗信息信息的修改,具體參數(shù)請(qǐng)參照創(chuàng)建人員中副崗信息。
V5.6-V6.0增加了人員LDAP目錄設(shè)置
res.put('ldapbind', 'cn=paul.chen,ou=users,dc=seeyon,dc=com')
V7.1支持通過(guò)單位、部門、職務(wù)和崗位編碼設(shè)置人員信息,詳情請(qǐng)參考新建人員(V6.0增加了副崗信息))中的編碼使用說(shuō)明。
返回說(shuō)明
返回JSON格式。
指定人員未存在返回null。
返回結(jié)果的說(shuō)明參見新建人員。
通過(guò)人員Id批量修改人員信息
接口請(qǐng)求說(shuō)明:
http請(qǐng)求方式:POST
http://ip:port/seeyon/rest/orgMember/updateMembers
如
http://127.0.0.1/seeyon/rest/orgMember/updateMembers
參數(shù)說(shuō)明:
將需要修改的多人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支持通過(guò)單位、部門、職務(wù)和崗位編碼設(shè)置人員信息,詳情請(qǐng)參考新建人員(V6.0增加了副崗信息))中的編碼使用說(shuō)明。
返回說(shuō)明
更新人員成功則返回JSON格式人員信息。
按人員Id修改人員啟用和停用狀態(tài)
接口請(qǐng)求說(shuō)明:
http請(qǐng)求方式:PUT
http://ip:port/seeyon/rest/orgMember/{id}/enabled/{enabled}
如
http://127.0.0.1/seeyon/rest/orgMember/-757960293000589356/enabled/true
參數(shù)說(shuō)明:
參數(shù) | 是否必須 | 說(shuō)明 |
---|---|---|
id | 是 | 人員Id |
enbaled | 是 | 人員狀態(tài):true為啟用,false為停用 |
返回說(shuō)明
返回JSON格式。
指定人員未存在返回null。
返回結(jié)果的說(shuō)明參見新建人員。
按人員Id刪除人員
接口請(qǐng)求說(shuō)明:
http請(qǐng)求方式:DELETE
http://ip:port/seeyon/rest/orgMember/{memberId}
如
http://127.0.0.1/seeyon/rest/orgMember/-757960293000589356
參數(shù)說(shuō)明:
參數(shù) | 是否必須 | 說(shuō)明 |
---|---|---|
memberId | 是 | 人員Id |
返回說(shuō)明
返回JSON格式。
指定人員未存在返回null。
返回結(jié)果的說(shuō)明參見新建人員。
開發(fā)者可以通過(guò)【人員登錄名和密碼】來(lái)驗(yàn)證當(dāng)前人員有效性。
接口請(qǐng)求說(shuō)明:
http請(qǐng)求方式:GET
http://127.0.0.1/seeyon/rest/orgMember/effective/loginName/{loginName}?password=xxxxxx
參數(shù)說(shuō)明:
參數(shù) | 是否必須 | 說(shuō)明 |
---|---|---|
loginName | 是 | 登錄名 |
password | 是 | 密碼 |
返回說(shuō)明
返回true為有效,false為無(wú)效。
開發(fā)者可以通過(guò)【部門ID】來(lái)獲取指定部門下所有人員總數(shù)。
接口請(qǐng)求說(shuō)明:
http請(qǐng)求方式:GET
http://ip:port/seeyon/rest/orgMembers/department/count/{departmentId}?firstLayer=false/true;
參數(shù)說(shuō)明:
參數(shù) | 是否必須 | 說(shuō)明 |
---|---|---|
departmentId | 是 | 部門ID |
firstLayer | 否 | true是只顯示直屬子部門,false是包含所有層級(jí)的部門 |
返回說(shuō)明
返回JSON整數(shù)。
開發(fā)者可以批量更新和新增人員。
接口請(qǐng)求說(shuō)明:
http請(qǐng)求方式:PUT
http://ip:port/seeyon/rest/orgMembers
參數(shù)說(shuō)明:
新建與更新的人員參數(shù)同
請(qǐng)求多人信息可以存放在List中傳遞。
V7.1支持通過(guò)單位、部門、職務(wù)和崗位編碼設(shè)置人員信息,詳情請(qǐng)參考新建人員(V6.0增加了副崗信息))中的編碼使用說(shuō)明。
返回說(shuō)明
正常情況下,會(huì)返回的是JSON格式人員信息,JSON數(shù)據(jù)包參考:人員對(duì)象示例
參數(shù)說(shuō)明 請(qǐng)參考:人員對(duì)象屬性說(shuō)明
開發(fā)者可以批量刪除人員。
接口請(qǐng)求說(shuō)明:
http請(qǐng)求方式:PUT
http://ip:port/seeyon/rest/orgMembers/batchdelete
參數(shù)說(shuō)明:
參數(shù) | 是否必須 | 說(shuō)明 |
---|---|---|
memberId | 是 | 人員Id |
...
Map Post = new HashMap();
Map Post2 = new HashMap();
List li=new ArrayList();
..
Post.put('id', id1);
Post2.put('id', id2);
..
li.add(Post);
li.add(Post2);
返回說(shuō)明
返回JSON格式。 指定人員未存在返回null。 返回結(jié)果的說(shuō)明參見新建人員。
開發(fā)者可以處理離職人員。
接口請(qǐng)求說(shuō)明:
http請(qǐng)求方式:PUT
http://ip:port/seeyon/rest/orgMember/leave/{memberId}/{agentMemberId}
例如:
http://ip:port/seeyon/rest/orgMember/leave/12315646574656/7894561616687111
參數(shù)說(shuō)明:
參數(shù) | 是否必填 | 說(shuō)明 |
---|---|---|
memberId | 是 | 離職人員Id |
agentMemberId | 是 | 代理人Id,0:清空代理人、-1或代理人無(wú)效:不做代理人設(shè)置處理,維持現(xiàn)狀、不為空且代理人有效,設(shè)置所有代辦事項(xiàng)的代理人為此人 |
CTPRestClient client = RestResource.getInstance().resouresClent();
client.post('orgMember/leave/12315646574656/7894561616687111', new HashMap(), String.class);
返回說(shuō)明
返回JSON格式。 組織模型實(shí)體操作息類。
外部單位服務(wù)管理(Since:V6.0)外部單位服務(wù)支持獲取當(dāng)前單位下所建立的外部單位信息。
{
'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
}
參數(shù) | 說(shuō)明 |
---|---|
orgAccountId | 外部單位所屬的單位ID |
id | ID |
name | 名稱 |
code | 編碼 |
createTime | 創(chuàng)建時(shí)間 |
updateTime | 更新時(shí)間 |
sortId | 序號(hào) |
enabled | 是否啟用 |
path | 路徑 |
type | 類型 |
wholeName |
可以通過(guò)【單位ID】來(lái)獲取所屬的外部單位信息。
接口請(qǐng)求說(shuō)明:
http請(qǐng)求方式:GET
http://ip:port/seeyon/rest/externalAccounts/{AccountId}
參數(shù)說(shuō)明:
參數(shù) | 是否必須 | 說(shuō)明 |
---|---|---|
AccountId | 是 | 單位ID |
返回說(shuō)明
正常情況下,會(huì)返回的是JSON格式外部單位信息,JSON數(shù)據(jù)包參考:外部單位對(duì)象實(shí)例.
參數(shù)說(shuō)明 請(qǐng)參考:對(duì)象屬性說(shuō)明
外部人員服務(wù)管理(Since:V6.0)外部人員服務(wù)支持獲取外部人員信息,以及增加和刪除外部人員信息。
{
'orgAccountId' : 3781960798631511882,
'id' : 5948516634567462597,
'name' : '外部人員名稱',【必填】
'code' : 'wb1',
'createTime' : 1441953325000,
'updateTime' : 1441953325000,
'sortId' : 1,
'isDeleted' : false,
'enabled' : true,
'status' : 1,
'description' : '說(shuō)明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:外部職務(wù),',
'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
}
參數(shù) | 說(shuō)明 |
---|---|
orgAccountId | 單位ID |
extAccountName | 單位名稱 |
orgDepartmentId | 部門ID |
extWorkScopeValue | 工作范圍對(duì)應(yīng)部門 |
extRoles | 外部人員權(quán)限 |
extRoleIds | 權(quán)限ID |
extWorkScope | 工作范圍對(duì)應(yīng)部門 |
code | 編號(hào) |
name | 姓名 |
sortId | 排序號(hào) |
isInternal | |
isChangePWD | |
isLoginNameModifyed | |
isNewLdap | |
isNewMember | |
loginName | 登錄名 |
password | 密碼 |
password2 | 密碼 |
primaryLanguange | 語(yǔ)言類型 |
enabled | 啟用 |
orgPostId | |
orgLevelId | |
telnumber | 移動(dòng)電話 |
officenumber | 辦公電話 |
emailaddress | 電子郵件 |
extgender | 性別 |
extAccountName | 所在外單位 |
birthday | 生日 |
extlevelName | 外部職務(wù) |
extprimaryPost | 外部崗位 |
可以通過(guò)【外部單位ID】來(lái)獲取所屬的外部單位下的外部人員。
接口請(qǐng)求說(shuō)明:
http請(qǐng)求方式:GET
http://ip:port/seeyon/rest/externalMembers/externalAccountId/{externalAccountId}
參數(shù)說(shuō)明:
參數(shù) | 是否必須 | 說(shuō)明 |
---|---|---|
externalAccountId | 是 | 外部單位ID |
返回說(shuō)明
正常情況下,會(huì)返回的是JSON格式外部人員信息,JSON數(shù)據(jù)包參考:外部人員對(duì)象實(shí)例
參數(shù)說(shuō)明 請(qǐng)參考:對(duì)象屬性說(shuō)明
可以通過(guò)【單位ID】來(lái)獲取所屬的外部單位下的外部人員。
接口請(qǐng)求說(shuō)明:
http請(qǐng)求方式:GET
http://ip:port/seeyon/rest/externalMembers/accountId/{accountId}
參數(shù)說(shuō)明:
參數(shù) | 是否必須 | 說(shuō)明 |
---|---|---|
accountId | 是 | 單位ID |
返回說(shuō)明
正常情況下,會(huì)返回的是JSON格式外部人員信息,JSON數(shù)據(jù)包參考:外部人員對(duì)象實(shí)例
參數(shù)說(shuō)明 請(qǐng)參考:對(duì)象屬性說(shuō)明
可以通過(guò)【外部人員登錄名】來(lái)獲取所屬的外部人員信息。
接口請(qǐng)求說(shuō)明:
http請(qǐng)求方式:GET
http://ip:port/seeyon/rest/externalMembers/loginName/{loginName}
參數(shù)說(shuō)明:
參數(shù) | 是否必須 | 說(shuō)明 |
---|---|---|
loginName | 是 | 外部人員登錄名 |
返回說(shuō)明
正常情況下,會(huì)返回的是JSON格式外部人員信息,JSON數(shù)據(jù)包參考:外部人員對(duì)象實(shí)例
參數(shù)說(shuō)明 請(qǐng)參考:對(duì)象屬性說(shuō)明
可以通過(guò)【外部人員ID】來(lái)獲取所屬的外部人員信息
接口請(qǐng)求說(shuō)明:
http請(qǐng)求方式:GET
http://ip:port/seeyon/rest/externalMembers/externalMemberId/{externalMemberId}?accountId={accountId}
參數(shù)說(shuō)明:
參數(shù) | 是否必須 | 說(shuō)明 |
---|---|---|
externalMemberId | 是 | 外部人員ID |
返回說(shuō)明
正常情況下,會(huì)返回的是JSON格式外部人員信息,JSON數(shù)據(jù)包參考:外部人員對(duì)象實(shí)例
參數(shù)說(shuō)明 請(qǐng)參考:對(duì)象屬性說(shuō)明
創(chuàng)建外部人員信息。
接口請(qǐng)求說(shuō)明:
http請(qǐng)求方式:POST
http://ip:port/seeyon/rest/externalMembers/
Map newMember = new HashMap() {
{
put('orgAccountId', '3781960798631511882'); //單位ID---
put('extAccountName', '外部單位1,'); //單位名稱---
put('orgDepartmentId', '-1970889903265267124');//部門ID--
put('extWorkScopeValue', 'Department|-1770506021266306174');//--工作范圍對(duì)應(yīng)部門
put('extRoles', '外部人員權(quán)限');//權(quán)限 --
put('extRoleIds', '4649394686314365441');//權(quán)限ID
put('extWorkScope', '部門1,');//--工作范圍對(duì)應(yīng)部門
put('code', '568');//編號(hào)--
put('name', 'cs55');//姓名--
put('sortId', 4);//排序號(hào) --
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');//移動(dòng)電話--
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', '外部職務(wù)');//職務(wù)ID--
newMember.put('extprimaryPost', '外部崗位');//崗位ID--
返回說(shuō)明
成功,返回的是新創(chuàng)建人員的ID。 失敗,返回空。
可以通過(guò)【外部人員ID】來(lái)刪除的外部人員信息。
接口請(qǐng)求說(shuō)明:
http請(qǐng)求方式:DELETE
http://ip:port/seeyon/rest/externalMembers/{externalMemberId}
參數(shù)說(shuō)明:
參數(shù) | 是否必須 | 說(shuō)明 |
---|---|---|
externalMemberId | 是 | 外部人員ID |
返回說(shuō)明
正常情況下,刪除成功返回true,失敗返回FALSE。
兼職服務(wù)管理(Since:V5.6 -V6.0)兼職服務(wù)管理支持對(duì)于單位兼職信息的查詢與新建等操作。
{
'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', //職務(wù)ID
'objective3Id': null,
'objective4Id': null,
'objective7Id': '-2674129842350898190,'//權(quán)限ID
},
'conMemberName': '李世民(V56SP1)',
'souAccountName': 'V56SP1',
'souPAnames': '程序員(V56SP1)',
'conPostCode': '1',
'tarAccountName': 'addAccount2',
'tarDPAnames': 'add2-管理部-add2-行政崗位ie',
'conSortId': '1'
}
參數(shù) | 說(shuō)明 |
---|---|
id | 兼職ID |
orgAccountId | 單位ID |
sortId | 排序 |
sourceId | |
objective6Id | |
objective0Id | 部門ID |
objective1Id | 崗位ID |
objective5Id | |
objective2Id | 職務(wù)ID |
objective3Id | |
objective4Id | |
objective7Id | 權(quán)限ID |
conMemberName | 人名(原單位簡(jiǎn)稱) |
souAccountName | 原單位名稱 |
souPAnames | 原崗位名稱(原單位簡(jiǎn)稱) |
tarAccountName | 兼職單位名稱 |
tarDPAnames | 兼職單位部門-兼職單位崗位 |
獲取兼職列表信息(以翻頁(yè)模式返回)
接口請(qǐng)求說(shuō)明:
http請(qǐng)求方式:GET
http://ip:port/seeyon/rest/orgPartTimeJob/list?pageNo={pageNo}&pageSize={pageSize}
參數(shù)說(shuō)明:
參數(shù) | 是否必須 | 說(shuō)明 |
---|---|---|
pageNo | 是 | 列表第一條開始的位置號(hào),“0”為第一條 |
pageSize | 是 | 獲取列表?xiàng)l數(shù) |
返回說(shuō)明
正常情況下,會(huì)返回的是JSON格式兼職信息,JSON數(shù)據(jù)包參考:兼職對(duì)象實(shí)例
參數(shù)說(shuō)明 請(qǐng)參考:對(duì)象屬性說(shuō)明
通過(guò)CODE 獲取對(duì)外單位兼職信息
接口請(qǐng)求說(shuō)明:
http請(qǐng)求方式:GET
http://ip:port/seeyon/rest/orgPartTimeJob/foreignlist?condition=type%3D\'input\',condition%3D\'cCode\',value%3D\'(code)\'&accountid={accountid}
參數(shù)說(shuō)明:
參數(shù) | 是否必須 | 說(shuō)明 |
---|---|---|
type=input | 是 | 條件固定值 |
condition=cCode | 是 | 條件類型{cCode=通過(guò)code查詢,除外還可以通過(guò)名字查詢cMemberName} |
value={code} | 是 | 編號(hào)值 |
accountid | 是 | 單位ID |
返回說(shuō)明
正常情況下,會(huì)返回的是JSON格式兼職信息,JSON數(shù)據(jù)包參考:兼職對(duì)象實(shí)例
參數(shù)說(shuō)明 請(qǐng)參考:對(duì)象屬性說(shuō)明
通過(guò)CODE 獲取對(duì)本單位兼職信息
接口請(qǐng)求說(shuō)明:
http請(qǐng)求方式:GET
http://ip:port/seeyon/rest/orgPartTimeJob/insidelist?condition=type%3D\'input\',condition%3D\'cCode\',value%3D\'(code)\'&accountid={accountid}
參數(shù)說(shuō)明:
參數(shù) | 是否必須 | 說(shuō)明 |
---|---|---|
type=input | 是 | 條件固定值 |
condition=cCode | 是 | 條件類型{cCode=通過(guò)code查詢,除外還可以通過(guò)名字查詢cMemberName} |
value={code} | 是 | 編號(hào)值 |
accountid | 是 | 單位ID |
返回說(shuō)明
正常情況下,會(huì)返回的是JSON格式兼職信息,JSON數(shù)據(jù)包參考:兼職對(duì)象實(shí)例
參數(shù)說(shuō)明 請(qǐng)參考:對(duì)象屬性說(shuō)明
通過(guò)ID 獲取兼職信息
接口請(qǐng)求說(shuō)明:
http請(qǐng)求方式:GET
http://ip:port/seeyon/rest/orgPartTimeJob/{id}
參數(shù)說(shuō)明:
參數(shù) | 是否必須 | 說(shuō)明 |
---|---|---|
id | 是 | 兼職ID |
返回說(shuō)明
正常情況下,會(huì)返回的是JSON格式兼職信息,JSON數(shù)據(jù)包參考:兼職對(duì)象實(shí)例
參數(shù)說(shuō)明 請(qǐng)參考:對(duì)象屬性說(shuō)明
新建兼職信息
接口請(qǐng)求說(shuō)明:
http請(qǐng)求方式:POST
http://ip:port/seeyon/rest/orgPartTimeJob
新增所需參數(shù)::
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');//兼職職務(wù)ID
res.put('cRoleIds', '-2674129842350898190');//兼職權(quán)限ID
res.put('cMember', '2015(56sp1)');//人名(原單位簡(jiǎn)稱)
res.put('sortId', '');
res.put('code', '4');
res.put('primaryPost', '技術(shù)(56sp1)');//原崗位名稱(原單位簡(jiǎn)稱)
res.put('cAccount', 'addAccount2');//兼職單位名稱
res.put('cDept', 'add2-管理部(test2)');//兼職單位部門名稱(兼職單位簡(jiǎn)稱)
res.put('cPost', 'add2-行政崗位ie(test2)');//兼職單位部門名稱(兼職單位簡(jiǎn)稱)
res.put('cLevel', 'dd2-經(jīng)理職務(wù)');//兼職單位職務(wù)名稱
res.put('cRoles', '普通人員權(quán)限');//兼職單位權(quán)限名稱
返回說(shuō)明
正常情況下,會(huì)返回的是JSON格式兼職信息,JSON數(shù)據(jù)包參考:兼職對(duì)象實(shí)例
參數(shù)說(shuō)明 請(qǐng)參考:對(duì)象屬性說(shuō)明
按照兼職ID刪除兼職
接口請(qǐng)求說(shuō)明:
http請(qǐng)求方式:DELETE
http://ip:port/seeyon/rest/orgPartTimeJob/delete/{ID}
參數(shù)說(shuō)明:
參數(shù) | 是否必須 | 說(shuō)明 |
---|---|---|
id | 是 | 兼職ID |
返回說(shuō)明
正常情況下,會(huì)返回的是JSON格式兼職信息,JSON數(shù)據(jù)包參考:兼職對(duì)象實(shí)例
參數(shù)說(shuō)明 請(qǐng)參考:對(duì)象屬性說(shuō)明
修改兼職信息
接口請(qǐng)求說(shuō)明:
http請(qǐng)求方式:PUT
http://ip:port/seeyon/rest/orgPartTimeJob
修改相關(guān)參數(shù):
res.put('id', '-717933079254446538');//更新是刪除收插入,此ID 更新注意org_relationship表ID變化
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');//兼職職務(wù)ID
res.put('cRoleIds', '-2674129842350898190');//兼職權(quán)限ID
res.put('cMember', '2015(56sp1)');//人名(原單位簡(jiǎn)稱)
res.put('sortId', '');
res.put('code', '6');
res.put('primaryPost', '技術(shù)(56sp1)');//原崗位名稱(原單位簡(jiǎn)稱)
res.put('cAccount', 'addAccount2');//兼職單位名稱
res.put('cDept', 'add2-管理部(test2)');//兼職單位部門名稱(兼職單位簡(jiǎn)稱)
res.put('cPost', 'add2-行政崗位ie(test2)');//兼職單位部門名稱(兼職單位簡(jiǎn)稱)
res.put('cLevel', 'dd2-經(jīng)理職務(wù)');//兼職單位職務(wù)名稱
res.put('cRoles', '普通人員權(quán)限');//兼職單位權(quán)限名稱
返回說(shuō)明
正常情況下,會(huì)返回的是JSON格式兼職信息,JSON數(shù)據(jù)包參考:兼職對(duì)象實(shí)例
參數(shù)說(shuō)明 請(qǐng)參考:對(duì)象屬性說(shuō)明
權(quán)限服務(wù)管理支持對(duì)于權(quán)限信息的查詢等操作。
{
'type': 2,
'valid': true,
'entityType': 'Role',
'category': '1',
'showName': '普通人員權(quán)限',
'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'
}
參數(shù) | 說(shuō)明 |
---|---|
id | 權(quán)限ID |
name | 名稱 |
sortId | 排序 |
isBenchmark | |
showName | 名稱 |
status | 狀態(tài) |
entityType | 類型 |
code | 編碼 |
orgAccountId | 單位ID |
enabled | 是否啟用 |
type |
根據(jù)單位ID獲取權(quán)限列表
接口請(qǐng)求說(shuō)明:
http請(qǐng)求方式:GET
http://ip:port/seeyon/rest/role/accountrole/{accountId}
參數(shù)說(shuō)明:
參數(shù) | 是否必須 | 說(shuō)明 |
---|---|---|
accountId | 是 | 單位ID |
返回說(shuō)明
正常情況下,會(huì)返回的是JSON格式權(quán)限信息,JSON數(shù)據(jù)包參考:權(quán)限對(duì)象實(shí)例
參數(shù)說(shuō)明 請(qǐng)參考:對(duì)象屬性說(shuō)明
以集團(tuán)管理員是身份添加部門角色.
接口請(qǐng)求說(shuō)明
http請(qǐng)求方式:POST
http://ip:port/seeyon/rest/role/addDepartMentRole
創(chuàng)建數(shù)據(jù)示例:
Map data = new HashMap() {
{
put('name', '部門角色名稱');
put('code','編碼');
put('sortId','10');
}
};
client.post('role/addDepartMentRole', data, String.class);
返回說(shuō)明
創(chuàng)建角色成功則返回角色I(xiàn)D。
根據(jù)部門id,獲取部門下的所有部門角色
接口請(qǐng)求說(shuō)明
http請(qǐng)求方式:GET
http://ip:port/seeyon/rest/role/departmentRole/{departmentId}
參數(shù)說(shuō)明:
參數(shù) | 是否必須 | 說(shuō)明 |
---|---|---|
departmentId | 是 | 部門ID |
返回說(shuō)明
請(qǐng)求成功,返回部門下對(duì)應(yīng)角色JSON信息。
根據(jù)部門id 和角色id 獲取部門下對(duì)應(yīng)的角色人員.
接口請(qǐng)求說(shuō)明
http請(qǐng)求方式:GET
http://ip:port/seeyon/rest/role/departmentRoleMembers/{departmentId}/{roleId}
參數(shù)說(shuō)明:
參數(shù) | 是否必須 | 說(shuō)明 |
---|---|---|
departmentId | 是 | 部門ID |
roleId | 是 | 角色I(xiàn)D(org_role表ID) |
返回說(shuō)明
請(qǐng)求成功,返回部門下對(duì)應(yīng)角色人員的JSON信息。
根據(jù)部門id 和角色id 更新部門下對(duì)應(yīng)的角色人員.
接口請(qǐng)求說(shuō)明
http請(qǐng)求方式:POST
http://ip:port/seeyon/rest/role/updateDepartmentRoleMember
創(chuàng)建數(shù)據(jù)示例:
Map data = new HashMap() {
{
put('deptId','5485888616457063756');//部門ID
put('roleId','8985889456139161281');//權(quán)限ID
put('memberIds','2611992240500982806,-7260678671148761009');//設(shè)置的人員ID
}
};
client.post('role/updateDepartmentRoleMember', data, String.class);
返回說(shuō)明
跟新角色人員成功則返回成功提示。
聯(lián)系客服