REST APIを使用してPythonのHTMLページにJSONデータを表示する

今日のテクノロジーに精通した世界では、データの視覚化は情報を効果的かつ包括的に提示する上で極めて重要な役割を果たしています。 Word 文書、スプレッドシート、テキスト形式などのさまざまな形式の JSON データとテンプレートを使用して動的なレポートを生成できる機能は、開発者にとっても企業にとっても同様に重要です。このブログ投稿では、Python 開発者向けに、GroupDocs.Assembly Cloud REST API とその Python SDK を活用して、レポートデータを JSON 形式とテンプレートファイルでアップロードし、生成されたレポートを [HTML][ で表示する方法を説明します。 1】ページです。 API は、視覚的に魅力的で有益なレポートを作成するためのチャート、表、画像、バーコードなどの一連の機能を提供します。

前提条件:

始める前に、次のものが整っていることを確認してください。

Python がシステムにインストールされていること。
GroupDocs.Assembly Cloud SDK for Python がインストールされています。
有効な API 資格情報を持つアクティブな GroupDocs.Assembly Cloud アカウント。
テスト用のサンプルデータとテンプレート (次のサンプル JSON データとレポートテンプレートを使用します)。

サンプル JSON データ

次のデータを 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}\]
	}
\]

サンプルテンプレート

次のテンプレートを TXT、DOCX、または必要な形式で作成して、マネージャーのデータとそれぞれのクライアントおよび詳細を反復します。次に、レポート生成用のコードに進みます。

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

Python HTML レポートジェネレーター SDK を構成する

まず、コンソールで次のコマンドを使用して、GroupDocs.Assembly Cloud SDK for Python を pip (Python 用パッケージインストーラー) を使用して 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"

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

データソースとテンプレートファイルをアップロードする

まず、以下のコード例を使用して、データソースとテンプレートファイルをクラウドにアップロードします。

	# 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

その結果、アップロードされたファイルは、クラウド上のダッシュボードのファイルセクションで利用できるようになります。

Python を使用して JSON データを HTML ページに表示する

JSON データを HTML ページに表示するには、以下の手順に従ってください。

client_id と client_secret を使用して AssemblyApi のインスタンスを作成します。
ファイルパス、ストレージ名、バージョンID、パスワードを含むテンプレート情報を設定します。
AssembleOptions を使用してレポートデータ、テンプレート情報、出力パス、保存形式を指定してアセンブルリクエストを準備します。
AssemblyApi.assemble_document(AssembleOptions) メソッドを使用して HTML レポートを生成します。

次のコード例は、HTML レポートジェネレーター REST API 用の Python SDK を使用して、HTML ページに JSON データを表示する方法を示しています。

	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

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

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

結論

このブログ投稿では、GroupDocs.Assembly Cloud REST API とその Python SDK を使用して HTML ページに JSON データを表示するプロセスについて説明しました。この強力な API を使用すると、開発者は JSON または XML ソースのデータと、Word ドキュメント、スプレッドシート、テキストファイルなどのさまざまな形式のテンプレートを活用して、さまざまな形式で動的なレポートを簡単に生成できます。

さらに、ドキュメントを使用して、GroupDocs.Assembly Cloud API について詳しく学ぶことができます。また、ブラウザーを通じて API を直接視覚化し操作できるようにする API リファレンスセクションも提供しています。 Python SDK の完全なソースコードは Github で無料で入手できます。

最後に、私たちはさまざまなファイル形式で新しいブログ記事を書き続け、REST API を使用してそれらを解析します。最新の更新情報については、お問い合わせください。コーディングを楽しんでください!

質問する

HTML レポートジェネレーター についてご質問や混乱がある場合は、フォーラム経由でお気軽にお問い合わせください。

前提条件:#

サンプル JSON データ#

サンプル テンプレート#

取り上げるべきポイント:#

Python HTML レポート ジェネレーター SDK を構成する#

APIクライアントを起動する#

データソースとテンプレートファイルをアップロードする#

Python を使用して JSON データを HTML ページに表示する#

HTMLファイルをダウンロード#

結論#

質問する#

関連項目#