![在 HTML 頁面中顯示 XML 數據](images/display-xml-data-in-html.png#center)
XML 是一種受 W3C 支持的自描述語言,專為高效數據存儲和無縫數據交換而構建。對於 Python 應用程序開發人員來說,XML 格式的適應性可以輕鬆轉換為用戶友好、人類可讀的格式,例如 HTML。本文將指導您完成利用適用於 Python 的 GroupDocs.Assembly Cloud SDK 和簡單模板將 XML 數據轉換為綜合 HTML 報告的過程。
先決條件:
在開始之前,請確保您已具備以下條件:
- Python 安裝在您的系統上。
- 安裝了適用於 Python 的 GroupDocs.Assembly Cloud SDK。
- 具有有效 API 憑據的活動 GroupDocs.Assembly 雲帳戶。
- 用於測試的示例數據和模板(我們將使用以下示例 XML 數據和報告模板)。
XML 數據示例
使用以下 XML 數據。
<Managers>
<Manager>
<Name>John Smith</Name>
<Contract>
<Client>
<Name>A Company</Name>
</Client>
<Price>1200000</Price>
</Contract>
<Contract>
...
</Contract>
...
</Manager>
<Manager>
<Name>Tony Anderson</Name>
...
</Manager>
...
</Managers>
示例模板
生成 TXT、DOCX 或必要格式的指定模板,以迭代經理的數據以及相應的客戶和相關信息。隨後,繼續執行代碼以生成報告。
<<foreach \[in managers\]>>Manager: <<\[Name\]>>
Contracts:
<<foreach \[in Contract\]>>- <<\[Client.Name\]>> ($<<\[Price\]>>)
<</foreach>>
<</foreach>>
需要涵蓋的要點:
配置 Python HTML 報告生成器 SDK
要啟動此過程,請使用 pip(Python 的軟件包安裝程序)將適用於 Python 的 GroupDocs.Assembly Cloud SDK 合併到您的 Python 項目中。在控制台執行後續命令:
pip install groupdocs-assembly-cloud
啟動 API 客戶端
接下來,從 儀表板 檢索您的 客戶端 ID 和 客戶端密鑰,並合併提供的代碼,如下所示:
import groupdocsassemblycloud as assembly | |
# Get app_sid & app_key from https://dashboard.groupdocs.cloud after free registration. | |
app_sid = "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" | |
app_key = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" | |
# Get File API configurations. | |
configuration = assembly.Configuration(app_sid, app_key) | |
configuration.api_base_url = "https://api.groupdocs.cloud" | |
storage_name = "LocalStorage" |
上傳數據源和模板文件
首先,使用下面給出的代碼示例將數據源和模板文件上傳到雲端:
# Create an instance of the file API | |
file_api = groupdocsassemblycloud.FileApi.from_config(configuration) | |
# Call upload file request | |
request = groupdocsassemblycloud.UploadFileRequest("python-testing\input-sample-file.xml", "H:\\groupdocs-cloud-data\\input-sample-file.xml", "storage_name") | |
# Upload file to the cloud | |
response = file_api.upload_file(request) | |
print(response.uploaded) |
因此,上傳的文件將在雲上儀表板的文件部分中可用。
使用 Python 在 HTML 頁面上顯示 XML 數據
要在 HTML 頁面中呈現 XML 數據,請遵循以下步驟:
- 使用 client_id 和 client_secret 創建 AssemblyApi 的實例。
- 設置模板信息,包括文件路徑、存儲名稱、版本 ID 和密碼。
- 使用 AssembleOptions 準備彙編請求以及報告數據、模板信息、輸出路徑和保存格式。
- 使用 AssemblyApi.assemble_document(AssembleOptions) 方法生成 HTML 報告。
提供的代碼示例舉例說明了用於 HTML 報告生成器 REST API 的 Python SDK 的實現,從而能夠在 HTML 頁面上呈現 XML 數據。
import groupdocsassemblycloud as assembly | |
client_id = "XXXX-XXXX-XXXX-XXXX" | |
client_secret = "XXXXXXXXXXXXXXXX" | |
assemblyAPI = assembly.AssemblyApi(client_id,client_secret ) | |
# Set up template info | |
templateInfo = assembly.TemplateFileInfo() | |
templateInfo.file_path= 'Python_Testing/template.txt' | |
templateInfo.storage_name= 'LocalStorage' | |
templateInfo.version_id= '' | |
templateInfo.password='abc123' | |
# Prepare assemble request | |
options=assembly.AssembleOptions() | |
options.report_data = 'Python_Testing/report-data.xml'; | |
options.template_file_info = templateInfo | |
options.output_path = 'Python_Testing/report.html'; | |
options.save_format = 'html' | |
# Generate HTML report | |
assemblyAPI.assemble_document(options) |
下載 HTML 文件
上一步中給出的代碼將轉換後的 HTML 文件保存在雲端。要下載它,您可以使用以下代碼片段。
# Create instance of the API | |
file_api = groupdocsassemblycloud.FileApi.from_config(configuration) | |
request = groupdocs_conversion_cloud.DownloadFileRequest('Python_Testing/report.html', my_storage) | |
response = file_api.download_file(request) | |
# Move downloaded file to your working directory | |
shutil.move(response, "C:\\Files\\") |
結論
在本文中,我們介紹了通過結合使用 GroupDocs.Assembly Cloud REST API 及其 Python SDK 在 HTML 頁面上呈現 XML 數據所涉及的步驟。這個強大的 API 使開發人員能夠無縫地製作跨不同格式的動態報告,利用來自 XML 或 XML 源的信息,並融合跨越 Word 文檔、電子表格和文本文件的模板。
此外,為了更全面地掌握 GroupDocs.Assembly Cloud API,請深入研究詳細的文檔。此外,還可以利用我們的 API 參考 區域,該區域使您能夠直接從瀏覽器中參與並觀察我們的 API 的運行情況。您還可以在Github上免費訪問Python SDK的完整源代碼。
最後,我們不斷地撰寫新的博客文章,探索一系列文件格式及其利用 REST API 的解析。請聯繫我們獲取最新信息。
問一個問題
如果您對 HTML 報告生成器 有任何疑問或困惑,請隨時通過我們的 論壇 與我們聯繫。
也可以看看
以下是一些可能對您有幫助的相關文章: