部门新增

接口说明

新增部门信息

前置条件

请求头设置Authorization字段

接口配套版本信息

智能物联综合管理平台iConnection Center V5.0.6及以上版本

接口版本

1.0.0

接口URL

/evo-apigw/evo-brm/1.0.0/department/add

请求Method

POST

数据提交格式

application/json

请求参数

参数名必选类型说明
parentIdtruelong父部门Id，默认为根节点1,调部门分页查询 或部门树查询获取
nametruestring部门名称,长度 1-25 位,允许输入的值：数字、字母、下划线、中文、横线、点 、·最大长度25个字符,不能以空格开头和结尾,正则：^[a-zA-Z0-9_@./ ():-\s\u4E00-\u9FA5\u3400-\u4DBF]{0,25}$
depTypefalsestring部门类型，调查询部门类型列表获取的部门类型编号字段seq
departmentCodefalsestring部门编码,允许输入的值：数字、字母 最大长度64个字符
departmentSnfalsestring部门唯一标识码,允许输入的值：数字、字母 最大长度64个字符；全局唯一
thoseResponsiblefalsestring部门负责人人员编码,调人员信息分页获取接口获取人员编码code字段
phonefalsestring部门联系电话,长度 1-16 位,允许输入的值：数字、-
emailfalsestring部门邮箱,长度 1-64 位,允许输入的值（数字，字母，._符号）
addressfalsestring部门地址,长度 1-64 位,允许输入的值：数字、字母、下划线、中文、横线、点 、·最大长度64个字符,不能以空格开头和结尾
memofalsestring备注

请求参数示例

{
    "parentId": 1,
    "parentName": "根部门",
    "name": "12190004",
    "depType": "a440d242-5cca-4fa9-adf6-97f5595374c1",
    "departmentCode": "12190004",
    "departmentSn": "12190004",
    "thoseResponsible": "453321",
    "phone": "150****1234",
    "email": "xxx@xx.com",
    "address": "测试",
    "memo": "测试"
}

返回参数

名称类型说明
successboolean接口返回是否成功
codestring错误码：0-为无错误，非0-为具体错误码
errMsgstring错误消息
dataobject返回数据对象
+idlong部门id

返回参数示例（成功）

{
    "success": true,
    "data": {
        "id": 10015
    },
    "code": "0",
    "errMsg": ""
}

返回参数示例（失败）

{
    "success": false,
    "data": {},
    "code": "28170000",
    "errMsg": "上级部门不存在"
}
部门更新

接口说明

更新部门信息

前置条件

请求头设置Authorization字段

接口配套版本信息

智能物联综合管理平台iConnection Center V5.0.6及以上版本

接口版本

1.0.0

接口URL

/evo-apigw/evo-brm/1.0.0/department/update

请求Method

PUT

数据提交格式

application/json

请求参数

参数名必选类型说明
idtruelong部门Id，不支持修改
parentIdtruelong父部门Id，默认为根节点1,调部门分页查询 或部门树查询获取，不支持修改
nametruestring部门名称,长度 1-25 位,允许输入的值：数字、字母、下划线、中文、横线、点 、·最大长度25个字符,不能以空格开头和结尾,正则：^[a-zA-Z0-9_@./ ():-\s\u4E00-\u9FA5\u3400-\u4DBF]{0,25}$
depTypefalsestring部门类型，调查询部门类型列表获取的部门类型编号字段seq
departmentCodefalsestring部门编码,允许输入的值：数字、字母 最大长度64个字符
departmentSnfalsestring部门唯一标识码,允许输入的值：数字、字母 最大长度64个字符；全局唯一
thoseResponsiblefalsestring部门负责人人员编码,调人员信息分页获取接口获取人员编码code字段
phonefalsestring部门联系电话,长度 1-16 位,允许输入的值：数字、-
emailfalsestring部门邮箱,长度 1-64 位,允许输入的值（数字，字母，._符号）
addressfalsestring部门地址,长度 1-64 位,允许输入的值：数字、字母、下划线、中文、横线、点 、·最大长度64个字符,不能以空格开头和结尾
memofalsestring备注

请求参数示例

{
	"id":10011,
	"parentId":10002,
	"name":"一级部门G",
	"memo":"备注"
}

返回参数

名称类型说明
successboolean接口返回是否成功
codestring错误码：0-为无错误，非0-为具体错误码
errMsgstring错误消息
dataobject返回数据对象
+idlong部门id

返回参数示例（成功）

 {
    "success": true,
    "data": {
		"id":10011
	 },
    "code": "0",
    "errMsg": ""
}

返回参数示例（失败）

{
    "success": false,
    "data": {},
    "code": "28170000",
    "errMsg": "上级部门不存在"
}
部门批量新增

接口说明

更新部门信息

前置条件

请求头设置Authorization字段

接口配套版本信息

智能物联综合管理平台iConnection Center V5.0.6及以上版本

接口版本

1.0.0

接口URL

/evo-apigw/evo-brm/1.0.0/department/batch-add

请求Method

POST

数据提交格式

application/json

请求参数

参数名必选类型说明
departmentListtrueList<DepartmentVO>部门列表

DepartmentVO

参数名必选类型说明
idtruelong部门id,需要通过部门全局id批量生成接口申请
parentIdtruelong父部门Id，默认为根节点1,调部门分页查询 或部门树查询获取
nametruestring部门名称,长度 1-25 位,允许输入的值：数字、字母、下划线、中文、横线、点 、·最大长度25个字符,不能以空格开头和结尾,正则：^[a-zA-Z0-9_@./ ():-\s\u4E00-\u9FA5\u3400-\u4DBF]{0,25}$
depTypefalsestring部门类型，调查询部门类型列表获取的部门类型编号字段seq
departmentCodefalsestring部门编码,允许输入的值：数字、字母 最大长度64个字符
departmentSnfalsestring部门唯一标识码,允许输入的值：数字、字母 最大长度64个字符；全局唯一
thoseResponsiblefalsestring部门负责人人员编码,调人员信息分页获取接口获取人员编码code字段
phonefalsestring部门联系电话,长度 1-16 位,允许输入的值：数字、-
emailfalsestring部门邮箱,长度 1-64 位,允许输入的值（数字，字母，._符号）
addressfalsestring部门地址,长度 1-64 位,允许输入的值：数字、字母、下划线、中文、横线、点 、·最大长度64个字符,不能以空格开头和结尾
memofalsestring备注

请求参数示例

{
    "departmentList": [
        {
            "parentId": 1,
            "parentName": "根部门",
            "name": "12190003",
            "depType": "a440d242-5cca-4fa9-adf6-97f5595374c1",
            "departmentCode": "12190003",
            "departmentSn": "12190003",
            "thoseResponsible": "453321",
            "phone": "150****1234",
            "email": "xxx@xx.com",
            "address": "测试",
            "memo": "测试",
            "id": 100016
        },
        {
            "parentId": 1,
            "parentName": "根部门",
            "name": "12190002",
            "depType": "a440d242-5cca-4fa9-adf6-97f5595374c1",
            "departmentCode": "12190002",
            "departmentSn": "12190002",
            "thoseResponsible": "453321",
            "phone": "150****1234",
            "email": "xxx@xx.com",
            "address": "测试",
            "memo": "测试",
            "id": 100017
        }
    ]
}

返回参数

名称类型说明
successboolean接口返回是否成功
codestring错误码：0为无错误，非0为具体错误码
errMsgstring错误消息
dataobject返回数据对象
+idsarray部门id集合

返回参数示例（成功）

 {
    "success": true,
    "data": {
		"ids":[10011,10012]
	  },
    "code": "0",
    "errMsg": ""
}

返回参数示例（失败）

{
    "success": false,
    "data": {},
    "code": "28170000",
    "errMsg": "上级部门不存在"
}
部门删除

接口说明

删除部门信息

前置条件

请求头设置Authorization字段

接口配套版本信息

智能物联综合管理平台iConnection Center V5.0.6及以上版本

接口版本

1.0.0

接口URL

/evo-apigw/evo-brm/1.0.0/department/delete

请求Method

DELETE

数据提交格式

application/json

请求参数

参数名必选类型说明
idtruelong部门Id，调部门分页查询 或部门树查询获取

请求参数示例

{
    "id": 100021
}

返回参数

名称类型说明
successboolean接口返回是否成功
codestring错误码：0-为无错误，非0-为具体错误码
errMsgstring错误消息
dataobject返回数据对象
+idlong部门Id

返回参数示例（成功）

{
    "success": true,
    "code": "0",
    "errMsg": "成功",
    "data": {
        "id":10005
    }
}

返回参数示例（失败）

{
    "success": false,
    "data": {},
    "code": "28170014",
    "errMsg": "用户没有对应部门权限"
}
部门详情查询

接口说明

查询部门详细信息

前置条件

请求头设置Authorization字段

接口配套版本信息

智能物联综合管理平台iConnection Center V5.0.6及以上版本

接口版本

1.0.0

接口URL

/evo-apigw/evo-brm/1.0.0/department/{id}

请求Method

GET

数据提交格式

application/json

请求参数

参数名必选类型说明
idtruelong部门id

请求参数示例

/evo-apigw/evo-brm/1.0.0/department/6

返回参数

名称类型说明
successboolean接口返回是否成功
codestring错误码：0-为无错误，非0-为具体错误码
errMsgstring错误消息
dataobject返回数据对象
idlong部门ID
parentIdlong父部门Id，默认为根节点1,调部门分页查询 或部门树查询获取
namestring部门名称,长度 1-25 位,允许输入的值：数字、字母、下划线、中文、横线、点 、·最大长度25个字符,不能以空格开头和结尾
depTypestring部门类型，调查询部门类型列表获取的部门类型编号字段seq
departmentCodestring部门编码,允许输入的值：数字、字母 最大长度64个字符
departmentSnstring部门唯一标识码,允许输入的值：数字、字母 最大长度64个字符；全局唯一
thoseResponsiblestring部门负责人人员编码,调人员信息分页获取接口获取人员编码code字段
phonestring部门联系电话,长度 1-16 位,允许输入的值：数字、-
emailstring部门邮箱,长度 1-64 位,允许输入的值（数字，字母，._符号）
addressstring部门地址,长度 1-25 位,允许输入的值：数字、字母、下划线、中文、横线、点 、·最大长度25个字符,不能以空格开头和结尾
memostring备注

返回参数示例（成功）

{
    "success": true,
    "data": {
        "id": 100015,
        "parentId": 1,
        "name": "12190001",
        "nameExt": "12190001",
        "memo": "测试",
        "memoExt": "测试",
        "sort": 10,
        "parentIds": "1,100015,",
        "address": "测试",
        "depType": "a440d242-5cca-4fa9-adf6-97f5595374c1",
        "departmentCode": "12190001",
        "thoseResponsible": "453321",
        "thoseResponsibleName": "ceshi",
        "email": "xxx@xx.com",
        "phone": "150****1234",
        "departmentSn": "12190001"
    },
    "code": "0",
    "errMsg": ""
}
部门全局id生成

接口说明

生成部门全局id(新增部门时候使用)

前置条件

请求头设置Authorization字段

接口配套版本信息

智能物联综合管理平台iConnection Center V5.0.6及以上版本

接口版本

1.0.0

接口URL

/evo-apigw/evo-brm/1.0.0/department/generate-id

请求Method

GET

数据提交格式

application/json

请求参数

参数名必选类型说明

请求参数示例

/evo-apigw/evo-brm/1.0.0/department/generate-id

返回参数

名称类型说明
successboolean接口返回是否成功
codestring错误码：0-为无错误，非0-为具体错误码
errMsgstring错误消息
dataobject返回数据对象
+idlong部门全局ID

返回参数示例（成功）

{
    "success": true,
    "data": {
        "id": 10015
    },
    "code": "0",
    "errMsg": ""
}
部门全局id批量生成

接口说明

批量生成部门全局id(批量新增部门时候使用)

前置条件

请求头设置Authorization字段

接口配套版本信息

智能物联综合管理平台iConnection Center V5.0.6及以上版本

接口版本

1.0.0

接口URL

/evo-apigw/evo-brm/1.0.0/department/batch-generate-id

请求Method

GET

数据提交格式

application/json

请求参数

参数名必选类型说明
counttrueInteger生成全局唯一部门Id个数

请求参数示例

/evo-apigw/evo-brm/1.0.0/department/batch-generate-id?count=2

返回参数

名称类型说明
successboolean接口返回是否成功
codestring错误码：0-为无错误，非0-为具体错误码
errMsgstring错误消息
dataobject返回数据对象
+idListArray部门全局ID集合

返回参数示例（成功）

  {
    "success": true,
    "code": "0",
    "errMsg": ""
    "data": {
        "idList":[12,13]
    }
}
部门分页查询

接口说明

分页查询部门信息

若无请求参数，请求体应设置为{}

前置条件

请求头设置Authorization字段

接口配套版本信息

智能物联综合管理平台iConnection Center V5.0.6及以上版本

接口版本

1.0.0

接口URL

/evo-apigw/evo-brm/1.2.0/department/page

请求Method

POST

数据提交格式

application/json

请求参数

参数名必选类型说明
parentIdfalselong上级部门ID
containerLowerfalsestring是否包含所有下级节点,parentId不为空时有效
departmentIdsfalsearray部门id列表
pageNumfalseint当前页, 默认1
pageSizefalseint每页大小
searchKeyfalsestring模糊搜索关键字 按照部门名称模糊

请求参数示例

{
	"parentId":1,
	"containerLower":"1",
	"searchKey":"",
	"departmentIds":[],
	"pageNum":1,
	"pageSize":10
}

返回参数

名称类型说明
successboolean接口返回是否成功
codestring错误码：0-为无错误，非0-为具体错误码
errMsgstring错误消息
dataPageVO分页数据

PageVO

名称类型说明
currentPageint当前页码
totalPageint总页数
pageSizeint每页记录数
totalRowsint总数
pageDataList<DeptInfoVO>数据列表

DeptInfoVO

名称类型说明
idlong部门id
parentIdlong上级部门id
namestring部门名称
memostring备注
sortint同级部门排序值
parentIdsstring部门层级关系
departmentSnstring部门唯一编码
domainIdstring级联节点的域id

返回参数示例（成功）

{
	"success": true,
	"data": {
		"pageData": [{
				"id": 1,
				"parentId": 0,
				"name": "根部门",
				"memo": "根部门",
				"sort": 1,
				"parentIds": "1,",
				"domainId": null,
				"departmentSn": null
			},
			{
				"id": 10001,
				"parentId": 1,
				"name": "默认部门2",
				"memo": null,
				"sort": 1,
				"parentIds": "1,10001,",
				"domainId": null,
				"departmentSn": "12"
			}
		],
		"currentPage": 1,
		"totalPage": 1,
		"pageSize": 2,
		"totalRows": 2
	},
	"code": "0",
	"errMsg": ""
}
部门全量数据同步

接口说明

全量同步部门数据

前置条件

请求头设置Authorization字段

接口配套版本信息

智能物联综合管理平台iConnection Center V5.0.6及以上版本

接口版本

1.0.0

接口URL

/evo-apigw/evo-brm/1.0.0/department/list-page

请求Method

GET

数据提交格式

multipart/form-data

请求参数

参数名必选类型说明
maxRangeIdfalselong同步边界值
pageNumfalseint当前页, 默认1
pageSizefalseint每页大小
searchKeyfalsestring模糊搜索关键字 按照部门名称模糊

请求参数示例

https://10.55.36.202/evo-apigw/evo-brm/1.0.0/department/list-page?pageSize=20&pageNum=1

返回参数

名称类型说明
successboolean接口返回是否成功
codestring错误码：0-为无错误，非0-为具体错误码
errMsgstring错误消息
dataPageVO分页数据

PageVO

名称类型说明
currentPageint当前页码
totalPageint总页数
pageSizeint每页记录数
totalRowsint总数
pageDataList<DeptInfoVO>数据列表

DeptInfoVO

名称类型说明
idlong部门id
parentIdlong上级部门id
namestring部门名称
memostring备注
sortint同级部门排序值
parentIdsstring部门层级关系
departmentSnstring部门唯一编码
domainIdstring级联节点的域id

返回参数示例（成功）

{
	"success": true,
	"data": {
		"pageData": [{
				"id": 1,
				"parentId": 0,
				"name": "根部门",
				"memo": "根部门",
				"sort": 1,
				"parentIds": "1,",
				"domainId": null,
				"departmentSn": null
			},
			{
				"id": 10001,
				"parentId": 1,
				"name": "默认部门2",
				"memo": null,
				"sort": 1,
				"parentIds": "1,10001,",
				"domainId": null,
				"departmentSn": "12"
			}
		],
		"currentPage": 1,
		"totalPage": 1,
		"pageSize": 2,
		"totalRows": 2
	},
	"code": "0",
	"errMsg": ""
}
部门树查询

接口说明

查询部门树

若无请求参数，请求体应设置为{}

前置条件

请求头设置Authorization字段

接口配套版本信息

智能物联综合管理平台iConnection Center V5.0.6及以上版本

接口版本

1.2.0

接口URL

/evo-apigw/evo-brm/1.2.0/department/tree

请求Method

POST

数据提交格式

application/json

请求参数

参数名必选类型说明
parentIdfalselong上级部门id
checkStatfalseint上级部门checkStat (是否有权限)
namefalsestring查询部门名称
showPersonNodefalseInteger是否展示人员节点,默认不展示
showCascadeNodefalseInteger是否展示级联节点级联节点,默认不展示
personIdentityIdfalseLong人员身份 只有展示人员节点时可用
pageNumfalseint当前页, 默认1
needCheckDepartmentIdListfalseList勾选部门ID列表

请求参数示例

{
	"parentId":0,
	"checkStat":1,
	"name":"根部门",
	"showPersonNode":"1",
	"showCascadeNode":"1",
	"personIdentityId":1,
	"pageNum":1,
	"needCheckDepartmentIdList":[1,2]
}

返回参数

名称类型说明
successboolean接口返回是否成功
codestring错误码：0-为无错误，非0-为具体错误码
errMsgstring错误消息
dataValueVO返回数据

ValueVO

名称类型说明
valueList<DeptInfoVO>数据列表

DeptInfoVO

名称类型说明
idlong部门id
parentIdlong上级部门id
nameString部门名称
checkStatint是否有节点权限
sortint同级部门排序字段
isParentint是否有子部门
nodeTypeint部门树节点类型,默认部门节点
pageNumint下一页页数 仅虚拟翻页节点有，表示下一页页数
personIdLong人员ID 仅人员节点有
personCodeString人员编码 仅人员节点有
personNameString人员姓名 仅人员节点有
personIdentityLong人员身份 仅人员节点有
paperNumberString证件号码 仅人员节点有
paperTypeint证件类型,仅人员节点有
isCheckBoolean是否勾选,仅传参有needCheckDepartmentIdList时返回

返回参数示例（成功）

{
    "success": true,
    "data": {
        "value": [
            {
                "id": 1,
                "parentId": 0,
                "name": "根部门",
                "checkStat": 1,
                "sort": 1,
                "isParent": 1,
                "isCheck": true
            },
            {
                "parentId": 2,
                "name": "人员名称",
                "checkStat": 1,
                "sort": 1,
                "isParent": 0,
                "nodeType": 2,
                "isCheck": false,
                "personId": 16,
                "personCode": "48477",
                "personName": "人员名称",
                "personIdentity": 1,
                "paperNumber": "1***********2",
                "paperType": 3
            },
            {
                "parentId": 2,
                "name": "人员名称",
                "checkStat": 1,
                "sort": 2,
                "isParent": 0,
                "nodeType": 2,
                "isCheck": false,
                "personId": 14,
                "personCode": "39961",
                "personName": "人员名称",
                "personIdentity": 1,
                "paperNumber": "1000000018593",
                "paperType": 3
            },
            {
                "parentId": 1,
                "name": "人员名称",
                "checkStat": 1,
                "sort": 3,
                "isParent": 0,
                "nodeType": 2,
                "isCheck": false,
                "personId": 12,
                "personCode": "38116",
                "personName": "人员名称",
                "personIdentity": 1,
                "paperNumber": "1000000013296",
                "paperType": 3
            },
            {
                "parentId": 1,
                "name": "人员名称update",
                "checkStat": 1,
                "sort": 4,
                "isParent": 0,
                "nodeType": 2,
                "isCheck": false,
                "personId": 6,
                "personCode": "1234571",
                "personName": "人员名称update",
                "personIdentity": 1,
                "paperNumber": "330101********6121",
                "paperType": 111
            },
            {
                "parentId": 1,
                "name": "147852369",
                "checkStat": 1,
                "sort": 5,
                "isParent": 0,
                "nodeType": 2,
                "isCheck": false,
                "personId": 5,
                "personCode": "147852369",
                "personName": "147852369",
                "personIdentity": 1,
                "paperNumber": "147852369",
                "paperType": 131
            },
            {
                "parentId": 5,
                "name": "123456789",
                "checkStat": 1,
                "sort": 6,
                "isParent": 0,
                "nodeType": 2,
                "isCheck": false,
                "personId": 4,
                "personCode": "123456789",
                "personName": "123456789",
                "personIdentity": 1,
                "paperNumber": "123456789",
                "paperType": 6
            },
            {
                "parentId": 1,
                "name": "213123",
                "checkStat": 1,
                "sort": 7,
                "isParent": 0,
                "nodeType": 2,
                "isCheck": false,
                "personId": 3,
                "personCode": "321321",
                "personName": "213123",
                "personIdentity": 1,
                "paperNumber": "3213213",
                "paperType": 3
            },
            {
                "parentId": 1,
                "name": "dsadsa",
                "checkStat": 1,
                "sort": 8,
                "isParent": 0,
                "nodeType": 2,
                "isCheck": false,
                "personId": 2,
                "personCode": "312",
                "personName": "dsadsa",
                "personIdentity": 1,
                "paperNumber": "3213",
                "paperType": 3
            },
            {
                "parentId": 1,
                "name": "123123123",
                "checkStat": 1,
                "sort": 9,
                "isParent": 0,
                "nodeType": 2,
                "isCheck": false,
                "personId": 1,
                "personCode": "123123321",
                "personName": "123123123",
                "personIdentity": 1,
                "paperNumber": "153123132",
                "paperType": 6
            }
        ]
    },
    "code": "0",
    "errMsg": ""
}

返回参数示例（失败）

{
    "success": false,
    "data": {},
    "code": "28160061",
    "errMsg": "匹配结果节点较多，请提供更精确的模糊查询条件进行搜索 "
}
查询部门类型列表

接口说明

查询部门类型列表

前置条件

请求头设置Authorization字段

接口配套版本信息

智能物联综合管理平台iConnection Center V5.0.14及以上版本

接口版本

1.2.0

接口URL

/evo-apigw/evo-brm/1.2.0/department/type/{stat}

请求Method

GET

数据提交格式

-

请求参数

参数名必选类型说明
statfalselong启用状态；-1：全部，0：停用 1：启用，-1则查询包含启用与停用的部门类型列表

请求参数示例

查询所有部门类型列表
https://10.56.10.163/evo-apigw/evo-brm/1.2.0/department/type/-1

查询启用状态的部门类型列表
https://10.56.10.163/evo-apigw/evo-brm/1.2.0/department/type/1

返回参数

名称类型说明
successboolean接口返回是否成功
codestring错误码：0-为无错误，非0-为具体错误码
errMsgstring错误消息
dataValueVO返回数据

ValueVO

名称类型说明
depTypesList<DepType>部门类型列表

DepType

名称类型说明
seqString部门类型编号
nameString类型名称
statString启用状态；0：停用 1：启用
editString是否可以编辑1:不能编辑 其他可以编辑

返回参数示例（成功）

{
    "success": true,
    "data": {
        "depTypes": [
            {
                "name": "基本部门",
                "seq": "a440d242-5cca-4fa9-adf6-97f5595374c1",
                "stat": 1,
                "description": null,
                "systemCode": null,
                "edit": "1"
            },
            {
                "name": "集团公司",
                "seq": "8ee61ad3-5062-4b4f-8fec-bdce90488fa7",
                "stat": 1,
                "description": null,
                "systemCode": null,
                "edit": "1"
            },
            {
                "name": "分子公司",
                "seq": "477d08c7-23d3-4084-ad8a-b00a93439525",
                "stat": 1,
                "description": null,
                "systemCode": null,
                "edit": "1"
            },
            {
                "name": "6767",
                "seq": "d0ecce95-e854-4e22-b84b-84adc84d008b",
                "stat": 1,
                "description": "",
                "systemCode": null,
                "edit": "0"
            }
        ]
    },
    "code": "0",
    "errMsg": ""
}

返回参数示例（失败）

{
    "success": false,
    "data": {},
    "code": "99020032",
    "errMsg": "parameter type mismatch"
}