
V dnešním technicky vyspělém světě hraje vizualizace dat klíčovou roli při efektivní a komplexní prezentaci informací. Schopnost generovat dynamické sestavy pomocí dat a šablon JSON v různých formátech, jako jsou dokumenty Word, tabulky nebo textový formát, je klíčová pro vývojáře i firmy. V tomto příspěvku na blogu provedeme vývojáře Pythonu, jak využít GroupDocs.Assembly Cloud REST API a jeho Python SDK k nahrání dat sestav ve formě JSON a souboru šablony a poté zobrazení vygenerovaných sestav na HTML strana. Rozhraní API poskytuje řadu funkcí, jako jsou grafy, tabulky, obrázky, čárové kódy a další, pro vytváření vizuálně poutavých a informativních zpráv.
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.
- Ukázková data a šablony pro testování (použijeme následující ukázková data a šablonu sestavy JSON).
Ukázková data JSON
Uložte následující data do souboru JSON.
\[
{
"Name":"John Smith","Contract":\[
{"Client":{"Name":"A Company"},"Price":1200000},
{"Client":{"Name":"B Ltd."},"Price":750000},
{"Client":{"Name":"C & D"},"Price":350000}\]
},
{
"Name":"Tony Anderson","Contract":\[
{"Client":{"Name":"E Corp."},"Price":650000},
{"Client":{"Name":"F & Partners"},"Price":550000}\]
},
{
"Name":"July James","Contract":\[
{"Client":{"Name":"G & Co."},"Price":350000},
{"Client":{"Name":"H Group"},"Price":250000},
{"Client":{"Name":"I & Sons"},"Price":100000},
{"Client":{"Name":"J Ent."},"Price":100000}\]
}
\]
Vzorová šablona
Vytvořte následující šablonu ve formátu TXT, DOCX nebo v požadovaném formátu pro iteraci dat manažerů spolu s jejich příslušnými klienty a podrobnostmi. Poté pokračujte s kódem pro generování zprávy.
<<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 JSON na stránce HTML
- Stáhnout soubor HTML
Nakonfigurujte Python HTML Report Generator SDK
Nejprve nainstalujte GroupDocs.Assembly Cloud SDK pro Python do svého projektu Python pomocí pip (instalátor balíčku pro Python) pomocí následujícího příkazu v konzole:
pip install groupdocs-assembly-cloud
Spusťte klienta API
Nyní prosím získejte své ID klienta a ** Tajemství klienta** z dashboard a přidejte kód, jak je uvedeno 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" |
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.json", "H:\\groupdocs-cloud-data\\input-sample-file.json", "storage_name") | |
# Upload file to the cloud | |
response = file_api.upload_file(request) | |
print(response.uploaded) |
V důsledku toho budou nahrané soubory dostupné v sekce souborů vašeho řídicího panelu v cloudu.
Zobrazte data JSON na stránce HTML pomocí Pythonu
Chcete-li zobrazit data JSON na stránce HTML, postupujte podle následujících kroků:
- 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).
Následující příklad kódu ukazuje, jak zobrazit data JSON na stránce HTML pomocí Python SDK pro generátor sestav HTML REST API.
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.json'; | |
options.template_file_info = templateInfo | |
options.output_path = 'Python_Testing/report.html'; | |
options.save_format = 'html' | |
# Generate HTML report | |
assemblyAPI.assemble_document(options) |
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\\") |
Závěr
V tomto příspěvku na blogu jsme se zabývali procesem zobrazování dat JSON na stránce HTML pomocí GroupDocs.Assembly Cloud REST API a jeho Python SDK. Toto výkonné rozhraní API umožňuje vývojářům bez námahy generovat dynamické sestavy v různých formátech s využitím dat ze zdrojů JSON nebo XML a šablon v různých formátech, jako jsou dokumenty Word, tabulky nebo textové soubory.
Dále se můžete dozvědět více o GroupDocs.Assembly Cloud API pomocí dokumentace. Poskytujeme také sekci odkaz na rozhraní API, která vám umožní vizualizovat naše rozhraní API a pracovat s nimi přímo prostřednictvím prohlížeče. Úplný zdrojový kód Python SDK je volně dostupný na Github.
Konečně stále píšeme nové články na blogu o různých formátech souborů a analyzujeme je pomocí REST API. Proto nás prosím kontaktujte pro nejnovější aktualizace. Šťastné kódování!
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: