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"

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

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

# 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 ページ内に表示するには、次の手順に従います。

  1. client_id と client_secret を使用して AssemblyApi のインスタンスを作成します。
  2. ファイルパス、ストレージ名、バージョンID、パスワードを含むテンプレート情報を設定します。
  3. AssembleOptions を使用してレポート データ、テンプレート情報、出力パス、保存形式を指定してアセンブル リクエストを準備します。
  4. 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)

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

結論

この記事では、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 レポート ジェネレーター についてご質問や混乱がある場合は、フォーラム 経由でお気軽にお問い合わせください。

関連項目

役立つと思われる関連記事をいくつか紹介します。