報告生成器的關鍵任務之一是數(shù)據(jù)檢索。大多數(shù)情況下，數(shù)據(jù)庫用于存儲和檢索數(shù)據(jù)。但是如果是遠程云存儲，用于存儲某些數(shù)據(jù)呢？如何通過 http 將公司徽標上傳到報告以確保它始終是最新的？

為了解決這些問題，我們在 FastReport VCL 2021.3 中增加了對協(xié)議的支持以及通過協(xié)議將數(shù)據(jù)加載到對象中的功能，例如：地圖、圖片、文本、PDF 對象、HTML 對象。某些對象具有新的DataLink屬性，其中包括用于處理鏈接的附加屬性。此類鏈接始終以架構(gòu)名稱開頭，后跟分隔符。示例 <schema>: [//path]。在大多數(shù)情況下，方案是http和https等協(xié)議。

通過 FastReport VCL 中的鏈接加載數(shù)據(jù)

FastReport VCL 基于模塊化架構(gòu)，http 和 https 的功能也不例外，它與 Internet 傳輸一起包含在一個單獨的包中。因此，對于通過 http 和 https 協(xié)議工作的鏈接，您需要連接應用程序使用部分中的 frxTransportHTTP 模塊，或者將 Internet 傳輸之一添加到應用程序表單。

重要！https 協(xié)議需要以下 Open SSL 庫才能工作：ssleay32.dll 和 libeay32.dll。您可以在主演示應用程序所在的目錄中找到它們。

讓我們啟動報表設計器并創(chuàng)建一個新報表。然后在報表頁面上添加“報表標題”欄，并為其添加一個圖片對象。報告應如下所示：

讓我們選擇“圖片”對象并轉(zhuǎn)到對象檢查器。在對象檢查器中找到 DataLink 屬性。為了快速搜索，您可以通過輸入所需屬性的名稱來使用對象檢查器中內(nèi)置的過濾器。

讓我們看看 DataLink 子屬性的含義：

Link– 帶有模式（協(xié)議）的鏈接，格式為 <schema>: [//path]。數(shù)據(jù)將從指定的鏈接加載。

LoadingType – 加載類型。它指示何時加載數(shù)據(jù)。它可以具有以下值：

[] - 空的。當用戶點擊加載編輯器時，數(shù)據(jù)以模板編輯模式加載。如果您只需要檢索一次數(shù)據(jù)并將其存儲在模板中，則使用它。

[dltOnGetData] – 默認情況下。數(shù)據(jù)在構(gòu)建報告時加載到對象中。在這種情況下，對象數(shù)據(jù)不會保存在模板中。每次生成報告時，對象都會通過鏈接接收新數(shù)據(jù)。

[dltOnPreview] – 在報告預覽、導出或打印期間加載數(shù)據(jù)。在這種情況下，生成的報告存儲數(shù)據(jù)的鏈接，并在用戶每次加載生成的報告時加載它。它可用于在生成的報告中獲取最新數(shù)據(jù)，而無需重建它。

[dltOnGetData, dltOnPreview] – 混合模式。構(gòu)建報告時，對象通過鏈接接收數(shù)據(jù)并將其保存在生成的報告中。數(shù)據(jù)的鏈接也被保存。使用此對象加載生成的報表時，該對象會嘗試以與[dltOnPreview] 相同的方式加載數(shù)據(jù)，但如果數(shù)據(jù)加載不成功，則會顯示報表生成過程中獲取的數(shù)據(jù)。

ProcessingType – 確定在報告生成期間如何處理鏈接的值： dpString – 作為常規(guī)字符串， dpExpression – 作為報告腳本的表達式。

讓我們設置DataLink。 例如，“圖片”對象的鏈接屬性帶有從網(wǎng)站鏈接到圖片的鏈接。 讓我們執(zhí)行報告。  

同樣，您可以加載其他對象，例如：Text、Picture、Maps、HTMLView、PDFView。

這些鏈接可用于訪問 Web API 以獲取數(shù)據(jù)，例如 OSM 地圖。

讓我們創(chuàng)建一個帶有“Report Title”帶和一個空層的 Map 對象的新報告（您可以在我們的文檔中了解如何創(chuàng)建 Map 對象）。

現(xiàn)在讓我們選擇地圖圖層 MapFileLayer1 并轉(zhuǎn)到對象檢查器中的 DataLink.Link 屬性。您可以使用 OpenStreetMap API 加載 OSM 地圖。讓我們嘗試在 FastReport VCL 中顯示選定的區(qū)域。將其插入到 DataLink.Link 屬性中。讓我們生成報告。

來自服務器的數(shù)據(jù)已自動加載到地圖對象中。

不僅僅是超鏈接

在 FastReport VCL 中，DataLink 屬性的所有模式和協(xié)議都是通過工廠處理的。這允許開發(fā)人員通過添加新的方案和協(xié)議來擴展應用程序的功能，而無需對 FastReport VCL 源代碼進行任何更改。此外，F(xiàn)astReport VCL 在工廠中自動將互聯(lián)網(wǎng)傳輸注冊為新協(xié)議。這允許訪問私有云存儲并將數(shù)據(jù)從它們加載到報告中，而無需在報告中傳輸或存儲任何授權(quán)數(shù)據(jù)。您可以在下面看到 DataLink 屬性與協(xié)議工廠的交互方案。

如何添加互聯(lián)網(wǎng)傳輸并使用指向私人 Google Drive 的鏈接？

這可以通過幾個步驟完成：

1. 使用 Internet 傳輸打開組件選項板。

• 將 TfrxGoogleDriveIOTransport 添加到申請表中。
• 為組件指定一個名稱。該名稱將用作訪問鏈接的模式協(xié)議。在示例中，我們將其命名為“GDRIVE”。

• 通過“編輯連接”菜單編輯與 Google Drive 的連接（有關詳細信息，請參閱另一篇文章）。

• 運行報表設計器并按照本文開頭創(chuàng)建帶有圖片的報表時的步驟創(chuàng)建報表。
• 您需要在 DataLink.Link 屬性中指定 Google Dive 中文件的鏈接，但不是方案（協(xié)議）指定傳輸?shù)拿Q。在我們的例子中，它是“GDRIVE”。該鏈接將如下所示：GDRIVE://LogoF.PNG。然后就可以執(zhí)行報告了。

重要！如果未加載數(shù)據(jù)，請確保您已正確連接到云存儲并在連接時保存了授權(quán)令牌。

同樣，您可以連接到其他 Internet 傳輸。這是 FastReport VCL 2021.3 中引入的少數(shù)強大工具之一，您可以使用它來改進您的項目。