
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 を使ってみる
- APIクライアントを起動する
- テンプレートとデータ ソース ファイルをアップロードする
- XML データを HTML ページに表示する
- HTMLファイルをダウンロード
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) |
その結果、アップロードされたファイルは、クラウド上のダッシュボードの ファイル セクション で利用できるようになります。
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) |
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 レポート ジェネレーター についてご質問や混乱がある場合は、フォーラム 経由でお気軽にお問い合わせください。
関連項目
役立つと思われる関連記事をいくつか紹介します。