数据连接
Stimulsoft是白俄罗斯一家报表控件厂商,该商家一直专注于报表控件的研发与创新,是报表控件行业的领导者。Stimulsoft 经过多年的努力,终于实现了更加简单的设计报表,数据驱动更快的应用程序,更加简便的应用新的技术,极大程度上的减少了开发人员的工作量,提高了工作的效率。
数据连接在报表数据字典中进行,包括以下步骤:创建连接和创建数据源。根据数据源的类型,创建过程可能有所不同。
本章将介绍以下内容:
- 创建 SQL 数据源
- 创建 OData 数据源
- 从文件中检索数据
- 创建数据源时将数据文件移动到报告资源
- 嵌入数据文件并基于该文件创建数据
信息
设计报表时,可以在报表文件中嵌入所有已创建的数据源。每种类型的连接都将转换为单独的 XML 文件,并作为资源嵌入到报表文件中。在这种情况下,数据源的连接将在此资源上重新定义。不过,在这种情况下,您应该知道:
- 报告文件的大小会显著增加
- 这是一个不可逆的操作。因此,在执行此步骤之前,应备份报告文件或使用 Stimulsoft 云存储报告。
要将所有数据嵌入报告文件,请从数据字典的 "Actions"菜单中选择 "Embed all data to resources "命令。
创建 SQL 数据源第 1 步:运行报告设计器。
第 2 步:转到数据字典。
第 3 步:单击 "New Item "按钮并选择 "New Data Source "命令。
第 4 步:选择数据源类型。在当前示例中,我们选择了 MySQL。
第 5 步:报告引擎将检查以下路径中是否安装了适配器:c:\Users\% username%\AppData\Local\Stimulsoft\DataAdapters\。如果当前没有适配器,则会提供下载。
第 6 步:点击下载按钮,报告生成器将下载并安装所需的适配器;
第 7 步:成功安装数据适配器后,将打开一个用于创建数据存储连接的窗口。
第 8 步:单击 "Test "按钮测试连接。测试过程结束后,将显示一条信息。如果连接成功,请单击新建连接窗口中的确定。
第 9 步:之后,将显示 "Select Data "对话框。在这个窗口中,你应该选择作为报告字典数据源的数据表。
第 10 步: 单击 "Select Data "窗口中的 "OK "。
现在,您可以根据这些数据源设计报告或仪表盘。此外,您还可以编辑已创建的数据源。
第 1 步:在报告字典中选择数据源。
第 2 步:单击数据字典工具栏上的编辑按钮。
第 3 步:在编辑数据源对话框中指定数据选择请求。例如,从产品中选择 *。
第 4 步:单击运行按钮运行请求。
第 5 步:单击 "Retrieve Columns"按钮,按照要求从存储中检索所有列。
第 6 步:单击数据源编辑窗口中的确定。
创建 OData 数据源
第 1 步:运行报表设计器。
第 2 步:转到数据字典。
第 3 步:单击 "New Item "按钮并选择 "New Data Source "命令;
第 4 步:选择数据源类型。在当前示例中,选择 OData。
第 5 步:报告引擎将检查以下路径中是否存在已安装的适配器:c:\Users\%username%\AppData\Local\Stimulsoft\DataAdapters\. 如果当前没有适配器,则会提供下载。
第 6 步:点击下载按钮,报告引擎将下载并安装所需的适配器;
第 7 步:成功安装数据适配器后,将打开一个创建数据存储连接的窗口。如果是 OData 数据存储,则应指定数据路径。
第 8 步:单击 "Test"按钮测试连接。测试连接过程结束时,将显示一条信息。如果连接成功,请单击新建连接窗口中的确定。
第 9 步:之后,将显示 "Select Data "窗口。在这个窗口中,你应该选择作为报告字典数据源的数据表。
第 10 步: 选择数据表后,单击 "Select Data "窗口中的 "OK "按钮。
现在,您可以根据这些表格创建报告和仪表盘。此外,您还可以编辑已创建的数据源。例如,您可以创建一个数据采样请求。具体操作如下:
第 1 步:在报告字典中选择数据源.
第 2 步: 单击数据字典工具栏上的 " Edit "按钮.
第 3 步:在 "Edit Data Source "窗口中指定数据过滤请求。
现在,当使用当前数据源渲染报告时,只能从存储中获取过滤后的数据。
创建文件数据源
设计报表时,可以从 CSV、Excel、JSON、XML 和 DBF 文件中获取数据。数据文件的主要优点是可以嵌入到报告模板中。不过,报告文件的大小会因数据文件的大小而增加。
信息
报告设计器支持拖动数据文件。将数据文件拖入字典时,有两个选项可用于添加该文件:
- 新数据源,将为该文件创建一个连接,并从中获取数据表,但该文件不会嵌入到报表中。
- 新建资源,数据文件将作为资源嵌入到报告中。基于此资源,您可以创建一个数据源。
当您将数据文件拖到报表设计器的任何其他区域时,它将作为资源添加并嵌入到报表中。
考虑连接到外部数据文件,该文件未嵌入报告模板中。
第 1 步:运行报告设计器。
第 2 步:转到数据字典。
第 3 步:单击 "New Item "按钮并选择 "New Data Source "命令;
第 4 步:选择数据源类型。例如,JSON;
第 5 步:在 "New JSON Data "窗口中,使用 "Browse "按钮选择本地 JSON 数据文件。此外,还可以指定 JSON 文件的 URL 路径。
第 6 步:在 "New JSON Data "窗口中单击 " OK";
第 7 步:弹出 " Select Data "窗口。您应在此选择数据表。每个数据表将在报告数据字典中代表一个单独的数据源。
第 8 步:在 " Select Data "窗口中单击 "OK "。
现在,您可以根据这些数据源创建报告或仪表板。
移动到资源
请看一个将数据文件拖动到报告资源的示例。
第 1 步:运行报告设计器。
第 2 步:转到数据字典。
第 3 步:单击 "New Item "按钮并选择 "New Data Source "命令;
第 4 步:选择数据源类型,例如 XML;
第 5 步:在新建 XML 数据窗口中,使用浏览按钮选择 XML 和 XSD 文件。
第 6 步:单击 "Move to Resource "按钮。
第 7 步:新建 XML 数据窗口将关闭,然后弹出选择数据窗口。您应在此选择数据表。每个数据表将在报告数据字典中代表一个单独的数据源。
第 8 步:在 "Select Data"窗口中单击 "OK "。
现在,您可以根据这些数据源创建报告或仪表盘。
此外,还可以先将数据文件作为资源添加到报告中,然后根据该资源创建数据源。
第 1 步:将数据文件拖到报告数据字典的底部。
或者,单击数据字典中的 "New Item "按钮,然后选择 "New Resource "命令。
在弹出的 "New Resource "窗口中,单击 "Open "按钮选择数据文件。然后,在 "新建资源 "窗口中单击 "OK"。
第 2 步:在数据字典中选择资源。
第 3 步:单击数据字典中的新建项目按钮,选择新建数据源[资源名称]命令。
第 4 步::在 "新建 Excel 连接 "窗口中单击 "OK"。
第 5 步:在 "Select Data "窗口中选择数据表。每个数据表将在报告数据字典中代表一个单独的数据源。
第 6 步:在 "Select Data "窗口中单击 "OK “
现在,您可以根据这些数据源设计报告或仪表盘。