FastReport:使用 http 和 https 协议将对象上传到FastReport VCL

报告生成器的关键任务之一是数据检索。大多数情况下，数据库用于存储和检索数据。但是如果是远程云存储，用于存储某些数据呢？如何通过 http 将公司徽标上传到报告以确保它始终是最新的？

为了解决这些问题，我们在 FastReport VCL 2021.3 中增加了对协议的支持以及通过协议将数据加载到对象中的功能，例如：地图、图片、文本、PDF 对象、HTML 对象。某些对象具有新的DataLink属性，其中包括用于处理链接的附加属性。此类链接始终以架构名称开头，后跟分隔符。示例 <schema>: [//path]。在大多数情况下，方案是http和https等协议。

通过 FastReport VCL 中的链接加载数据

FastReport VCL 基于模块化架构，http 和 https 的功能也不例外，它与 Internet 传输一起包含在一个单独的包中。因此，对于通过 http 和 https 协议工作的链接，您需要连接应用程序使用部分中的 frxTransportHTTP 模块，或者将 Internet 传输之一添加到应用程序表单。

 

 

 

重要！https 协议需要以下 Open SSL 库才能工作：ssleay32.dll 和 libeay32.dll。您可以在主演示应用程序所在的目录中找到它们。

让我们启动报表设计器并创建一个新报表。然后在报表页面上添加“报表标题”栏，并为其添加一个图片对象。报告应如下所示：

 

 

 

让我们选择“图片”对象并转到对象检查器。在对象检查器中找到 DataLink 属性。为了快速搜索，您可以通过输入所需属性的名称来使用对象检查器中内置的过滤器。

 

 

 

让我们看看 DataLink 子属性的含义：

Link– 带有模式（协议）的链接，格式为 <schema>: [//path]。数据将从指定的链接加载。

LoadingType – 加载类型。它指示何时加载数据。它可以具有以下值：

[] - 空的。当用户点击加载编辑器时，数据以模板编辑模式加载。如果您只需要检索一次数据并将其存储在模板中，则使用它。

 

 

 

[dltOnGetData] – 默认情况下。数据在构建报告时加载到对象中。在这种情况下，对象数据不会保存在模板中。每次生成报告时，对象都会通过链接接收新数据。

[dltOnPreview] – 在报告预览、导出或打印期间加载数据。在这种情况下，生成的报告存储数据的链接，并在用户每次加载生成的报告时加载它。它可用于在生成的报告中获取最新数据，而无需重建它。

[dltOnGetData, dltOnPreview] – 混合模式。构建报告时，对象通过链接接收数据并将其保存在生成的报告中。数据的链接也被保存。使用此对象加载生成的报表时，该对象会尝试以与[dltOnPreview] 相同的方式加载数据，但如果数据加载不成功，则会显示报表生成过程中获取的数据。

ProcessingType – 确定在报告生成期间如何处理链接的值： dpString – 作为常规字符串， dpExpression – 作为报告脚本的表达式。

让我们设置DataLink。 例如，“图片”对象的链接属性带有从网站链接到图片的链接。 让我们执行报告。  

 

 

 

同样，您可以加载其他对象，例如：Text、Picture、Maps、HTMLView、PDFView。

这些链接可用于访问 Web API 以获取数据，例如 OSM 地图。

让我们创建一个带有“Report Title”带和一个空层的 Map 对象的新报告（您可以在我们的文档中了解如何创建 Map 对象）。

 

 

 

现在让我们选择地图图层 MapFileLayer1 并转到对象检查器中的 DataLink.Link 属性。您可以使用 OpenStreetMap API 加载 OSM 地图。让我们尝试在 FastReport VCL 中显示选定的区域。将其插入到 DataLink.Link 属性中。让我们生成报告。

 

 

 

来自服务器的数据已自动加载到地图对象中。

 

不仅仅是超链接

在 FastReport VCL 中，DataLink 属性的所有模式和协议都是通过工厂处理的。这允许开发人员通过添加新的方案和协议来扩展应用程序的功能，而无需对 FastReport VCL 源代码进行任何更改。此外，FastReport VCL 在工厂中自动将互联网传输注册为新协议。这允许访问私有云存储并将数据从它们加载到报告中，而无需在报告中传输或存储任何授权数据。您可以在下面看到 DataLink 属性与协议工厂的交互方案。

 

 

 

如何添加互联网传输并使用指向私人 Google Drive 的链接？

这可以通过几个步骤完成：

1. 使用 Internet 传输打开组件选项板。

• 将 TfrxGoogleDriveIOTransport 添加到申请表中。
• 为组件指定一个名称。该名称将用作访问链接的模式协议。在示例中，我们将其命名为“GDRIVE”。

 

 

 

• 通过“编辑连接”菜单编辑与 Google Drive 的连接（有关详细信息，请参阅另一篇文章）。

 

 

 

• 运行报表设计器并按照本文开头创建带有图片的报表时的步骤创建报表。
• 您需要在 DataLink.Link 属性中指定 Google Dive 中文件的链接，但不是方案（协议）指定传输的名称。在我们的例子中，它是“GDRIVE”。该链接将如下所示：GDRIVE://LogoF.PNG。然后就可以执行报告了。

 

 

 

重要！如果未加载数据，请确保您已正确连接到云存储并在连接时保存了授权令牌。

同样，您可以连接到其他 Internet 传输。这是 FastReport VCL 2021.3 中引入的少数强大工具之一，您可以使用它来改进您的项目。