Stimulsoft Reports用户手册：如何进行数据连接

---

Stimulsoft Reports.Net是一个基于.NET框架的报表生成器，能够帮助你创建结构、功能丰富的报表。StimulReport.Net 的报表设计器不仅界面友好，而且使用便捷，能够让你轻松创建所有报表；该报表设计器在报表设计过程中以及报表运行的过程中都可以使用。在运行时使用StimulReport.Net 的报表设计器不需要支付任何的专利费用。

所创建的报表既可以在Windows窗体应用程序中使用，也可以在Asp.Net应用程序中使用。可导出多种数据格式,比如：PDF，XML，HTML，Word，Excel，RTF格式，文本文件，CSV，BMP和JPEG格式，GIF，PNG，TIFF格式等。

立即点击下载Stimulsoft Reports.Net v2020.5.1最新版

数据连接在报表数据字典中执行，包括以下步骤：创建连接和创建数据源。根据数据源的类型，创建过程可能会有所不同。

本章将介绍以下内容：

•  创建SQL数据源;
•  创建OData数据源;
•  从文件检索数据;
•  创建数据源时，将数据文件移动到报表资源中；
•  嵌入数据文件并基于该文件创建数据源。

信息

设计报告时，可以将所有创建的数据源嵌入到报告文件中。每种类型的连接都将转换为单独的XML文件，并作为资源嵌入到报表文件中。在这种情况下，将在此资源上重新定义数据源的连接。但是，在这种情况下，您应该知道：

 报告文件的大小可能会大大增加；

• 这是不可逆转的动作。因此，在执行此步骤之前，您应该备份报告文件或使用Stimulsoft Cloud存储报告
• 要将所有数据嵌入报表文件中，请从数据字典的“操作”菜单中选择“将所有数据嵌入资源”命令。

创建SQL数据源

步骤1 ：运行报表设计器；
步骤2 ：转到数据字典;
步骤3 ：点击“新建项目”按钮，然后选择“新建数据源”命令；

步骤4 ：选择数据源的类型。在当前示例中，我们选择了MySQL。

步骤5 ：报告引擎将在以下路径中检查安装的适配器：c：\ Users \％username％\ AppData \ Local \ Stimulsoft \ DataAdapters \ 。如果没有当前适配器，将提供其下载。

步骤6 ：点击Download（下载）按钮，报告生成器将下载并安装必要的适配器；

步骤7 ：成功安装数据适配器后，将打开一个用于创建与数据存储的连接的窗口。

步骤8 ：单击“测试”按钮以测试连接。在测试过程结束时，将显示一条消息。如果连接成功，请在“新建连接”窗口中单击“确定” 。

步骤9 ：之后，将显示“选择数据”对话框。在此窗口中，您应该选择将成为报告字典中数据源的数据表。

步骤10 ：在Select Data（选择数据）窗口中单击OK（确定）。

现在，基于这些数据源，您可以设计报告或仪表板。另外，您可以编辑创建的源。例如，您可以更改请求。

步骤1 ：在报告字典中选择数据源；

第2步：单击数据字典工具栏上的“编辑”按钮；

步骤3 ：在“编辑数据源”对话框中指定数据选择请求。例如，从产品中选择*；

步骤4 ：点击“运行”按钮运行请求；

步骤5 ：点击Retrieve Columns按钮，根据要求从存储中检索所有列；

步骤6 ：在数据源编辑窗口中单击“确定”。

创建一个OData数据源

步骤1 ：运行报表设计器；

步骤2 ：转到数据字典;

步骤3 ：点击“新建项目”按钮，然后选择“新建数据源”命令；

步骤4 ：选择数据源的类型。在当前示例中，OData ;

步骤5 ：报告引擎将在以下路径中检查是否存在已安装的适配器：c：\ Users \％username％\ AppData \ Local \ Stimulsoft \ DataAdapters \ 。如果没有当前适配器，将提供其下载。

步骤6 ：点击Download（下载）按钮，报告引擎将下载并安装必要的适配器；

步骤7 ：成功安装数据适配器后，将打开一个用于创建与数据存储的连接的窗口。对于OData数据存储，应指定数据路径。

步骤8 ：单击“测试”按钮以测试连接。在测试连接过程结束时，将显示一条消息。如果连接成功，则在“新建连接”窗口中单击“确定” 。

步骤9 ：之后，将显示“选择数据”窗口。在此窗口中，您应该选择将成为报告字典中数据源的数据表。

步骤10 ：选择数据表后，在“选择数据”窗口中单击“确定”按钮。

现在，基于这些表，您可以创建报告和仪表板。另外，您可以编辑创建的数据源。例如，您可以创建一个数据采样请求。去做这个：

步骤1 ：在报告字典中选择数据源；

第2步：单击数据字典工具栏上的“编辑”按钮；

步骤3 ：在“编辑数据源”窗口中指定数据过滤请求。例如，Products？$ filter = ProductID文件10，然后在当前窗口中单击“确定”。

现在，当使用当前数据源呈现报表时，将仅从存储中获取经过过滤的数据。

创建文件数据源

设计报告时，可以从CSV，Excel，JSON，XML和DBF文件中获取数据。数据文件的主要优点是可以将它们嵌入报表模板中。但是，报告文件的大小将随数据文件的大小而增加。

信息

报表设计器支持拖动数据文件。将数据文件拖到字典中时，有两个添加该文件的选项：

•  New Data Source ，将为此文件创建一个连接，并从中获取数据表，但是该文件不会嵌入到报表中。
•  在新资源中，数据文件将作为资源嵌入到报表中。基于此资源，您可以创建一个数据源。

当您将数据文件拖到报表设计器的任何其他区域时，它将作为资源添加到报表中。

考虑连接到外部数据文件，该文件未嵌入报表模板中。
步骤1 ：运行报表设计器；
步骤2 ：转到数据字典;
步骤3 ：点击“新建项目”按钮，然后选择“新建数据源”命令；

步骤4 ：选择数据源的类型。例如，JSON；

步骤5 ：在“新建JSON数据”窗口中，使用“浏览”按钮选择本地JSON数据文件。另外，您可以指定JSON文件的URL路径。

步骤6 ：在New JSON Data窗口中单击OK ；

步骤7 ：将弹出“选择数据”窗口。您应该在那里选择数据表。每个数据表将在报告数据字典中代表一个单独的数据源。

步骤8 ：在Select Data（选择数据）窗口中单击OK（确定）。

现在，基于这些数据源，您可以创建报告或仪表板。

移至资源

考虑一个拖动数据文件以报告资源的示例。

步骤1 ：运行报表设计器；
步骤2 ：转到数据字典;
步骤3 ：点击“新建项目”按钮，然后选择“新建数据源”命令；

步骤4 ：选择数据源的类型，例如XML；

步骤5 ：在New XML Data（新建XML数据）窗口中，使用Browse（浏览）按钮选择XML和XSD文件。

步骤6 ：点击“移至资源”按钮。

步骤7 ：将关闭“新建XML数据”窗口，并弹出“选择数据”窗口。您应该在此处选择数据表。每个数据表将在报告数据字典中代表一个单独的数据源。

步骤8 ：在Select Data（选择数据）窗口中单击OK（确定）。

现在，基于这些数据源，您可以创建报告或仪表板。

另外，您可以首先将数据文件作为资源添加到报表中，然后基于此资源创建数据源。

步骤1 ：将数据文件拖到报表数据字典的底部。

或者，单击数据字典中的“新建项目”按钮，然后选择“新建资源”命令。 在弹出的“新资源”窗口中，单击“打开”按钮以选择一个数据文件。然后，在“新资源”窗口中单击“确定” 。 步骤2 ：在资料字典中选取资源；

步骤3 ：点击数据字典中的New item按钮，然后选择New Data Source [resource name]命令；

步骤4 ：在“新建Excel连接”窗口中单击“确定” ；

步骤5 ：在“选择数据”窗口中选择数据表。每个数据表将在报告数据字典中代表一个单独的数据源。

步骤6 ：在Select Data（选择数据）窗口中单击OK（确定）。

现在，基于这些数据源，您可以设计报告或仪表板。

---