数据集

此功能用于定义报表中所用到的数据集信息。数据集是报表的数据来源，目前支持SQL类型和URL类型数据集。

• 菜单路径： 报表平台 > 数据集

数据集列表

列表字段：

• 数据集代码：数据集唯一标识。
• 数据集名称：数据集的名称。
• 类型：定义数据集时的数据来源类型。有标准SQL、脚本SQL和URL三种类型。
• 备注：数据集的备注信息。
• 状态：启用和禁用两种状态。单位禁用时不能使用该数据集。
• 操作：可编辑和删除数据集信息，查看报表可查看使用了该数据集的报表。

查询数据集

查询字段：

• 数据集代码：数据集唯一标识。支持模糊查询。
• 数据集名称：数据集的名称。支持模糊查询。
• 数据源：LOV选择定义数据集中具体使用的数据源。

点击按钮可根据查询字段筛选出对应信息。

新建数据集

点击按钮，进入新建界面。

必输字段：

• 数据集代码：数据集唯一标识。
• 数据集名称：数据集的名称。
• 数据源：选择数据集所使用的数据源（数据源管理功能中数据源用途为数据报表的数据）。
• 启用：启用禁用两种状态。当设置为禁用时不可使用该数据集。默认为启用。
• 类型：数据集的数据来源类型。目前支持标准SQL、脚本SQL和URL三种类型。
• SQL语句或URL：具体查询的SQL语句或者URL。

标准sql

标准sql适用于简单的数据查询，例如单表查询等。sql语句的编写为通用sql写法，sql的参数使用${}做为占位符，支持条件判断，使用Velocity语法实现。

SELECT 
    template_code,
    template_name,
    template_title,
    template_content 
FROM hmsg_message_template 
WHERE template_code like '%${templateCode}%' 
#if(${templateName} != '') AND template_name = '${templateName}' #end

脚本sql

脚本sql适用于较复杂的数据查询，例如头行结构查询。脚本sql使用报表平台自定义的语法结构，sql的参数也使用${}做为占位符。
语法提供了select``column``from``where四种标签。select标签需要指定name属性，且不可重复

<select name="head">
	<column>
		hts.temp_server_id,
		hts.tenant_id,
		hts.message_code,
		hts.message_name,
		hts.enabled_flag
	</column>
	<from>
		hmsg_template_server hts
	</from>
	<where>
		hts.message_code like '${messageCode}'
	</where>
	<select name="line">
		<column>
			htsl.temp_server_line_id,
			htsl.temp_server_id,
			htsl.type_code,
			htsl.template_code,
			htsl.server_id,
			htsl.remark
		</column>
		<from>
			hmsg_template_server_line htsl
		</from>
		<where>
			htsl.temp_server_id = {{TEMP_SERVER_ID}}
		</where>
	</select>
</select>

为了简化sql，子查询可以直接使用上一级sql查询出的结果，使用{{}}作为占位符，字段名为数据库字段的大写

URL

URL用于定义一个接口的URL，使用时通过该API来获取数据，仅支持GET请求

URL格式：地址支持内部地址和外部地址，请求都会携带当前请求的access_token

• 内部地址
  例：http://hzero-scheduler/v1/executors
  内部接口不会鉴权，需要注意，可以获取用户信息

• 外部地址
  例: http://hzerodevb.saas.hand-china.com/hsdr/v1/executors
  非本系统的外部地址，建议使用接口平台配置，然后开放接口供报表服务内部调用

表格报表使用url数据集时，url的返回的数据结构必须是Page<?>
模板报表和表格报表可以返回分页对象或普通对象

非必输字段：

• 备注：数据集的备注信息。

SQL校验

点击按钮可预览SQL。 若弹出预览框，表示SQL校验通过，否则表示SQL校验不成功，报表无法打印。

xml示例

1.点击按钮进入XML示例界面。

2.点击获取xml按钮可生成xml格式的数据。

3.点击导出文件按钮可导出生成的xml文件。

初始化元数据

元数据指的是SQL或者URL查出来的字段。

点击按钮可初始化SQL类型数据集的元数据，

如果数据集类型为URL类型，则需要手动维护元数据，点击数据集行右侧的新建按钮，弹出新建界面。

必输字段：

• 序号：排序号
• 列名：数据列名称
• 标题：数据列的标题
• 数据类型：数据列的类型，如VARCHAR、BIGINT等
• 精度：数据的精度，默认0

初始化参数

参数指的是SQL中作为查询条件的参数或者URL接收的参数。

点击按钮可初始化SQL类型数据集的参数，

如果数据集类型为URL类型，则需要手动维护参数，点击数据集行右侧的新建按钮，弹出新建界面。

必输字段：

• 序号：排序号

• 数据类型：下拉列表选择字符串、浮点数、整数、日期

• 参数名：参数的名称，对应接口接收的参数名

• 标题：参数的显示描述

• 来源类型：下拉列表选择SQL语句、文本字符串或者无内容

  • SQL语句
    本类型的表单控件只能使用下拉选,会将sql执行结果集中的value,meaning作为选项 (数据集类型为URL时不可用)

  • 文本字符串
    本类型的表单控件只能使用下拉选,使用会将字符串的拆分结果作为下拉选的选项

    字符串格式: value,meaning|value,meaning

  • 无内容
    使用时参数没有选项

• 表单控件：选择对应表单的控件，如下拉单选、复选、日期等

• 来源值：当来源类型为文本字符串时输入字符串，类型为SQL语句时输入sql，或表单控件为值列表时输入值集视图编码

• 数据长度：输入框的宽度

• 数据高度：输入框的高度

非必输字段：

• 默认值：数据的默认值
• 默认值显示：默认显示的值

修改数据集

1.在数据集列表操作列中点击编辑按钮。

2.修改字段后点击按钮完成修改。必输性同新增数据集。

删除数据集

在数据集列表操作列中点击删除按钮。