組織模型管理 · 致遠(yuǎn)開放平臺(tái)

{
    '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
}

1.1.2. 返回值說明

參數(shù)	說明
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í)體

1.1.3. 狀態(tài)碼

參數(shù)	說明
ACCOUNT_CUSTOM_LOGIN_URL_DUPLICATED	單位自定義登錄頁地址不能重復(fù)
ACCOUNT_EXIST_CHILDACCOUNT	單位下存在未刪除的子單位
ACCOUNT_EXIST_CHILDACCOUNT_ENABLE	單位存在有效子單位不允許停用
ACCOUNT_EXIST_DEPARTMENT	單位下存在未刪除的部門
ACCOUNT_EXIST_DEPARTMENT_ENABLE	單位存在有效的部門不允許停用
ACCOUNT_EXIST_ENTITY	單位下存在未刪除的組織模型實(shí)體
ACCOUNT_EXIST_LEVEL	單位下存在未刪除的職務(wù)級別
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ù)版--職級存在成員
LEVEL_EXIST_MAPPING	存在職務(wù)級別的映射
LEVEL_EXIST_MEMBER	職務(wù)存在成員
LEVEL_REPEAT_NAME	存在職務(wù)級別的映射
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ù)量大于單位剩余的可注冊數(shù)量，不允許添加人員！
POST_EXIST_BENCHMARK	基準(zhǔn)崗位已引用
POST_EXIST_MEMBER	崗位存在成員
POST_REPEAT_NAME	崗位名稱重復(fù)
PRINCIPAL_NOT_EXIST	登錄名不存在
PRINCIPAL_REPEAT_NAME	人員賬號名稱重復(fù)
REPEAT_PATH	PATH重復(fù)
ROLE_NOT_EXIST	角色不存在
SUCCESS	完全成功

1.2. 部門管理

部門管理服務(wù)支持獲取，創(chuàng)建，修改，刪除部門數(shù)據(jù)。

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
}

部門對象屬性說明

參數(shù)	說明
orgAccountId	所屬單位ID
id	ID
name	部門名稱
code	部門代碼
sortId	排序號
shortName	單位簡稱
createTime	創(chuàng)建時(shí)間
updateTime	修改時(shí)間
isDeleted	是否刪除
enabled	是否啟用
status	狀態(tài)
description	描述
path	路徑
secondName	外文名稱，對部門無效，保留字段
isInternal	是否是內(nèi)部機(jī)構(gòu)
isGroup	是否是集團(tuán)
levelScope	只對type=account有效
type	類型
fax	傳真
unitMail	郵件
address	地址
chiefLeader	負(fù)責(zé)人
zipCode	郵編
telephone	電話
superior	上級部門Id，一級部門則為所屬單位Id
sortIdType
isCanAccess	是否允許訪問
entityType	實(shí)體類型
valid	是否合法
parentPath	父部門的路徑

部門創(chuàng)建更新返回對象示例

部門創(chuàng)建/更新成功返回對象示例

{
    '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)建/更新失敗返回對象示例

{
    '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取部門信息

開發(fā)者可以通過【部門ID】來獲取部門信息。

接口調(diào)用請求說明：

http請求方式：GET
http://ip:port/seeyon/rest/orgDepartment/{id}

參數(shù)	是否必須	說明
id	是	部門ID

返回說明：

正常情況下，會(huì)返回的是JSON格式部門信息，JSON數(shù)據(jù)包參考：部門對象示例

參數(shù)說明請參考：部門對象屬性說明

如果錄入的部門ID錯(cuò)誤或者為空時(shí)，返回JSON格式部門信息的為空.

1.2.3. 按部門編碼取部門信息

開發(fā)者可以通過【部門編碼】來獲取部門信息。

接口調(diào)用請求說明：

http請求方式：GET
http://ip:port/seeyon/rest/orgDepartment/code/{code}

參數(shù)	是否必須	說明
code	是	部門編碼

返回說明：

正常情況下，會(huì)返回的是JSON格式部門信息，JSON數(shù)據(jù)包參考：部門對象示例

參數(shù)說明請參考：部門對象屬性說明

如果錄入的部門編碼錯(cuò)誤或者為空時(shí)，返回JSON格式部門信息的為空.

1.2.4. 獲取指定單位的所有部門(不包含停用)

開發(fā)者可以通過【單位ID】來獲取單位下所有部門信息(不包含停用部門)。

接口調(diào)用請求說明：

http請求方式：GET
http://ip:port/seeyon/rest/orgDepartments/{accountId}

參數(shù)	是否必須	說明
accountId	是	單位ID

返回說明

正常情況下，會(huì)返回的是JSON格式部門信息，JSON數(shù)據(jù)包參考：部門對象示例

參數(shù)說明請參考：部門對象屬性說明

如果錄入的單位ID錯(cuò)誤或者為空時(shí)，返回JSON格式部門信息的為空.

1.2.5. 獲取指定單位的所有部門數(shù)量(不包含停用)

開發(fā)者可以通過【單位ID】來獲取部門的數(shù)量(不包含停用部門)。

接口調(diào)用請求說明：

http請求方式：GET
http://ip:port/seeyon/rest/orgDepartments/count/{accountId}

參數(shù)	是否必須	說明
accountId	是	單位ID

返回說明

正常情況下，會(huì)返回的是JSON格式部門信息，JSON數(shù)據(jù)包參考：部門對象示例

參數(shù)說明請參考：部門對象屬性說明

正常情況下，會(huì)返回的是Integer類型的數(shù)值。

如果錄入的單位ID錯(cuò)誤或者為空時(shí)，返回信息為空。

1.2.6. 獲取指定單位的所有部門(包含停用)

開發(fā)者可以通過【單位ID】來獲取單位下所有部門信息(包含停用部門)。

接口調(diào)用請求說明：

http請求方式：GET
http://ip:port/seeyon/rest/orgDepartments/all/{accountId}

參數(shù)	是否必須	說明
accountId	是	單位ID

返回說明

正常情況下，會(huì)返回的是JSON格式部門信息，JSON數(shù)據(jù)包參考：部門對象示例

參數(shù)說明請參考：部門對象屬性說明

如果錄入的單位ID錯(cuò)誤或者為空時(shí)，返回JSON格式部門信息的為空.

1.2.7. 創(chuàng)建部門

開發(fā)者可以將部門相關(guān)參數(shù)組裝為JSON類型，來創(chuàng)建部門信息。

接口請求說明：

http請求方式：POST
http://ip:port/seeyon/rest/orgDepartment

參數(shù)	是否必須	說明
orgAccountId	是	單位ID
code	是	編號
name	是	名稱
description	否	描述
enabled	是	是否啟用
superior	是	父部門ID

組裝新建部門JSON數(shù)據(jù),請參照：部門對象示例只需要將示例對象中標(biāo)明為【必填】（不包括ID）參數(shù)組裝即可。

正常情況下，創(chuàng)建成功會(huì)返回成功的標(biāo)識(shí)以及JSON格式部門信息，返回JSON數(shù)據(jù)信息請參考：部門創(chuàng)建更新返回對象示例

如果創(chuàng)建失敗，同樣會(huì)返回失敗的標(biāo)識(shí)，并且在【'errorMsgs'】參數(shù)中給出創(chuàng)建失敗的原因以及JSON信息。

1.2.8. 批量創(chuàng)建部門(Since:V61)

將需要?jiǎng)?chuàng)建的多個(gè)部門Map放入List中批量創(chuàng)建部門信息。【注意：單位下必須沒有啟用的部門，才能夠進(jìn)行批量創(chuàng)建】

接口請求說明：

http請求方式：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');//編號
put('name', 'REST創(chuàng)建');//名稱
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);

返回說明

創(chuàng)建部門成功則返回JSON格式部門信息。

1.2.9. 按部門Id修改部門信息

開發(fā)者可以通過部門ID修改對應(yīng)的部門信息。

接口請求說明：

http請求方式：PUT
http://ip:port/seeyon/rest/orgDepartment

創(chuàng)建數(shù)據(jù)示例：

{
    'Id': 需修改的部門ID, 【必填】
    'code': 要修改部門參數(shù), 【必填】
}

返回說明

部門ID不存在，那么返回信息為空。

如果失敗，同樣會(huì)返回失敗的標(biāo)識(shí)，并且在【'errorMsgs'】參數(shù)中給出創(chuàng)建失敗的原因以及JSON信息。

1.2.10. 批量修改部門(Since:V61)

將需要修改的多個(gè)部門Map放入List中批量創(chuàng)建部門信息。

接口請求說明：

http請求方式：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);

返回說明

修改部門成功則返回JSON格式部門信息。

1.2.11. 按部門Id刪除部門

開發(fā)者可以通過部門ID刪除對應(yīng)的部門信息。

接口請求說明：

http請求方式：DELETE
http://ip:port/seeyon/rest/orgDepartment/{id}

參數(shù)	是否必須	說明
id	是	部門ID

返回說明

因?yàn)閯h除目前接口采用異步模式，暫無返回值信息。

1.2.12. 按部門Id啟用/停用部門

開發(fā)者可以通過部門ID以及enabled字段信息來啟用禁用對應(yīng)的部門信息。

接口請求說明：

http請求方式：PUT
http://ip:port/seeyon/rest/orgDepartment/{id}/enabled/{enabled}

參數(shù)	是否必須	說明
id	是	部門ID
enabled	是	部門是否啟用【true.啟動(dòng)；false停止】

創(chuàng)建數(shù)據(jù)示例：

組裝修改部門啟用/禁用JSON數(shù)據(jù)的參數(shù)只需要部門的ID以及enabled參數(shù)信息即可，示例如下：

{
    'Id': 部門ID, 【必填】
    'enabled': true, 【必填】
}

1.2.13. 獲取指定部門下的所有子部門

開發(fā)者可以通過【部門ID】來獲取指定部門下所有部門信息。

接口調(diào)用請求說明：

http請求方式：GET
http://ip:port/seeyon/rest/orgDepartments/children/{parentId}?firstLayer=false/true;

參數(shù)	是否必須	說明
parentId	是	部門ID
firstLayer	否	true是只顯示直屬子部門,false是包含所有層級的部門

返回說明

正常情況下，會(huì)返回的是JSON格式部門信息，JSON數(shù)據(jù)包參考：部門對象示例

參數(shù)說明請參考：部門對象屬性說明

如果錄入的單位ID錯(cuò)誤或者為空時(shí)，返回JSON格式部門信息的為空.

1.2.14. 獲取指定部門父級部門

開發(fā)者可以通過【部門ID】來獲取指定部門父級部門信息。

接口調(diào)用請求說明：

http請求方式：GET
http://ip:port/seeyon/rest/orgDepartments/parent/{departmentId}?firstLayer=false/true;

參數(shù)	是否必須	說明
departmentId	是	部門ID
firstLayer	否	true是只顯示直屬子部門,false是包含所有層級的部門

返回說明

正常情況下，會(huì)返回的是JSON格式部門信息，JSON數(shù)據(jù)包參考：部門對象示例

參數(shù)說明請參考：部門對象屬性說明

如果錄入的單位ID錯(cuò)誤或者為空時(shí)，返回JSON格式部門信息的為空.

1.2.15. 按部門編碼修改部門信息(Since:V6.0)

開發(fā)者可以通過部門編碼修改對應(yīng)的部門信息。

接口請求說明：

http請求方式：PUT
http://ip:port/seeyon/rest/orgDepartment

創(chuàng)建數(shù)據(jù)示例：

field字段指定根據(jù)code來匹配部門，根據(jù)條件得到多個(gè)結(jié)果則會(huì)報(bào)錯(cuò)。
{
    'id': {'field':'code'}, 【必填】
    'code': 要修改部門編碼, 【必填】
    'description': 需要修改的參數(shù)【必填】
}

返回說明

部門編碼不存在，那么返回信息為空。

如果失敗，同樣會(huì)返回失敗的標(biāo)識(shí)，并且在【'errorMsgs'】參數(shù)中給出創(chuàng)建失敗的原因以及JSON信息。

1.2.16. 按照部門編碼啟用/停用部門信息(Since:V6.0)

開發(fā)者可以通過部門編碼以及enabled字段信息來啟用禁用對應(yīng)的部門信息。

接口請求說明：

http請求方式：PUT
http://ip:port/seeyon/rest/orgDepartment/code/{code}/enabled/{enabled}

參數(shù)	是否必須	說明
code	是	部門編碼
enabled	是	部門是否啟用【true.啟動(dòng)；false停止】

創(chuàng)建數(shù)據(jù)示例：

組裝修改部門啟用/禁用JSON數(shù)據(jù)的參數(shù)只需要部門的ID以及enabled參數(shù)信息即可，示例如下：

{
    'code': 部門編碼, 【必填】
    'enabled': true, 【必填】
}

返回說明

如果創(chuàng)建失敗，同樣會(huì)返回失敗的標(biāo)識(shí)，并且在【'errorMsgs'】參數(shù)中給出創(chuàng)建失敗的原因以及JSON信息。

1.2.17. 按照部門編碼刪除部門(Since:V6.0)

開發(fā)者可以通過部門編碼刪除對應(yīng)的部門信息。

接口請求說明

http請求方式：DELETE
http://ip:port/seeyon/rest/orgDepartment/code/{code}

參數(shù)	是否必須	說明
code	是	部門編碼

返回說明

因?yàn)閯h除目前接口采用異步模式，暫無返回值信息。

1.2.18. 按照單位編碼獲取所有部門信息(包含停用部門)(Since:V6.0)

開發(fā)者可以通過【單位編碼】來獲取單位下所有部門信息(包含停用部門)。

接口調(diào)用請求說明：

http請求方式：GET
http://ip:port/seeyon/rest/orgDepartment/code/{code}

返回說明

正常情況下，會(huì)返回的是JSON格式部門信息，JSON數(shù)據(jù)包參考：部門對象示例

參數(shù)說明請參考：部門對象屬性說明

如果錄入的單位編碼錯(cuò)誤或者為空時(shí)，返回JSON格式部門信息的為空.

1.2.19. 按部門編碼獲取所有所有子部門(Since:V6.0)

開發(fā)者可以通過【部門編碼】來獲取指定部門下所有子部門信息。

接口調(diào)用請求說明;

http請求方式：GET
http://ip:port/seeyon/rest/orgDepartments/children/code/{parentCode}

參數(shù)	是否必須	說明
parentCode	是	部門編碼

返回說明

正常情況下，會(huì)返回的是JSON格式部門信息，JSON數(shù)據(jù)包參考：部門對象示例

參數(shù)說明請參考：部門對象屬性說明

如果錄入的部門編碼錯(cuò)誤或者為空時(shí)，返回JSON格式部門信息的為空.

1.2.20. 根據(jù)部門編碼獲取部門兼職人員信息(Since:V6.0)

開發(fā)者可以通過【部門編碼】來獲取指定部門下所有兼職人員信息。

接口調(diào)用請求說明：

http請求方式：GET
http://ip:port/seeyon/rest/orgDepartments/concurrentpost/code/{code}

參數(shù)	是否必須	說明
code	是	部門編碼

返回說明

正常情況下，會(huì)返回的是JSON格式部門信息，JSON數(shù)據(jù)包參考：部門對象示例

參數(shù)說明請參考：部門對象屬性說明

如果錄入的部門編碼錯(cuò)誤或者為空時(shí)，返回JSON格式部門信息的為空.

1.2.21. 根據(jù)部門ID查看部門崗位(Since:V6.0)

根據(jù)部門ID查看當(dāng)前部門所設(shè)置的崗位。

接口調(diào)用請求說明：

http請求方式：GET
http://ip:port/seeyon/rest/orgDepartment/departmentpost/{departmentid}

參數(shù)	是否必須	說明
departmentid	是	部門ID

返回說明

正常情況下，會(huì)返回的是JSON格式部門信息，JSON數(shù)據(jù)包參考：部門對象示例

參數(shù)說明請參考：部門對象屬性說明

如果錄入的錯(cuò)誤或者為空時(shí)，返回JSON格式部門信息的為空.

1.2.22. 根據(jù)部門ID跟新部門崗位(Since:V6.0)

根據(jù)部門ID更新當(dāng)前部門所設(shè)置的崗位。

接口調(diào)用請求說明：

http請求方式：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è)字母大寫

返回說明

正常情況下，會(huì)返回的是JSON格式部門信息，JSON數(shù)據(jù)包參考：部門對象示例

參數(shù)說明請參考：部門對象屬性說明

如果錄入錯(cuò)誤或者為空時(shí)，返回JSON格式部門信息的為空.

1.2.23. 根據(jù)部門ID查看部門[部門主管、分管領(lǐng)導(dǎo)、部門管理員、部門公文收發(fā)員](Since:V6.0)

根據(jù)部門ID查看當(dāng)前部門的部門主管、分管領(lǐng)導(dǎo)、部門管理員、部門公文收發(fā)員。

接口調(diào)用請求說明：

http請求方式：GET
http://ip:port/seeyon/rest/orgDepartment/departmentmanagerinfo/{departmentid}/{accountid}

返回說明

正常情況下，會(huì)返回的是JSON格式部門信息，JSON數(shù)據(jù)包參考：部門對象示例

參數(shù)說明請參考：部門對象屬性說明

如果錄入錯(cuò)誤或者為空時(shí)，返回JSON格式部門信息的為空.

1.2.24. 更新部門管理角色[主管，領(lǐng)導(dǎo)，管理員，公文收發(fā)員](Since:V6.0)

修改部門管理角色信息。

接口調(diào)用請求說明：

http請求方式：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é)對應(yīng)的就是角色順序

返回說明

正常情況下，會(huì)返回的是JSON格式部門信息，JSON數(shù)據(jù)包參考：部門對象示例

參數(shù)說明請參考：部門對象屬性說明

如果錄入錯(cuò)誤或者為空時(shí)，返回JSON格式部門信息的為空.

1.2.25. 按照編碼更新部門管理角色[主管，領(lǐng)導(dǎo)，管理員，公文收發(fā)員](Since:V7.1)

根據(jù)編碼修改部門管理角色信息。

接口調(diào)用請求說明：

http請求方式：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ā)送請求

返回說明

正常情況下，返回JSON格式部門信息，JSON數(shù)據(jù)包詳情請參考：部門對象示例

參數(shù)說明請參考：部門對象屬性說明

返回成功示例：

{
      'code' : 0,
      'data' : {
      // 部門對象屬性
        'orgAccountId' : 4096395336238448877,
        ......
      },
      'message' : '成功'
    }

返回失敗示例：

{
      'code' : 1001,// 不同錯(cuò)誤返回不同的錯(cuò)誤狀態(tài)碼
      'data' : 'accountCode',
      'message' : '單位編碼不能為空!'
}

1.2.26. 按照部門編碼獲取部門主管、分管領(lǐng)導(dǎo)、部門管理員、部門公文收發(fā)員(Since:V6.0)

開發(fā)者可以通過【部門編碼】來獲取指定部門下部門主管、分管領(lǐng)導(dǎo)、部門管理員、部門公文收發(fā)員。

接口調(diào)用請求說明：

http請求方式：GET
http://ip:port/seeyon/rest/orgDepartments/visor/code/{code}

參數(shù)	是否必須	說明
code	是	部門編碼

返回說明

正常情況下，會(huì)返回的是JSON格式部門信息，JSON數(shù)據(jù)包參考：部門對象示例

參數(shù)說明請參考：部門對象屬性說明

如果錄入的部門編碼錯(cuò)誤或者為空時(shí)，返回JSON格式部門信息的為空.

1.3. 崗位管理

崗位管理服務(wù)支持獲取，創(chuàng)建，修改，刪除崗位數(shù)據(jù)。

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. 崗位對象屬性說明

參數(shù)	說明
orgAccountId	所屬單位ID
id	ID
name	崗位名稱
code	崗位代碼
createTime	創(chuàng)建時(shí)間
updateTime	更改時(shí)間
sortId	排序號
isDeleted	是否被刪除
enabled	是否啟用
status	狀態(tài)
description	描述
typeId	類型ID
valid	是否合法

1.3.3. 崗位創(chuàng)建更新返回對象示例

崗位創(chuàng)建/更新成功返回對象示例

{
    '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)建/更新失敗返回對象示例

{
    '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取崗位信息

開發(fā)者可以通過【崗位ID】來獲取崗位信息。

接口調(diào)用請求說明

http請求方式：GET
http://ip:port/seeyon/rest/orgPost/{id}

參數(shù)	是否必須	說明
id	是	崗位ID

返回說明

正常情況下，會(huì)返回的是JSON格式崗位信息，JSON數(shù)據(jù)包參考：崗位對象示例

參數(shù)說明請參考：崗位對象屬性說明

如果錄入的部門ID錯(cuò)誤或者為空時(shí)，返回JSON格式崗位信息的為空.

1.3.5. 獲取指定單位的所有崗位(不包含停用)

開發(fā)者可以通過【單位ID】來獲取當(dāng)前單位下的所有崗位信息（不包含停用崗位）。

接口調(diào)用請求說明

http請求方式：GET
http://ip:port/seeyon/rest/orgPosts/{accountId}

參數(shù)	是否必須	說明
accountId	是	單位ID

返回說明

正常情況下，會(huì)返回的是JSON格式崗位信息，JSON數(shù)據(jù)包參考：崗位對象示例

參數(shù)說明請參考：崗位對象屬性說明

如果錄入的部門ID錯(cuò)誤或者為空時(shí)，返回JSON格式崗位信息的為空.

1.3.6. 獲取指定單位的所有崗位數(shù)量(不包含停用)

開發(fā)者可以通過【單位ID】來獲取崗位的數(shù)量(不包含停用崗位)。

接口調(diào)用請求說明

http請求方式：GET
http://ip:port/seeyon/rest/orgPosts/count/{accountId}

參數(shù)	是否必須	說明
accountId	是	單位ID

返回說明

正常情況下，會(huì)返回的是Integer類型的數(shù)值。

如果錄入的單位ID錯(cuò)誤或者為空時(shí)，返回信息為空。

1.3.7. 獲取指定單位的所有崗位(包含停用)

開發(fā)者可以通過【單位ID】來獲取當(dāng)前單位下的所有崗位信息（包含停用崗位）。

接口調(diào)用請求說明

http請求方式：GET
http://ip:port/seeyon/rest/orgPosts/all/{accountId}

參數(shù)	是否必須	說明
accountId	是	單位ID

返回說明

正常情況下，會(huì)返回的是JSON格式崗位信息，JSON數(shù)據(jù)包參考：崗位對象示例

參數(shù)說明請參考：崗位對象屬性說明

如果錄入的部門ID錯(cuò)誤或者為空時(shí)，返回JSON格式崗位信息的為空.

1.3.8. 獲取指定單位的所有崗位數(shù)量(包含停用)

開發(fā)者可以通過【單位ID】來獲取崗位的數(shù)量(包含停用崗位)。

接口調(diào)用請求說明

http請求方式：GET
http://ip:port/seeyon/rest/orgPosts/all/count/{accountId}

參數(shù)	是否必須	說明
accountId	是	單位ID

返回說明

正常情況下，會(huì)返回的是Integer類型的數(shù)值。

如果錄入的單位ID錯(cuò)誤或者為空時(shí)，返回信息為空。

1.3.9. 創(chuàng)建崗位

開發(fā)者可以將崗位相關(guān)參數(shù)組裝為JSON類型，來創(chuàng)建崗位信息。

接口請求說明

http請求方式：POST
http://ip:port/seeyon/rest/orgPost

創(chuàng)建數(shù)據(jù)示例：

參數(shù)	是否必須	說明
orgAccountId	是	單位ID
code	是	編號
name	是	名稱
description	否	描述
typeId	是	類型參數(shù)(管理類是1，技術(shù)類是2，營銷類是3，職能類是4)

組裝新建崗位JSON數(shù)據(jù),請參照：崗位對象示例只需要將示例對象中標(biāo)明為【必填】參數(shù)組裝即可。

新建崗位JSON數(shù)據(jù)參數(shù)的具體字段含義請參見崗位對象屬性說明

返回說明

正常情況下，創(chuàng)建成功會(huì)返回成功的標(biāo)識(shí)以及JSON格式崗位信息，JSON數(shù)據(jù)信息請參考：崗位創(chuàng)建更新返回對象示例

如果崗位創(chuàng)建失敗，同樣會(huì)返回失敗的標(biāo)識(shí)，并且在【'errorMsgs'】參數(shù)中給出創(chuàng)建失敗的原因以及JSON格式崗位信息。

1.3.10. 批量創(chuàng)建崗位(Since:V61)

將需要?jiǎng)?chuàng)建的多個(gè)崗位Map放入List中批量創(chuàng)建崗位信息。

接口請求說明

http請求方式：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);

返回說明

創(chuàng)建崗位成功則返回JSON格式崗位信息。

1.3.11. 按崗位Id修改崗位信息

開發(fā)者可以通過崗位ID修改對應(yīng)的崗位信息。

接口請求說明

http請求方式：PUT
http://ip:port/seeyon/rest/orgPost

創(chuàng)建數(shù)據(jù)示例：

組裝修改崗位JSON數(shù)據(jù)的參數(shù)只需要崗位的ID以及需要修改參數(shù)信息即可，示例如下：

{
    'Id': 需修改的崗位ID, 【必填】
    'description': 要修改的參數(shù), 【必填】
}

返回說明

正常情況下，成功會(huì)返回成功的標(biāo)識(shí)以及JSON格式崗位信息，JSON數(shù)據(jù)信息請參考:崗位創(chuàng)建更新返回對象示例

如果崗位創(chuàng)建失敗，同樣會(huì)返回失敗的標(biāo)識(shí)，并且在【'errorMsgs'】參數(shù)中給出創(chuàng)建失敗的原因以及JSON格式崗位信息.

1.3.12. 按崗位Id批量修改崗位信息(Since:V61)

將需要修改的多個(gè)崗位Map放入List中批量修改崗位信息。

接口請求說明

http請求方式：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);

返回說明

修改崗位成功則返回JSON格式崗位信息。

1.3.13. 按崗位Id刪除崗位信息

開發(fā)者可以通過崗位ID刪除對應(yīng)的崗位信息。

接口請求說明

http請求方式：DELETE
http://ip:port/seeyon/rest/orgPost/{id}

參數(shù)	是否必須	說明
id	是	崗位ID

返回說明

因?yàn)閯h除目前接口采用異步模式，暫無返回值信息。

1.3.14. 按崗位Id啟用/禁用崗位

開發(fā)者可以通過崗位ID以及enabled字段信息來啟用禁用對應(yīng)的崗位信息。

接口請求說明

http請求方式：PUT
http://ip:port/seeyon/rest/orgPost/{id}/enabled/{enabled}

參數(shù)	是否必須	說明
id	是	崗位ID
enabled	是	崗位是否啟用【true.啟動(dòng)；false停止】

創(chuàng)建數(shù)據(jù)示例：

組裝修改崗位啟用/禁用JSON數(shù)據(jù)的參數(shù)只需要崗位的ID以及enabled參數(shù)信息即可，示例如下：

{
    'Id': 需修改的崗位ID, 【必填】
    'enabled': true, 【必填】
}

返回說明

正常情況下，成功會(huì)返回成功的標(biāo)識(shí)以及JSON格式崗位信息，JSON數(shù)據(jù)信息請參考：崗位創(chuàng)建更新返回對象示例

如果崗位創(chuàng)建失敗，同樣會(huì)返回失敗的標(biāo)識(shí)，并且在【'errorMsgs'】參數(shù)中給出創(chuàng)建失敗的原因以及JSON格式崗位信息.

1.3.15. 按崗位編碼停用/啟用崗位(Since:V6.0)

開發(fā)者可以通過崗位編碼以及enabled字段信息來啟用禁用對應(yīng)的崗位信息。

接口請求說明

http請求方式：PUT
http://ip:port/seyon/rest/orgPost/code/{code}/enabled/{enabled}

參數(shù)	是否必須	說明
code	是	崗位編碼
enabled	是	崗位是否啟用【true.啟動(dòng)；false停止】

返回說明

正常情況下，成功會(huì)返回成功的標(biāo)識(shí)以及JSON格式崗位信息，JSON數(shù)據(jù)信息請參考:崗位創(chuàng)建更新返回對象示例

如果崗位創(chuàng)建失敗，同樣會(huì)返回失敗的標(biāo)識(shí)，并且在【'errorMsgs'】參數(shù)中給出創(chuàng)建失敗的原因以及JSON格式崗位信息.

1.3.16. 按崗位編碼刪除崗位

開發(fā)者可以通過崗位ID刪除對應(yīng)的崗位信息。

接口請求說明

http請求方式：DELETE
http://ip:port/seeyon/rest/orgPost/code/{code}

參數(shù)	是否必須	說明
code	是	崗位編碼

返回說明

因?yàn)閯h除目前接口采用異步模式，暫無返回值信息。

1.3.17. 按崗位編碼修改崗位

開發(fā)者可以通過崗位編碼修改對應(yīng)的崗位信息。

接口請求說明

http請求方式：PUT
http://ip:port/seeyon/rest/orgPost

創(chuàng)建數(shù)據(jù)示例：

組裝修改崗位JSON數(shù)據(jù)的參數(shù)只需要崗位的編碼以及需要修改參數(shù)信息即可，示例如下：

field字段指定根據(jù)code來匹配人員，根據(jù)條件得到多個(gè)結(jié)果則會(huì)報(bào)錯(cuò)
{
    'Id': {'field':'code'}, 【必填】
    'code'：需要修改的崗位編碼【必填】
    'description': 要修改的參數(shù), 【必填】
}

返回說明

正常情況下，成功會(huì)返回成功的標(biāo)識(shí)以及JSON格式崗位信息，JSON數(shù)據(jù)信息請參考:崗位創(chuàng)建更新返回對象示例

如果崗位創(chuàng)建失敗，同樣會(huì)返回失敗的標(biāo)識(shí)，并且在【'errorMsgs'】參數(shù)中給出創(chuàng)建失敗的原因以及JSON格式崗位信息.

1.4. 職務(wù)管理

職務(wù)管理服務(wù)支持獲取，創(chuàng)建，修改，刪除職務(wù)數(shù)據(jù)。

1.4.1. 職務(wù)對象

職務(wù)對象示例

{
    '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'【非必填】
}

職務(wù)對象屬性說明

參數(shù)	說明
orgAccountId	所屬單位ID
id	ID
name	職務(wù)級別名稱
code	職務(wù)級別代碼
createTime	創(chuàng)建時(shí)間
updateTime	更改時(shí)間
sortId	排序
isDeleted	是否被刪除
enabled	是否啟用
status	狀態(tài)
description	描述
valid	是否合法
levelId	職務(wù)級別序號
groupLevelId	映射的集團(tuán)職務(wù)級別號
entityType	類型

職務(wù)創(chuàng)建更新返回對象示例

崗位創(chuàng)建/更新成功返回對象示例

{
    '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)建/更新失敗返回對象示例

{
    '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
}

1.4.2. 按職務(wù)級別Id取職務(wù)級別信息

開發(fā)者可以通過【職務(wù)ID】來獲取職務(wù)信息。

接口調(diào)用請求說明

http請求方式：GET
http://ip:port/seeyon/rest/orgLevel/{id}

參數(shù)	是否必須	說明
id	是	職務(wù)ID

返回說明

正常情況下，會(huì)返回的是JSON格式職務(wù)信息，JSON數(shù)據(jù)包參考：職務(wù)對象示例

參數(shù)說明請參考:職務(wù)對象屬性說明

如果錄入的職務(wù)ID錯(cuò)誤或者為空時(shí)，返回JSON格式職務(wù)信息的為空.

1.4.3. 獲取指定單位的所有職務(wù)級別(不包含停用)

開發(fā)者可以通過【單位ID】來獲取單位下所有職務(wù)信息(不包含停用職務(wù))。

接口調(diào)用請求說明

http請求方式：GET
http://ip:port/seeyon/rest/orgLevels/{accountId}

參數(shù)	是否必須	說明
accountId	是	單位ID

返回說明

正常情況下，會(huì)返回的是JSON格式職務(wù)信息，JSON數(shù)據(jù)包參考：職務(wù)對象示例

參數(shù)說明請參考:職務(wù)對象屬性說明

如果錄入的職務(wù)ID錯(cuò)誤或者為空時(shí)，返回JSON格式職務(wù)信息的為空.

1.4.4. 獲取指定單位的所有職務(wù)級別(包含停用)

開發(fā)者可以通過【單位ID】來獲取單位下所有職務(wù)信息(包含停用職務(wù))。

接口調(diào)用請求說明

http請求方式：GET
http://ip:port/seeyon/rest/orgLevels/all/{accountId}

參數(shù)	是否必須	說明
accountId	是	單位ID

返回說明

正常情況下，會(huì)返回的是JSON格式職務(wù)信息，JSON數(shù)據(jù)包參考：職務(wù)對象示例

參數(shù)說明請參考:職務(wù)對象屬性說明

如果錄入的職務(wù)ID錯(cuò)誤或者為空時(shí)，返回JSON格式職務(wù)信息的為空.

1.4.5. 創(chuàng)建職務(wù)級別

開發(fā)者可以將職務(wù)相關(guān)參數(shù)組裝為JSON類型，來創(chuàng)建崗位信息。

接口請求說明

http請求方式：POST
http://ip:port/seeyon/rest/orgLevel

參數(shù)	是否必須	說明
orgAccountId	是	單位ID
code	是	編號
name	是	名稱
description	否	描述

創(chuàng)建數(shù)據(jù)示例：

組裝新建職務(wù)JSON數(shù)據(jù),請參照:職務(wù)對象示例只需要將示例對象中標(biāo)明為【必填】參數(shù)組裝即可。

新建職務(wù)JSON數(shù)據(jù)參數(shù)的具體字段含義請參見:職務(wù)對象屬性說明

返回說明

正常情況下，成功會(huì)返回成功的標(biāo)識(shí)以及JSON格式職務(wù)信息，JSON數(shù)據(jù)信息請參考：職務(wù)創(chuàng)建更新返回對象示例

如果職務(wù)創(chuàng)建失敗，同樣會(huì)返回失敗的標(biāo)識(shí)，并且在【'errorMsgs'】參數(shù)中給出創(chuàng)建失敗的原因以及JSON格式職務(wù)信息.

1.4.6. 按職務(wù)級別Id修改職務(wù)級別信息

開發(fā)者可以通過職務(wù)ID修改對應(yīng)的職務(wù)信息。

接口請求說明

http請求方式：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ù), 【必填】
}

返回說明

正常情況下，成功會(huì)返回成功的標(biāo)識(shí)以及JSON格式職務(wù)信息，JSON數(shù)據(jù)信息請參考：職務(wù)創(chuàng)建更新返回對象示例

1.4.7. 按職務(wù)級別Id刪除職務(wù)級別

開發(fā)者可以通過職務(wù)ID刪除對應(yīng)的職務(wù)信息。

接口請求說明

http請求方式：DELETE
http://ip:port/seeyon/rest/orgLevel/{id}

參數(shù)	是否必須	說明
id	是	職務(wù)ID

返回說明

因?yàn)閯h除目前接口采用異步模式，暫無返回值信息。

1.4.8. 按職務(wù)級別Id啟用/禁用職務(wù)級別

開發(fā)者可以通過職務(wù)ID以及enabled字段信息來啟用禁用對應(yīng)的職務(wù)信息。

接口請求說明：

http請求方式：PUT
http://ip:port/seeyon/rest/orgLevel/{id}/enabled/{enabled}

參數(shù)	是否必須	說明
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, 【必填】
}

返回說明

正常情況下，成功會(huì)返回成功的標(biāo)識(shí)以及JSON格式職務(wù)信息，JSON數(shù)據(jù)信息請參考：職務(wù)創(chuàng)建更新返回對象示例

1.4.9. 按職務(wù)級別編碼啟用/禁用職務(wù)級別

開發(fā)者可以通過職務(wù)比那么以及enabled字段信息來啟用禁用對應(yīng)的職務(wù)信息。

接口請求說明：

http請求方式：PUT
http://ip:port/seeyon/rest/orgLevel/code/{code}/enabled/{enabled}

參數(shù)	是否必須	說明
code	是	職務(wù)code
enabled	是	職務(wù)是否啟用【true.啟動(dòng)；false停止】

返回說明

正常情況下，成功會(huì)返回成功的標(biāo)識(shí)以及JSON格式職務(wù)信息，JSON數(shù)據(jù)信息請參考：職務(wù)創(chuàng)建更新返回對象示例

1.4.10. 按職務(wù)級別編碼刪除職務(wù)

開發(fā)者可以通過職務(wù)編碼刪除對應(yīng)的職務(wù)信息。

接口請求說明：

http請求方式：DELETE
http://ip:port/seeyon/rest/orgLevel/code/{code}

參數(shù)	是否必須	說明
code	是	職務(wù)編碼

返回說明

因?yàn)閯h除目前接口采用異步模式，暫無返回值信息。

1.4.11. 按職務(wù)編碼修改職務(wù)

開發(fā)者可以通過職務(wù)編碼修改對應(yīng)的職務(wù)信息。

接口請求說明：

http請求方式：PUT
http://ip:port/seeyon/rest/orgLevel

創(chuàng)建數(shù)據(jù)示例：

組裝修改職務(wù)JSON數(shù)據(jù)的參數(shù)只需要職務(wù)的ID以及需要修改職務(wù)參數(shù)信息即可，示例如下：

field字段指定根據(jù)code來匹配人員，根據(jù)條件得到多個(gè)結(jié)果則會(huì)報(bào)錯(cuò)。
{
    'Id': {'field':'code'}, 【必填】
    'code'：需要修改的職務(wù)編碼,【必填】
    'description': 要修改職務(wù)參數(shù), 【必填】
}

返回說明

正常情況下，成功會(huì)返回成功的標(biāo)識(shí)以及JSON格式職務(wù)信息，JSON數(shù)據(jù)信息請參考：職務(wù)創(chuàng)建更新返回對象示例

1.5. 單位管理

單位管理服務(wù)支持獲取，修改，刪除單位信息。

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
}

單位對象屬性說明

參數(shù)	說明
orgAccountId	所屬單位ID
id	ID
name	單位名稱
code	單位編碼
sortId	排序號
shortName	單位簡稱
createTime	創(chuàng)建時(shí)間
updateTime	修改時(shí)間
isDeleted	是否刪除
enabled	是否啟用
status	狀態(tài)
description	描述
path	路徑
secondName	外文名稱
isInternal	是否是內(nèi)部機(jī)構(gòu)
isGroup	是否是集團(tuán)
levelScope	只對type=account有效
type	類型
unitCategory	機(jī)構(gòu)類型
fax	傳真
unitMail	郵件
address	地址
chiefLeader	負(fù)責(zé)人
zipCode	郵編
telephone	電話
superior	上級單位Id，如果當(dāng)前單位為集團(tuán)則值為-1
superiorName
sortIdType
isCanAccess	是否可訪問
childrenAccounts
entityType	實(shí)體類型
valid	是否合法
parentPath	父單位路徑

1.5.2. 按單位名稱取單位信息

開發(fā)者可以通過【單位名稱】來獲取單位信息

接口請求說明：

http請求方式：GET
http://ip:port/seeyon/rest/orgAccount/name/{name}

參數(shù)	是否必須	說明
name	是	單位名稱【UTF-8 encode中文編碼】

注意：

因?yàn)閱挝幻Q是漢字所以，需要漢字做UTF-8 encode中文編碼，示例如下：

String name = URLEncoder.encode('單位名稱', 'UTF-8');

返回說明

正常情況下，會(huì)返回的是JSON格式單位信息，JSON數(shù)據(jù)包參考：單位對象示例

參數(shù)說明請參考:單位對象屬性說明

如果錄入的單位名稱錯(cuò)誤或者為空時(shí)，返回JSON格式單位信息的為空.

1.5.3. 按單位Id取單位的信息

開發(fā)者可以通過【單位ID】來獲取單位信息

接口請求說明：

http請求方式：GET
http://ip:port/seeyon/rest/orgAccount/{id}

參數(shù)	是否必須	說明
ID	是	單位ID

返回說明

正常情況下，會(huì)返回的是JSON格式單位信息，JSON數(shù)據(jù)包參考：單位對象示例

參數(shù)說明請參考:單位對象屬性說明

如果錄入的單位名稱錯(cuò)誤或者為空時(shí)，返回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

參數(shù)	是否必須	說明
ID	是	單位ID

返回說明

正常情況下，會(huì)返回的是JSON格式單位信息，JSON數(shù)據(jù)包參考：單位對象示例

參數(shù)說明請參考:單位對象屬性說明

如果錄入的單位ID錯(cuò)誤或者為空時(shí)，返回null，否則返回單位管理員的人員信息。

1.5.5. 新增單位(Since:V5.6 )【V6.0 增加單位管理員】

創(chuàng)建單位信息?！咀⒁猓捍私涌谥荒芗瘓F(tuán)版使用.】

接口請求說明：

http請求方式：POST
http://ip:port/seeyon/rest/orgAccount

參數(shù)	是否必須	說明
name	是	單位名稱
code	是	單位編碼
description	是	單位描述
shortName	是	單位簡稱
sortId	是	單位序號
superior	是	單位父級單位ID

增加單位管理員后，創(chuàng)建單位格式：
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);

返回說明

正常情況下，會(huì)返回的是JSON格式單位信息，JSON數(shù)據(jù)包參考：單位對象示例

參數(shù)說明請參考:單位對象屬性說明

如果錄入的單位ID錯(cuò)誤或者為空時(shí)，返回null.

1.5.6. 取所有單位信息

開發(fā)者獲取所有單位信息。

接口請求說明：

http請求方式：GET
http://ip:port/seeyon/rest/orgAccounts

返回說明

正常情況下，會(huì)返回的是JSON格式單位信息，JSON數(shù)據(jù)包參考：單位對象示例

參數(shù)說明請參考:單位對象屬性說明

1.5.7. 按單位Id刪除單位

開發(fā)者可以通過單位ID刪除對應(yīng)的單位信息。

接口請求說明：

http請求方式：DELETE
http://ip:port/seeyon/rest/orgAccount/{id}

參數(shù)	是否必須	說明
id	是	單位ID

返回說明

因?yàn)閯h除目前接口采用異步模式，暫無返回值信息。

1.5.8. 按單位Id修改單位信息【V6.0 增加修改單位LDAP目錄設(shè)置】

開發(fā)者可以通過單位ID修改對應(yīng)的單位信息。

接口請求說明：

http請求方式：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);

返回說明

正常情況下，會(huì)返回的是JSON格式單位信息，JSON數(shù)據(jù)包參考：單位對象示例

參數(shù)說明請參考:單位對象屬性說明

單位ID不存在，那么返回信息為空。

更新失敗，同樣會(huì)返回失敗的標(biāo)識(shí)，并且在【'errorMsgs'】參數(shù)中給出創(chuàng)建失敗的原因以及JSON格式信息.

1.5.9. 獲取指定單位下級單位(Since:V5.6)

開發(fā)者可以通過指定單位ID來獲取下級單位列表.

接口請求說明：

http請求方式：GET
http://ip:port/seeyon/rest/orgAccounts/{id}

參數(shù)	是否必須	說明
id	是	單位ID

返回說明

正常情況下，會(huì)返回的是JSON格式單位信息，JSON數(shù)據(jù)包參考：單位對象示例

參數(shù)說明請參考:單位對象屬性說明

如果錄入的單位ID錯(cuò)誤或者為空時(shí)，返回null

1.5.10. 獲取指定單位上級單位(Since:V5.6)

開發(fā)者可以通過指定單位ID來獲取上級單位列表.

接口請求說明：

http請求方式：GET
http://ip:port/seeyon/rest/orgAccounts/parent/{id}

參數(shù)	是否必須	說明
id	是	單位ID

返回說明

正常情況下，會(huì)返回的是JSON格式單位信息，JSON數(shù)據(jù)包參考：單位對象示例

參數(shù)說明請參考:單位對象屬性說明

如果錄入的單位ID錯(cuò)誤或者為空時(shí)，返回null

1.5.11. 按單位編碼修改單位信息(Since:V6.0)

開發(fā)者可以通過單位編碼修改對應(yīng)的單位信息。

接口請求說明：

http請求方式：PUT
http://ip:port/seeyon/rest/orgAccount

創(chuàng)建數(shù)據(jù)示例：

組裝修改單位JSON數(shù)據(jù)的參數(shù)只需要單位的編碼以及需要修改單位參數(shù)信息即可，示例如下：

field字段指定根據(jù)code來匹配單位，根據(jù)條件得到多個(gè)結(jié)果則會(huì)報(bào)錯(cuò)。
{
    'Id': {'field':'code'}, 【必填】
    'code':要修改的單位編碼,【必填】
    'description': 要修改單位參數(shù), 【必填】
}

返回說明

正常情況下，會(huì)返回的是JSON格式單位信息，JSON數(shù)據(jù)包參考：單位對象示例

參數(shù)說明請參考:單位對象屬性說明

1.5.12. 按單位編碼獲取單位信息

開發(fā)者可以通過【單位Code】來獲取單位信息。

接口請求說明：

http請求方式：GET
http://ip:port/seeyon/rest/orgAccount/code/{code}

參數(shù)	是否必須	說明
code	是	單位編碼

返回說明

正常情況下，會(huì)返回的是JSON格式單位信息，JSON數(shù)據(jù)包參考：單位對象示例

參數(shù)說明請參考:單位對象屬性說明

1.6. 人員管理

人員的創(chuàng)建、修改、刪除和查找接口。

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': '匯報(bào)人'，
    'hiredate': '入職時(shí)間
}

人員對象屬性說明

參數(shù)	說明
id	Id，唯一標(biāo)識(shí)人員
name	姓名
loginName	登錄名
code	人員編碼
createTime	創(chuàng)建時(shí)間
updateTime	更新時(shí)間
sortId	排序號
description	說明
orgAccountId	人員所屬單位Id
orgLevelId	人員職務(wù)級別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為申請停用、3為申請刪除、4為申請調(diào)離；此屬性不常用，一般返回1
telNumber	手機(jī)號碼
birthday	出生日期
officeNum	辦公電話
emailAddress	電子郵件
gender	性別：-1為未指定、1為男、2為女
location	工作地
reporter	匯報(bào)人
hiredate	入職時(shí)間

1.6.2. 按登錄名取人員信息

按照登錄名獲取人員信息。

接口請求說明：

http請求方式：GET
http://ip:port/seeyon/rest/orgMember?loginName={loginName}
如
http://127.0.0.1/seeyon/rest/orgMember?loginName=s1

參數(shù)說明：

參數(shù)	是否必須	說明
loginName	是	人員登錄名

返回說明

正常情況下，會(huì)返回的是JSON格式人員信息，JSON數(shù)據(jù)包參考：人員對象示例

參數(shù)說明請參考:人員對象屬性說明

1.6.3. 按Id取人員信息

按照人員的Id獲取人員信息

接口請求說明：

http請求方式：GET
http://ip:port/seeyon/rest/orgMember/{memberId}
如
http://127.0.0.1/seeyon/rest/orgMember/710000480641633932

參數(shù)說明：

參數(shù)	是否必須	說明
memberId	是	人員Id

返回說明

正常情況下，會(huì)返回的是JSON格式人員信息，JSON數(shù)據(jù)包參考：人員對象示例

參數(shù)說明請參考:人員對象屬性說明

1.6.4. 按編碼取人員信息

按照人員的code獲取人員信息

接口請求說明：

http請求方式：GET
http://ip:port/seeyon/rest/orgMembers/code/{code}
如
http://127.0.0.1/seeyon/rest/orgMembers/code/001

參數(shù)說明：

參數(shù)	是否必須	說明
code	是	人員編號

返回說明

正常情況下，會(huì)返回的是JSON格式人員信息，JSON數(shù)據(jù)包參考：人員對象示例

參數(shù)說明請參考:人員對象屬性說明

1.6.5. 按手機(jī)號碼取人員信息

按照人員的手機(jī)號碼獲取人員信息

接口請求說明：

http請求方式：GET
http://ip:port/seeyon/rest/orgMember/telephone/{telephoneNumber}
如
127.0.0.1/seeyon/rest/orgMember/telephone/13366666666

參數(shù)說明：

參數(shù)	是否必須	說明
telephoneNumber	是	手機(jī)號碼

返回說明

正常情況下，會(huì)返回的是JSON格式人員信息，JSON數(shù)據(jù)包參考：人員對象示例

參數(shù)說明請參考:人員對象屬性說明

1.6.6. 取得指定單位的所有人員(不包含停用人員)

取得指定單位的所有人員（不包含停用人員）

接口請求說明：

http請求方式：GET
http://ip:port/seeyon/rest/orgMembers/{accountId}
如
http://127.0.0.1/seeyon/rest/orgMembers/-2332227039700957764

參數(shù)說明：

參數(shù)	是否必須	說明
accountId	是	單位Id

返回說明

返回JSON格式的人員對象數(shù)組。

[
    {
        'orgAccountId': -2332227039700957700,
        'id': 710000480641633900,
        'name': 's1',
        'loginName': 's1'
        // ...
    },
    {
        'orgAccountId': -2332227039700957700,
        'id': -889216812767428100,
        'name': 's2',
        'loginName': 's2'
        // ...
    }
]

返回值說明

正常情況下，會(huì)返回的是JSON格式人員信息，JSON數(shù)據(jù)包參考：人員對象示例

參數(shù)說明請參考:人員對象屬性說明

1.6.7. 取得指定單位的所有人員(包含停用人員)

取得指定單位的所有人員(包含停用人員)

接口請求說明：

http請求方式：GET
http://ip:port/seeyon/rest/orgMembers/all/{accountId}
如
http://127.0.0.1/seeyon/rest/orgMembers/all/-2332227039700957764

參數(shù)說明：

參數(shù)	是否必須	說明
accountId	是	單位Id

返回說明

正常情況下，會(huì)返回的是JSON格式人員信息，JSON數(shù)據(jù)包參考：人員對象示例

參數(shù)說明請參考:人員對象屬性說明

1.6.8. 取得指定單位的所有人員總數(shù)(不包含停用人員)

取得指定單位的所有人員總數(shù)(不包含停用人員)

接口請求說明：

http請求方式：GET
http://ip:port/seeyon/rest/orgMembers/count/{accountId}
如
http://127.0.0.1/seeyon/rest/orgMembers/count/-2332227039700957764

參數(shù)說明：

參數(shù)	是否必須	說明
accountId	是	單位Id

返回說明

正常情況下，會(huì)返回的是JSON格式人員信息，JSON數(shù)據(jù)包參考：人員對象示例

參數(shù)說明請參考:人員對象屬性說明

1.6.9. 取得指定單位的所有人員總數(shù)(包含停用人員)

取得指定單位的所有人員總數(shù)(包含停用人員)

接口請求說明：

http請求方式：GET
http://ip:port/seeyon/rest/orgMembers/all/count/{accountId}
如
http://127.0.0.1/seeyon/rest/orgMembers/all/count/-2332227039700957764

參數(shù)說明：

參數(shù)	是否必須	說明
accountId	是	單位Id

返回說明

返回JSON整數(shù)。

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

參數(shù)說明：

參數(shù)	是否必須	說明
departmentId	是	部門Id
firstLayer	否	只取當(dāng)前部門人員，不包含子部門，缺省為true

返回說明

返回JSON格式的人員對象數(shù)組。

[
    {
        'orgAccountId': -2332227039700957700,
        'id': 710000480641633900,
        'name': 's1',
        'loginName': 's1'
        // ...
    },
    {
        'orgAccountId': -2332227039700957700,
        'id': -889216812767428100,
        'name': 's2',
        'loginName': 's2'
        // ...
    }
]

返回值說明

正常情況下，會(huì)返回的是JSON格式人員信息，JSON數(shù)據(jù)包參考：人員對象示例

參數(shù)說明請參考:人員對象屬性說明

1.6.11. 取得指定崗位的所有人員

取指定崗位的所有人員，不包含停用人員。

接口請求說明：

http請求方式：GET
http://ip:port/seeyon/rest/orgMembers/post/{postId}
如
http://127.0.0.1/seeyon/rest/orgMembers/post/-2779802668474544380

參數(shù)說明：

參數(shù)	是否必須	說明
postId	是	崗位Id

返回說明

返回JSON格式的人員對象數(shù)組。

[
    {
        'orgAccountId': -2332227039700957700,
        'id': 710000480641633900,
        'name': 's1',
        'loginName': 's1'
        // ...
    },
    {
        'orgAccountId': -2332227039700957700,
        'id': -889216812767428100,
        'name': 's2',
        'loginName': 's2'
        // ...
    }
]

返回值說明

正常情況下，會(huì)返回的是JSON格式人員信息，JSON數(shù)據(jù)包參考：人員對象示例

參數(shù)說明請參考:人員對象屬性說明

1.6.12. 取得指定職務(wù)級別的所有人員

取指定職務(wù)級別的所有人員，不包含停用人員。

接口請求說明：

http請求方式：GET
http://ip:port/seeyon/rest/orgMembers/level/{levelId}
如
http://127.0.0.1/seeyon/rest/orgMembers/level/3176188816548513663

參數(shù)說明：

參數(shù)	是否必須	說明
leveld	是	職務(wù)級別Id

返回說明

返回JSON格式的人員對象數(shù)組。

[
    {
        'orgAccountId': -2332227039700957700,
        'id': 710000480641633900,
        'name': 's1',
        'loginName': 's1'
        // ...
    },
    {
        'orgAccountId': -2332227039700957700,
        'id': -889216812767428100,
        'name': 's2',
        'loginName': 's2'
        // ...
    }
]

返回值說明

正常情況下，會(huì)返回的是JSON格式人員信息，JSON數(shù)據(jù)包參考：人員對象示例

參數(shù)說明請參考:人員對象屬性說明

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

參數(shù)說明：

參數(shù)	是否必須	說明
name	是	人員姓名，中文必須使用UTF-8進(jìn)行編碼，如“姓名”編碼后為“%E5%A7%93%E5%90%8D”

返回說明

正常情況下，會(huì)返回的是JSON格式人員信息，JSON數(shù)據(jù)包參考：人員對象示例

參數(shù)說明請參考:人員對象屬性說明

1.6.14. 新建人員(V6.0增加了副崗信息)

創(chuàng)建人員。

接口請求說明：

http請求方式：POST
http://ip:port/seeyon/rest/orgMember
如
http://127.0.0.1/seeyon/rest/orgMember

參數(shù)說明：

使用HTTP請求的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');//編號
            put('name', '夏強(qiáng)6');//姓名
           // put('sortId', 1);//排序號  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è)置的主崗中來選擇）
    resfg.put('postId', '-8953437412957663435');//指定副崗ID
    resfg.put('orgAccountId', '-4532703988283521957');//單位ID
    reslist.add(resfg);

    newMember.put('second_post', reslist);
}

V7.1支持通過單位、部門、職務(wù)和崗位編碼設(shè)置人員信息，包括副崗中的單位、部門、職務(wù)和崗位，且兼容之前通過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');}});//崗位編碼
        }
    };
}

返回說明

返回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
}

1.6.15. 批量新建人員(Since:V61)

批量創(chuàng)建人員。

接口請求說明：

http請求方式：POST
http://ip:port/seeyon/rest/orgMember/addMembers
如
http://127.0.0.1/seeyon/rest/orgMember/addMembers

參數(shù)說明：

將批量新建人員(Since:V61))中人員Map放入List中即可。

 List members=new ArrayList();
Map newMember = new HashMap() {
...
}
members.add(newMember);
client.post('orgMember/updateMembers',members,String.class);

V7.1支持通過單位、部門、職務(wù)和崗位編碼設(shè)置人員信息，詳情請參考新建人員(V6.0增加了副崗信息))中的編碼使用說明。

返回說明

創(chuàng)建人員成功則返回JSON格式人員信息。

1.6.16. 按Id修改人員信息【V6.0增加了副崗信息，以及修改人員LDAP目錄設(shè)置】

按人員Id修改人員信息

接口請求說明：

http請求方式：PUT
http://ip:port/seeyon/rest/orgMember
如
http://127.0.0.1/seeyon/rest/orgMember

參數(shù)說明：

使用HTTP請求的Body傳入JSON格式的人員信息

id必填，支持新建人員參數(shù)說明中所有參數(shù)，必須至少指定一項(xiàng)

{
    'id': 7115200831996735909, //【必填】
    'sortId': 20,
    'orgAccountId': 144, //【必填】
    'enabled': true
}

5.6版以后支持按編碼修改人員信息，此處id的類型由Long改為對象，field字段指定根據(jù)code來匹配人員，根據(jù)條件得到多個(gè)結(jié)果則會(huì)報(bào)錯(cuò)。

{
    'id': { 'field' : 'code' },
    'code': '001',
    'password': 'abcdef'
}

V5.6后增加了副崗信息信息的修改，具體參數(shù)請參照創(chuàng)建人員中副崗信息。

V5.6-V6.0增加了人員LDAP目錄設(shè)置

res.put('ldapbind', 'cn=paul.chen,ou=users,dc=seeyon,dc=com')

V7.1支持通過單位、部門、職務(wù)和崗位編碼設(shè)置人員信息，詳情請參考新建人員(V6.0增加了副崗信息))中的編碼使用說明。

返回說明

返回JSON格式。

指定人員未存在返回null。

返回結(jié)果的說明參見新建人員。

1.6.17. 按Id批量修改人員信息(Since:V61)

通過人員Id批量修改人員信息

接口請求說明：

http請求方式：POST
http://ip:port/seeyon/rest/orgMember/updateMembers
如
http://127.0.0.1/seeyon/rest/orgMember/updateMembers

參數(shù)說明：

將需要修改的多人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支持通過單位、部門、職務(wù)和崗位編碼設(shè)置人員信息，詳情請參考新建人員(V6.0增加了副崗信息))中的編碼使用說明。

返回說明

更新人員成功則返回JSON格式人員信息。

1.6.18. 按Id啟用/停用人員

按人員Id修改人員啟用和停用狀態(tài)

接口請求說明：

http請求方式：PUT
http://ip:port/seeyon/rest/orgMember/{id}/enabled/{enabled}
如
http://127.0.0.1/seeyon/rest/orgMember/-757960293000589356/enabled/true

參數(shù)說明：

參數(shù)	是否必須	說明
id	是	人員Id
enbaled	是	人員狀態(tài)：true為啟用，false為停用

返回說明

返回JSON格式。

指定人員未存在返回null。

返回結(jié)果的說明參見新建人員。

1.6.19. 按Id刪除人員

按人員Id刪除人員

接口請求說明：

http請求方式：DELETE
http://ip:port/seeyon/rest/orgMember/{memberId}
如
http://127.0.0.1/seeyon/rest/orgMember/-757960293000589356

參數(shù)說明：

參數(shù)	是否必須	說明
memberId	是	人員Id

返回說明

返回JSON格式。

指定人員未存在返回null。

返回結(jié)果的說明參見新建人員。

1.6.20. 驗(yàn)證人員有效性(Since:V5.6)

開發(fā)者可以通過【人員登錄名和密碼】來驗(yàn)證當(dāng)前人員有效性。

接口請求說明：

http請求方式：GET
http://127.0.0.1/seeyon/rest/orgMember/effective/loginName/{loginName}?password=xxxxxx

參數(shù)說明：

參數(shù)	是否必須	說明
loginName	是	登錄名
password	是	密碼

返回說明

返回true為有效，false為無效。

1.6.21. 獲取當(dāng)前部門及其下級部門人員總數(shù)

開發(fā)者可以通過【部門ID】來獲取指定部門下所有人員總數(shù)。

接口請求說明：

http請求方式：GET
http://ip:port/seeyon/rest/orgMembers/department/count/{departmentId}?firstLayer=false/true;

參數(shù)說明：

參數(shù)	是否必須	說明
departmentId	是	部門ID
firstLayer	否	true是只顯示直屬子部門,false是包含所有層級的部門

返回說明

返回JSON整數(shù)。

1.6.22. 批量新增/更新人員信息

開發(fā)者可以批量更新和新增人員。

接口請求說明：

http請求方式：PUT
http://ip:port/seeyon/rest/orgMembers

參數(shù)說明：

新建與更新的人員參數(shù)同

請求多人信息可以存放在List中傳遞。

V7.1支持通過單位、部門、職務(wù)和崗位編碼設(shè)置人員信息，詳情請參考新建人員(V6.0增加了副崗信息))中的編碼使用說明。

返回說明

正常情況下，會(huì)返回的是JSON格式人員信息，JSON數(shù)據(jù)包參考：人員對象示例

參數(shù)說明請參考:人員對象屬性說明

1.6.23. 批量刪除人員

開發(fā)者可以批量刪除人員。

接口請求說明：

http請求方式：PUT
http://ip:port/seeyon/rest/orgMembers/batchdelete

參數(shù)說明：

參數(shù)	是否必須	說明
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);

返回說明

返回JSON格式。指定人員未存在返回null。返回結(jié)果的說明參見新建人員。

1.6.24. 人員離職 (Since:V7.0)

開發(fā)者可以處理離職人員。

接口請求說明：

http請求方式：PUT
http://ip:port/seeyon/rest/orgMember/leave/{memberId}/{agentMemberId}
例如：
http://ip:port/seeyon/rest/orgMember/leave/12315646574656/7894561616687111

參數(shù)說明：

參數(shù)	是否必填	說明
memberId	是	離職人員Id
agentMemberId	是	代理人Id，0:清空代理人、-1或代理人無效:不做代理人設(shè)置處理,維持現(xiàn)狀、不為空且代理人有效，設(shè)置所有代辦事項(xiàng)的代理人為此人

CTPRestClient client = RestResource.getInstance().resouresClent();
client.post('orgMember/leave/12315646574656/7894561616687111', new HashMap(), String.class);

返回說明

返回JSON格式。組織模型實(shí)體操作息類。

1.7. 外部單位服務(wù)管理

外部單位服務(wù)管理(Since:V6.0)外部單位服務(wù)支持獲取當(dāng)前單位下所建立的外部單位信息。

1.7.1. 外部單位對象實(shí)例

外部單位對象實(shí)例

{
  '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ù)	說明
orgAccountId	外部單位所屬的單位ID
id	ID
name	名稱
code	編碼
createTime	創(chuàng)建時(shí)間
updateTime	更新時(shí)間
sortId	序號
enabled	是否啟用
path	路徑
type	類型
wholeName

1.7.2. 按照單位ID獲取外部單位列表

可以通過【單位ID】來獲取所屬的外部單位信息。

接口請求說明：

http請求方式：GET
http://ip:port/seeyon/rest/externalAccounts/{AccountId}

參數(shù)說明：

參數(shù)	是否必須	說明
AccountId	是	單位ID

返回說明

正常情況下，會(huì)返回的是JSON格式外部單位信息，JSON數(shù)據(jù)包參考：外部單位對象實(shí)例.

參數(shù)說明請參考:對象屬性說明

1.8. 外部人員服務(wù)管理

外部人員服務(wù)管理(Since:V6.0)外部人員服務(wù)支持獲取外部人員信息，以及增加和刪除外部人員信息。

1.8.1. 外部人員對象

外部人員對象實(shí)例

{
  '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:外部職務(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ù)	說明
orgAccountId	單位ID
extAccountName	單位名稱
orgDepartmentId	部門ID
extWorkScopeValue	工作范圍對應(yīng)部門
extRoles	外部人員權(quán)限
extRoleIds	權(quán)限ID
extWorkScope	工作范圍對應(yīng)部門
code	編號
name	姓名
sortId	排序號
isInternal
isChangePWD
isLoginNameModifyed
isNewLdap
isNewMember
loginName	登錄名
password	密碼
password2	密碼
primaryLanguange	語言類型
enabled	啟用
orgPostId
orgLevelId
telnumber	移動(dòng)電話
officenumber	辦公電話
emailaddress	電子郵件
extgender	性別
extAccountName	所在外單位
birthday	生日
extlevelName	外部職務(wù)
extprimaryPost	外部崗位

1.8.2. 按照外部單位ID獲取，外單位所有人員

可以通過【外部單位ID】來獲取所屬的外部單位下的外部人員。

接口請求說明：

http請求方式：GET
http://ip:port/seeyon/rest/externalMembers/externalAccountId/{externalAccountId}

參數(shù)說明：

參數(shù)	是否必須	說明
externalAccountId	是	外部單位ID

返回說明

正常情況下，會(huì)返回的是JSON格式外部人員信息，JSON數(shù)據(jù)包參考：外部人員對象實(shí)例

參數(shù)說明請參考:對象屬性說明

1.8.3. 按照單位ID獲取，當(dāng)前單位下所有外部人員

可以通過【單位ID】來獲取所屬的外部單位下的外部人員。

接口請求說明：

http請求方式：GET
http://ip:port/seeyon/rest/externalMembers/accountId/{accountId}

參數(shù)說明：

參數(shù)	是否必須	說明
accountId	是	單位ID

返回說明

正常情況下，會(huì)返回的是JSON格式外部人員信息，JSON數(shù)據(jù)包參考：外部人員對象實(shí)例

參數(shù)說明請參考:對象屬性說明

1.8.4. 按照外部人員登錄名獲取人員信息

可以通過【外部人員登錄名】來獲取所屬的外部人員信息。

接口請求說明：

http請求方式：GET
http://ip:port/seeyon/rest/externalMembers/loginName/{loginName}

參數(shù)說明：

參數(shù)	是否必須	說明
loginName	是	外部人員登錄名

返回說明

正常情況下，會(huì)返回的是JSON格式外部人員信息，JSON數(shù)據(jù)包參考：外部人員對象實(shí)例

參數(shù)說明請參考:對象屬性說明

1.8.5. 按照外部人員ID獲取人員信息

可以通過【外部人員ID】來獲取所屬的外部人員信息

接口請求說明：

http請求方式：GET
http://ip:port/seeyon/rest/externalMembers/externalMemberId/{externalMemberId}?accountId={accountId}

參數(shù)說明：

參數(shù)	是否必須	說明
externalMemberId	是	外部人員ID

返回說明

正常情況下，會(huì)返回的是JSON格式外部人員信息，JSON數(shù)據(jù)包參考：外部人員對象實(shí)例

參數(shù)說明請參考:對象屬性說明

1.8.6. 新增外部人員

創(chuàng)建外部人員信息。

接口請求說明：

http請求方式：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');//--工作范圍對應(yīng)部門
            put('extRoles', '外部人員權(quán)限');//權(quán)限       --   
            put('extRoleIds', '4649394686314365441');//權(quán)限ID
            put('extWorkScope', '部門1,');//--工作范圍對應(yīng)部門
            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');//移動(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--

返回說明

成功，返回的是新創(chuàng)建人員的ID。失敗，返回空。

1.8.7. 通過ID刪除外部人員

可以通過【外部人員ID】來刪除的外部人員信息。

接口請求說明：

http請求方式：DELETE
http://ip:port/seeyon/rest/externalMembers/{externalMemberId}

參數(shù)說明：

參數(shù)	是否必須	說明
externalMemberId	是	外部人員ID

返回說明

正常情況下，刪除成功返回true,失敗返回FALSE。

1.9. 兼職服務(wù)管理

兼職服務(wù)管理(Since:V5.6 -V6.0)兼職服務(wù)管理支持對于單位兼職信息的查詢與新建等操作。

1.9.1. 兼職服務(wù)對象

兼職對象實(shí)例

{
    '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ù)	說明
id	兼職ID
orgAccountId	單位ID
sortId	排序
sourceId
objective6Id
objective0Id	部門ID
objective1Id	崗位ID
objective5Id
objective2Id	職務(wù)ID
objective3Id
objective4Id
objective7Id	權(quán)限ID
conMemberName	人名(原單位簡稱)
souAccountName	原單位名稱
souPAnames	原崗位名稱(原單位簡稱)
tarAccountName	兼職單位名稱
tarDPAnames	兼職單位部門-兼職單位崗位

1.9.2. 獲取兼職列表

獲取兼職列表信息（以翻頁模式返回）

接口請求說明：

http請求方式：GET
http://ip:port/seeyon/rest/orgPartTimeJob/list?pageNo={pageNo}&pageSize={pageSize}

參數(shù)說明：

參數(shù)	是否必須	說明
pageNo	是	列表第一條開始的位置號，“0”為第一條
pageSize	是	獲取列表?xiàng)l數(shù)

返回說明

正常情況下，會(huì)返回的是JSON格式兼職信息，JSON數(shù)據(jù)包參考：兼職對象實(shí)例

參數(shù)說明請參考:對象屬性說明

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}

參數(shù)說明：

參數(shù)	是否必須	說明
type=input	是	條件固定值
condition=cCode	是	條件類型{cCode=通過code查詢，除外還可以通過名字查詢cMemberName}
value={code}	是	編號值
accountid	是	單位ID

返回說明

正常情況下，會(huì)返回的是JSON格式兼職信息，JSON數(shù)據(jù)包參考：兼職對象實(shí)例

參數(shù)說明請參考:對象屬性說明

#

1.9.4. 通過code獲取對內(nèi)單位兼職信息

通過CODE 獲取對本單位兼職信息

接口請求說明：

http請求方式：GET
http://ip:port/seeyon/rest/orgPartTimeJob/insidelist?condition=type%3D\'input\',condition%3D\'cCode\',value%3D\'(code)\'&accountid={accountid}

參數(shù)說明：

參數(shù)	是否必須	說明
type=input	是	條件固定值
condition=cCode	是	條件類型{cCode=通過code查詢，除外還可以通過名字查詢cMemberName}
value={code}	是	編號值
accountid	是	單位ID

返回說明

正常情況下，會(huì)返回的是JSON格式兼職信息，JSON數(shù)據(jù)包參考：兼職對象實(shí)例

參數(shù)說明請參考:對象屬性說明

1.10. #

1.10.1. 通過ID獲取兼職信息

通過ID 獲取兼職信息

接口請求說明：

http請求方式：GET
http://ip:port/seeyon/rest/orgPartTimeJob/{id}

參數(shù)說明：

參數(shù)	是否必須	說明
id	是	兼職ID

返回說明

正常情況下，會(huì)返回的是JSON格式兼職信息，JSON數(shù)據(jù)包參考：兼職對象實(shí)例

參數(shù)說明請參考:對象屬性說明

1.10.2. 新增兼職

新建兼職信息

接口請求說明：

http請求方式：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)');//人名(原單位簡稱)
 res.put('sortId', '');
 res.put('code', '4');
 res.put('primaryPost', '技術(shù)(56sp1)');//原崗位名稱(原單位簡稱)
 res.put('cAccount', 'addAccount2');//兼職單位名稱
 res.put('cDept', 'add2-管理部(test2)');//兼職單位部門名稱(兼職單位簡稱)
 res.put('cPost', 'add2-行政崗位ie(test2)');//兼職單位部門名稱(兼職單位簡稱)
 res.put('cLevel', 'dd2-經(jīng)理職務(wù)');//兼職單位職務(wù)名稱
 res.put('cRoles', '普通人員權(quán)限');//兼職單位權(quán)限名稱

返回說明

正常情況下，會(huì)返回的是JSON格式兼職信息，JSON數(shù)據(jù)包參考：兼職對象實(shí)例

參數(shù)說明請參考:對象屬性說明

1.10.3. 按照兼職ID刪除兼職

按照兼職ID刪除兼職

接口請求說明：

http請求方式：DELETE
http://ip:port/seeyon/rest/orgPartTimeJob/delete/{ID}

參數(shù)說明：

參數(shù)	是否必須	說明
id	是	兼職ID

返回說明

正常情況下，會(huì)返回的是JSON格式兼職信息，JSON數(shù)據(jù)包參考：兼職對象實(shí)例

參數(shù)說明請參考:對象屬性說明

1.10.4. 修改兼職信息

修改兼職信息

接口請求說明：

http請求方式：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)');//人名(原單位簡稱)
 res.put('sortId', '');
 res.put('code', '6');
 res.put('primaryPost', '技術(shù)(56sp1)');//原崗位名稱(原單位簡稱)
 res.put('cAccount', 'addAccount2');//兼職單位名稱
 res.put('cDept', 'add2-管理部(test2)');//兼職單位部門名稱(兼職單位簡稱)
 res.put('cPost', 'add2-行政崗位ie(test2)');//兼職單位部門名稱(兼職單位簡稱)
 res.put('cLevel', 'dd2-經(jīng)理職務(wù)');//兼職單位職務(wù)名稱
 res.put('cRoles', '普通人員權(quán)限');//兼職單位權(quán)限名稱

返回說明

正常情況下，會(huì)返回的是JSON格式兼職信息，JSON數(shù)據(jù)包參考：兼職對象實(shí)例

參數(shù)說明請參考:對象屬性說明

1.11. 權(quán)限服務(wù)管理

權(quán)限服務(wù)管理支持對于權(quán)限信息的查詢等操作。

1.11.1. 權(quán)限對象

權(quán)限對象實(shí)例

{
    '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ù)	說明
id	權(quán)限ID
name	名稱
sortId	排序
isBenchmark
showName	名稱
status	狀態(tài)
entityType	類型
code	編碼
orgAccountId	單位ID
enabled	是否啟用
type

1.11.2. 根據(jù)單位ID獲取權(quán)限列表

根據(jù)單位ID獲取權(quán)限列表

接口請求說明：

http請求方式：GET
http://ip:port/seeyon/rest/role/accountrole/{accountId}

參數(shù)說明：

參數(shù)	是否必須	說明
accountId	是	單位ID

返回說明

正常情況下，會(huì)返回的是JSON格式權(quán)限信息，JSON數(shù)據(jù)包參考：權(quán)限對象實(shí)例

參數(shù)說明請參考:對象屬性說明

1.11.3. 添加部門角色(Since:V61)

以集團(tuán)管理員是身份添加部門角色.

接口請求說明

http請求方式：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);

返回說明

創(chuàng)建角色成功則返回角色I(xiàn)D。

1.11.4. 獲取部門下的所有部門角色(Since:V61)

根據(jù)部門id，獲取部門下的所有部門角色

接口請求說明

http請求方式：GET
http://ip:port/seeyon/rest/role/departmentRole/{departmentId}

參數(shù)說明：

參數(shù)	是否必須	說明
departmentId	是	部門ID

返回說明

請求成功，返回部門下對應(yīng)角色JSON信息。

1.11.5. 獲取部門下對應(yīng)的角色人員(Since:V61)

根據(jù)部門id 和角色id 獲取部門下對應(yīng)的角色人員.

接口請求說明

http請求方式：GET
http://ip:port/seeyon/rest/role/departmentRoleMembers/{departmentId}/{roleId}

參數(shù)說明：

參數(shù)	是否必須	說明
departmentId	是	部門ID
roleId	是	角色I(xiàn)D(org_role表ID)

返回說明

請求成功，返回部門下對應(yīng)角色人員的JSON信息。

1.11.6. 更新部門下對應(yīng)的角色人員(Since:V61)

根據(jù)部門id 和角色id 更新部門下對應(yīng)的角色人員.

接口請求說明

http請求方式：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);

返回說明

跟新角色人員成功則返回成功提示。

本站是提供個(gè)人知識(shí)管理的網(wǎng)絡(luò)存儲(chǔ)空間，所有內(nèi)容均由用戶發(fā)布，不代表本站觀點(diǎn)。請注意甄別內(nèi)容中的聯(lián)系方式、誘導(dǎo)購買等信息，謹(jǐn)防詐騙。如發(fā)現(xiàn)有害或侵權(quán)內(nèi)容，請點(diǎn)擊一鍵舉報(bào)。

轉(zhuǎn)藏 分享

QQ空間 QQ好友新浪微博微信

獻(xiàn)花（0） +1

來自： cc龍卷風(fēng) > 《待分類》

舉報(bào)/認(rèn)領(lǐng)

0條評論

發(fā)表

請遵守用戶評論公約

類似文章 更多

cc龍卷風(fēng)

關(guān)注對話

TA的最新館藏

寫寫保定航校，我出生的大院
微信突然更新，新增六個(gè)功能，最后一個(gè)被罵慘了
WPS專業(yè)版來了，解鎖會(huì)員功能，永久免費(fèi)使用
軟件秒瘦身！這款工具太逆天了
無限多開，再也不怕對象查手機(jī)了！
新發(fā)現(xiàn)！iOS16永久屏蔽升級，不用擔(dān)心自動(dòng)升級

喜歡該文的人也喜歡更多

熱門閱讀換一換

乡下人产国偷v产偷v自拍,国产午夜片在线观看,婷婷成人亚洲综合国产麻豆,久久综合给合久久狠狠狠9

組織模型管理 · 致遠(yuǎn)開放平臺(tái)

1. 組織模型管理

1.1. 更新接口返回值說明

1.1.1. 返回值示例

1.1.2. 返回值說明

1.1.3. 狀態(tài)碼

1.2. 部門管理

1.2.1. 部門對象

部門對象示例

部門對象屬性說明

部門創(chuàng)建更新返回對象示例

1.2.2. 按部門ID取部門信息

1.2.3. 按部門編碼取部門信息

1.2.4. 獲取指定單位的所有部門(不包含停用)

1.2.5. 獲取指定單位的所有部門數(shù)量(不包含停用)

1.2.6. 獲取指定單位的所有部門(包含停用)

1.2.7. 創(chuàng)建部門

1.2.8. 批量創(chuàng)建部門(Since:V61)

1.2.9. 按部門Id修改部門信息

1.2.10. 批量修改部門(Since:V61)

1.2.11. 按部門Id刪除部門

1.2.12. 按部門Id啟用/停用部門

1.2.13. 獲取指定部門下的所有子部門

1.2.14. 獲取指定部門父級部門

1.2.15. 按部門編碼修改部門信息(Since:V6.0)

1.2.16. 按照部門編碼啟用/停用部門信息(Since:V6.0)

1.2.17. 按照部門編碼刪除部門(Since:V6.0)

1.2.18. 按照單位編碼獲取所有部門信息(包含停用部門)(Since:V6.0)

1.2.19. 按部門編碼獲取所有所有子部門(Since:V6.0)

1.2.20. 根據(jù)部門編碼獲取部門兼職人員信息(Since:V6.0)

1.2.21. 根據(jù)部門ID查看部門崗位(Since:V6.0)

1.2.22. 根據(jù)部門ID跟新部門崗位(Since:V6.0)

1.2.23. 根據(jù)部門ID查看部門[部門主管、分管領(lǐng)導(dǎo)、部門管理員、部門公文收發(fā)員](Since:V6.0)

1.2.24. 更新部門管理角色[主管，領(lǐng)導(dǎo)，管理員，公文收發(fā)員](Since:V6.0)

1.2.25. 按照編碼更新部門管理角色[主管，領(lǐng)導(dǎo)，管理員，公文收發(fā)員](Since:V7.1)

1.2.26. 按照部門編碼獲取部門主管、分管領(lǐng)導(dǎo)、部門管理員、部門公文收發(fā)員(Since:V6.0)

1.3. 崗位管理

1.3.1. 崗位對象示例

1.3.2. 崗位對象屬性說明

1.3.3. 崗位創(chuàng)建更新返回對象示例

1.3.4. 按崗位Id取崗位信息

1.3.5. 獲取指定單位的所有崗位(不包含停用)

1.3.6. 獲取指定單位的所有崗位數(shù)量(不包含停用)

1.3.7. 獲取指定單位的所有崗位(包含停用)

1.3.8. 獲取指定單位的所有崗位數(shù)量(包含停用)

1.3.9. 創(chuàng)建崗位

1.3.10. 批量創(chuàng)建崗位(Since:V61)

1.3.11. 按崗位Id修改崗位信息

1.3.12. 按崗位Id批量修改崗位信息(Since:V61)

1.3.13. 按崗位Id刪除崗位信息

1.3.14. 按崗位Id啟用/禁用崗位

1.3.15. 按崗位編碼停用/啟用崗位(Since:V6.0)

1.3.16. 按崗位編碼刪除崗位

1.3.17. 按崗位編碼修改崗位

1.4. 職務(wù)管理

1.4.1. 職務(wù)對象

職務(wù)對象示例

職務(wù)對象屬性說明

職務(wù)創(chuàng)建更新返回對象示例

1.4.2. 按職務(wù)級別Id取職務(wù)級別信息

1.4.3. 獲取指定單位的所有職務(wù)級別(不包含停用)

1.4.4. 獲取指定單位的所有職務(wù)級別(包含停用)

1.4.5. 創(chuàng)建職務(wù)級別

1.4.6. 按職務(wù)級別Id修改職務(wù)級別信息

1.4.7. 按職務(wù)級別Id刪除職務(wù)級別

1.4.8. 按職務(wù)級別Id啟用/禁用職務(wù)級別

1.4.9. 按職務(wù)級別編碼啟用/禁用職務(wù)級別

1.4.10. 按職務(wù)級別編碼刪除職務(wù)

1.4.11. 按職務(wù)編碼修改職務(wù)

1.5. 單位管理

1.5.1. 單位對象

單位對象示例

單位對象屬性說明

1.5.2. 按單位名稱取單位信息

1.5.3. 按單位Id取單位的信息

1.5.4. 取指定單位的管理員

1.5.5. 新增單位(Since:V5.6 )【V6.0 增加單位管理員】

1.5.6. 取所有單位信息

1.5.7. 按單位Id刪除單位

1.2.23. 根據(jù)部門ID查看部門[部門主管、分管領(lǐng)導(dǎo)、部門管理員、部門公文收發(fā)員](Since:V6.0)

1.2.24. 更新部門管理角色[主管，領(lǐng)導(dǎo)，管理員，公文收發(fā)員](Since:V6.0)

1.2.25. 按照編碼更新部門管理角色[主管，領(lǐng)導(dǎo)，管理員，公文收發(fā)員](Since:V7.1)

1.2.26. 按照部門編碼獲取部門主管、分管領(lǐng)導(dǎo)、部門管理員、部門公文收發(fā)員(Since:V6.0)

1.6.16. 按Id修改人員信息【V6.0增加了副崗信息，以及修改人員LDAP目錄設(shè)置】

1.8.2. 按照外部單位ID獲取，外單位所有人員

1.8.3. 按照單位ID獲取，當(dāng)前單位下所有外部人員