Rest APIを使用してPythonでXMLデータからHTMLレポートを生成する

XML は、W3C によってサポートされている自己記述言語であり、効率的なデータストレージとシームレスなデータ交換を目的として構築されています。 Python アプリケーション開発者にとって、XML 形式の適応性により、HTML のようなユーザーフレンドリーで人間が判読できる形式に簡単に変換できます。この記事では、GroupDocs.Assembly Cloud SDK for Python とシンプルなテンプレートを利用して、XML データを包括的な HTML レポートに変換するプロセスについて説明します。

前提条件:

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

Python がシステムにインストールされていること。
GroupDocs.Assembly Cloud SDK for Python がインストールされています。
有効な API 認証情報を持つアクティブな GroupDocs.Assembly Cloud アカウント。
テスト用のサンプルデータとテンプレート (次のサンプル 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 のパッケージインストーラー) を利用して、GroupDocs.Assembly Cloud SDK for 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.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

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

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

XML データを HTML ページ内に表示するには、次の手順に従います。

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)

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 ページ上に XML データを表示する手順を説明しました。この堅牢な API を使用すると、開発者は、XML または XML ソースからの情報を活用し、Word 文書、スプレッドシート、テキストファイルにまたがるテンプレートを統合して、さまざまな形式にわたる動的なレポートをシームレスに作成できます。

さらに、GroupDocs.Assembly Cloud API をより包括的に理解するには、詳細なドキュメントを詳しく調べてください。また、API リファレンスエリアを活用すると、ブラウザから直接 API に直接アクセスし、動作を観察できるようになります。 Github で Python SDK の完全なソースコードに自由にアクセスすることもできます。

最後に、私たちは、REST API を利用したさまざまなファイル形式とその解析を調査する新鮮なブログ記事を一貫して作成しています。最新情報については、お問い合わせください。

質問する

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

前提条件:#

サンプル XML データ#

サンプル テンプレート#

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

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

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

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

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

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

結論#

質問する#

関連項目#