Generujte HTML sestavu z XML dat v Pythonu pomocí Rest API

XML představuje samodeskriptivní jazyk podporovaný W3C, určený pro efektivní ukládání dat a bezproblémovou výměnu dat. Vývojářům aplikací Python umožňuje adaptabilita formátu XML snadnou transformaci do uživatelsky přívětivých, člověkem čitelných formátů, jako je HTML. Tento článek vás provede procesem využití sady GroupDocs.Assembly Cloud SDK pro Python a jednoduchých šablon k převodu dat XML do komplexních zpráv HTML.

Předpoklady:

Než začnete, ujistěte se, že máte na svém místě následující:

Python nainstalovaný ve vašem systému.
Nainstalovaná sada GroupDocs.Assembly Cloud SDK pro Python.
Aktivní účet GroupDocs.Assembly Cloud s platnými přihlašovacími údaji API.
Vzorová data a šablony pro testování (použijeme následující vzorová XML data a šablonu reportu).

Ukázková data XML

Použijte následující data 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>

Vzorová šablona

Vygenerujte zadanou šablonu ve formátu TXT, DOCX nebo v potřebném formátu pro iteraci dat manažerů spolu s jejich odpovídajícími klienty a souvisejícími informacemi. Následně pokračujte v implementaci kódu pro vygenerování sestavy.

<<foreach \[in managers\]>>Manager: <<\[Name\]>>
Contracts:
<<foreach \[in Contract\]>>- <<\[Client.Name\]>> ($<<\[Price\]>>)
<</foreach>>
<</foreach>>

Body, které je třeba probrat:

Začněte s Python HTML Report Generator SDK
Spusťte klienta API
Nahrajte soubory šablon a zdrojů dat
Zobrazit data XML na stránce HTML
Stáhnout soubor HTML

Nakonfigurujte Python HTML Report Generator SDK

Chcete-li zahájit proces, zahrňte do svého projektu Python sadu GroupDocs.Assembly Cloud SDK pro Python pomocí pip (instalátor balíčku Pythonu). Proveďte následující příkaz v konzole:

pip install groupdocs-assembly-cloud

Spusťte klienta API

Dále načtěte své ID klienta a Tajný klíč klienta z dashboard a začleňte poskytnutý kód, jak je znázorněno níže:

	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"

view raw initialize-API-client.py hosted with ❤ by GitHub

Nahrajte zdroj dat a soubory šablon

Nejprve nahrajte zdroj dat a soubory šablon do cloudu pomocí níže uvedeného příkladu kódu:

	# 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)

view raw upload-file.py hosted with ❤ by GitHub

V důsledku toho budou nahrané soubory dostupné v sekce souborů vašeho řídicího panelu v cloudu.

Zobrazení dat XML na stránce HTML pomocí Pythonu

Chcete-li prezentovat data XML na stránce HTML, dodržujte následující kroky:

Vytvořte instanci AssemblyApi s client_id a client_secret.
Nastavte informace o šabloně s cestou k souboru, názvem úložiště, ID verze a heslem.
Připravte požadavek na sestavení pomocí AssembleOptions s daty sestavy, informacemi o šabloně, výstupní cestou a formátem uložení.
Vygenerujte zprávu HTML pomocí metody AssemblyApi.assemble_document(AssembleOptions).

Poskytnutý ukázkový kód je příkladem implementace Python SDK pro generátor sestav HTML REST API, které umožňuje prezentaci dat XML na stránce HTML.

	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)

view raw generate-html-report.py hosted with ❤ by GitHub

Stáhnout soubor HTML

Kód uvedený v předchozím kroku uloží převedený soubor HTML do cloudu. Chcete-li jej stáhnout, můžete použít následující fragment kódu.

	# 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\\")

view raw download-file.py hosted with ❤ by GitHub

Závěr

V tomto článku jsme zahrnuli kroky spojené s prezentováním dat XML na stránce HTML prostřednictvím využití GroupDocs.Assembly Cloud REST API ve spojení s jeho Python SDK. Toto robustní rozhraní API umožňuje vývojářům bezproblémově vytvářet dynamické sestavy v různých formátech, využívat informace ze zdrojů XML nebo XML a spojovat šablony zahrnující dokumenty Word, tabulky a textové soubory.

Pro komplexnější pochopení GroupDocs.Assembly Cloud API se navíc ponořte do podrobné dokumentace. Využijte také naši oblast API reference, která vám umožňuje přímo se zapojit a sledovat naše API v akci přímo z vašeho prohlížeče. Můžete také volně přistupovat ke kompletnímu zdrojovému kódu sady Python SDK na Github.

Na závěr neustále vytváříme nové články na blogu, které zkoumají řadu formátů souborů a jejich analýzu pomocí REST API. Kontaktujte nás pro nejaktuálnější informace.

Položit otázku

V případě, že byste měli nějaké dotazy nebo nejasnosti ohledně generátoru HTML reportů, neváhejte nás kontaktovat prostřednictvím našeho fóra.

Viz také

Zde je několik souvisejících článků, které by vám mohly pomoci:

Zobrazení dat JSON na stránce HTML v Pythonu pomocí REST API

Předpoklady:#

Ukázková data XML#

Vzorová šablona#

Body, které je třeba probrat:#

Nakonfigurujte Python HTML Report Generator SDK#

Spusťte klienta API#

Nahrajte zdroj dat a soubory šablon#

Zobrazení dat XML na stránce HTML pomocí Pythonu#

Stáhnout soubor HTML#

Závěr#

Položit otázku#

Viz také#