1. 组织模型管理

本接口用来获取组织模型基本信息

组织模型服务支持获取人员,岗位,职务,部门,单位等数据。

1.1. 更新接口返回值说明

新增修改部门、岗位、职务级别和人员时的返回值。

1.1.1. 返回值示例

成功示例:创建人员

{
    "successMsgs": [
        {
            "code": "SUCCESS",
            "ent": {
                "orgAccountId": -2332227039700957700,
                "id": 7998660249083069000,
                "name": "新建人员",
                "code": "A002",
                "createTime": 1398417138169,
                "updateTime": 1398417138169,
                "sortId": 20,
                "isDeleted": false,
                "enabled": false,
                "status": 1,
                "description": "描述",
                "orgLevelId": 3176188816548514000,
                "orgPostId": -2779802668474544000,
                "orgDepartmentId": 8422701464295851000,
                "type": 1,
                "isInternal": true,
                "isLoginable": true,
                "isVirtual": false,
                "isAssigned": true,
                "isAdmin": false,
                "isValid": false,
                "state": 1,
                "properties": {
                    "birthday": 1398096000000,
                    "postalcode": "",
                    "emailaddress": "",
                    "extPostLevel": "",
                    "website": "",
                    "address": "",
                    "officenumber": "",
                    "gender": "1",
                    "telnumber": "",
                    "blog": "",
                    "imageid": ""
                },
                "second_post": [ ],
                "concurrent_post": [ ],
                "valid": false,
                "telNumber": null,
                "birthday": 1398096000000,
                "officeNum": null,
                "emailAddress": null,
                "gender": 1,
                "loginName": "newUser"
"
            }
        }
    ],
    "errorMsgs": [ ],
    "success": true
}

失败示例:创建岗位:

{
    "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. 返回值说明

参数 说明
success 执行状态,true为执行成功,false为失败
successMsgs success为true时,返回值执行的状态码和成功新建(更新)后的组织模型实体
errorMsgs success为false时,返回执行的状态码和出错的组织模型实体
--code 状态码,参见状态码
--entity 组织模型实体

1.1.3. 状态码

参数 说明
ACCOUNT_CUSTOM_LOGIN_URL_DUPLICATED 单位自定义登录页地址不能重复
ACCOUNT_EXIST_CHILDACCOUNT 单位下存在未删除的子单位
ACCOUNT_EXIST_CHILDACCOUNT_ENABLE 单位存在有效子单位不允许停用
ACCOUNT_EXIST_DEPARTMENT 单位下存在未删除的部门
ACCOUNT_EXIST_DEPARTMENT_ENABLE 单位存在有效的部门不允许停用
ACCOUNT_EXIST_ENTITY 单位下存在未删除的组织模型实体
ACCOUNT_EXIST_LEVEL 单位下存在未删除的职务级别
ACCOUNT_EXIST_LEVEL_ENABLE 单位存在有效职务不允许停用
ACCOUNT_EXIST_MEMBER 单位下存在未删除的人员
ACCOUNT_EXIST_MEMBER_ENABLE 单位内存在有效人员不允许停用
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 单位管理员名称重复
ACCOUNT_REPEAT_CODE 单位编码重复
ACCOUNT_REPEAT_NAME 单位名称重复
ACCOUNT_REPEAT_SHORT_NAME 单位名称重复
DEPARTMENT_EXIST_MEMBER 部门存在成员
DEPARTMENT_EXIST_TEAM 部门存在组
DEPARTMENT_PARENTDEPT_DISABLED 父部门禁用
DEPARTMENT_PARENTDEPT_ISCHILD 父部门是自己的子部门
DEPARTMENT_PARENTDEPT_SAME 与父部门相同(检查父部门是否是自己)
DEPARTMENT_PARENTID_NULL 父部门ID为空
DEPARTMENT_REPEAT_CODE 部门编码重复
DEPARTMENT_REPEAT_NAME 部门名称重复
DUTYLEVEL_EXIST_MEMBER 政务版--职级存在成员
LEVEL_EXIST_MAPPING 存在职务级别的映射
LEVEL_EXIST_MEMBER 职务存在成员
LEVEL_REPEAT_NAME 存在职务级别的映射
MEMBER_CANNOT_DELETE 人员有公共信息管理员或者审核员等身份,或其他为清理事项,删除失败
MEMBER_DEPARTMENT_DISABLED 人员所在部门不可用
MEMBER_EXIST_SIGNET 人员存在授权印章
MEMBER_LEVEL_DISABLED 人员所在职务不可用
MEMBER_NOT_EXIST 人员不存在(常用在修改和删除时)
MEMBER_POST_DISABLED 人员所在岗位不可用
MEMBER_REPEAT_CODE 人员编码重复
MEMBER_REPEAT_POST 人员副岗和主岗重复
OUT_PER_NUM 添加的人员数量大于单位剩余的可注册数量,不允许添加人员!
POST_EXIST_BENCHMARK 基准岗位已引用
POST_EXIST_MEMBER 岗位存在成员
POST_REPEAT_NAME 岗位名称重复
PRINCIPAL_NOT_EXIST 登录名不存在
PRINCIPAL_REPEAT_NAME 人员帐号名称重复
REPEAT_PATH PATH重复
ROLE_NOT_EXIST 角色不存在
SUCCESS 完全成功

1.2. 部门管理

部门管理服务支持获取,创建,修改,删除部门数据。

1.2.1. 部门对象

部门对象示例

   {
     "orgAccountId": 967547186016371000, 【必填】
    "id": 7313901301646381000,
    "name": "部门名称", 【必填】
    "enabled": true,
    "sortId": 2,
    "isGroup": false,
    "superior": 967547186016371000, 【必填】
    "path": "000000050002",

    "code": "",
    "createTime": 1394418149000,
    "updateTime": 1394418149000,
    "isDeleted": false,
    "status": 1,
    "description": "",
    "shortName": null,
    "secondName": null,
    "isInternal": true,
    "levelScope": -1,
    "type": "Department",
    "properties": {
        "unitCategory": null,
        "fax": null,
        "unitMail": null,
        "accessLevels": null,
        "customLoginUrl": null,
        "ldapOu": null,
        "address": null,
        "chiefLeader": null,
        "zipCode": null,
        "telephone": null,
        "permissionType": null,
        "isCustomLoginUrl": null,
        "ipAddress": null
    },
    "superiorName": "",
    "sortIdType": "1",
    "entityType": "Department",
    "depManager": null,
    "depAdmin": null,
    "posts": [ ],
    "valid": true,
    "group": false,
    "customLogin": false,
    "parentPath": "00000005",
    "customLoginUrl": null
}

部门对象属性说明

参数 说明
orgAccountId 所属单位ID
id ID
name 部门名称
code 部门代码
sortId 排序号
shortName 单位简称
createTime 创建时间
updateTime 修改时间
isDeleted 是否删除
enabled 是否启用
status 状态
description 描述
path 路径
secondName 外文名称,对部门无效,保留字段
isInternal 是否是内部机构
isGroup 是否是集团
levelScope 只对type=account有效
type 类型
fax 传真
unitMail 邮件
address 地址
chiefLeader 负责人
zipCode 邮编
telephone 电话
superior 上级部门Id,一级部门则为所属单位Id
sortIdType
isCanAccess 是否允许访问
entityType 实体类型
valid 是否合法
parentPath 父部门的路径

部门创建更新返回对象示例

部门创建/更新成功返回对象示例

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

部门创建/更新失败返回对象示例

{
    "successMsgs": [ ],
    "errorMsgs": [
        {
            "code": "POST_REPEAT_NAME",
            "ent": {
                "orgAccountId": 967547186016371000,
                "id": -255377732695800220,
                "name": "部门名称",
                "code": "999",
                "createTime": 1394418123000,
                "updateTime": 1394418123000,
                "sortId": 1,
                "isDeleted": false,
                "enabled": true,
                "status": 1,
                "description": "",
                "path": "000000050001",
                "shortName": null,
                "secondName": null,
                "isInternal": true,
                "isGroup": false,
                "levelScope": -1,
                "type": "Department",
                "properties": {
                    "unitCategory": null,
                    "fax": null,
                    "unitMail": null,
                    "accessLevels": null,
                    "customLoginUrl": null,
                    "ldapOu": null,
                    "address": null,
                    "chiefLeader": null,
                    "zipCode": null,
                    "telephone": null,
                    "permissionType": null,
                    "isCustomLoginUrl": null,
                    "ipAddress": null
                },
                "superior": 967547186016371000,
                "superiorName": "",
                "sortIdType": "1",
                "entityType": "Department",
                "depManager": null,
                "depAdmin": null,
                "posts": [
                    -1438182393845429500
                ],
                "valid": true,
                "group": false,
                "customLogin": false,
                "parentPath": "00000005",
                "customLoginUrl": null
            }
        }
    ],
    "success": false
}

1.2.2. 按部门ID取部门信息

开发者可以通过【部门ID】来获取部门信息。

接口调用请求说明:

http请求方式:GET
http://ip:port/seeyon/rest/orgDepartment/{id}
参数 是否必须 说明
id 部门ID

返回说明:

正常情况下,会返回的是JSON格式部门信息,JSON数据包参考:部门对象示例

参数说明 请参考:部门对象属性说明

如果录入的部门ID错误或者为空时,返回JSON格式部门信息的为空.

1.2.3. 按部门编码取部门信息

开发者可以通过【部门编码】来获取部门信息。

接口调用请求说明:

http请求方式:GET
http://ip:port/seeyon/rest/orgDepartment/code/{code}
参数 是否必须 说明
code 部门编码

返回说明:

正常情况下,会返回的是JSON格式部门信息,JSON数据包参考:部门对象示例

参数说明 请参考:部门对象属性说明

如果录入的部门编码错误或者为空时,返回JSON格式部门信息的为空.

1.2.4. 获取指定单位的所有部门(不包含停用)

开发者可以通过【单位ID】来获取单位下所有部门信息(不包含停用部门)。

接口调用请求说明:

http请求方式:GET
http://ip:port/seeyon/rest/orgDepartments/{accountId}
参数 是否必须 说明
accountId 单位ID

返回说明

正常情况下,会返回的是JSON格式部门信息,JSON数据包参考:部门对象示例

参数说明 请参考:部门对象属性说明

如果录入的单位ID错误或者为空时,返回JSON格式部门信息的为空.

1.2.5. 获取指定单位的所有部门数量(不包含停用)

开发者可以通过【单位ID】来获取部门的数量(不包含停用部门)。

接口调用请求说明:

http请求方式:GET
http://ip:port/seeyon/rest/orgDepartments/count/{accountId}
参数 是否必须 说明
accountId 单位ID

返回说明

正常情况下,会返回的是JSON格式部门信息,JSON数据包参考:部门对象示例

参数说明 请参考:部门对象属性说明

正常情况下,会返回的是Integer类型的数值。

如果录入的单位ID错误或者为空时,返回信息为空。

1.2.6. 获取指定单位的所有部门(包含停用)

开发者可以通过【单位ID】来获取单位下所有部门信息(包含停用部门)。

接口调用请求说明:

http请求方式:GET
http://ip:port/seeyon/rest/orgDepartments/all/{accountId}
参数 是否必须 说明
accountId 单位ID

返回说明

正常情况下,会返回的是JSON格式部门信息,JSON数据包参考:部门对象示例

参数说明 请参考:部门对象属性说明

如果录入的单位ID错误或者为空时,返回JSON格式部门信息的为空.

1.2.7. 创建部门

开发者可以将部门相关参数组装为JSON类型,来创建部门信息。

接口请求说明:

http请求方式:POST
http://ip:port/seeyon/rest/orgDepartment
参数 是否必须 说明
orgAccountId 单位ID
code 编号
name 名称
description 描述
enabled 是否启用
superior 父部门ID

组装新建部门JSON数据,请参照:部门对象示例只需要将示例对象中标明为【必填】(不包括ID)参数组装即可。

正常情况下,创建成功会返回成功的标识以及JSON格式部门信息,返回JSON数据信息请参考:部门创建更新返回对象示例

如果创建失败,同样会返回失败的标识,并且在【"errorMsgs"】参数中给出创建失败的原因以及JSON信息。

1.2.8. 批量创建部门(Since:V61)

将需要创建的多个部门Map放入List中批量创建部门信息。【注意:单位下必须没有启用的部门,才能够进行批量创建】

接口请求说明:

http请求方式:POST
http://ip:port/seeyon/rest/orgDepartment/addDepartments

创建数据示例:

List reslist=new ArrayList();
Map newDep = new HashMap() {
{
put("orgAccountId", "5269865115340261356"); //单位ID
put("code", "auto1");//编号
put("name", "REST创建");//名称
put("description", "描述");
 put("enabled","true");//启用是否
put("superior", "5269865115340261356");//父级ID
}
};
Map newDep2 = new HashMap() {
...
}
reslist.add(newDep);
reslist.add(newDep2);
client.post("/orgDepartment/addDepartments",reslist, String.class);

返回说明

创建部门成功则返回JSON格式部门信息。

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

开发者可以通过部门ID修改对应的部门信息。

接口请求说明:

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

创建数据示例:

{
    "Id": 需修改的部门ID, 【必填】
    "code": 要修改部门参数, 【必填】
}

返回说明

正常情况下,创建成功会返回成功的标识以及JSON格式部门信息,返回JSON数据信息请参考:部门创建更新返回对象示例

部门ID不存在,那么返回信息为空。

如果失败,同样会返回失败的标识,并且在【"errorMsgs"】参数中给出创建失败的原因以及JSON信息。

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

将需要修改的多个部门Map放入List中批量创建部门信息。

接口请求说明:

http请求方式:POST
http://ip:port/seeyon/rest/orgDepartment/updateDepartments

创建数据示例:

List reslist=new ArrayList();
Map res = new HashMap();
res.put("id","-7591078065748751151");
res.put("description","批量修改");
reslist.add(res);
client.post("/orgDepartment/updateDepartments",reslist, String.class);

返回说明

修改部门成功则返回JSON格式部门信息。

1.2.11. 按部门Id删除部门

开发者可以通过部门ID删除对应的部门信息。

接口请求说明:

http请求方式:DELETE
http://ip:port/seeyon/rest/orgDepartment/{id}
参数 是否必须 说明
id 部门ID

返回说明

因为删除目前接口采用异步模式,暂无返回值信息。

1.2.12. 按部门Id启用/停用部门

开发者可以通过部门ID以及enabled字段信息来启用禁用对应的部门信息。

接口请求说明:

http请求方式:PUT
http://ip:port/seeyon/rest/orgDepartment/{id}/enabled/{enabled}
参数 是否必须 说明
id 部门ID
enabled 部门是否启用【true.启动;false停止】

创建数据示例:

组装修改部门启用/禁用JSON数据的参数只需要部门的ID以及enabled参数信息即可,示例如下:

{
    "Id": 部门ID, 【必填】
    "enabled": true, 【必填】
}

1.2.13. 获取指定部门下的所有子部门

开发者可以通过【部门ID】来获取指定部门下所有部门信息。

接口调用请求说明:

http请求方式:GET
http://ip:port/seeyon/rest/orgDepartments/children/{parentId}?firstLayer=false/true;
参数 是否必须 说明
parentId 部门ID
firstLayer true是只显示直属子部门,false是包含所有层级的部门

返回说明

正常情况下,会返回的是JSON格式部门信息,JSON数据包参考:部门对象示例

参数说明 请参考:部门对象属性说明

如果录入的单位ID错误或者为空时,返回JSON格式部门信息的为空.

1.2.14. 获取指定部门父级部门

开发者可以通过【部门ID】来获取指定部门父级部门信息。

接口调用请求说明:

http请求方式:GET
http://ip:port/seeyon/rest/orgDepartments/parent/{departmentId}?firstLayer=false/true;
参数 是否必须 说明
departmentId 部门ID
firstLayer true是只显示直属子部门,false是包含所有层级的部门

返回说明

正常情况下,会返回的是JSON格式部门信息,JSON数据包参考:部门对象示例

参数说明 请参考:部门对象属性说明

如果录入的单位ID错误或者为空时,返回JSON格式部门信息的为空.

1.2.15. 按部门编码修改部门信息(Since:V6.0)

开发者可以通过部门编码修改对应的部门信息。

接口请求说明:

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

创建数据示例:

field字段指定根据code来匹配部门,根据条件得到多个结果则会报错。
{
    "id": {"field":"code"}, 【必填】
    "code": 要修改部门编码, 【必填】
    "description": 需要修改的参数【必填】
}

返回说明

正常情况下,创建成功会返回成功的标识以及JSON格式部门信息,返回JSON数据信息请参考:部门创建更新返回对象示例

部门编码不存在,那么返回信息为空。

如果失败,同样会返回失败的标识,并且在【"errorMsgs"】参数中给出创建失败的原因以及JSON信息。

1.2.16. 按照部门编码启用/停用部门信息(Since:V6.0)

开发者可以通过部门编码以及enabled字段信息来启用禁用对应的部门信息。

接口请求说明:

http请求方式:PUT
http://ip:port/seeyon/rest/orgDepartment/code/{code}/enabled/{enabled}
参数 是否必须 说明
code 部门编码
enabled 部门是否启用【true.启动;false停止】

创建数据示例:

组装修改部门启用/禁用JSON数据的参数只需要部门的ID以及enabled参数信息即可,示例如下:

{
    "code": 部门编码, 【必填】
    "enabled": true, 【必填】
}

返回说明

正常情况下,创建成功会返回成功的标识以及JSON格式部门信息,返回JSON数据信息请参考:部门创建更新返回对象示例

如果创建失败,同样会返回失败的标识,并且在【"errorMsgs"】参数中给出创建失败的原因以及JSON信息。

1.2.17. 按照部门编码删除部门(Since:V6.0)

开发者可以通过部门编码删除对应的部门信息。

接口请求说明

http请求方式:DELETE
http://ip:port/seeyon/rest/orgDepartment/code/{code}
参数 是否必须 说明
code 部门编码

返回说明

因为删除目前接口采用异步模式,暂无返回值信息。

1.2.18. 按照单位编码获取所有部门信息(包含停用部门)(Since:V6.0)

开发者可以通过【单位编码】来获取单位下所有部门信息(包含停用部门)。

接口调用请求说明:

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

返回说明

正常情况下,会返回的是JSON格式部门信息,JSON数据包参考:部门对象示例

参数说明 请参考:部门对象属性说明

如果录入的单位编码错误或者为空时,返回JSON格式部门信息的为空.

1.2.19. 按部门编码获取所有所有子部门(Since:V6.0)

开发者可以通过【部门编码】来获取指定部门下所有子部门信息。

接口调用请求说明;

http请求方式:GET
http://ip:port/seeyon/rest/orgDepartments/children/code/{parentCode}
参数 是否必须 说明
parentCode 部门编码

返回说明

正常情况下,会返回的是JSON格式部门信息,JSON数据包参考:部门对象示例

参数说明 请参考:部门对象属性说明

如果录入的部门编码错误或者为空时,返回JSON格式部门信息的为空.

1.2.20. 根据部门编码获取部门兼职人员信息(Since:V6.0)

开发者可以通过【部门编码】来获取指定部门下所有兼职人员信息。

接口调用请求说明:

http请求方式:GET
http://ip:port/seeyon/rest/orgDepartments/concurrentpost/code/{code}
参数 是否必须 说明
code 部门编码

返回说明

正常情况下,会返回的是JSON格式部门信息,JSON数据包参考:部门对象示例

参数说明 请参考:部门对象属性说明

如果录入的部门编码错误或者为空时,返回JSON格式部门信息的为空.

1.2.21. 根据部门ID查看部门岗位(Since:V6.0)

根据部门ID查看当前部门所设置的岗位。

接口调用请求说明:

http请求方式:GET
http://ip:port/seeyon/rest/orgDepartment/departmentpost/{departmentid}
参数 是否必须 说明
departmentid 部门ID

返回说明

正常情况下,会返回的是JSON格式部门信息,JSON数据包参考:部门对象示例

参数说明 请参考:部门对象属性说明

如果录入的错误或者为空时,返回JSON格式部门信息的为空.

1.2.22. 根据部门ID跟新部门岗位(Since:V6.0)

根据部门ID更新当前部门所设置的岗位。

接口调用请求说明:

http请求方式:PUT
http://ip:port/seeyon/rest/orgDepartment/departmentpost

更新部门岗位参数:
Map res = new HashMap();
res.put("id", "3138456220332082763");//部门ID
res.put("deptpost", "Post|-8953437412957663435,Post|-1185154002310052488");//岗位ID Post 第一个字母大写

返回说明

正常情况下,会返回的是JSON格式部门信息,JSON数据包参考:部门对象示例

参数说明 请参考:部门对象属性说明

如果录入错误或者为空时,返回JSON格式部门信息的为空.

1.2.23. 根据部门ID查看部门[部门主管、分管领导、部门管理员、部门公文收发员](Since:V6.0)

根据部门ID查看当前部门的部门主管、分管领导、部门管理员、部门公文收发员。

接口调用请求说明:

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

返回说明

正常情况下,会返回的是JSON格式部门信息,JSON数据包参考:部门对象示例

参数说明 请参考:部门对象属性说明

如果录入错误或者为空时,返回JSON格式部门信息的为空.

1.2.24. 更新部门管理角色[主管,领导,管理员,公文收发员](Since:V6.0)

推荐使用新接口按照编码更新部门管理角色[主管,领导,管理员,公文收发员](Since:V7.1))

修改部门管理角色信息。

接口调用请求说明:

http请求方式:PUT
http://ip:port/seeyon/rest/orgDepartment/departmentmanagerinfo
修改部门角色信息参数:
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|部门领导(man)|-4532703988283521957|true");//部门分管领导
res.put("deptrole2", "Member|-2833598432627637498|李世民|-4532703988283521957|true");//部门管理员
res.put("deptrole3", "");//如果不传则置空//"Member|-2833598432627637498|李世民|-4532703988283521957|true,Member|6715603953152377707|部门公文收发(man)|-4532703988283521957|true");//部门公文收发员
//注意deptrole0 1 2 3 的顺序 不能改变,顺学对应的就是角色顺序

返回说明

正常情况下,会返回的是JSON格式部门信息,JSON数据包参考:部门对象示例

参数说明 请参考:部门对象属性说明

如果录入错误或者为空时,返回JSON格式部门信息的为空.

1.2.25. 按照编码更新部门管理角色[主管,领导,管理员,公文收发员](Since:V7.1)

根据编码修改部门管理角色信息。

接口调用请求说明:

http请求方式:PUT
http://ip:port/seeyon/rest/orgDepartment/role
修改部门角色信息参数:
Map data = new HashMap();
data.put("accountCode", "u1"); // 单位编码
data.put("departmentCode", "d1");// 部门编码

Map m1 = new HashMap();// 角色人员信息
m1.put("DepManager", "10010001,20013001");// 部门主管编码
m1.put("DepLeader", "zhangsan,lisi");// 部门领导编码
data.put("roleMember", m1);

client.put("orgDepartment/role", data, String.class);// 发送请求

返回说明

正常情况下,返回JSON格式部门信息,JSON数据包详情请参考:部门对象示例

参数说明 请参考:部门对象属性说明

返回成功示例:

{
      "code" : 0,
      "data" : {
      // 部门对象属性
        "orgAccountId" : 4096395336238448877,
        ......
      },
      "message" : "成功"
    }

返回失败示例:

{
      "code" : 1001,// 不同错误返回不同的错误状态码
      "data" : "accountCode",
      "message" : "单位编码不能为空!"
}

1.2.26. 按照部门编码获取部门主管、分管领导、部门管理员、部门公文收发员(Since:V6.0)

开发者可以通过【部门编码】来获取指定部门下部门主管、分管领导、部门管理员、部门公文收发员。

接口调用请求说明:

http请求方式:GET
http://ip:port/seeyon/rest/orgDepartments/visor/code/{code}
参数 是否必须 说明
code 部门编码

返回说明

正常情况下,会返回的是JSON格式部门信息,JSON数据包参考:部门对象示例

参数说明 请参考:部门对象属性说明

如果录入的部门编码错误或者为空时,返回JSON格式部门信息的为空.

1.3. 岗位管理

岗位管理服务支持获取,创建,修改,删除岗位数据。

1.3.1. 岗位对象示例

{
  "orgAccountId" : -6611845740562398180,【必填】
  "id" : 3975462922290545021,
  "name" : "测试岗位",【必填】
  "code" : "2",
  "createTime" : 1476065603000,
  "updateTime" : 1476065603000,
  "sortId" : 2,
  "isDeleted" : false,
  "enabled" : true,
  "status" : 1,
  "description" : "",
  "typeId" : 1,
  "valid" : true,
  "entityType" : "Post"
}

1.3.2. 岗位对象属性说明

参数 说明
orgAccountId 所属单位ID
id ID
name 岗位名称
code 岗位代码
createTime 创建时间
updateTime 更改时间
sortId 排序号
isDeleted 是否被删除
enabled 是否启用
status 状态
description 描述
typeId 类型ID
valid 是否合法

1.3.3. 岗位创建更新返回对象示例

岗位创建/更新成功返回对象示例

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

岗位创建/更新失败返回对象示例

{
    "successMsgs": [ ],
    "errorMsgs": [
        {
            "code": "POST_REPEAT_NAME",
            "ent": {
                "orgAccountId": 967547186016371000,
                "id": -4595331224678873600,
                "name": "岗位名称",
                "code": "",
                "createTime": 1398235224015,
                "updateTime": 1398235224015,
                "sortId": 1,
                "isDeleted": false,
                "enabled": true,
                "status": 1,
                "description": "描述",
                "typeId": -1,
                "valid": true,
                "entityType": "Post"
            }
        }
    ],
    "success": false
}

1.3.4. 按岗位Id取岗位信息

开发者可以通过【岗位ID】来获取岗位信息。

接口调用请求说明

http请求方式:GET
http://ip:port/seeyon/rest/orgPost/{id}
参数 是否必须 说明
id 岗位ID

返回说明

正常情况下,会返回的是JSON格式岗位信息,JSON数据包参考:岗位对象示例

参数说明 请参考:岗位对象属性说明

如果录入的部门ID错误或者为空时,返回JSON格式岗位信息的为空.

1.3.5. 获取指定单位的所有岗位(不包含停用)

开发者可以通过【单位ID】来获取当前单位下的所有岗位信息(不包含停用岗位)。

接口调用请求说明

http请求方式:GET
http://ip:port/seeyon/rest/orgPosts/{accountId}
参数 是否必须 说明
accountId 单位ID

返回说明

正常情况下,会返回的是JSON格式岗位信息,JSON数据包参考:岗位对象示例

参数说明 请参考:岗位对象属性说明

如果录入的部门ID错误或者为空时,返回JSON格式岗位信息的为空.

1.3.6. 获取指定单位的所有岗位数量(不包含停用)

开发者可以通过【单位ID】来获取岗位的数量(不包含停用岗位)。

接口调用请求说明

http请求方式:GET
http://ip:port/seeyon/rest/orgPosts/count/{accountId}
参数 是否必须 说明
accountId 单位ID

返回说明

正常情况下,会返回的是Integer类型的数值。

如果录入的单位ID错误或者为空时,返回信息为空。

1.3.7. 获取指定单位的所有岗位(包含停用)

开发者可以通过【单位ID】来获取当前单位下的所有岗位信息(包含停用岗位)。

接口调用请求说明

http请求方式:GET
http://ip:port/seeyon/rest/orgPosts/all/{accountId}
参数 是否必须 说明
accountId 单位ID

返回说明

正常情况下,会返回的是JSON格式岗位信息,JSON数据包参考:岗位对象示例

参数说明 请参考:岗位对象属性说明

如果录入的部门ID错误或者为空时,返回JSON格式岗位信息的为空.

1.3.8. 获取指定单位的所有岗位数量(包含停用)

开发者可以通过【单位ID】来获取岗位的数量(包含停用岗位)。

接口调用请求说明

http请求方式:GET
http://ip:port/seeyon/rest/orgPosts/all/count/{accountId}
参数 是否必须 说明
accountId 单位ID

返回说明

正常情况下,会返回的是Integer类型的数值。

如果录入的单位ID错误或者为空时,返回信息为空。

1.3.9. 创建岗位

开发者可以将岗位相关参数组装为JSON类型,来创建岗位信息。

接口请求说明

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

创建数据示例:

参数 是否必须 说明
orgAccountId 单位ID
code 编号
name 名称
description 描述
typeId 类型参数(管理类是1,技术类是2,营销类是3,职能类是4)

组装新建岗位JSON数据,请参照:岗位对象示例只需要将示例对象中标明为【必填】参数组装即可。

新建岗位JSON数据参数的具体字段含义请参见岗位对象属性说明

返回说明

正常情况下,创建成功会返回成功的标识以及JSON格式岗位信息,JSON数据信息请参考:岗位创建更新返回对象示例

如果岗位创建失败,同样会返回失败的标识,并且在【"errorMsgs"】参数中给出创建失败的原因以及JSON格式岗位信息。

1.3.10. 批量创建岗位(Since:V61)

将需要创建的多个岗位Map放入List中批量创建岗位信息。

接口请求说明

http请求方式:POST
http://ip:port/seeyon/rest/orgPost/addPosts

创建数据示例:

List postList=new ArrayList();
Map newPost = new HashMap() {
{
put("orgAccountId", "5269865115340261356"); //单位ID
put("name","addrestPost1"); //岗位名称
put("code","rest1"); //编码
put("description","xxxxxxd"); //描述
put("levelId","1"); //岗位类别ID
}
};
Map newPost2 = new HashMap() {
...
}
postList.add(newPost);
postList.add(newPost2);
client.post("orgPost/addPosts" ,res, String.class);

返回说明

创建岗位成功则返回JSON格式岗位信息。

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

开发者可以通过岗位ID修改对应的岗位信息。

接口请求说明

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

创建数据示例:

组装修改岗位JSON数据的参数只需要岗位的ID以及需要修改参数信息即可,示例如下:

{
    "Id": 需修改的岗位ID, 【必填】
    "description": 要修改的参数, 【必填】
}

返回说明

正常情况下,成功会返回成功的标识以及JSON格式岗位信息,JSON数据信息请参考:岗位创建更新返回对象示例

如果岗位创建失败,同样会返回失败的标识,并且在【"errorMsgs"】参数中给出创建失败的原因以及JSON格式岗位信息.

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

将需要修改的多个岗位Map放入List中批量修改岗位信息。

接口请求说明

http请求方式:POST
http://ip:port/seeyon/rest/orgPost/updatePosts

创建数据示例:

List postList=new ArrayList();
Map postmody = new HashMap();
postmody.put("id","1727044139605774299");
postmody.put("description","REST修改");
postList.add(postmody);
client.post("/orgPost/updatePosts" ,postList, String.class);

返回说明

修改岗位成功则返回JSON格式岗位信息。

1.3.13. 按岗位Id删除岗位信息

开发者可以通过岗位ID删除对应的岗位信息。

接口请求说明

http请求方式:DELETE
http://ip:port/seeyon/rest/orgPost/{id}
参数 是否必须 说明
id 岗位ID

返回说明

因为删除目前接口采用异步模式,暂无返回值信息。

1.3.14. 按岗位Id启用/禁用岗位

开发者可以通过岗位ID以及enabled字段信息来启用禁用对应的岗位信息。

接口请求说明

http请求方式:PUT
http://ip:port/seeyon/rest/orgPost/{id}/enabled/{enabled}
参数 是否必须 说明
id 岗位ID
enabled 岗位是否启用【true.启动;false停止】

创建数据示例:

组装修改岗位启用/禁用JSON数据的参数只需要岗位的ID以及enabled参数信息即可,示例如下:

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

返回说明

正常情况下,成功会返回成功的标识以及JSON格式岗位信息,JSON数据信息请参考:岗位创建更新返回对象示例

如果岗位创建失败,同样会返回失败的标识,并且在【"errorMsgs"】参数中给出创建失败的原因以及JSON格式岗位信息.

1.3.15. 按岗位编码停用/启用岗位(Since:V6.0)

开发者可以通过岗位编码以及enabled字段信息来启用禁用对应的岗位信息。

接口请求说明

http请求方式:PUT
http://ip:port/seyon/rest/orgPost/code/{code}/enabled/{enabled}
参数 是否必须 说明
code 岗位编码
enabled 岗位是否启用【true.启动;false停止】

返回说明

正常情况下,成功会返回成功的标识以及JSON格式岗位信息,JSON数据信息请参考:岗位创建更新返回对象示例

如果岗位创建失败,同样会返回失败的标识,并且在【"errorMsgs"】参数中给出创建失败的原因以及JSON格式岗位信息.

1.3.16. 按岗位编码删除岗位

开发者可以通过岗位ID删除对应的岗位信息。

接口请求说明

http请求方式:DELETE
http://ip:port/seeyon/rest/orgPost/code/{code}
参数 是否必须 说明
code 岗位编码

返回说明

因为删除目前接口采用异步模式,暂无返回值信息。

1.3.17. 按岗位编码修改岗位

开发者可以通过岗位编码修改对应的岗位信息。

接口请求说明

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

创建数据示例:

组装修改岗位JSON数据的参数只需要岗位的编码以及需要修改参数信息即可,示例如下:

field字段指定根据code来匹配人员,根据条件得到多个结果则会报错
{
    "Id": {"field":"code"}, 【必填】
    "code":需要修改的岗位编码【必填】
    "description": 要修改的参数, 【必填】
}

返回说明

正常情况下,成功会返回成功的标识以及JSON格式岗位信息,JSON数据信息请参考:岗位创建更新返回对象示例

如果岗位创建失败,同样会返回失败的标识,并且在【"errorMsgs"】参数中给出创建失败的原因以及JSON格式岗位信息.

1.4. 职务管理

职务管理服务支持获取,创建,修改,删除职务数据。

1.4.1. 职务对象

职务对象示例

{
    "orgAccountId": 967547186016371000, 【必填】
    "name": "职务", 【必填】
    "code": "", 【必填】
    "description": "", 【必填】
    "levelId": 1, 【必填】
    "sortId": 0, 【必填】

    "id": 6294808909395413000,【非必填】
    "createTime": 1394418219000, 【非必填】
    "updateTime": 1394418219000, 【非必填】
    "isDeleted": false, 【非必填】
    "enabled": true, 【非必填】
    "status": 1, 【非必填】
    "groupLevelId": -3648300496484547000, 【非必填】
    "valid": true, 【非必填】
    "entityType": "Level"【非必填】
}

职务对象属性说明

参数 说明
orgAccountId 所属单位ID
id ID
name 职务级别名称
code 职务级别代码
createTime 创建时间
updateTime 更改时间
sortId 排序
isDeleted 是否被删除
enabled 是否启用
status 状态
description 描述
valid 是否合法
levelId 职务级别序号
groupLevelId 映射的集团职务级别号
entityType 类型

职务创建更新返回对象示例

岗位创建/更新成功返回对象示例

{
    "successMsgs": [
        {
            "code": "SUCCESS",
            "ent": {
                "orgAccountId": 967547186016371000,
                "id": -8210141186763832000,
                "name": "职务",
                "code": "",
                "createTime": 1398325590589,
                "updateTime": 1398325590589,
                "sortId": 1,
                "isDeleted": false,
                "enabled": true,
                "status": 1,
                "description": "xxxxx",
                "levelId": 1,
                "groupLevelId": null,
                "valid": true,
                "entityType": "Level"
            }
        }
    ],
    "errorMsgs": [ ],
    "success": true
}

岗位创建/更新失败返回对象示例

{
    "successMsgs": [ ],
    "errorMsgs": [
        {
            "code": "POST_REPEAT_NAME",
            "ent": {
               "orgAccountId": 967547186016371000,
                "id": -8210141186763832000,
                "name": "职务",
                "code": "",
                "createTime": 1398325590589,
                "updateTime": 1398325590589,
                "sortId": 1,
                "isDeleted": false,
                "enabled": true,
                "status": 1,
                "description": "xxxxx",
                "levelId": 1,
                "groupLevelId": null,
                "valid": true,
                "entityType": "Level"
            }
        }
    ],
    "success": false
}

1.4.2. 按职务级别Id取职务级别信息

开发者可以通过【职务ID】来获取职务信息。

接口调用请求说明

http请求方式:GET
http://ip:port/seeyon/rest/orgLevel/{id}
参数 是否必须 说明
id 职务ID

返回说明

正常情况下,会返回的是JSON格式职务信息,JSON数据包参考:职务对象示例

参数说明 请参考:职务对象属性说明

如果录入的职务ID错误或者为空时,返回JSON格式职务信息的为空.

1.4.3. 获取指定单位的所有职务级别(不包含停用)

开发者可以通过【单位ID】来获取单位下所有职务信息(不包含停用职务)。

接口调用请求说明

http请求方式:GET
http://ip:port/seeyon/rest/orgLevels/{accountId}
参数 是否必须 说明
accountId 单位ID

返回说明

正常情况下,会返回的是JSON格式职务信息,JSON数据包参考:职务对象示例

参数说明 请参考:职务对象属性说明

如果录入的职务ID错误或者为空时,返回JSON格式职务信息的为空.

1.4.4. 获取指定单位的所有职务级别(包含停用)

开发者可以通过【单位ID】来获取单位下所有职务信息(包含停用职务)。

接口调用请求说明

http请求方式:GET
http://ip:port/seeyon/rest/orgLevels/all/{accountId}
参数 是否必须 说明
accountId 单位ID

返回说明

正常情况下,会返回的是JSON格式职务信息,JSON数据包参考:职务对象示例

参数说明 请参考:职务对象属性说明

如果录入的职务ID错误或者为空时,返回JSON格式职务信息的为空.

1.4.5. 创建职务级别

开发者可以将职务相关参数组装为JSON类型,来创建岗位信息。

接口请求说明

http请求方式:POST
http://ip:port/seeyon/rest/orgLevel
参数 是否必须 说明
orgAccountId 单位ID
code 编号
name 名称
description 描述

创建数据示例:

组装新建职务JSON数据,请参照:职务对象示例只需要将示例对象中标明为【必填】参数组装即可。

新建职务JSON数据参数的具体字段含义请参见:职务对象属性说明

返回说明

正常情况下,成功会返回成功的标识以及JSON格式职务信息,JSON数据信息请参考:职务创建更新返回对象示例

如果职务创建失败,同样会返回失败的标识,并且在【"errorMsgs"】参数中给出创建失败的原因以及JSON格式职务信息.

1.4.6. 按职务级别Id修改职务级别信息

开发者可以通过职务ID修改对应的职务信息。

接口请求说明

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

创建数据示例:

组装修改职务JSON数据的参数只需要职务的ID以及需要修改职务参数信息即可,示例如下:

{
    "Id": 需修改的职务ID, 【必填】
    "description": 要修改职务参数, 【必填】
}

返回说明

正常情况下,成功会返回成功的标识以及JSON格式职务信息,JSON数据信息请参考:职务创建更新返回对象示例

如果职务创建失败,同样会返回失败的标识,并且在【"errorMsgs"】参数中给出创建失败的原因以及JSON格式职务信息.

1.4.7. 按职务级别Id删除职务级别

开发者可以通过职务ID删除对应的职务信息。

接口请求说明

http请求方式:DELETE
http://ip:port/seeyon/rest/orgLevel/{id}
参数 是否必须 说明
id 职务ID

返回说明

因为删除目前接口采用异步模式,暂无返回值信息。

1.4.8. 按职务级别Id启用/禁用职务级别

开发者可以通过职务ID以及enabled字段信息来启用禁用对应的职务信息。

接口请求说明:

http请求方式:PUT
http://ip:port/seeyon/rest/orgLevel/{id}/enabled/{enabled}
参数 是否必须 说明
id 职务ID
enabled 职务是否启用【true.启动;false停止】

创建数据示例:

组装修改职务启用/禁用JSON数据的参数只需要职务的ID以及enabled参数信息即可,示例如下:

{
    "Id": 职务ID, 【必填】
    "enabled": true, 【必填】
}

返回说明

正常情况下,成功会返回成功的标识以及JSON格式职务信息,JSON数据信息请参考:职务创建更新返回对象示例

如果职务创建失败,同样会返回失败的标识,并且在【"errorMsgs"】参数中给出创建失败的原因以及JSON格式职务信息.

1.4.9. 按职务级别编码启用/禁用职务级别

开发者可以通过职务比那么以及enabled字段信息来启用禁用对应的职务信息。

接口请求说明:

http请求方式:PUT
http://ip:port/seeyon/rest/orgLevel/code/{code}/enabled/{enabled}
参数 是否必须 说明
code 职务code
enabled 职务是否启用【true.启动;false停止】

返回说明

正常情况下,成功会返回成功的标识以及JSON格式职务信息,JSON数据信息请参考:职务创建更新返回对象示例

如果职务创建失败,同样会返回失败的标识,并且在【"errorMsgs"】参数中给出创建失败的原因以及JSON格式职务信息.

1.4.10. 按职务级别编码删除职务

开发者可以通过职务编码删除对应的职务信息。

接口请求说明:

http请求方式:DELETE
http://ip:port/seeyon/rest/orgLevel/code/{code}
参数 是否必须 说明
code 职务编码

返回说明

因为删除目前接口采用异步模式,暂无返回值信息。

1.4.11. 按职务编码修改职务

开发者可以通过职务编码修改对应的职务信息。

接口请求说明:

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

创建数据示例:

组装修改职务JSON数据的参数只需要职务的ID以及需要修改职务参数信息即可,示例如下:

field字段指定根据code来匹配人员,根据条件得到多个结果则会报错。
{
    "Id": {"field":"code"}, 【必填】
    "code":需要修改的职务编码,【必填】
    "description": 要修改职务参数, 【必填】
}

返回说明

正常情况下,成功会返回成功的标识以及JSON格式职务信息,JSON数据信息请参考:职务创建更新返回对象示例

如果职务创建失败,同样会返回失败的标识,并且在【"errorMsgs"】参数中给出创建失败的原因以及JSON格式职务信息.

1.5. 单位管理

单位管理服务支持获取,修改,删除单位信息。

1.5.1. 单位对象

单位对象示例

{
    "orgAccountId": 1340327733561737700,
    "id": 1340327733561737700,
    "name": "单位名称", 【必填】
    "code": "1", 【必填】
    "sortId": 2, 【必填】
    "shortName": "单位", 【必填】

    "createTime": 1381371586000,
    "updateTime": 1381371586000,
    "isDeleted": false,
    "enabled": true,
    "status": 1,
    "description": "",
    "path": "00000001",
    "secondName": "",
    "isInternal": true,
    "isGroup": false,
    "levelScope": -1,
    "type": "Account",
    "properties": {
        "unitCategory": null,
        "fax": "",
        "unitMail": "",
        "accessLevels": null,
        "customLoginUrl": null,
        "ldapOu": "",
        "address": "",
        "chiefLeader": "",
        "zipCode": "",
        "telephone": "",
        "permissionType": 0,
        "isCustomLoginUrl": null,
        "ipAddress": ""
    },
    "superior": -1730833917365171700,
    "superiorName": "",
    "sortIdType": "1",
    "isCanAccess": true,
    "accessIds": [ ],
    "accessScopeLevels": [ ],
    "childrenAccounts": [ ],
    "entityType": "Account",
    "valid": true,
    "group": false,
    "customLogin": false,
    "parentPath": "0000",
    "customLoginUrl": null
}

单位对象属性说明

参数 说明
orgAccountId 所属单位ID
id ID
name 单位名称
code 单位编码
sortId 排序号
shortName 单位简称
createTime 创建时间
updateTime 修改时间
isDeleted 是否删除
enabled 是否启用
status 状态
description 描述
path 路径
secondName 外文名称
isInternal 是否是内部机构
isGroup 是否是集团
levelScope 只对type=account有效
type 类型
unitCategory 机构类型
fax 传真
unitMail 邮件
address 地址
chiefLeader 负责人
zipCode 邮编
telephone 电话
superior 上级单位Id,如果当前单位为集团则值为-1
superiorName
sortIdType
isCanAccess 是否可访问
childrenAccounts
entityType 实体类型
valid 是否合法
parentPath 父单位路径

1.5.2. 按单位名称取单位信息

开发者可以通过【单位名称】来获取单位信息

接口请求说明:

http请求方式:GET
http://ip:port/seeyon/rest/orgAccount/name/{name}
参数 是否必须 说明
name 单位名称【UTF-8 encode中文编码】

注意:

因为单位名称是汉字所以,需要汉字做UTF-8 encode中文编码,示例如下:

String name = URLEncoder.encode("单位名称", "UTF-8");

返回说明

正常情况下,会返回的是JSON格式单位信息,JSON数据包参考:单位对象示例

参数说明 请参考:单位对象属性说明

如果录入的单位名称错误或者为空时,返回JSON格式单位信息的为空.

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

开发者可以通过【单位ID】来获取单位信息

接口请求说明:

http请求方式:GET
http://ip:port/seeyon/rest/orgAccount/{id}
参数 是否必须 说明
ID 单位ID

返回说明

正常情况下,会返回的是JSON格式单位信息,JSON数据包参考:单位对象示例

参数说明 请参考:单位对象属性说明

如果录入的单位名称错误或者为空时,返回JSON格式单位信息的为空.

1.5.4. 取指定单位的管理员

通过单位Id取得单位的管理员(人员)信息

接口请求说明:

http请求方式:GET
http://ip:port/seeyon/rest/orgAccount/administrator/{id}
例如
http://127.0.0.1/seeyon/rest/orgAccount/administrator/2700994180139011164
参数 是否必须 说明
ID 单位ID

返回说明

正常情况下,会返回的是JSON格式单位信息,JSON数据包参考:单位对象示例

参数说明 请参考:单位对象属性说明

如果录入的单位ID错误或者为空时,返回null,否则返回单位管理员的人员信息。

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

创建单位信息。【注意:此接口只能集团版使用.】

接口请求说明:

http请求方式:POST
http://ip:port/seeyon/rest/orgAccount
参数 是否必须 说明
name 单位名称
code 单位编码
description 单位描述
shortName 单位简称
sortId 单位序号
superior 单位父级单位ID
增加单位管理员后,创建单位格式:
Map newDep = new HashMap() {
{
    put("name", "addAccount6"); //单位名称
    put("code", "16"); //编码
    put("description", "xxxxxxd"); //描述
    put("shortName", "test6"); //简称
    put("sortId", "8"); //排序ID
    put("Superior", "-1730833917365171641"); //上级ID
}
};

//管理员信息
List reslist=new ArrayList();
Map resfg=new HashMap();
resfg.put("loginName", "add6");//管理员登录名
resfg.put("password", "111111");//管理员密码

reslist.add(resfg);
newDep.put("admin", reslist);

返回说明

正常情况下,会返回的是JSON格式单位信息,JSON数据包参考:单位对象示例

参数说明 请参考:单位对象属性说明

如果录入的单位ID错误或者为空时,返回null.

1.5.6. 取所有单位信息

开发者获取所有单位信息。

接口请求说明:

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

返回说明

正常情况下,会返回的是JSON格式单位信息,JSON数据包参考:单位对象示例

参数说明 请参考:单位对象属性说明

1.5.7. 按单位Id删除单位

开发者可以通过单位ID删除对应的单位信息。

接口请求说明:

http请求方式:DELETE
http://ip:port/seeyon/rest/orgAccount/{id}
参数 是否必须 说明
id 单位ID

返回说明

因为删除目前接口采用异步模式,暂无返回值信息。

1.5.8. 按单位Id修改单位信息【V6.0 增加修改单位LDAP目录设置】

开发者可以通过单位ID修改对应的单位信息。

接口请求说明:

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

创建数据示例:

组装修改单位JSON数据的参数只需要单位的ID以及需要修改单位参数信息即可,示例如下:

{
    "Id": 需修改的单位ID, 【必填】
    "description": 要修改单位参数, 【必填】
}
V5.6-V6.0 增加修改单位LDAP目录设置
   Map res = new HashMap();
   HashMap properties=new HashMap();
   properties.put("ldapOu", "dc=seeyon,dc=com");
   res.put("properties",properties);

返回说明

正常情况下,会返回的是JSON格式单位信息,JSON数据包参考:单位对象示例

参数说明 请参考:单位对象属性说明

单位ID不存在,那么返回信息为空。

更新失败,同样会返回失败的标识,并且在【"errorMsgs"】参数中给出创建失败的原因以及JSON格式信息.

1.5.9. 获取指定单位下级单位(Since:V5.6)

开发者可以通过指定单位ID来获取下级单位列表.

接口请求说明:

http请求方式:GET
http://ip:port/seeyon/rest/orgAccounts/{id}
参数 是否必须 说明
id 单位ID

返回说明

正常情况下,会返回的是JSON格式单位信息,JSON数据包参考:单位对象示例

参数说明 请参考:单位对象属性说明

如果录入的单位ID错误或者为空时,返回null

1.5.10. 获取指定单位上级单位(Since:V5.6)

开发者可以通过指定单位ID来获取上级单位列表.

接口请求说明:

http请求方式:GET
http://ip:port/seeyon/rest/orgAccounts/parent/{id}
参数 是否必须 说明
id 单位ID

返回说明

正常情况下,会返回的是JSON格式单位信息,JSON数据包参考:单位对象示例

参数说明 请参考:单位对象属性说明

如果录入的单位ID错误或者为空时,返回null

1.5.11. 按单位编码修改单位信息(Since:V6.0)

开发者可以通过单位编码修改对应的单位信息。

接口请求说明:

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

创建数据示例:

组装修改单位JSON数据的参数只需要单位的编码以及需要修改单位参数信息即可,示例如下:

field字段指定根据code来匹配单位,根据条件得到多个结果则会报错。
{
    "Id": {"field":"code"}, 【必填】
    "code":要修改的单位编码,【必填】
    "description": 要修改单位参数, 【必填】
}

返回说明

正常情况下,会返回的是JSON格式单位信息,JSON数据包参考:单位对象示例

参数说明 请参考:单位对象属性说明

1.5.12. 按单位编码获取单位信息

开发者可以通过【单位Code】来获取单位信息。

接口请求说明:

http请求方式:GET
http://ip:port/seeyon/rest/orgAccount/code/{code}
参数 是否必须 说明
code 单位编码

返回说明

正常情况下,会返回的是JSON格式单位信息,JSON数据包参考:单位对象示例

参数说明 请参考:单位对象属性说明

1.6. 人员管理

人员的创建、修改、删除和查找接口。

1.6.1. 人员对象

人员对象示例

{
    "id": 710000480641633900,
    "name": "s1", 【必填】
    "code": "001",
    "createTime":1398216937707,
    "updateTime": 1398160905847,
    "sortId": 1,
    "isDeleted": false,
    "enabled": true,
    "status": 1,
    "description": "说明",
    "orgAccountId": -2332227039700957700, 【必填】
    "orgLevelId": 3176188816548514000, 【必填】
    "orgPostId": -2779802668474544000, 【必填】
    "orgDepartmentId": 8422701464295851000, 【必填】
    "isInternal": true,
    "isLoginable": true,
    "isAssigned": true,
    "isAdmin": false,
    "isValid": true,
    "state": 1,
    "second_post": [{"memberId":710000480641633932,"depId":8422701464295850729,"postId":-6172367662268331356}],
    "concurrent_post": [ ],
    "telNumber": "13366666666",
    "birthday": 1398096000000,
    "officeNum": "010-88888888",
    "emailAddress": "seeyon@seeyon.com",
    "gender": 1,
    "loginName": "s1",
    "location": "工作地",
    "reporter": "汇报人",
    "hiredate": "入职时间
}

人员对象属性说明

参数 说明
id Id,唯一标识人员
name 姓名
loginName 登录名
code 人员编码
createTime 创建时间
updateTime 更新时间
sortId 排序号
description 说明
orgAccountId 人员所属单位Id
orgLevelId 人员职务级别Id
orgPostId 人员岗位Id
orgDepartmentId 人员所属部门Id
second_post 副岗
concurrent_post 兼职
enabled 账户状态:true为启用,false为停用
isDeleted 删除标记:true为已删除
isInternal 是否内部人员
isLoginable 是否可登录
isAssigned 是否已分配人员
isAdmin 是否管理员,集团管理员、系统管理员、审计管理员或单位管理员返回true,否则为false
isValid 是否可用:已删除、被停用、不可登录、未分配或离职人员返回false,否则返回true
state 人员状态:1为在职,2 为离职
status 实体状态:1为正常、2为申请停用、3为申请删除、4为申请调离;此属性不常用,一般返回1
telNumber 手机号码
birthday 出生日期
officeNum 办公电话
emailAddress 电子邮件
gender 性别:-1为未指定、1为男、2为女
location 工作地
reporter 汇报人
hiredate 入职时间

1.6.2. 按登录名取人员信息

按照登录名获取人员信息。

接口请求说明:

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

参数说明:

参数 是否必须 说明
loginName 人员登录名

返回说明

正常情况下,会返回的是JSON格式人员信息,JSON数据包参考:人员对象示例

参数说明 请参考:人员对象属性说明

1.6.3. 按Id取人员信息

按照人员的Id获取人员信息

接口请求说明:

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

参数说明:

参数 是否必须 说明
memberId 人员Id

返回说明

正常情况下,会返回的是JSON格式人员信息,JSON数据包参考:人员对象示例

参数说明 请参考:人员对象属性说明

1.6.4. 按编码取人员信息

按照人员的Id获取人员信息

接口请求说明:

http请求方式:GET
http://ip:port/seeyon/rest/orgMember/code/{code}
如
http://127.0.0.1/seeyon/rest/orgMember/code/001

参数说明:

参数 是否必须 说明
memberId 人员Id

返回说明

正常情况下,会返回的是JSON格式人员信息,JSON数据包参考:人员对象示例

参数说明 请参考:人员对象属性说明

1.6.5. 按手机号码取人员信息

按照人员的手机号码获取人员信息

接口请求说明:

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

参数说明:

参数 是否必须 说明
telephoneNumber 手机号码

返回说明

正常情况下,会返回的是JSON格式人员信息,JSON数据包参考:人员对象示例

参数说明 请参考:人员对象属性说明

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

取得指定单位的所有人员(不包含停用人员)

接口请求说明:

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

参数说明:

参数 是否必须 说明
accountId 单位Id

返回说明

返回JSON格式的人员对象数组。

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

返回值说明

正常情况下,会返回的是JSON格式人员信息,JSON数据包参考:人员对象示例

参数说明 请参考:人员对象属性说明

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

取得指定单位的所有人员(包含停用人员)

接口请求说明:

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

参数说明:

参数 是否必须 说明
accountId 单位Id

返回说明

正常情况下,会返回的是JSON格式人员信息,JSON数据包参考:人员对象示例

参数说明 请参考:人员对象属性说明

1.6.8. 取得指定单位的所有人员总数(不包含停用人员)

取得指定单位的所有人员总数(不包含停用人员)

接口请求说明:

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

参数说明:

参数 是否必须 说明
accountId 单位Id

返回说明

正常情况下,会返回的是JSON格式人员信息,JSON数据包参考:人员对象示例

参数说明 请参考:人员对象属性说明

1.6.9. 取得指定单位的所有人员总数(包含停用人员)

取得指定单位的所有人员总数(包含停用人员)

接口请求说明:

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

参数说明:

参数 是否必须 说明
accountId 单位Id

返回说明

返回JSON整数。

1.6.10. 取得指定部门的所有人员

取指定部门的所有人员,不包含停用人员。

接口请求说明:

http请求方式:GET
http://ip:port/seeyon/rest/orgMembers/department/{departmentId}
如
http://127.0.0.1/seeyon/rest/orgMembers/department/8422701464295850729?firstLayer=false

参数说明:

参数 是否必须 说明
departmentId 部门Id
firstLayer 只取当前部门人员,不包含子部门,缺省为true

返回说明

返回JSON格式的人员对象数组。

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

返回值说明

正常情况下,会返回的是JSON格式人员信息,JSON数据包参考:人员对象示例

参数说明 请参考:人员对象属性说明

1.6.11. 取得指定岗位的所有人员

取指定岗位的所有人员,不包含停用人员。

接口请求说明:

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

参数说明:

参数 是否必须 说明
postId 岗位Id

返回说明

返回JSON格式的人员对象数组。

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

返回值说明

正常情况下,会返回的是JSON格式人员信息,JSON数据包参考:人员对象示例

参数说明 请参考:人员对象属性说明

1.6.12. 取得指定职务级别的所有人员

取指定职务级别的所有人员,不包含停用人员。

接口请求说明:

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

参数说明:

参数 是否必须 说明
leveld 职务级别Id

返回说明

返回JSON格式的人员对象数组。

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

返回值说明

正常情况下,会返回的是JSON格式人员信息,JSON数据包参考:人员对象示例

参数说明 请参考:人员对象属性说明

1.6.13. 按姓名取人员信息

按照人员的姓名查找人员。

接口请求说明:

http请求方式:GET
http://ip:port/seeyon/rest/orgMembers/name/{name}
如
http://127.0.0.1/seeyon/rest/orgMembers/name/%E5%A7%93%E5%90%8D

参数说明:

参数 是否必须 说明
name 人员姓名,中文必须使用UTF-8进行编码,如“姓名”编码后为“%E5%A7%93%E5%90%8D”

返回说明

正常情况下,会返回的是JSON格式人员信息,JSON数据包参考:人员对象示例

参数说明 请参考:人员对象属性说明

1.6.14. 新建人员(V6.0增加了副岗信息)

创建人员。

接口请求说明:

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

参数说明:

使用HTTP请求的Body传入JSON格式的人员信息

{
    Map newMember = new HashMap() {
        {
            put("orgAccountId", "-4532703988283521957"); //单位ID
            put("orgDepartmentId", "3034473275669826764");//部门ID
            put("orgLevelId", "-4560829651911226401");//职务ID
            put("orgPostId", "-1185154002310052488");//岗位ID
            put("code", "26");//编号
            put("name", "夏强6");//姓名
           // put("sortId", 1);//排序号  V5.6最新版本后可以不用录入此参数                    
            put("telNumber", "13551001572");//移动电话
            put("officeNum", "");//办公电话
            put("emailAddress", "");//电子邮件
            put("gender", "1");//性别
            put("telNumber", "13922600261");//电话
            put("officeNum", null);//固话
            put("password", "123456");//密码
            put("loginName", "rest6");//登录名
            put("birthday", "-1497600000");//出生日期"birthday":567964800000
        }
    };

    //副岗信息
    List reslist=new ArrayList();
    Map resfg=new HashMap();
    //resfg.put("memberId", "-4584455978690592711");//需要设置 副岗人员ID
    resfg.put("deptId", "3034473275669826764");//指定副岗所在部门ID(副岗范围是部门下已经存在人员所设置的主岗中来选择)
    resfg.put("postId", "-8953437412957663435");//指定副岗ID
    resfg.put("orgAccountId", "-4532703988283521957");//单位ID
    reslist.add(resfg);

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

V7.1支持通过单位、部门、职务和岗位编码设置人员信息,包括副岗中的单位、部门、职务和岗位,且兼容之前通过id设置人员信息。使用编码设置人员信息示例如下:

{
    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");}});//职务编码
            put("orgPostId", new HashMap(){{put("code","1");}});//岗位编码
        }
    };
}

返回说明

返回JSON格式。

success为true则创建成功

{
    "successMsgs": [
        {
            "code": "SUCCESS",
            "ent": {
                "orgAccountId": -2332227039700957700,
                "id": 7998660249083069000,
                "name": "新建人员",
                "code": "A002",
                "createTime": 1398417138169,
                "updateTime": 1398417138169,
                "sortId": 20,
                "isDeleted": false,
                "enabled": false,
                "status": 1,
                "description": "描述",
                "orgLevelId": 3176188816548514000,
                "orgPostId": -2779802668474544000,
                "orgDepartmentId": 8422701464295851000,
                "type": 1,
                "isInternal": true,
                "isLoginable": true,
                "isVirtual": false,
                "isAssigned": true,
                "isAdmin": false,
                "isValid": false,
                "state": 1,
                "properties": {
                    "birthday": 1398096000000,
                    "postalcode": "",
                    "emailaddress": "",
                    "extPostLevel": "",
                    "website": "",
                    "address": "",
                    "officenumber": "",
                    "gender": "1",
                    "telnumber": "",
                    "blog": "",
                    "imageid": ""
                },
                "second_post": [ ],
                "concurrent_post": [ ],
                "valid": false,
                "telNumber": null,
                "birthday": 1398096000000,
                "officeNum": null,
                "emailAddress": null,
                "gender": 1,
                "loginName": "newUser"
            }
        }
    ],
    "errorMsgs": [ ],
    "success": true
}

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

批量创建人员。

接口请求说明:

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

参数说明:

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

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

V7.1支持通过单位、部门、职务和岗位编码设置人员信息,详情请参考新建人员(V6.0增加了副岗信息))中的编码使用说明。

返回说明

创建人员成功则返回JSON格式人员信息。

1.6.16. 按Id修改人员信息【V6.0增加了副岗信息,以及修改人员LDAP目录设置】

按人员Id修改人员信息

接口请求说明:

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

参数说明:

使用HTTP请求的Body传入JSON格式的人员信息

id必填,支持新建人员参数说明中所有参数,必须至少指定一项

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

5.6版以后支持按编码修改人员信息,此处id的类型由Long改为对象,field字段指定根据code来匹配人员,根据条件得到多个结果则会报错。

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

V5.6后增加了副岗信息信息的修改,具体参数请参照创建人员中副岗信息。

V5.6-V6.0增加了人员LDAP目录设置

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

V7.1支持通过单位、部门、职务和岗位编码设置人员信息,详情请参考新建人员(V6.0增加了副岗信息))中的编码使用说明。

返回说明

返回JSON格式。

指定人员未存在返回null。

返回结果的说明参见新建人员。

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

通过人员Id批量修改人员信息

接口请求说明:

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

参数说明:

将需要修改的多人Map放入List中即可。

人员id必填

List members=new ArrayList();
Map newMember1 = new HashMap() {
{
put("id","-8823594534827504520");
put("orgAccountId",144);
put("description", "批量修改");
}
 };
Map newMember2 = new HashMap() {
...
}
members.add(newMember1);
members.add(newMember2);
client.post("orgMember/updateMembers",members,String.class);

V7.1支持通过单位、部门、职务和岗位编码设置人员信息,详情请参考新建人员(V6.0增加了副岗信息))中的编码使用说明。

返回说明

更新人员成功则返回JSON格式人员信息。

1.6.18. 按Id启用/停用人员

按人员Id修改人员启用和停用状态

接口请求说明:

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

参数说明:

参数 是否必须 说明
id 人员Id
enbaled 人员状态:true为启用,false为停用

返回说明

返回JSON格式。

指定人员未存在返回null。

返回结果的说明参见新建人员。

1.6.19. 按Id删除人员

按人员Id删除人员

接口请求说明:

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

参数说明:

参数 是否必须 说明
memberId 人员Id

返回说明

返回JSON格式。

指定人员未存在返回null。

返回结果的说明参见新建人员。

1.6.20. 验证人员有效性(Since:V5.6)

开发者可以通过【人员登录名和密码】来验证当前人员有效性。

接口请求说明:

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

参数说明:

参数 是否必须 说明
loginName 登录名
password 密码

返回说明

返回true为有效,false为无效。

1.6.21. 获取当前部门及其下级部门人员总数

开发者可以通过【部门ID】来获取指定部门下所有人员总数。

接口请求说明:

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

参数说明:

参数 是否必须 说明
departmentId 部门ID
firstLayer true是只显示直属子部门,false是包含所有层级的部门

返回说明

返回JSON整数。

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

开发者可以批量更新和新增人员。

接口请求说明:

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

参数说明:

新建与更新的人员参数同

请求多人信息可以存放在List中传递。

V7.1支持通过单位、部门、职务和岗位编码设置人员信息,详情请参考新建人员(V6.0增加了副岗信息))中的编码使用说明。

返回说明

正常情况下,会返回的是JSON格式人员信息,JSON数据包参考:人员对象示例

参数说明 请参考:人员对象属性说明

1.6.23. 批量删除人员

开发者可以批量删除人员。

接口请求说明:

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

参数说明:

参数 是否必须 说明
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。 返回结果的说明参见新建人员。

1.6.24. 人员离职 (Since:V7.0)

开发者可以处理离职人员。

接口请求说明:

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

参数说明:

参数 是否必填 说明
memberId 离职人员Id
agentMemberId 代理人Id,0:清空代理人、-1或代理人无效:不做代理人设置处理,维持现状、不为空且代理人有效,设置所有代办事项的代理人为此人
CTPRestClient client = RestResource.getInstance().resouresClent();
client.post("orgMember/leave/12315646574656/7894561616687111", new HashMap(), String.class);

返回说明

返回JSON格式。 组织模型实体操作息类。

1.7. 外部单位服务管理

外部单位服务管理(Since:V6.0)外部单位服务支持获取当前单位下所建立的外部单位信息。

1.7.1. 外部单位对象实例

外部单位对象实例

{
  "orgAccountId" : 3781960798631511882,
  "id" : -1970889903265267124,
  "name" : "外部单位1",
  "code" : "001",
  "createTime" : 1441953236000,
  "updateTime" : 1441953236000,
  "sortId" : 1,
  "isDeleted" : false,
  "enabled" : true,
  "status" : 1,
  "description" : "",
  "path" : "0000000100010001",
  "shortName" : null,
  "secondName" : null,
  "isInternal" : false,
  "isGroup" : false,
  "levelScope" : -1,
  "type" : "Department",
  "properties" : {
    "unitCategory" : null,
    "fax" : null,
    "unitMail" : null,
    "accessLevels" : null,
    "customLoginUrl" : null,
    "ldapOu" : null,
    "address" : null,
    "chiefLeader" : null,
    "zipCode" : null,
    "telephone" : null,
    "permissionType" : null,
    "isCustomLoginUrl" : null,
    "ipAddress" : null
  },
  "superior" : -1770506021266306174,
  "superiorName" : "",
  "sortIdType" : "1",
  "entityType" : "Department",
  "depManager" : null,
  "depAdmin" : null,
  "posts" : [ ],
  "wholeName" : "部门1,外部单位1",
  "valid" : true,
  "group" : false,
  "customLogin" : false,
  "parentPath" : "000000010001",
  "customLoginUrl" : null
}

对象属性说明

参数 说明
orgAccountId 外部单位所属的单位ID
id ID
name 名称
code 编码
createTime 创建时间
updateTime 更新时间
sortId 序号
enabled 是否启用
path 路径
type 类型
wholeName

1.7.2. 按照单位ID获取外部单位列表

可以通过【单位ID】来获取所属的外部单位信息。

接口请求说明:

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

参数说明:

参数 是否必须 说明
AccountId 单位ID

返回说明

正常情况下,会返回的是JSON格式外部单位信息,JSON数据包参考:外部单位对象实例.

参数说明 请参考:对象属性说明

1.8. 外部人员服务管理

外部人员服务管理(Since:V6.0)外部人员服务支持获取外部人员信息,以及增加和删除外部人员信息。

1.8.1. 外部人员对象

外部人员对象实例

{
  "orgAccountId" : 3781960798631511882,
  "id" : 5948516634567462597,
  "name" : "外部人员名称",【必填】
  "code" : "wb1",
  "createTime" : 1441953325000,
  "updateTime" : 1441953325000,
  "sortId" : 1,
  "isDeleted" : false,
  "enabled" : true,
  "status" : 1,
  "description" : "说明1",
  "orgLevelId" : -1,
  "orgPostId" : -1,
  "orgDepartmentId" : -1970889903265267124,【必填】
  "type" : 1,
  "isInternal" : false,
  "isLoginable" : true,
  "isVirtual" : false,
  "isAssigned" : true,
  "isAdmin" : false,
  "isValid" : true,
  "state" : 1,
  "properties" : {
    "postalcode" : "",
    "birthday" : 684518400000,
    "website" : "",
    "postAddress" : "",
    "officenumber" : "028-85965587",
    "eduBack" : 0,
    "telnumber" : "135587745896",
    "blog" : "",
    "imageid" : "",
    "politics" : 0,
    "degree" : "",
    "idnum" : "",
    "weixin" : "",
    "emailaddress" : "wb@qq.com",
    "address" : "",
    "extPostLevel" : "p:外部主岗,l:外部职务,",
    "gender" : 1,
    "weibo" : ""
  },
  "second_post" : [ ],
  "concurrent_post" : [ ],
  "address" : null,
  "valid" : true,
  "loginName" : "wb1",
  "entityType" : "Member",
  "emailAddress" : "wb@qq.com",
  "officeNum" : "028-85965587",
  "postalcode" : null,
  "telNumber" : "135587745896",
  "birthday" : 684518400000,
  "weibo" : null,
  "weixin" : null,
  "idNum" : null,
  "degree" : null,
  "postAddress" : null,
  "gender" : 1,
  "blog" : null,
  "website" : null
}

对象属性说明

参数 说明
orgAccountId 单位ID
extAccountName 单位名称
orgDepartmentId 部门ID
extWorkScopeValue 工作范围对应部门
extRoles 外部人员权限
extRoleIds 权限ID
extWorkScope 工作范围对应部门
code 编号
name 姓名
sortId 排序号
isInternal
isChangePWD
isLoginNameModifyed
isNewLdap
isNewMember
loginName 登录名
password 密码
password2 密码
primaryLanguange 语言类型
enabled 启用
orgPostId
orgLevelId
telnumber 移动电话
officenumber 办公电话
emailaddress 电子邮件
extgender 性别
extAccountName 所在外单位
birthday 生日
extlevelName 外部职务
extprimaryPost 外部岗位

1.8.2. 按照外部单位ID获取,外单位所有人员

可以通过【外部单位ID】来获取所属的外部单位下的外部人员。

接口请求说明:

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

参数说明:

参数 是否必须 说明
externalAccountId 外部单位ID

返回说明

正常情况下,会返回的是JSON格式外部人员信息,JSON数据包参考:外部人员对象实例

参数说明 请参考:对象属性说明

1.8.3. 按照单位ID获取,当前单位下所有外部人员

可以通过【单位ID】来获取所属的外部单位下的外部人员。

接口请求说明:

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

参数说明:

参数 是否必须 说明
accountId 单位ID

返回说明

正常情况下,会返回的是JSON格式外部人员信息,JSON数据包参考:外部人员对象实例

参数说明 请参考:对象属性说明

1.8.4. 按照外部人员登录名获取人员信息

可以通过【外部人员登录名】来获取所属的外部人员信息。

接口请求说明:

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

参数说明:

参数 是否必须 说明
loginName 外部人员登录名

返回说明

正常情况下,会返回的是JSON格式外部人员信息,JSON数据包参考:外部人员对象实例

参数说明 请参考:对象属性说明

1.8.5. 按照外部人员ID获取人员信息

可以通过【外部人员ID】来获取所属的外部人员信息

接口请求说明:

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

参数说明:

参数 是否必须 说明
externalMemberId 外部人员ID

返回说明

正常情况下,会返回的是JSON格式外部人员信息,JSON数据包参考:外部人员对象实例

参数说明 请参考:对象属性说明

1.8.6. 新增外部人员

创建外部人员信息。

接口请求说明:

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");//--工作范围对应部门
            put("extRoles", "外部人员权限");//权限       --   
            put("extRoleIds", "4649394686314365441");//权限ID
            put("extWorkScope", "部门1,");//--工作范围对应部门
            put("code", "568");//编号--
            put("name", "cs55");//姓名--
            put("sortId", 4);//排序号          --
            put("isInternal", false);//
            put("isChangePWD", true);//
            put("isLoginNameModifyed", false);//
            put("isNewLdap", false);//
            put("isNewMember", false);//
            put("loginName", "exo55");//--
            put("password", "123456");//--
            put("password2", "123456");//--
            put("primaryLanguange", "zh_CN");//--
            put("enabled", true);//--=

            put("orgPostId", -1);//
            put("orgLevelId", -1);//
            put("telnumber", "13551001572");//移动电话--
            put("officenumber", "1111111111");//办公电话--
            put("emailaddress", "xxx@sohu.com");//电子邮件--
            put("extgender", "1");//性别--
            put("extAccountName", "-1970889903265267124");//所在外单位--

            put("birthday", "2015-09-01");//出生日期"birthday":567964800000
            put("extbirthday", "-1497600000");//出生日期"birthday":567964800000
            put("extdescription", "cccccccc");//extdescription
        }
    };
    newMember.put("extlevelName", "外部职务");//职务ID--
    newMember.put("extprimaryPost", "外部岗位");//岗位ID--

返回说明

成功,返回的是新创建人员的ID。 失败,返回空。

1.8.7. 通过ID删除外部人员

可以通过【外部人员ID】来删除的外部人员信息。

接口请求说明:

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

参数说明:

参数 是否必须 说明
externalMemberId 外部人员ID

返回说明

正常情况下,删除成功返回true,失败返回FALSE。

1.9. 兼职服务管理

兼职服务管理(Since:V5.6 -V6.0)兼职服务管理支持对于单位兼职信息的查询与新建等操作。

1.9.1. 兼职服务对象

兼职对象实例

{
    "id": "-4657363023839605508",
    "concurrentRel": {
        "key": "Member_Post",
        "id": "-4657363023839605508", //兼职ID
        "orgAccountId": "-1956420195551131697", //单位ID
        "sortId": "1", //排序
        "createTime": "2016-03-16 09:47",
        "updateTime": "2016-03-16 09:47",
        "sourceId": "-2833598432627637498", //
        "objective6Id": "1",
        "objective0Id": "-7058041343460749784", //部门ID
        "objective1Id": "-7680462456906494208", //岗位ID
        "objective5Id": "Concurrent",
        "objective2Id": "2572864152117856133", //职务ID
        "objective3Id": null,
        "objective4Id": null,
        "objective7Id": "-2674129842350898190,"//权限ID
    },
    "conMemberName": "李世民(V56SP1)",
    "souAccountName": "V56SP1",
    "souPAnames": "程序员(V56SP1)",
    "conPostCode": "1",
    "tarAccountName": "addAccount2",
    "tarDPAnames": "add2-管理部-add2-行政岗位ie",
    "conSortId": "1"
}

对象属性说明

参数 说明
id 兼职ID
orgAccountId 单位ID
sortId 排序
sourceId
objective6Id
objective0Id 部门ID
objective1Id 岗位ID
objective5Id
objective2Id 职务ID
objective3Id
objective4Id
objective7Id 权限ID
conMemberName 人名(原单位简称)
souAccountName 原单位名称
souPAnames 原岗位名称(原单位简称)
tarAccountName 兼职单位名称
tarDPAnames 兼职单位部门-兼职单位岗位

1.9.2. 获取兼职列表

获取兼职列表信息(以翻页模式返回)

接口请求说明:

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

参数说明:

参数 是否必须 说明
pageNo 列表第一条开始的位置号,“0”为第一条
pageSize 获取列表条数

返回说明

正常情况下,会返回的是JSON格式兼职信息,JSON数据包参考:兼职对象实例

参数说明 请参考:对象属性说明

1.9.3. 通过code获取对外单位兼职信息**

通过CODE 获取对外单位兼职信息

接口请求说明:

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

参数说明:

参数 是否必须 说明
type=input 条件固定值
condition=cCode 条件类型{cCode=通过code查询,除外还可以通过名字查询cMemberName}
value={code} 编号值
accountid 单位ID

返回说明

正常情况下,会返回的是JSON格式兼职信息,JSON数据包参考:兼职对象实例

参数说明 请参考:对象属性说明

#

1.9.4. 通过code获取对内单位兼职信息

通过CODE 获取对本单位兼职信息

接口请求说明:

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

参数说明:

参数 是否必须 说明
type=input 条件固定值
condition=cCode 条件类型{cCode=通过code查询,除外还可以通过名字查询cMemberName}
value={code} 编号值
accountid 单位ID

返回说明

正常情况下,会返回的是JSON格式兼职信息,JSON数据包参考:兼职对象实例

参数说明 请参考:对象属性说明

1.10. #

1.10.1. 通过ID获取兼职信息

通过ID 获取兼职信息

接口请求说明:

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

参数说明:

参数 是否必须 说明
id 兼职ID

返回说明

正常情况下,会返回的是JSON格式兼职信息,JSON数据包参考:兼职对象实例

参数说明 请参考:对象属性说明

1.10.2. 新增兼职

新建兼职信息

接口请求说明:

http请求方式:POST
http://ip:port/seeyon/rest/orgPartTimeJob

新增所需参数::

res.put("id", "-1");//
 res.put("cMemberId", "-5904186531465311839");//r人员ID
 res.put("cAccountId", "-1956420195551131697");//兼职单位ID
 res.put("cDeptId", "-7058041343460749784");//兼职部门ID
 res.put("cPostId", "-7680462456906494208");//兼职岗位ID
 res.put("cLevelId", "2572864152117856133");//兼职职务ID
 res.put("cRoleIds", "-2674129842350898190");//兼职权限ID
 res.put("cMember", "2015(56sp1)");//人名(原单位简称)
 res.put("sortId", "");
 res.put("code", "4");
 res.put("primaryPost", "技术(56sp1)");//原岗位名称(原单位简称)
 res.put("cAccount", "addAccount2");//兼职单位名称
 res.put("cDept", "add2-管理部(test2)");//兼职单位部门名称(兼职单位简称)
 res.put("cPost", "add2-行政岗位ie(test2)");//兼职单位部门名称(兼职单位简称)
 res.put("cLevel", "dd2-经理职务");//兼职单位职务名称
 res.put("cRoles", "普通人员权限");//兼职单位权限名称

返回说明

正常情况下,会返回的是JSON格式兼职信息,JSON数据包参考:兼职对象实例

参数说明 请参考:对象属性说明

1.10.3. 按照兼职ID删除兼职

按照兼职ID删除兼职

接口请求说明:

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

参数说明:

参数 是否必须 说明
id 兼职ID

返回说明

正常情况下,会返回的是JSON格式兼职信息,JSON数据包参考:兼职对象实例

参数说明 请参考:对象属性说明

1.10.4. 修改兼职信息

修改兼职信息

接口请求说明:

http请求方式:PUT
http://ip:port/seeyon/rest/orgPartTimeJob

修改相关参数:

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");//兼职职务ID
 res.put("cRoleIds", "-2674129842350898190");//兼职权限ID
 res.put("cMember", "2015(56sp1)");//人名(原单位简称)
 res.put("sortId", "");
 res.put("code", "6");
 res.put("primaryPost", "技术(56sp1)");//原岗位名称(原单位简称)
 res.put("cAccount", "addAccount2");//兼职单位名称
 res.put("cDept", "add2-管理部(test2)");//兼职单位部门名称(兼职单位简称)
 res.put("cPost", "add2-行政岗位ie(test2)");//兼职单位部门名称(兼职单位简称)
 res.put("cLevel", "dd2-经理职务");//兼职单位职务名称
 res.put("cRoles", "普通人员权限");//兼职单位权限名称

返回说明

正常情况下,会返回的是JSON格式兼职信息,JSON数据包参考:兼职对象实例

参数说明 请参考:对象属性说明

1.11. 权限服务管理

权限服务管理支持对于权限信息的查询等操作。

1.11.1. 权限对象

权限对象实例

{
    "type": 2,
    "valid": true,
    "entityType": "Role",
    "category": "1",
    "showName": "普通人员权限",
    "bond": 1,
    "isBenchmark": true,
    "name": "GeneralStaff",
    "id": "1438771049297169890",
    "description": "",
    "status": 1,
    "code": "GeneralStaff",
    "isDeleted": false,
    "orgAccountId": "-4532703988283521957",
    "enabled": true,
    "sortId": "1",
    "createTime": "2015-12-24 16:53",
    "updateTime": "2013-03-20 00:00"
}

对象属性说明

参数 说明
id 权限ID
name 名称
sortId 排序
isBenchmark
showName 名称
status 状态
entityType 类型
code 编码
orgAccountId 单位ID
enabled 是否启用
type

1.11.2. 根据单位ID获取权限列表

根据单位ID获取权限列表

接口请求说明:

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

参数说明:

参数 是否必须 说明
accountId 单位ID

返回说明

正常情况下,会返回的是JSON格式权限信息,JSON数据包参考:权限对象实例

参数说明 请参考:对象属性说明

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

以集团管理员是身份添加部门角色.

接口请求说明

http请求方式:POST
http://ip:port/seeyon/rest/role/addDepartMentRole

创建数据示例:

Map data = new HashMap() {
{
put("name", "部门角色名称");
put("code","编码");
put("sortId","10");
}
};
client.post("role/addDepartMentRole", data, String.class);

返回说明

创建角色成功则返回角色ID。

1.11.4. 获取部门下的所有部门角色(Since:V61)

根据部门id,获取部门下的所有部门角色

接口请求说明

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

参数说明:

参数 是否必须 说明
departmentId 部门ID

返回说明

请求成功,返回部门下对应角色JSON信息。

1.11.5. 获取部门下对应的角色人员(Since:V61)

根据部门id 和角色id 获取部门下对应的角色人员.

接口请求说明

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

参数说明:

参数 是否必须 说明
departmentId 部门ID
roleId 角色ID(org_role表ID)

返回说明

请求成功,返回部门下对应角色人员的JSON信息。

1.11.6. 更新部门下对应的角色人员(Since:V61)

根据部门id 和角色id 更新部门下对应的角色人员.

接口请求说明

http请求方式:POST
http://ip:port/seeyon/rest/role/updateDepartmentRoleMember

创建数据示例:

Map data = new HashMap() {
{
put("deptId","5485888616457063756");//部门ID
put("roleId","8985889456139161281");//权限ID
put("memberIds","2611992240500982806,-7260678671148761009");//设置的人员ID
}
};
client.post("role/updateDepartmentRoleMember", data, String.class);

返回说明

跟新角色人员成功则返回成功提示。

results matching ""

    No results matching ""