看板
# 概述
看板
类名
ProjectBoardApi.java
成员方法
| 名称 | 方法 | Method | Path |
|---|---|---|---|
| 新增看板 | addProjectBoard | POST | /api-organization/projectBoard/addProjectBoard |
| 删除项目看板 | deleteProjectBoard | POST | /api-organization/projectBoard/deleteProjectBoard |
| 查询所有项目看板列表 | getAllProjectBoardList | POST | /api-organization/projectBoard/getAllProjectBoardList |
| 查询单条看板信息 | getProjectBoard | POST | /api-organization/projectBoard/getProjectBoard |
| 查询可用项目看板列表 | getVisibleProjectBoardList | POST | /api-organization/projectBoard/getVisibleProjectBoardList |
| 修改项目看板 | updateProjectBoard | POST | /api-organization/projectBoard/updateProjectBoard |
# 新增看板
ResultObject addProjectBoard(addProjectBoardForm)
根据传入的Form 添加看板信息
# 请求参数
| 名称 | 类型 | 描述 | 备注 |
|---|---|---|---|
| addProjectBoardForm | AddProjectBoardForm | addProjectBoardForm |
# AddProjectBoardForm
| 名称 | 类型 | 描述 | 备注 |
|---|---|---|---|
| name | String | 项目看板名称 | - |
| remark | String | 项目看板备注 | - |
| sort | Integer | 项目看板序列号 | - |
| structureType | String | 项目看板数据结构类型 [0:树结构, 1:过滤列表, 2:分组结构] | - |
| useEnable | Boolean | 是否使用项目看板 [true:使用, false:不使用] | - |
# 返回参数
ResultObject
| 名称 | 类型 | 描述 | 备注 |
|---|---|---|---|
| code | String | 响应码 | - |
| data | Object | 响应数据 | - |
| msg | String | 响应消息 | - |
| time | OffsetDateTime | 响应时间 | - |
# java-sdk 调用示例
//实例化api类,传入token
ProjectBoardApi apiInstance = new ProjectBoardApi(token);
//实例化请求参数
AddProjectBoardForm addProjectBoardForm = new AddProjectBoardForm();
try {
ResultObject result = apiInstance.addProjectBoard(addProjectBoardForm);
System.out.println(result);
} catch (ApiException e) {
System.err.println("调用ProjectBoardApi.addProjectBoard异常: " + e.getMessage());
e.printStackTrace();
}
1
2
3
4
5
6
7
8
9
10
11
12
2
3
4
5
6
7
8
9
10
11
12
# HTTP 调用示例
| 属性 | 名称 |
|---|---|
| HTTP请求地址 | http://[server]:[port]/api-organization/projectBoard/addProjectBoard |
| 请求方式 | POST |
| Content-Type | application/json |
| header:key | Authorization |
| header:value | Bearer YOUR_ACCESS_TOKEN |
请求参数:
{
"name":"",
"remark":"",
"sort":0,
"structureType":"",
"useEnable":false
}
1
2
3
4
5
6
7
2
3
4
5
6
7
# 删除项目看板
ResultObject deleteProjectBoard(id)
根据传入的看板Id 删除该看板下的所有信息
# 请求参数
| 名称 | 类型 | 描述 | 备注 |
|---|---|---|---|
| id | String | 看板Id | - |
# 返回参数
ResultObject
| 名称 | 类型 | 描述 | 备注 |
|---|---|---|---|
| code | String | 响应码 | - |
| data | Object | 响应数据 | - |
| msg | String | 响应消息 | - |
| time | OffsetDateTime | 响应时间 | - |
# java-sdk 调用示例
//实例化api类,传入token
ProjectBoardApi apiInstance = new ProjectBoardApi(token);
//实例化请求参数
String id = "id_example";
try {
ResultObject result = apiInstance.deleteProjectBoard(id);
System.out.println(result);
} catch (ApiException e) {
System.err.println("调用ProjectBoardApi.deleteProjectBoard异常: " + e.getMessage());
e.printStackTrace();
}
1
2
3
4
5
6
7
8
9
10
11
12
2
3
4
5
6
7
8
9
10
11
12
# HTTP 调用示例
| 属性 | 名称 |
|---|---|
| HTTP请求地址 | http://[server]:[port]/api-organization/projectBoard/deleteProjectBoard |
| 请求方式 | POST |
| Content-Type | application/json |
| header:key | Authorization |
| header:value | Bearer YOUR_ACCESS_TOKEN |
请求参数:
{
"id":""
}
1
2
3
2
3
# 查询所有项目看板列表
ResultListProjectBoardVo getAllProjectBoardList()
查询所有看板信息
# 请求参数
请求参数为空.
# 返回参数
ResultListProjectBoardVo
| 名称 | 类型 | 描述 | 备注 |
|---|---|---|---|
| code | String | 响应码 | - |
| data | List<ProjectBoardVo> | 响应数据 | - |
| msg | String | 响应消息 | - |
| time | OffsetDateTime | 响应时间 | - |
ProjectBoardVo
| 名称 | 类型 | 描述 | 备注 |
|---|---|---|---|
| boardType | String | 项目看板类型 {0=系统 | 1=企业} |
| createdTime | OffsetDateTime | 项目看板创建时间 | - |
| id | String | 项目看板ID | - |
| name | String | 项目看板名称 | - |
| phoneEnable | Boolean | 项目看板是否在移动端使用 {0=不使用 | 1= 使用} |
| remark | String | 项目看板备注 | - |
| sort | Integer | 项目看板排序号 | - |
| structureType | String | 项目看板数据结构类型 {0=树结构 | 1=列表 |
| useEnable | Boolean | 项目看板是否使用 {0=不使用 | 1=使用} |
# java-sdk 调用示例
//实例化api类,传入token
ProjectBoardApi apiInstance = new ProjectBoardApi(token);
try {
ResultListProjectBoardVo result = apiInstance.getAllProjectBoardList();
System.out.println(result);
} catch (ApiException e) {
System.err.println("调用ProjectBoardApi.getAllProjectBoardList异常: " + e.getMessage());
e.printStackTrace();
}
1
2
3
4
5
6
7
8
9
10
2
3
4
5
6
7
8
9
10
# HTTP 调用示例
| 属性 | 名称 |
|---|---|
| HTTP请求地址 | http://[server]:[port]/api-organization/projectBoard/getAllProjectBoardList |
| 请求方式 | POST |
| Content-Type | application/json |
| header:key | Authorization |
| header:value | Bearer YOUR_ACCESS_TOKEN |
请求参数:
{}
1
# 查询单条看板信息
ResultProjectBoard getProjectBoard(id)
查询单条看板信息
# 请求参数
| 名称 | 类型 | 描述 | 备注 |
|---|---|---|---|
| id | String | id | - |
# 返回参数
ResultProjectBoard
| 名称 | 类型 | 描述 | 备注 |
|---|---|---|---|
| code | String | 响应码 | - |
| data | ProjectBoard | 响应数据 | - |
| msg | String | 响应消息 | - |
| time | OffsetDateTime | 响应时间 | - |
ProjectBoard
| 名称 | 类型 | 描述 | 备注 |
|---|---|---|---|
| boardType | String | 项目看板类型 | - |
| companyId | String | 项目看板所属企业ID | - |
| createdBy | String | 项目看板创建人 | - |
| createdTime | OffsetDateTime | 项目看板创建时间 | - |
| id | String | 项目看板ID | - |
| name | String | 项目看板名称 | - |
| phoneEnable | Boolean | 项目看板是否移动端显示 | - |
| remark | String | 项目看板备注 | - |
| sort | Integer | 项目看板排序号 | - |
| structureType | String | 项目看板结构类型 | - |
| updatedTime | OffsetDateTime | 项目看板修改时间 | - |
| useEnable | Boolean | 是否使用项目看板 | - |
# java-sdk 调用示例
//实例化api类,传入token
ProjectBoardApi apiInstance = new ProjectBoardApi(token);
//实例化请求参数
String id = "id_example";
try {
ResultProjectBoard result = apiInstance.getProjectBoard(id);
System.out.println(result);
} catch (ApiException e) {
System.err.println("调用ProjectBoardApi.getProjectBoard异常: " + e.getMessage());
e.printStackTrace();
}
1
2
3
4
5
6
7
8
9
10
11
12
2
3
4
5
6
7
8
9
10
11
12
# HTTP 调用示例
| 属性 | 名称 |
|---|---|
| HTTP请求地址 | http://[server]:[port]/api-organization/projectBoard/getProjectBoard |
| 请求方式 | POST |
| Content-Type | application/json |
| header:key | Authorization |
| header:value | Bearer YOUR_ACCESS_TOKEN |
请求参数:
{
"id":""
}
1
2
3
2
3
# 查询可用项目看板列表
ResultListProjectBoardVo getVisibleProjectBoardList()
查询当前登录用户可见的的项目看板列表
# 请求参数
请求参数为空.
# 返回参数
ResultListProjectBoardVo
| 名称 | 类型 | 描述 | 备注 |
|---|---|---|---|
| code | String | 响应码 | - |
| data | List<ProjectBoardVo> | 响应数据 | - |
| msg | String | 响应消息 | - |
| time | OffsetDateTime | 响应时间 | - |
ProjectBoardVo
| 名称 | 类型 | 描述 | 备注 |
|---|---|---|---|
| boardType | String | 项目看板类型 {0=系统 | 1=企业} |
| createdTime | OffsetDateTime | 项目看板创建时间 | - |
| id | String | 项目看板ID | - |
| name | String | 项目看板名称 | - |
| phoneEnable | Boolean | 项目看板是否在移动端使用 {0=不使用 | 1= 使用} |
| remark | String | 项目看板备注 | - |
| sort | Integer | 项目看板排序号 | - |
| structureType | String | 项目看板数据结构类型 {0=树结构 | 1=列表 |
| useEnable | Boolean | 项目看板是否使用 {0=不使用 | 1=使用} |
# java-sdk 调用示例
//实例化api类,传入token
ProjectBoardApi apiInstance = new ProjectBoardApi(token);
try {
ResultListProjectBoardVo result = apiInstance.getVisibleProjectBoardList();
System.out.println(result);
} catch (ApiException e) {
System.err.println("调用ProjectBoardApi.getVisibleProjectBoardList异常: " + e.getMessage());
e.printStackTrace();
}
1
2
3
4
5
6
7
8
9
10
2
3
4
5
6
7
8
9
10
# HTTP 调用示例
| 属性 | 名称 |
|---|---|
| HTTP请求地址 | http://[server]:[port]/api-organization/projectBoard/getVisibleProjectBoardList |
| 请求方式 | POST |
| Content-Type | application/json |
| header:key | Authorization |
| header:value | Bearer YOUR_ACCESS_TOKEN |
请求参数:
{}
1
# 修改项目看板
ResultObject updateProjectBoard(updateProjectBoardForm)
只可修改 该看板的[名称, 是否使用, 排序号, 备注]
# 请求参数
| 名称 | 类型 | 描述 | 备注 |
|---|---|---|---|
| updateProjectBoardForm | UpdateProjectBoardForm | updateProjectBoardForm |
# UpdateProjectBoardForm
| 名称 | 类型 | 描述 | 备注 |
|---|---|---|---|
| id | String | 项目看板Id | |
| name | String | 项目看板名称 | |
| phoneEnable | Boolean | 是否在移动端使用项目看板 true:使用 false:不使用 | - |
| remark | String | 项目看板备注 | - |
| sort | Integer | 项目看板序列号 | - |
| useEnable | Boolean | 是否使用项目看板 true:使用 false:不使用 |
# 返回参数
ResultObject
| 名称 | 类型 | 描述 | 备注 |
|---|---|---|---|
| code | String | 响应码 | - |
| data | Object | 响应数据 | - |
| msg | String | 响应消息 | - |
| time | OffsetDateTime | 响应时间 | - |
# java-sdk 调用示例
//实例化api类,传入token
ProjectBoardApi apiInstance = new ProjectBoardApi(token);
//实例化请求参数
UpdateProjectBoardForm updateProjectBoardForm = new UpdateProjectBoardForm();
try {
ResultObject result = apiInstance.updateProjectBoard(updateProjectBoardForm);
System.out.println(result);
} catch (ApiException e) {
System.err.println("调用ProjectBoardApi.updateProjectBoard异常: " + e.getMessage());
e.printStackTrace();
}
1
2
3
4
5
6
7
8
9
10
11
12
2
3
4
5
6
7
8
9
10
11
12
# HTTP 调用示例
| 属性 | 名称 |
|---|---|
| HTTP请求地址 | http://[server]:[port]/api-organization/projectBoard/updateProjectBoard |
| 请求方式 | POST |
| Content-Type | application/json |
| header:key | Authorization |
| header:value | Bearer YOUR_ACCESS_TOKEN |
请求参数:
{
"phoneEnable":false,
"useEnable":false,
"name":"",
"remark":"",
"id":"",
"sort":0
}
1
2
3
4
5
6
7
8
2
3
4
5
6
7
8
