Wyświetlaj dane JSON na stronie HTML w języku Python przy użyciu interfejsu API REST

W dzisiejszym, zaawansowanym technologicznie świecie, wizualizacja danych odgrywa kluczową rolę w skutecznym i kompleksowym prezentowaniu informacji. Możliwość generowania dynamicznych raportów przy użyciu danych i szablonów JSON w różnych formatach, takich jak dokumenty Word, arkusze kalkulacyjne lub format tekstowy, jest kluczowa zarówno dla programistów, jak i firm. W tym poście na blogu poinstruujemy programistów języka Python, jak wykorzystać interfejs API REST GroupDocs.Assembly Cloud i jego pakiet SDK języka Python do przesyłania danych raportów w postaci JSON i pliku szablonu, a następnie wyświetlania wygenerowanych raportów w formacie HTML strona. Interfejs API zapewnia szereg funkcji, takich jak wykresy, tabele, obrazy, kody kreskowe i inne, umożliwiające tworzenie atrakcyjnych wizualnie i informacyjnych raportów.

Warunki wstępne:

Zanim zaczniesz, upewnij się, że masz przygotowane następujące elementy:

Python zainstalowany w twoim systemie.
Zainstalowano pakiet SDK GroupDocs.Assembly Cloud dla języka Python.
Aktywne konto GroupDocs.Assembly Cloud z ważnymi poświadczeniami API.
Przykładowe dane i szablony do testów (wykorzystamy poniższe przykładowe dane JSON i szablon raportu).

Przykładowe dane JSON

Zapisz następujące dane w pliku 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}\]
	}
\]

Przykładowy szablon

Utwórz następujący szablon w formacie TXT, DOCX lub w wymaganym formacie, aby iterować dane menedżerów wraz z ich odpowiednimi klientami i szczegółami. Następnie kontynuuj kod generowania raportu.

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

Punkty do omówienia:

Rozpocznij korzystanie z zestawu SDK generatora raportów HTML w języku Python
Uruchom klienta API
Prześlij szablon i pliki źródła danych
Wyświetl dane JSON na stronie HTML
Pobierz plik HTML

Skonfiguruj zestaw SDK generatora raportów HTML w języku Python

Na początek zainstaluj GroupDocs.Assembly Cloud SDK dla Pythona w swoim projekcie w Pythonie za pomocą pip (instalator pakietu dla Pythona), używając następującego polecenia w konsoli:

pip install groupdocs-assembly-cloud

Uruchom klienta API

Teraz pobierz swój Identyfikator klienta i Tajemnica klienta z panelu i dodaj kod, jak pokazano poniżej:

	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

Prześlij źródło danych i pliki szablonów

Najpierw prześlij źródło danych i pliki szablonów do chmury, korzystając z przykładowego kodu podanego poniżej:

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

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

W efekcie przesłane pliki będą dostępne w sekcji plików Twojego dashboardu w chmurze.

Wyświetlaj dane JSON na stronie HTML przy użyciu języka Python

Aby wyświetlić dane JSON na stronie HTML, wykonaj poniższe czynności:

Utwórz instancję AssemblyApi z identyfikatorem klienta i sekretem_klienta.
Skonfiguruj informacje o szablonie, obejmujące ścieżkę pliku, nazwę magazynu, identyfikator wersji i hasło.
Przygotuj żądanie złożenia za pomocą AssembleOptions z danymi raportu, informacjami o szablonie, ścieżką wyjściową i formatem zapisu.
Wygeneruj raport HTML przy użyciu metody AssemblyApi.assemble_document(AssembleOptions).

Poniższy przykład kodu pokazuje, jak wyświetlić dane JSON na stronie HTML przy użyciu zestawu SDK języka Python dla interfejsu API REST generatora raportów 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.json';
	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

Pobierz plik HTML

Kod podany w poprzednim kroku zapisuje przekonwertowany plik HTML w chmurze. Aby go pobrać, możesz użyć poniższego fragmentu kodu.

	# 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

Wniosek

W tym poście na blogu omówiliśmy proces wyświetlania danych JSON na stronie HTML przy użyciu interfejsu API REST GroupDocs.Assembly Cloud i jego pakietu SDK w języku Python. Ten potężny interfejs API umożliwia programistom bezproblemowe generowanie dynamicznych raportów w różnych formatach, wykorzystując dane ze źródeł JSON lub XML oraz szablony w różnych formatach, takich jak dokumenty programu Word, arkusze kalkulacyjne lub pliki tekstowe.

Ponadto możesz dowiedzieć się więcej o GroupDocs.Assembly Cloud API, korzystając z dokumentacji. Udostępniamy również sekcję odniesienia API, która umożliwia wizualizację naszych interfejsów API i interakcję z nimi bezpośrednio za pośrednictwem przeglądarki. Kompletny kod źródłowy pakietu Python SDK jest swobodnie dostępny na Github.

Wreszcie, wciąż piszemy nowe artykuły na blogu w różnych formatach plików i analizujemy je za pomocą interfejsu API REST. Prosimy zatem o kontakt w celu uzyskania najnowszych aktualizacji. Miłego kodowania!

Zadać pytanie

W przypadku jakichkolwiek pytań lub niejasności dotyczących generatora raportów HTML, prosimy o kontakt za pośrednictwem naszego forum.

Zobacz też

Oto kilka powiązanych artykułów, które mogą okazać się pomocne:

Warunki wstępne:#

Przykładowe dane JSON#

Przykładowy szablon#

Punkty do omówienia:#

Skonfiguruj zestaw SDK generatora raportów HTML w języku Python#

Uruchom klienta API#

Prześlij źródło danych i pliki szablonów#

Wyświetlaj dane JSON na stronie HTML przy użyciu języka Python#

Pobierz plik HTML#

Wniosek#

Zadać pytanie#

Zobacz też#