# 功能描述

图形报表可以设定图文并茂的形式，即图形跟报表同时展示，图形可以设定为表格、柱形、折线、饼图、漏斗图、雷达图、热力图、仪表图、字符云、自定义脚本

# 操作步骤

如果需要新建一张图形报表 入口：开发配置 -> 开发工具 -> 图形报表 点击【新增】

选择要创建的报表类型

当前的数据只能基于Freemarker SQL传入。

# 表格

传入Freemarker SQL

当然最好是指定自己需要的字段，以提高效率。

设置数据字段 表格的数据字段，是指需要显示的确切数据，一般来说是以数字的形式存在，不同于排列字段(栏位)。

设置排列字段(栏位)，一般来说该栏位是以文字形式存在，而不是确切的数字。

并且，在设置了排列字段(栏位)后，会根据该字段生成查询框，以方便使用者查询不同的结果。

预览结果

根据排列字段(栏位)生成的查询框
.排列的栏位
数据集栏位

# 折线、柱状图

传入Freemarker SQL

如果设置了<#if>..</#if>的参数传递，则需要在查询栏位中设置相关的栏位数据，才能使用查询。在后面的查询栏位设置中会指出。

图例设置 图例是指数据标识

数据字段设置

该栏位的数据只能是数字字段(栏位)，字符串的栏位是不能显示出确切的数字的。

由于折线和柱状图的显示是一样的，所以在选择了图形数据栏位后，可以对其设置为是柱状图或者是折线图（默认为柱状图）。

如果需要数据需要分y轴显示数值，可以设置是不是开启双y轴。

显示效果如下：

堆叠，是用于多个不同数据叠加在一起，可以自定义要堆叠在一起的数据。

显示效果如下：

xy轴转换，就是简单的把x轴转换为y轴，y轴则转换成x轴。

上面的图形转换效果如下：

x轴栏位设置 X轴其实就是图形中的X轴坐标的指示。

查询栏位设置 该处的设置，和传入的freemarker SQL中的参数相关联。即，SQL中有相关的参数，查询栏位才能生效。

不过，当前版本中的参数是使用下拉框，即查询栏位的数据集。

显示效果：

# 饼图

饼图的数据结构比较简单，一行或者一列数据即对应一个环状，所以建议数据结构不太多。

传入Freemarker SQL

数据字段设置 数据字段中的数据只能是数字形式。数据的显示有两种方式，

一种是一行数据对应一个环状， 由于行数据的每一个栏位就是一个图例，所以在没有图例字段的设置。

另一种是以列数据对应一个环状，

列数据显示方式，需要设置图例字段，这样才能知道列数据中的每行数据是什么意思。

查询栏位设置，同折线柱状图设置。

# 仪表图

由于仪表图是实时数据，所以只有一个数值字段

然后在数据字段设置中选择好列头即可。

# 漏斗图

漏斗图和饼图一样，一行或者一列数据对应一个漏斗图形，所以建议数据结构不要太多。

传入Freemarker SQL 数据字段设置 数据字段中的数据也依然只能是数字形式。数据的显示也同饼图一样，有两种显示方式，该说明同饼图一样。

查询栏位设置，同折线柱状图设置。

# 雷达图

传入Freemarker SQL 数据字段设置 数据字段中的数据也只能是数字形式。

默认以每列数据作为一个雷达标线。当然也可以设置为行数据作为雷达标线。

在雷达图中，列数据作为标线，是需要设置它的图例字段，不设置图例的话，是不会显示出雷达图的。而行数据作为标线的话，则可以不设置它的图例字段，但是不设置的话，则不会显示他它的图例。

查询栏位设置，同折线柱状图设置。

# 热力图

热力图，是在轴坐标中以高亮的方式显示数据。

传入Freemarker SQL 数据字段设置 数据字段中的数据只能是数字形式。

其中可以设置最大、最小热力值，即整个数据结构中的数值热力范围值只包含在最大和最小值中，大于最大值的或者小于最小值的数字，将以最大热力值或者最小热力值显示出来。

图例字段设置 图例字段，其实就是坐标轴中的X轴坐标的指示字段。

设置方式同折线柱状图。

查询栏位设置，同折线柱状图设置。

# 字符云图

字符云图，即是根据数字的大小来展现它所对应名称。

传入Freemarker SQL 数据字段设置 数据字段中的数据，只能是数字形式。

因为云图中的字符只能带入一个自己的数值，所以在多行或者多列的情况下，多行或者多列的数字将会合计起来(SUM)。

如上图，即每行的数值会相加起来合成一个新的统计值。

字符角度范围设置，即是每个字符和x轴的夹角只能在设置的范围内。一般会结合字符夹角间隔来设置。

设置了字符夹角间隔，即当前字符与下一个字符的夹角数值。

字符间距，则是两两字符之间的空白值。

字符越界显示，设置不显示，则如果数据集中的字符过多，超过了图形显示范围后，过多的部分不会显示出来。但是设置了显示，则过多的部分则会显示出来，并且会叠加在当前的其他字符上。

文字字段设置 文字字段，一般来说即是非数值栏位。即是字符云图的显示字符。

查询栏位设置，同折线柱状图设置。

# 关于下钻

图形报表开启了下钻功能，其作用在于点击当前图形的某一部分，即可触发其钻取下一级图形。

当前版本，除了在表格报表中无法实现下钻外，其他的图形均可配置下钻功能。

下钻方式 下钻的方式分两种，

一种是开窗，顾名思义，即在窗口中打开下钻的图形。这种方式，在理论上是可以实现无限极下钻，即各个下级窗口不断的开窗。

另一种是原图，这种方式即是在原本的图形中刷新数据，生成下钻图形。这种方式只支持一级钻取，即下级的图形也配置了下钻，是不可以继续钻取的。

开窗下钻 其配置了两种获取数据方式，一为图形报表，另一种是自定义列表(即：“单据开发”中的“列表视图设计”)。

点击两个按钮，即会打开相应的列表以供选择。

原图下钻 其只配置一种获取数据的方式，即图形报表。因为原图的刷新只适合echarts的图形。另外因为表格图形报表也不属于echarts图形，所以在原图下钻中也不支持。

列头配置

列头配置是用于下钻的参数设置，参数值取决于图形中点击部位的数据，因为条件不同，有可能触发的下钻图形会没有数据。所以参数的设置，需要和图形匹配。

而钻取的图形需要接收参数，则需要把传入的Freemarker SQL配置为接收参数的形式。

示例：

点击阴影区域的黄色部分，当前的柱状数据是“违建拆除宗数：243”，但是实际传入下钻图形的参数，是x轴上的坐标参数“[从化, 2018Q1]”，而根据下钻的列头配置，

两个栏位对应到坐标参数中的两个值，即SQ - 从化，TJZQ - 2018Q1，这样匹配出来的参数即为SQ=从化&TJZQ=2018Q1，钻取的图形或者列表的参数值，即可根据它来接收。

具体的下钻参数传递会因不同类型的图形而不同，具体请自行尝试。