Excel を HTML にレンダリングする

Microsoft Excel データをクラウド上で HTML 形式で簡単に表示できます。実際の Excel データ ファイルを共有することなく、関係者にデータを表示することが容易になる場合があります。 Python 開発者は、XLS または XLSX ファイルからのスプレッドシート データを、クラウド上でプログラムによって HTML でレンダリングできます。この記事では、Python の REST API を使用して Excel データを HTML にレンダリングする方法に焦点を当てます。

ドキュメント ビューアー REST API および Python SDK

XLS または XLSX スプレッドシートをレンダリングするには、GroupDocs.Viewer Cloud の Python SDK API を使用します。これを使用すると、あらゆる種類の一般的なドキュメントや画像ファイル形式をプログラムでレンダリングして表示できます。また、クラウド API の ドキュメント ビューア ファミリ メンバー として、.NET、Java、PHP、Ruby、Android、および Node.js SDK も提供します。

コンソールで次のコマンドを使用して、GroupDocs.Viewer Cloud を Python プロジェクトにインストールできます。

pip install groupdocs_viewer_cloud

手順と利用可能なコード例を開始する前に、ダッシュボード からクライアント ID とクライアント シークレットを取得してください。 ID とシークレットを取得したら、以下に示すようにコードを追加します。

client_id = "659fe7da-715b-4744-a0f7-cf469a392b73"
client_secret = "b377c36cfa28fa69960ebac6b6e36421"
my_storage = ""

configuration = groupdocs_viewer_cloud.Configuration(client_id, client_secret)
configuration.api_base_url = "https://api.groupdocs.cloud"

Python の REST API を使用して Excel データを HTML にレンダリングする

以下に示す簡単な手順に従って、Microsoft Excel スプレッドシート データを HTML でレンダリングできます。

ドキュメントをアップロードする

まず、以下のコード例を使用して、XLSX ファイルをクラウドにアップロードします。

# APIのインスタンスを作成する
file_api = groupdocs_viewer_cloud.FileApi.from_config(configuration)

request = groupdocs_viewer_cloud.UploadFileRequest("sample.xlsx", "C:\\Files\\sample.xlsx", my_storage)
response = file_api.upload_file(request)

その結果、sample.xlsx ファイルが Cloud Storage にアップロードされ、ダッシュボードの ファイル セクション で利用できるようになります。

Python で Excel を HTML にレンダリングする

Excel データをプログラムで HTML にレンダリングするには、以下の手順に従ってください。

  • View API のインスタンスを作成します。
  • ビューオプションの定義
  • ファイルパスと表示形式を「HTML」に設定します。
  • RenderOptions を HtmlOptions として設定する
  • スプレッドシートのレンダリング オプションを定義します(該当する場合)
  • CreateViewRequest メソッドを呼び出してビュー リクエストを作成します。
  • createview メソッドを呼び出して応答を取得します。

次のコード スニペットは、REST API を使用して Excel スプレッドシート データを HTML にレンダリングする方法を示しています。

# APIのインスタンスを作成する
api_instance = groupdocs_viewer_cloud.ViewApi.from_keys(client_id, client_secret)

# 表示オプションの定義
view_options = groupdocs_viewer_cloud.ViewOptions()
view_options.file_info = groupdocs_viewer_cloud.FileInfo()
view_options.file_info.file_path = "sample.xlsx"
view_options.view_format = "HTML"
view_options.render_options = groupdocs_viewer_cloud.HtmlOptions()

# スプレッドシートのレンダリング オプションを定義する
view_options.render_options.spreadsheet_options = groupdocs_viewer_cloud.SpreadsheetOptions() 
view_options.render_options.spreadsheet_options.paginate_sheets = False

# リクエストの準備
request = groupdocs_viewer_cloud.CreateViewRequest(view_options)

# 変換
response = api_instance.create_view(request)
Python を使用して Excel を HTML にレンダリングする

Python を使用して Excel を HTML にレンダリングする

デフォルトでは、1 つのワークシートが 1 ページにレンダリングされます。次のオプションを適用して、Excel のレンダリングをカスタマイズできます。

  • Excel ワークシートを複数のページにレンダリングする
view_options.render_options.spreadsheet_options.paginate_sheets = True
view_options.render_options.spreadsheet_options.count_rows_per_page = 45
  • HTML でグリッド線を表示する
view_options.render_options.spreadsheet_options.render_grid_lines = True
  • 空の行と列をレンダリングする
view_options.render_options.spreadsheet_options.render_empty_rows = True
view_options.render_options.spreadsheet_options.render_empty_columns = True
  • 非表示の行と列を表示する
view_options.render_options.spreadsheet_options.render_hidden_columns = True
view_options.render_options.spreadsheet_options.render_hidden_rows = True
  • 印刷領域のみをレンダリング
view_options.render_options.spreadsheet_options.render_print_area_only = True
  • テキストオーバーフローモードを設定する
view_options.render_options.spreadsheet_options.text_overflow_mode = "HideText"

ウォーターマークを使用して Excel を HTML にレンダリングする

Excel データをプログラムで HTML にレンダリングするときに透かしテキストを追加するには、以下の手順に従ってください。

  • View API のインスタンスを作成します。
  • ビューオプションの定義
  • ファイルパスと表示\形式を「HTML」として設定します
  • 透かし表示オプションを定義する
  • 透かしのテキストとサイズを設定する
  • CreateViewRequest メソッドを呼び出してビュー リクエストを作成します。
  • create\view メソッドを呼び出して応答を取得します。

次のコード スニペットは、REST API を使用してレンダリングされた HTML に透かしテキストを追加する方法を示しています。

# APIのインスタンスを作成する
api_instance = groupdocs_viewer_cloud.ViewApi.from_keys(client_id, client_secret)

# 表示オプションの定義
view_options = groupdocs_viewer_cloud.ViewOptions()
view_options.file_info = groupdocs_viewer_cloud.FileInfo()
view_options.file_info.file_path = "sample.xlsx"
view_options.view_format = "HTML"

# 透かしを追加する
view_options.watermark = groupdocs_viewer_cloud.Watermark()
view_options.watermark.size = 70
view_options.watermark.text = "This is a watermark"

# リクエストの準備
request = groupdocs_viewer_cloud.CreateViewRequest(view_options)

# 変換
response = api_instance.create_view(request)
ウォーターマークを使用して Excel を HTML にレンダリングする

Python を使用して Excel をウォーターマーク付き HTML にレンダリングする

更新されたファイルをダウンロードする

上記のコード サンプルは、レンダリングされた HTML ファイルをクラウドに保存します。次のコード サンプルを使用してダウンロードできます。

# APIのインスタンスを作成する
file_api = groupdocs_viewer_cloud.FileApi.from_config(configuration)

for page in response.pages:
  # HTML ページのダウンロード 
  request = groupdocs_viewer_cloud.DownloadFileRequest(page.path, my_storage)
  response = file_api.download_file(request)

  # ダウンロードしたファイルを作業ディレクトリに移動します
  shutil.move(response, "C:\\Files\\Html\\")

オンラインで試す

上記の API を使用して開発された、次の無料のオンライン スプレッドシート レンダリング ツールをお試しください。 https://products.groupdocs.app/viewer/xlsx

結論

この記事では、Python を使用したドキュメント ビューアー REST API を使用して、クラウド上で Excel スプレッドシート データを HTML にレンダリングする方法を学習しました。また、プログラムによって XLSX ファイルをクラウドにアップロードし、レンダリングされた HTML ファイルをクラウドからダウンロードする方法も学習しました。 ドキュメント を使用すると、GroupDocs.Viewer Cloud API についてさらに詳しく学ぶことができます。また、ブラウザーを通じて直接 API を視覚化し操作できるようにする API リファレンス セクションも提供しています。不明な点がある場合は、フォーラム でお気軽にお問い合わせください。

関連項目