# 组织模型管理

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

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

# 接口调用方式

本接口为OA的Http Rest，允许被异构系统远程调用，调用前需要调用Rest接口文档 (opens new window)获取Restful token身份凭证。

# 修订记录

时间	内容
2024年7月4日	基于V9.0版本全面检查并修订内容
2024年7月10日	增加获取组织扩展数据的接口

# 所有更新接口返回值统一说明

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

# 返回值示例

成功示例：创建人员

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

# 返回值说明

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

# 状态码

参数	说明
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	完全成功

# 部门管理

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

# 部门对象定义

# 部门对象示例

   {
     "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	状态（1正常2停用）
description	描述
path	路径
secondName	外文名称，对部门无效，保留字段
isInternal	是否是内部机构
isGroup	是否是集团
levelScope	范围控制（只对单位有效）
type	类型（Department）
fax	传真（只对单位有效）
unitMail	邮件（只对单位有效）
address	地址（只对单位有效）
chiefLeader	负责人（只对单位有效）
zipCode	邮编（只对单位有效）
telephone	电话（只对单位有效）
superior	上级部门Id，一级部门则为所属单位Id
sortIdType	排序类型
isCanAccess	是否允许访问
entityType	实体类型 Department
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
}

# 接口示例

# 按部门ID取部门信息

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

接口调用请求说明：

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

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

返回说明：

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

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

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

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

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

接口调用请求说明：

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

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

返回说明

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

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

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

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

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

接口调用请求说明：

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

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

返回说明

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

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

# 分页查询指定单位下的部门(包含停用)

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

接口调用请求说明：

http请求方式：GET
http://ip:port/seeyon/rest/orgDepartments/all/{accountId}?pageNo={pageNo}&pageSize={pageSize}

参数	是否必须	说明
accountId	是	单位ID
pageNo	是	当前页号，表示第几页
pageSize	是	每页显示多少条

返回说明

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

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

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

# 创建部门

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

接口请求说明：

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

参数	是否必须	说明
orgAccountId	是	单位ID
code	是	编号
name	是	名称
description	否	描述
enabled	是	是否启用
superior	是	父部门ID
superiorName	是	父部门名称

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

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

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

# 批量创建部门(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格式部门信息。

# 按部门Id修改部门信息

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

接口请求说明：

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

创建数据示例：

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

返回说明

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

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

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

# 批量修改部门(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格式部门信息。

# 按部门Id删除部门

开发者可以通过部门ID删除对应的部门信息，该删除是软删除，只会把isDeleted改为true，通过部门ID还是可以查询到该部门。

接口请求说明：

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

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

返回说明

删除部门成功则返回JSON格式部门信息。

# 按部门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, //【必填】
}

# 获取指定部门下的所有子部门

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

接口调用请求说明：

http请求方式：GET
http://ip:port/seeyon/rest/orgDepartments/children/{parentId}?firtLayer=false&pageNo={pageNo}&pageSize={pageSize}

参数	是否必须	说明
parentId	是	部门ID
firtLayer	否	true是只显示直属子部门,false是包含所有层级的部门
pageNo	是	页号，表示第几页
pageSize	是	每页显示条数

返回说明

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

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

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

# 获取指定部门父级部门

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

接口调用请求说明：

http请求方式：GET
http://ip:port/seeyon/rest/orgDepartments/parent/{departmentId}?firtLayer=false&pageNo={pageNo}&pageSize={pageSize}

参数	是否必须	说明
departmentId	是	部门ID
firtLayer	否	true是只显示直属子部门,false是包含所有层级的部门
pageNo	是	页号，表示第几页
pageSize	是	每页显示条数

返回说明

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

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

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

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

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

接口请求说明：

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

创建数据示例：

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

返回说明

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

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

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

# 按照部门编码启用/停用部门信息(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信息。

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

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

接口请求说明

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

参数	是否必须	说明
code	是	部门编码

返回说明

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

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

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

接口调用请求说明：

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

返回说明

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

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

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

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

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

接口调用请求说明;

http请求方式：GET
http://ip:port/seeyon/rest/orgDepartments/children/code/{parentCode}?pageNo={pageNo}&pageSize={pageSize}

参数	是否必须	说明
parentCode	是	部门编码
pageNo	是	页号，表示第几页
pageSize	是	每页显示条数

返回说明

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

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

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

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

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

接口调用请求说明：

http请求方式：GET
http://ip:port/seeyon/rest/orgDepartments/concurrentpost/code/{code}?pageNo={pageNo}&pageSize={pageSize}

参数	是否必须	说明
code	是	部门编码
pageNo	是	页号，表示第几页
pageSize	是	每页显示条数

返回说明

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

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

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

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

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

接口调用请求说明：

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

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

返回说明

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

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

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

# 根据部门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格式部门信息的为空.

# 根据部门ID查看部门角色(Since:V6.0)

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

接口调用请求说明：

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

返回说明

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

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

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

# 更新部门管理角色(Since:V6.0)

推荐使用新接口[按照编码更新部门管理角色(Since:V7.1)](#按照编码更新部门管理角色(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格式部门信息的为空.

# 按照编码更新部门管理角色(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" : "单位编码不能为空!"
}

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

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

接口调用请求说明：

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

参数	是否必须	说明
code	是	部门编码

返回说明

返回示例

{
    "DepartmentGovdocSend": "{\"text\":\"zzh1\",\"value\":\"Member|-6506565225848160056|zzh1|-3157981946275018285|true\"}",
    "DepLeader": "{\"text\":\"zzh1\",\"value\":\"Member|-6506565225848160056|zzh1|-3157981946275018285|true\"}",
    "DepMeetContact": "{}",
    "DepartmentGovdocRec": "{\"text\":\"zzh1\",\"value\":\"Member|-6506565225848160056|zzh1|-3157981946275018285|true\"}",
    "DepAdmin": "{\"text\":\"zzh1\",\"value\":\"Member|-6506565225848160056|zzh1|-3157981946275018285|true\"}",
    "DepManager": "{\"text\":\"zzh1\",\"value\":\"Member|-6506565225848160056|zzh1|-3157981946275018285|true\"}"
}

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

# 岗位管理

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

# 岗位对象定义

# 岗位对象示例

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

# 岗位对象属性说明

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

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

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

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

# 按岗位Id取岗位信息

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

接口调用请求说明

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

参数	是否必须	说明
id	是	岗位ID

返回说明

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

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

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

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

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

接口调用请求说明

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

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

返回说明

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

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

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

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

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

接口调用请求说明

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

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

返回说明

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

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

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

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

接口调用请求说明

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

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

返回说明

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

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

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

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

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

接口调用请求说明

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

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

返回说明

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

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

# 创建岗位

开发者可以将岗位相关参数组装为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格式岗位信息。

# 批量创建岗位(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格式岗位信息。

# 按岗位Id修改岗位信息

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

接口请求说明

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

创建数据示例：

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

{
    "Id": 需修改的岗位ID, //【必填】
    "要修改的参数字段名称": 要修改的参数值,//【必填】
}

返回说明

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

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

# 按岗位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格式岗位信息。

# 按岗位Id删除岗位信息

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

接口请求说明

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

参数	是否必须	说明
id	是	岗位ID

返回说明

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

# 按岗位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格式岗位信息.

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

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

接口请求说明

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

参数	是否必须	说明
code	是	岗位编码
enabled	是	岗位是否启用【true.启动；false停止】

返回说明

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

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

# 按岗位编码删除岗位

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

接口请求说明

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

参数	是否必须	说明
code	是	岗位编码

返回说明

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

# 按岗位编码修改岗位

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

接口请求说明

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

创建数据示例：

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

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

返回说明

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

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

# 职务管理

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

# 职务对象定义

# 职务对象示例

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

# 按职务级别Id取职务级别信息

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

接口调用请求说明

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

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

返回说明

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

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

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

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

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

接口调用请求说明

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

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

返回说明

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

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

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

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

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

接口调用请求说明

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

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

返回说明

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

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

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

# 创建职务级别

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

接口请求说明

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

参数	是否必须	说明
orgAccountId	是	单位ID
code	是	编号
name	是	名称
description	否	描述

创建数据示例：

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

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

返回说明

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

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

# 按职务级别Id修改职务级别信息

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

接口请求说明

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

创建数据示例：

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

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

返回说明

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

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

# 按职务级别Id删除职务级别

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

接口请求说明

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

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

返回说明

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

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

# 按职务级别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格式职务信息.

# 按职务级别编码启用/禁用职务级别

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

接口请求说明：

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

参数	是否必须	说明
code	是	职务code
enabled	是	职务是否启用【true.启动；false停止】

返回说明

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

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

# 按职务级别编码删除职务

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

接口请求说明：

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

参数	是否必须	说明
code	是	职务编码

返回说明

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

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

# 按职务编码修改职务

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

接口请求说明：

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

创建数据示例：

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

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

返回说明

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

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

# 单位管理

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

# 单位对象定义

# 单位对象示例

{
    "orgAccountId": 1340327733561737700,
    "id": 1340327733561737700,
    "name": "单位名称",// 【必填】
	"i18nNameId": null,
    "code": "1", //【必填】
    "sortId": 2, //【必填】
    "shortName": "单位", //【必填】
    "createTime": 1381371586000,
    "updateTime": 1381371586000,
    "isDeleted": false,
    "enabled": true,
	"externalType": 0,
    "status": 1,
	"customerProperties": {},
    "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": "",
		"managementSubunit: null,
		"isCreateDeptSpace": null
    },
    "superior": -1730833917365171700,
    "superiorName": "",
    "sortIdType": "1",
	"isPublic": false,
	"createrId": null,
    "isCanAccess": true,
    "accessIds": [ ],
    "accessScopeLevels": [ ],
	"root": false,
    "childrenAccounts": [ ],
    "entityType": "Account",
    "valid": true,
    "group": false,
	"superior0": -1730833917365171700,
    "customLogin": false,
    "parentPath": "0000",
    "customLoginUrl": null,
	"preName":"",
	"realSortId": 1,
	"fullName:"单位名称",
	"i18nNameWithLocale: "单位名称",
	"dataI18nCategoryName": "organization.account.name"
}

# 单位对象属性说明

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

# 按单位名称取单位信息

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

接口请求说明：

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格式单位信息的为空.

# 按单位Id取单位的信息

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

接口请求说明：

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

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

返回说明

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

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

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

# 新增单位(Since:V5.6 )

注：V6.0 增加单位管理员，管理员信息在V8.1已废弃

创建单位信息。【注意：此接口只能集团版使用.】，管理员信息在V8.1已废弃

接口请求说明：

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

参数	是否必须	说明
name	是	单位名称
code	是	单位编码
description	否	单位描述
shortName	是	单位简称
sortId	是	单位序号
superior	是	单位父级单位ID
admin	是	管理员（该参数从V8.1后无用了，但是还是需要传）

增加单位管理员后，创建单位格式：
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.

# 取所有单位信息

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

接口请求说明：

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

返回说明

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

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

# 按单位Id删除单位

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

接口请求说明：

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

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

返回说明

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

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

# 按单位Id修改单位信息

注：V6.0 增加修改单位LDAP目录设置

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

接口请求说明：

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

创建数据示例：

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

请求参数

{
    "id": 需修改的单位ID, //【必填】
    "description": 要修改单位参数, //【必填】
	"orgAccountId": 需修改的单位ID, //【必填】
}

说明:

//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格式信息.

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

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

接口请求说明：

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

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

返回说明

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

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

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

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

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

接口请求说明：

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

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

返回说明

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

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

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

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

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

接口请求说明：

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

创建数据示例：

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

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

返回说明

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

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

# 按单位编码获取单位信息

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

接口请求说明：

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

参数	是否必须	说明
code	是	单位编码

返回说明

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

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

# 人员管理

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

# 人员对象定义

# 人员对象示例

{
    "orgAccountId": -5182021562351009185, //【必填】
    "id": 1944960974152155549,
    "name": "s1", //【必填】
    "i18nNameId": null,
    "code": "001",
    "createTime": 1688719616000,
    "updateTime": 1692001649000,
    "sortId": 1,
    "isDeleted": false,
    "enabled": true,
    "externalType": 0,
    "status": 1,
    "description": "说明",
    "customerProperties": [],
    "orgLevelId": -3328275257431473154, //【必填】
    "orgPostId": 1885539155546097323, //【必填】
    "orgDepartmentId": -897857428368178224, // 【必填】
    "type": 1,
    "isInternal": true,
    "isLoginable": true,
    "isVirtual": false,
    "isAssigned": true,
    "isAdmin": false,
    "isValid": true,
    "state": 1,
    "properties": {
        "birthday": "",
        "politics": -1,
        "website": "",
        "address": "",
        "imageid": "",
        "gender": -1,
        "degree": "",
        "postAddress": "",
        "emailaddress": "xxx@cnpc.com.cn",
        "reporter": "",
        "blog": "",
        "hiredate": "",
        "extPostLevel": "",
        "weixin": "",
        "weibo": "",
        "telnumber": "13512345678",
        "postalcode": "",
        "eduBack": -1,
        "officenumber": "010-12345678",
        "location": "",
        "idnum": ""
    },
    "second_post": [{"memberId":710000480641633932,"depId":8422701464295850729,"postId":-6172367662268331356}],
    "concurrent_post": [],
    "customerAddressBooklist": [],
    "primaryLanguange": null,
    "pinyin": "s1",
    "pinyinhead": "s1",
    "secretLevel": null,
    "address": "",
    "location": "",
    "valid": true,
    "reporter": null,
    "fullName": "s1",
    "visitor": false,
    "v5External": false,
    "entityType": "Member",
    "postalcode": "",
    "vjoinExternal": false,
    "telNumber": "13512345678",
    "gender": -1,
    "officeNum": "010-12345678",
    "emailAddress": "xxx@qq,com",
    "weixin": "",
    "weibo": "",
    "loginName": "s1",
    "guest": false,
    "defaultGuest": false,
    "screenGuest": false,
    "isAssignedStatus": 1,
    "birthday": null,
    "idNum": "",
    "degree": "",
    "postAddress": "",
    "blog": "",
    "hiredate": null,
    "website": "",
    "preName": "",
    "realSortId": 1,
    "i18nNameWithLocale": "s1",
    "dataI18nCategoryName": "organization.member.name",
    "orgAccountName": "单位名称",
    "orgPostName": "岗位名称",
    "orgDepartmentName": "部门名称",
    "orgLevelName": "p2"
}

# 人员对象属性说明

参数	说明
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	入职时间

# 按登录名取人员信息

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

接口请求说明：

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

参数说明：

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

返回说明

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

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

# 按Id取人员信息

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

接口请求说明：

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

参数说明：

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

返回说明

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

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

# 按编码取人员信息

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

接口请求说明：

http请求方式：GET
http://ip:port/seeyon/rest/orgMembers/code/{code}?pageNo={pageNo}&pageSize={pageSize}
如
http://127.0.0.1/seeyon/rest/orgMembers/code/001?pageNo=0&pageSize=20

参数说明：

参数	是否必须	说明
code	是	人员编号
pageNo	是	页号，表示第几页
pageSize	是	每页显示条数

返回说明

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

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

# 按手机号码取人员信息

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

接口请求说明：

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

参数说明：

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

返回说明

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

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

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

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

接口请求说明：

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数据包参考：人员对象示例

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

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

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

接口请求说明：

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

参数说明：

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

返回说明

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

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

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

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

接口请求说明：

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

参数说明：

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

返回说明

正常情况下，会返回的是整型，例如：5

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

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

接口请求说明：

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

参数说明：

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

返回说明

正常情况下，会返回的是整型，例如：5

# 取得指定部门的所有人员

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

接口请求说明：

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数据包参考：人员对象示例

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

# 取得指定岗位的所有人员

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

接口请求说明：

http请求方式：GET
http://ip:port/seeyon/rest/orgMembers/post/{postId}?pageNo={pageNo}&pageSize={pageSize}
如
http://127.0.0.1/seeyon/rest/orgMembers/post/-2779802668474544380?pageNo=0&pageSize=20

参数说明：

参数	是否必须	说明
postId	是	岗位Id
pageNo	是	页号，表示第几页
pageSize	是	每页显示条数

返回说明

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

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

返回值说明

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

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

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

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

接口请求说明：

http请求方式：GET
http://ip:port/seeyon/rest/orgMembers/level/{levelId}?pageNo={pageNo}&pageSize={pageSize}
如
http://127.0.0.1/seeyon/rest/orgMembers/level/3176188816548513663?pageNo=0&pageSize=20

参数说明：

参数	是否必须	说明
leveld	是	职务级别Id
pageNo	是	页号，表示第几页
pageSize	是	每页显示条数

返回说明

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

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

返回值说明

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

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

# 按姓名取人员信息

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

接口请求说明：

http请求方式：GET
http://ip:port/seeyon/rest/orgMembers/name/{name}?pageNo={pageNo}&pageSize={pageSize}
如
http://127.0.0.1/seeyon/rest/orgMembers/name/%E5%A7%93%E5%90%8D?pageNo=0&pageSize=20

参数说明：

参数	是否必须	说明
name	是	人员姓名，中文必须使用UTF-8进行编码，如“姓名”编码后为“%E5%A7%93%E5%90%8D”
pageNo	是	页号，表示第几页
pageSize	是	每页显示条数

返回说明 正常情况下，会返回的是JSON格式人员信息列表，人员信息数据包参考：人员对象示例

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

# 新建人员(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("officeNum", null);//固话
            put("password", "123456");//密码
            put("loginName", "rest6");//登录名
            put("birthday", "-1497600000");//出生日期"birthday":567964800000
        }
    };

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

    newMember.put("second_post", reslist);
}
// JSON格式
{
    "orgAccountId": "38603735902077369",
    "name": "xxxxx",
    "code": "zzzz",
    "sortId": "2166234",
    "orgLevelId": "-4438556177370496089",
    "orgPostId": "7358219787882285422",
    "orgDepartmentId": "2925405094202984290",
    "telNumber": "13551001572",
    "emailAddress": "121212",
    "gender": "1",
    "loginName": "xxxx",
    "password": "123456",
    "officeNum": "1536876",
    "second_post": [
        {
            "deptId": "2925405094202984290",
            "postId": "6696415514758628651",
            "orgAccountId": "38603735902077369"
        }
    ]

}

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
}

# 批量新建人员(Since:V61)

批量创建人员。

接口请求说明：

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

参数说明：

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

JSON示例
[
    {
        "orgAccountId": "38603735902077369",
        "name": "hf111",
        "code": "43434",
        "sortId": "21664",
        "orgLevelId": "-4438556177370496089",
        "orgPostId": "7358219787882285422",
        "orgDepartmentId": "2925405094202984290",
        "telNumber": "13551001572",
        "emailAddress": "121212",
        "gender": "1",
        "loginName": "hf21212",
        "password": "123456",
        "officeNum": "1536876",
        "second_post": [
            {
                "deptId": "2925405094202984290",
                "postId": "6696415514758628651",
                "orgAccountId": "38603735902077369"
            }
        ]
    }
]


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

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

返回说明

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

# 按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。

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

# 按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格式人员信息。

# 按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。

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

# 按Id删除人员

按人员Id删除人员

接口请求说明：

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

参数说明：

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

返回说明

返回JSON格式。

指定人员未存在返回null。

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

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

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

接口请求说明：

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

参数说明：

参数	是否必须	说明
loginName	是	登录名
password	是	密码
UserAgentFrom	否	来源（不传为pc）V8.2SP1及以上开始支持
login.VerifyCode	否	图片验证码（needShowVerifyCode=true时需要传）V8.2SP1及以上开始支持

UserAgentFrom取值如下

public static enum login_useragent_from {
    pc, // 15普通电脑，包括台式机、笔记本，一般只通过IE等浏览器登录的
    mobile, //20 手机终端，一般只通过wap登录的
    email, //12 通过email过来的
    other, //16 其它终端
    iphone, //21 M
    ipad, //22 M
    androidphone, //23 M
    androidpad, //24 M
    wechat, //80 来自微信
    share, //13 分享到外部
    ucpc, //40 致信PC客户端
    vjoin, //11 致信PC客户端
    rest, //14 rest
    h5, // 160 h5
    zhifei,//320 致飞
    WeChat, //微信公众号，不影响之前的逻辑新增
     Lark,// 飞书
    DingTalk ,//钉钉
    wxwork,// 企业微信
    welink, // welink


}

返回说明

返回true为有效，V8.2SP1以下失败返回false V8.2SP1及以上验证失败返回以下格式

{
  "showVerifyCode": false, // 是否显示验证码，和后台系统管理员设置保持一致
  "success": false, // 验证是否成功
  "lock": false, // 是否锁定
  "msg": "绑定失败，无效的用户名或密码", // 失败原因
  "needShowVerifyCode": false // 是否需要显示验证码
}

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

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

接口请求说明：

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

参数说明：

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

返回说明

返回JSON整数。

# 批量新增/更新人员信息

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

接口请求说明：

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

参数说明：

新建与更新的人员参数同

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

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

返回说明

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

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

# 批量删除人员

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

接口请求说明：

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

参数说明：

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

json格式
[
    {"id": "6629517437492546360"}
]

...
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。返回结果的说明参见新建人员。

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

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

接口请求说明：

http请求方式：POST	
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格式。组织模型实体操作息类。

# 外部单位服务管理

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

# 外部单位对象定义

# 外部单位对象实例

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

# 按照单位ID获取外部单位列表

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

接口请求说明：

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

参数说明：

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

返回说明

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

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

# 外部人员服务管理

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

# 外部人员对象定义

# 外部人员对象实例

{
  "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	外部岗位

# 按照外部单位ID获取，外单位所有人员

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

接口请求说明：

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

参数说明：

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

返回说明

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

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

# 按照单位ID获取，当前单位下所有外部人员

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

接口请求说明：

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

参数说明：

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

返回说明

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

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

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

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

接口请求说明：

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

参数说明：

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

返回说明

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

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

# 按照外部人员ID获取人员信息

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

接口请求说明：

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

参数说明：

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

返回说明

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

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

# 新增外部人员

创建外部人员信息。

接口请求说明：

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。失败，返回空。

# 通过ID删除外部人员

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

接口请求说明：

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

参数说明：

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

返回说明

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

# 兼职服务管理

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

# 兼职服务对象定义

# 兼职对象实例

{
    "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	兼职单位部门-兼职单位岗位

# 获取兼职列表

获取兼职列表信息（以翻页模式返回）

接口请求说明：

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

参数说明：

参数	是否必须	说明
pageNo	是	页号，表示第几页
pageSize	是	每页显示条数

返回说明

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

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

# 通过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：通过兼职编号查询，cMemberName：通过兼职人员名称查询}
value={code}	是	编号值/人员名称
accountid	是	单位ID

返回说明

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

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

{
  "data": [
    {
      "id": 1263563815953975858,
      "concurrentRel": {
        "id": 1263563815953975858,
        "key": "Member_Post",
        "sourceId": 7943673015474471395,
        "objective0Id": 8660836888388716828,
        "objective1Id": -212598446762145162,
        "objective2Id": 3857499418371180882,
        "objective3Id": -880030961479892354,
        "objective4Id": -880030961479892354,
        "objective5Id": "Concurrent",
        "objective6Id": "jzbh001",
        "objective7Id": "-2736308504525451505,7719845212910406382,-4613445501354817437,4950678555804778711,-7705164106854020261,6462074474748723929,4624234846390337994",
        "objective8Id": null,
        "sortId": 1,
        "orgAccountId": 890230898462311829,
        "createTime": 1721200917020,
        "updateTime": 1721201226817,
        "validMemberPost": true
      },
      ...
  ],
  "page": 1,
  "size": 50,
  "needTotal": false,
  "total": 5,
  "sortPairs": [],
  "params": null,
  "showTotal": true,
  "sortOrder": "asc",
  "dataCount": 5,
  "startAt": 0,
  "pages": 1,
  "sortField": null
}

# 通过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：通过兼职编号查询，cMemberName：通过兼职人员名称查询}
value={code}	是	编号值/人员名称
accountid	是	单位ID

返回说明

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

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

# 通过ID获取兼职信息

通过ID 获取兼职信息

接口请求说明：

http请求方式：GET
http://ip:port/seeyon/rest/orgPartTimeJob/{id} // 注意该ID是兼职关系的ID，不是人员ID

参数说明：

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

返回说明

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

参数说明请参考:对象属性说明对应的ID的兼职关系不存在时会返回null

# 新增兼职

新建兼职信息

接口请求说明：

http请求方式：POST
http://ip:port/seeyon/rest/orgPartTimeJob?returnId=true

新增所需参数：：

res.put("cMemberId", "-5904186531465311839");//兼职人员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（对应兼职单位下的角色ID，多个以逗号拼接），必填
res.put("sortId", "");//兼职排序，非必填
res.put("code", "4");//兼职编号，非必填

 
 json格式如下
{
    "cPostId": “-7680462456906494208”, 
    "cRoleIds": "-2674129842350898190",
    "code": "4",
    "cMemberId": “-5904186531465311839”, 
    "cLevelId": “2572864152117856133”,
    "cDeptId": “-7058041343460749784”,
    "sortId": 6,
    "cAccountId": “-1956420195551131697”,
    "sAccountId": "38603735902077369",
}

返回说明

成功返回Success 失败返回failed

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

# 按照兼职ID删除兼职

按照兼职ID删除兼职

接口请求说明：

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

参数说明：

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

返回说明

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

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

# 修改兼职信息

修改兼职信息

接口请求说明：

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

修改相关参数：

res.put("id", "-717933079254446538");//更新是删除收插入，此ID 更新注意org_relationship表ID变化
res.put("cMemberId", "-5904186531465311839");//兼职人员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("sortId", "");//兼职排序，非必填
res.put("code", "4");//兼职编号，非必填

 
 json格式如下
{
	"id": “-717933079254446538”, 
    "cPostId": “-7680462456906494208”, 
    "cRoleIds": "-2674129842350898190",
    "code": "4",
    "cMemberId": “-5904186531465311839”, 
    "cLevelId": “2572864152117856133”,
    "cDeptId": “-7058041343460749784”,
    "sortId": 6,
    "cAccountId": “-1956420195551131697”,
    "sAccountId": "38603735902077369",
}

返回说明

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

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

# 权限服务管理

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

# 权限对象定义

# 权限对象实例

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

# 根据单位ID获取权限列表

根据单位ID获取权限列表

接口请求说明：

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

参数说明：

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

返回说明

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

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

# 添加部门角色(Since:V61)

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

接口请求说明

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

创建数据示例：

{
    "name":"测试部门角色",
    "code":"csbmjs",
    "sortId":"99"
}

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

返回说明

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

"角色创建成功： 8655510337858651768"

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

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

接口请求说明

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

参数说明：

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

返回说明

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

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

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

接口请求说明

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

参数说明：

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

返回说明

请求成功，返回部门下对应角色人员的JSON信息。JSON数据包参考：人员对象示例

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

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

接口请求说明

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

创建数据示例：

json格式
{
    "deptId": "2925405094202984290",
    "roleId": "-9215839272313205648",
    "memberIds": "7515430264335320501" 注意该人员ID是更新，如果要保留原角色下的人员，这个地方的人员ID需要添加原角色下的人员的ID，用逗号拼接
}

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

返回说明 跟新角色人员成功则返回成功提示。状态码

# 实体组织主数据值

# 查询对应实体的主数据值(Since:V8.2SP1)

根据实体id查询实体的主数据值

接口请求说明

http请求方式：GET
http://ip:port/seeyon/rest/{entityType}/customer/{entityId}

参数说明：

参数	是否必须	说明
entityType	是	实体类型
entityId	是	实体ID

entityType 取值如下：单位主数据：orgAccount 部门主数据：orgDepartment 岗位主数据：orgPost 人员主数据：orgMember 返回说明

请求成功，返回对应实体的所有主数据的JSON信息。

{
  "id": 412673114036716367,
  "memberId": -8655860078373615394,
  "createDate": 1700724472277,
  "updateDate": 1718938066317,
  "type": "Member",
  "extAttr1": null,
  "extAttr2": null,
  "extAttr3": null,
  "extAttr4": null,
  "extAttr5": null,
  "extAttr6": "",
  "extAttr7": null,
  "extAttr8": null,
  "extAttr9": null,
  "extAttr10": null,
  "extAttr11": null,
  "extAttr12": null,
  "extAttr13": null,
  "extAttr14": null,
  "extAttr15": null,
  "extAttr16": null,
  "extAttr17": null,
  "extAttr18": null,
  "extAttr19": null,
  "extAttr20": null,
  "extAttr21": null,
  "extAttr22": null,
  "extAttr23": null,
  "extAttr24": null,
  "extAttr25": null,
  "extAttr26": null,
  "extAttr27": null,
  "extAttr28": null,
  "extAttr29": null,
  "extAttr30": null,
  "extAttr31": "",
  "extAttr32": "",
  "extAttr33": null,
  "extAttr34": "",
  "extAttr35": null,
  "extAttr36": null,
  "extAttr37": null,
  "extAttr38": null,
  "extAttr39": null,
  "extAttr40": null,
  "extAttr41": "",
  "extAttr42": "",
  "extAttr43": "",
  "extAttr44": "",
  "extAttr45": null,
  "extAttr46": null,
  "extAttr47": null,
  "extAttr48": null,
  "extAttr49": null,
  "extAttr50": null,
  "extAttr51": "",
  "extAttr52": "",
  "extAttr53": null,
  "extAttr54": null,
  "extAttr55": null,
  "extAttr56": null,
  "extAttr57": null,
  "extAttr58": null,
  "extAttr59": null,
  "extAttr60": null,
  "extAttr61": null,
  "extAttr62": null,
  "extAttr63": null,
  "extAttr64": null,
  "extAttr65": null,
  "extAttr66": null,
  "extAttr67": null,
  "extAttr68": null,
  "extAttr69": null,
  "extAttr70": null,
  "extAttrMap": {
    "EXT_ATTR_19": null,
    "EXT_ATTR_12": null,
    "EXT_ATTR_56": null,
    "EXT_ATTR_11": null,
    "EXT_ATTR_55": null,
    "EXT_ATTR_14": null,
    "EXT_ATTR_58": null,
    "EXT_ATTR_13": null,
    "EXT_ATTR_57": null,
    "EXT_ATTR_16": null,
    "EXT_ATTR_15": null,
    "EXT_ATTR_59": null,
    "EXT_ATTR_18": null,
    "EXT_ATTR_17": null,
    "EXT_ATTR_50": null,
    "EXT_ATTR_52": "",
    "EXT_ATTR_51": "",
    "EXT_ATTR_10": null,
    "EXT_ATTR_54": null,
    "EXT_ATTR_53": null,
    "EXT_ATTR_45": null,
    "EXT_ATTR_44": "",
    "EXT_ATTR_47": null,
    "EXT_ATTR_46": null,
    "EXT_ATTR_49": null,
    "EXT_ATTR_48": null,
    "EXT_ATTR_6": "",
    "EXT_ATTR_7": null,
    "EXT_ATTR_4": null,
    "EXT_ATTR_5": null,
    "EXT_ATTR_2": null,
    "EXT_ATTR_41": "",
    "EXT_ATTR_3": null,
    "EXT_ATTR_40": null,
    "EXT_ATTR_43": "",
    "EXT_ATTR_1": null,
    "EXT_ATTR_42": "",
    "EXT_ATTR_8": null,
    "EXT_ATTR_9": null,
    "EXT_ATTR_34": "",
    "EXT_ATTR_33": null,
    "EXT_ATTR_36": null,
    "EXT_ATTR_35": null,
    "EXT_ATTR_38": null,
    "EXT_ATTR_37": null,
    "EXT_ATTR_39": null,
    "EXT_ATTR_70": null,
    "EXT_ATTR_30": null,
    "EXT_ATTR_32": "",
    "EXT_ATTR_31": "",
    "EXT_ATTR_23": null,
    "EXT_ATTR_67": null,
    "EXT_ATTR_22": null,
    "EXT_ATTR_66": null,
    "EXT_ATTR_25": null,
    "EXT_ATTR_69": null,
    "EXT_ATTR_24": null,
    "EXT_ATTR_68": null,
    "EXT_ATTR_27": null,
    "EXT_ATTR_26": null,
    "EXT_ATTR_29": null,
    "EXT_ATTR_28": null,
    "EXT_ATTR_61": "",
    "EXT_ATTR_60": null,
    "EXT_ATTR_63": null,
    "EXT_ATTR_62": "",
    "EXT_ATTR_21": null,
    "EXT_ATTR_65": null,
    "EXT_ATTR_20": null,
    "EXT_ATTR_64": null
  },
  "empty": true,
  "extraMap": {},
  "new": false
}

失败返回：数据不存在

创建人：admin

修改人：hufei、het、lichaoj

快速跳转

组织模型管理

← 致远REST客户端组织模型数据管理 →