# 数据接口 - 图表
##  新增图表
##### 请求路径: 
`/inputCharts`
##### 请求方式: 
`HTTP - POST`
##### 请求参数

| 字段名 | 类型 | 说明 |
| --- | --- | --- |
| chartName | String | 图表标题 |
| dataId | Number | 数据源id |
| describes | String | 描述 |
| style | String | 样式 |
| otherConfig | String | 其他设置 |
| chartsGroup | Number | 所属分组 |
| filters | String | 过滤条件 |
| chartType | enum : [ "Histogram", "Pie", "Line", "scatter", "population", "individual"]| 可视化模式        	|
| chartConfig | String | 图表配置 |

##### 请求示例
```json
{
    "chartName": "文档测试1(未命名)",
    "dataId": 71,
    "describes": "",
    "style": "",
    "chartConfig": "{}",
    "chartType": ""
}
```
##### 返回结果
```json
{
    "data": {
        "code": 200,
        "msg": "成功",
        "data": 298
    }
}
```
##### 详细说明
根据base.viewType的不同  chartConfig加载内容也不同
___
##  修改图表
##### 请求路径
`/updateCharts`
##### 请求方式
`HTTP - POST`
##### 请求参数

ChartID: code （图表编号） 其余同新增图表

##### 请求示例
```json
{
    "chartId": 298,
    "chartName": "文档测试1(未命名)",
    "dataId": 71,
    "createBy": "zhuth",
    "describes": null,
    "style": "",
    "otherConfig": "{}",
    "chartsGroup": "-1",
    "chartType": "Histogram",
    "chartConfig": "{\"xAxis\":{\"column\":{},\"granularity\":{}},\"yAxis\":{\"column\":{},\"gauge\":{}},\"groupBy\":{\"key\":\"\"}}",
    "groupBy": []
}
```
##### 返回结果
```json
{
    "data": {
        "code": 200,
        "msg": "成功",
        "data": null
    }
}
```
##### 详细说明
___
##  删除图表
##### 请求路径
`/delChartsConfig`
##### 请求方式
`HTTP - POST`
##### 请求参数

Code （图表编号）  

##### 请求示例
##### 返回结果
##### 详细说明
___
##  获得图表列表
##### 请求路径
`/getListCharts`
##### 请求方式
`HTTP - POST`
##### 请求参数
空
##### 返回结果
```json
{
    "data": {
        "code": 200,
        "msg": "成功",
        "data": [{
            "chartId": 262,
            "chartName": "bbbb",
            "chartType": "Pie",
            "describes": null,
            "chartsGroup": -1,
            "createBy": "zhuth",
            "createDate": "2018-08-06 11:17:33.0"
        }, {
            "chartId": 265,
            "chartName": "销售订单0",
            "chartType": "individual",
            "describes": null,
            "chartsGroup": 26,
            "createBy": "zhuth",
            "createDate": "2018-08-06 15:35:29.0"
        }, {
            "chartId": 263,
            "chartName": "bench_flowchart(未命名)111",
            "chartType": "Histogram",
            "describes": null,
            "chartsGroup": 41,
            "createBy": "zhuth",
            "createDate": "2018-08-06 11:18:19.0"
        }, {
            "chartId": 267,
            "chartName": "销售订单(未命名)",
            "chartType": "Line",
            "describes": null,
            "chartsGroup": 41,
            "createBy": "zhuth",
            "createDate": "2018-08-06 17:49:00.0"
        }, {
            "chartId": 264,
            "chartName": "hhjhh",
            "chartType": "Histogram",
            "describes": null,
            "chartsGroup": -1,
            "createBy": "zhuth",
            "createDate": "2018-08-06 11:20:16.0"
        }, {
            "chartId": 295,
            "chartName": "bbbb_副本",
            "chartType": "Pie",
            "describes": null,
            "chartsGroup": -1,
            "createBy": "zhuth",
            "createDate": "2018-08-08 13:56:26.0"
        }, {
            "chartId": 266,
            "chartName": "销售订单1",
            "chartType": "population",
            "describes": null,
            "chartsGroup": 26,
            "createBy": "zhuth",
            "createDate": "2018-08-06 16:22:30.0"
        }, {
            "chartId": 298,
            "chartName": "文档测试1(未命名)",
            "chartType": "Histogram",
            "describes": null,
            "chartsGroup": -1,
            "createBy": "zhuth",
            "createDate": "2018-08-08 16:32:33.0"
        }, {
            "chartId": 261,
            "chartName": "bench_flowchart(未命名)",
            "chartType": "Histogram",
            "describes": null,
            "chartsGroup": -1,
            "createBy": "zhuth",
            "createDate": "2018-08-06 10:03:03.0"
        }]
    }
}
```
##### 详细说明
___
##  获得单个图表详细数据
##### 请求路径 
`/getChartsConfig`
##### 请求方式
`HTTP - POST`
##### 请求参数

Code (图表编号)

##### 请求示例
```json
298
```
##### 返回结果
```json
{
    "data": {
        "code": 200,
        "msg": "成功",
        "data": {
            "chartId": 298,
            "chartName": "文档测试1(未命名)",
            "tableName": null,
            "chartType": "Histogram",
            "chartsGroup": -1,
            "groupBy": "[]",
            "chartConfig": "{\"xAxis\":{\"column\":{},\"granularity\":{}},\"yAxis\":{\"column\":{},\"gauge\":{}},\"groupBy\":{\"key\":\"\"}}",
            "createBy": "zhuth",
            "accessAuthority": "null",
            "updateAuthority": "null",
            "describes": null,
            "style": "\"\"",
            "filters": "null",
            "createDate": "2018-08-08 16:32:33.0",
            "updateDate": null,
            "dataId": 71,
            "subsections": null
        }
    }
}
```
##### 详细说明
___
##  请求单个图表展示数据
##### 请求路径
`/showHistogram`
`/showPie`
`/showLine`
`/showScatter`
`/showIndividual`

##### 请求方式
`HTTP - POST`

##### 请求参数

| 字段名 | 类型 | 说明 |
| --- | --- | --- |
| id | Number | 图表编号 |
| groups | Array | 分组列列名 |
| xAxis | Object : { columnRename: "列名", columnType: "列类型", showDataType: "统计方式" } | X轴 |
| yAxis | Object : { columnRename: "列名", showDataType: "统计方式"}| Y轴 |
| filters | Array | 过滤条件 |
##### 请求示例
##### 返回结果
##### 详细说明
- 在不同的可视化模式下有不同的请求参数，这里不一一列出了
- 此处gauge的命名可能会容易混淆：指的对单列进行合计统计的方式，分有计数、累计、最大值、中位数、平均值、最小值等。可能混淆的名称有metrics, aggregate等。
- 
___
##  获得图表所有分组/子分组
- 参照数据源分组接口说明
##### 请求路径
`/getChartsGroup`
##### 请求方式
`HTTP - POST`
##### 请求参数

空 

##### 请求示例
##### 返回结果
Code 分组编号
Pcode 父级分组编号
Index 索引
Label 标签
##### 详细说明
___
##  新增图表分组/子分组
##### 请求路径 
`/setChartsGroup`
#####请求方式`HTTP - POST`
##### 请求参数

| 字段名 | 类型 | 说明 |
| --- | --- | --- |
| fatherId | Number | 父级分组ID |
| groupName | String| 组名 |
| groupIndex | Number | 顺序号 |

##### 请求示例
##### 返回结果
##### 详细说明
如果是顶级分组（没有父级分组），则父级分组ID设置为-1
___
##  修改图表分组信息
##### 请求路径 
`/updataChartsGroup`
##### 请求方式
`HTTP - POST`
##### 请求参数

| 字段名 | 类型 | 说明 |
|--- | --- | --- |
| Id | Number | 分组ID |
| fatherId | Number | 父级分组ID |
| groupName | String | 组名 |
| groupIndex | Number | 顺序号 |

##### 请求示例
##### 返回结果
##### 详细说明
___
##  设置图表所属分组
##### 请求路径 
`/updateChartConfigGroup`
##### 请求方式
`HTTP - POST`
##### 请求参数

| 字段名 | 类型 | 说明 |
| --- | --- | --- |
| Id | Number | 数据源ID |
| GroupID | Number | 目标分组ID |

##### 请求示例
##### 返回结果
##### 详细说明
___
##  批量修改图表分组信息
##### 请求路径 
`/updataListGroup`
##### 请求方式
`HTTP - POST`
##### 请求参数

id : code  

##### 请求示例
##### 返回结果
##### 详细说明
___
##  删除图表分组/子分组
##### 请求路径 
`/delChartsGroup`
##### 请求方式
`HTTP - POST`
##### 请求参数

Code ID

##### 请求示例
##### 返回结果
##### 详细说明
___
##  图表移交
##### 请求路径 
`/changeChartOrder`
##### 请求方式
`HTTP - POST`
##### 请求参数
| 字段名 | 类型 | 说明 |
| --- | --- | --- |
| userId | Number | 被移交人id |
| id | Number | 图表id |
##### 请求示例
```json
{
    "userId": "23",
    "id": "145"
}
```        
##### 返回结果
##### 详细说明
___