# 报表开发

## 报表参数

报表参数能够使报表控件与 SQL 数据集进行联动。用户在设计报表时，可以使用包含报表参数的 SQL 数据集，并创建报表控件和报表参数的联动关系。用户在使用报表时，则可以通过报表控件修改关联的参数值，筛选数据数集中数据。

### 报表参数管理页面

报表参数管理页面以列表的形式展示已有的报表参数信息，并提供参数的新建、查询、修改、删除和更改权限设置的功能。

![image](../images_v2.0/report/reportparammanagement.jpg)

### 报表参数编辑页面

在新建或编辑报表参数时，要依次对报表参数的基本信息、可选值、默认值进行设置。只要完成全部设置，才能进行保存操作。

![image](../images_v2.0/report/paramcreation.jpg)

#### 基本信息

中文名称: 只能由中英文数字及下划线组成，且不能以数字开头。

描述: 对参数的描述。

参数类型：

1. 单值
2. 多值

数据类型：

1. 字符串
2. 整型
3. 日期
4. 时间
5. 日期时间

#### 可选值

参数的可选值有两种设置方式，手工输入和动态 SQL。

1. 手工输入
   用户可通过新增行按钮添加一个新的可选值。在可选值列表上修改可选值的现实值和真实值，同时可以对可选值进行删除或排序操作。

2. 动态 SQL
   用户通过输入 SQL 语句来动态地获取可选值，在 SQL 语句试运行后，需要关联真实值和显示值的对应列。用户可以将数据库表、字段、参数和系统函直接拖入 SQL 编辑器中。

#### 默认值

参数的默认值有两种设置方式，手工输入和动态 SQL。

1. 手工输入
   用户可通过新增行按钮添加一个新的默认值。默认值的总数不能超过可选值的总数。在默认值列表上选择可选值做为默认值，同时可以对默认值进行删除或排序操作。

2. 动态 SQL
   用户通过输入 SQL 来动态地获取默认值，在 SQL 语句试运行后，需要关联真实值和显示值的对应列。用户可以将数据库表、字段、参数和系统函直接拖入 SQL 编辑器中。

## SQL 数据集

通过输入 SQL 语句，对数据库表中的数据进行关联、筛选、格式化等操作。在设计报表时，可使用数据集作为报表的数据来源。

### SQL 数据集管理页面

SQL 数据集管理页面以列表的形式展示已有的 SQL 数据集信息，并提供 SQL 数据集的新建、查询、修改、删除和更改权限设置的功能。

![image](../images_v2.0/report/sqldataset.jpg)

### SQL 数据集编辑页面

![image](../images_v2.0/report/datasetedit.jpg)

SQL 数据集编辑页面由可选资源、SQL 文本、运行结果、输出字段、所需参数五个区域组成。

1. 可选资源
   包含表、字段、参数、系统函数等资源，资源节点可以直接拖入 SQL 文本中。
2. SQL 文本
   在 SQL 文本区可以输入 SQL 语句及其对象。编写 SQL 语句时，可拖入可选资源区的“表”、“字段”、“参数”、“系统函数”等对象。
3. 运行结果
   点击试运行按钮，系统会展示 SQL 语句的运行结果。
4. 输出字段
   根据 SQL 语句的运行结果，系统会自动列出数据集的输出字段。
5. 所需参数
   系统会自动分析 SQL 语句，列出数据集的所需参数。

## 报表管理

通过报表设计器，绑定报表单元格和数据源中字段，实现复杂的业务报表。

### 报表管理页面

报表管理页面以列表的形式展示已有的报表信息，并提供报表的新建、查询、修改、删除和更改权限设置的功能。在新建报表时，可以使用 EXCEL 导入功能导入 xlsx 文件。

![image](../images_v2.0/report/reportmanagement.jpg)

### 报表编辑页面

![image](../images_v2.0/report/report-editor.jpg)

#### 数据源面板

数据源面板包含数据集、数据库表、SQL数据集、标准指标、个人指标、维度、事实七种类型。通过将字段拖入单元格，将单元格和字段进行绑定。也可以通过拖动字段的父级节点一次性绑定多个字段。拖入的字段会根据父格规则形成表头。选中字段绑定单元格时，同表头的单元格会高亮显示。

#### 单元格设置

1. 数据设置
   绑定了数据源字段的单元格会启用数据设置选项。数据设置可选择分组列表、汇总三种模式。
   - 分组
     内容相同的行或列为一组，子格拓展时会合并单元格来显示。
   - 列表
     内容相同的行或列为不会被合并，直接以列表的方式显示。
   - 汇总
     扩展出来的内容进行聚合函数计算，并启用聚合函数选项。
   
2. 聚合函数
   可选择的聚合函数有：求和、平均、最大、最小、计数。
   其中求和、平均、最大、最小只支持数值类型的数据列字段。

3. 父格设置
   单元格同时可以设置上、左两个父格。关闭父格设置后，单元的拓展行为将不受父格影响。
4. 拓展方向
   数据设置不为汇总的单元格会启拓展方向选项，拓展方向可选择向下、向右两种选项。

   - 向下
     表示从绑定字段单元格起始，从上往下扩展内容，此时绑定的字段左侧会以向下的箭头标识。
   - 向右
     表示从绑定字段单元格起始，从左往右扩展内容，此时绑定的字段左侧会以向右的箭头标识。

5. 拓展方式
   单元格在进行拓展时，存在插入、覆盖两种模式。

   - 插入
     表示从绑定字段单元格为起始，每扩展出一行或一列数据，就新插入一行或一列用于填充这些数据展现。

   - 覆盖
     表示从绑定字段单元格起始，每扩展出一行或一列数据，就直接在接下来
     的行或列中填充这些数据展现。

#### 回写设置

1. 填报属性
   填报属性用于设置单元格是否允许在报表前端修改数据或插入单元格，并设置输入校验规则。数据类型“数字、日期、文本”。
2. 回写规则
   填报列表列出当前 sheet 页的所有单元格的填报属性。
3. 填报规则
   我们通过回写规则设置电子表格和回写表的关联关系，实现电子表格的数据写入到回写表中。

#### 权限设置

1. 权限设置
   用于设置用户和角色对单元格的查看和填报权限。
2. 权限列表
   填报列表列出当前 sheet 页的所有单元格的权限属性。

#### 控件设置

报表中添加报表控件并定位到单元格上。报表控件的种类有：按钮、下拉列表、时间选择器、输入框、多选框、复选框。其中按钮可以绑定触发宏（触发刷新、填报等行为），下拉列表、时间选择器、输入框、多选框、复选框可以绑定报表参数。

#### 单元格样式设置

在设计报表时，可以对单元格进行样式设置。可使用的样式属性包括：字体、字号、颜色、背景、边框等。

### 单元公式功能
在设计报表时，选中单元格再点击 “∑求和” 按钮，即可在单元格上开启公式计算功能。设置的公式参数区如包含绑定字段的单元格，会根据字段的拓展方式调整参数区范围。

### 动态文本
在设计报表时，选中一个单元格，点击鼠标右键，选择设置动态文本。在文本模版，可使用 ```{参数名}```的形式创建一个参数。参数可以使用报表名称、用户名称，和动态时间作为自己的值。

### 高级设置
双击单元格打开高级设置面板。在高级设置中，可以设置数据的过滤和排序规则。开启自动表头后，报表渲染时会自动生成表头单元格。

#### 报表预览

点击预览按钮，可以对当前报表设计进行预览。启用表头的情况，可以通过表头对数据进行过滤和排序。

![image](../images_v2.0/report/report-preview.jpg)