# 数据接口 - 图表
##  新增图表
##### 请求路径: 
`/inputCharts`
##### 请求方式: 
`HTTP - POST`
#####包类方法:  
`dispatch(type:'chart/remoteAdd')`
##### 请求参数

| 字段名（后端） 	| 字段名（前端）              	| 说明              	|
|----------------	|-----------------------------	|-------------------	|
| chartName      	| header.label                	| 图表标题          	|
| dataId         	| baseConfig.dataSource       	| 基础配置 – 数据源 	|
| groupBy{       	|                             	| 预处理 – 分组     	|
| columnName     	| preparing.groupBy.key       	| 分组列列名        	|
| columnRamane   	| preparing.groupBy.label     	| 分组列别名        	|
| }]             	|                             	|                   	|
| createBy       	|                             	| 创建人            	|
| describes      	| description                 	| 说明              	|
| style          	|                             	| 样式配置          	|
| otherConfig    	| JSON.stringify(otherConfig) 	| 其他配置          	|
| chartType      	| base.viewType               	| 可视化模式        	|
| chartConfig    	|                             	| 图表配置          	|

##### 请求示例
##### 返回结果
##### 详细说明
根据base.viewType的不同  chartConfig加载内容也不同
___
##  修改图表
##### 请求路径
`/updateCharts`
##### 请求方式
`HTTP - POST`
##### 包类方法
`dispatch(type:'chart/remoteModify')`
##### 请求参数

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

##### 请求示例
##### 返回结果
##### 详细说明
___
##  删除图表
##### 请求路径
`/delChartsConfig`
##### 请求方式
`HTTP - POST`
##### 包类方法
`dispatch(type:'chart/remoteDelete')`
##### 请求参数

Code （图表编号）  

##### 请求示例
##### 返回结果
##### 详细说明
___
##  获得图表列表
##### 请求路径
`/getListCharts`
##### 请求方式
`HTTP - POST`
##### 包类方法
`dispatch(type:'chart/fetchList')`
##### 请求参数

空

##### 请求示例
##### 返回结果
##### 详细说明
___
##  获得单个图表详细数据
##### 请求路径 
`/getChartsConfig`
##### 请求方式
`HTTP - POST`
##### 包类方法
`dispatch(type:'chart/remoteDetail')`
##### 请求参数

Code (图表编号)

##### 请求示例
##### 返回结果
##### 详细说明
___
##  请求单个图表展示数据
##### 请求路径
`/showHistogram`
`/showPie`
`/showLine`
`/showScatter`
`/showIndividual`

##### 请求方式
`HTTP - POST`
##### 包类方法
`dispatch(type:'chart/fetchBarData')`
`dispatch(type:'chart/fetchLineData')`
`dispatch(type:'chart/fetchPieData')`
`dispatch(type:'chart/fetchScatterData')`
`dispatch(type:'chart/fetchDataViewData')`

##### 请求参数

| 字段名（后端） 	| 字段名（前端）                    	| 说明        	|
|----------------	|-----------------------------------	|-------------	|
| id             	| code                              	| 图表编号    	|
| groups         	| preparing.groupBy.key             	| 分组列列名  	|
| xAxis          	|                                  	| X轴         	|
| columnRename   	| barConfig.xAxis.column.value      	| X轴列名     	|
| columnType     	| barConfig.xAxis.column.type       	| X轴分析类型 	|
| showDataType   	| barConfig.xAxis.granularity.value 	| X轴粒度     	|
| yAxis          	|                                  	| Y轴         	|
| columnRename   	| barConfig.yAxis.column.value      	| Y轴列名     	|
| showDataType   	| barConfig.yAxis.gauge.value       	| Y轴统计方式 	|

##### 请求示例
##### 返回结果
##### 详细说明
此处gauge的命名可能会容易混淆：指的对单列进行合计统计的方式，分有计数、累计、最大值、中位数、平均值、最小值等。可能混淆的名称有metrics, aggregate等。
___
##  获得图表所有分组/子分组
##### 请求路径
`/getChartsGroup`
##### 请求方式
`HTTP - POST`
##### 包类方法
`dispatch(type:'chart/remoteGroupList')`
##### 请求参数

空 

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

| 字段名（后端） 	| 字段名（前端） 	| 说明              	|
|----------------	|----------------	|-------------------	|
| fatherId       	| pgroup.code    	| 父级分组ID        	|
| groupName      	| “新子分组”’    	| 基础配置 – 数据源 	|
| groupIndex     	|                	| 分组索引          	|
| createBy       	|                	| 创建人            	|

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

| 字段名（后端） 	| 字段名（前端） 	| 说明              	|
|----------------	|----------------	|-------------------	|
| Id             	| Group.code     	| 分组ID            	|
| fatherId       	| pgroup.code    	| 父级分组ID        	|
| groupName      	| “新子分组”’    	| 基础配置 – 数据源 	|
| groupIndex     	|                	| 分组索引          	|
| createBy       	|                	| 创建人            	|

##### 请求示例
##### 返回结果
##### 详细说明
___
##  设置图表所属分组
##### 请求路径 
`/updateChartConfigGroup`
##### 请求方式
`HTTP - POST`
##### 包类方法
`dispatch(type:'chart/remoteSetChartGroup')`
##### 请求参数

| 字段名（后端） 	| 字段名（前端） 	| 说明       	|
|----------------	|----------------	|------------	|
| Id             	| DatasourceCode 	| 数据源ID   	|
| GroupID        	| “新子分组”’    	| 目标分组ID 	|

##### 请求示例
##### 返回结果
##### 详细说明
___
##  批量修改图表分组信息
##### 请求路径 
`/updataListGroup`
##### 请求方式
`HTTP - POST`
##### 包类方法
`dispatch(type:'chart/remoteModifyGroups')`
##### 请求参数

id : code  

##### 请求示例
##### 返回结果
##### 详细说明
___
##  删除图表分组/子分组
##### 请求路径 
`/delChartsGroup`
##### 请求方式
`HTTP - POST`
##### 包类方法
`dispatch(type:'chart/remoteDeleteGroup')`
##### 请求参数

Code ID

##### 请求示例
##### 返回结果
##### 详细说明
___
## 图表编辑器
##  获得数据源下的列数据
##### 请求路径 
`/getColumnData`
##### 请求方式
`HTTP - POST`
##### 包类方法
`dispatch(type:'chartDesigner/remoteDataColumn')`
##### 请求参数

| 字段名（后端） 	| 字段名（前端） 	| 说明              	|
|----------------	|----------------	|-------------------	|
| fatherId       	| pgroup.code    	| 父级分组ID        	|
| groupName      	| “新子分组”’    	| 基础配置 – 数据源 	|
| groupIndex     	|                	| 分组索引          	|
| createBy       	|                	| 创建人            	|

##### 请求示例
##### 返回结果
##### 详细说明
此处将整个groups集体上传 集体替换。
此处建议使用batch表达批量修改的概念。