インストール

パッケージは、availablePyPI にあり、経由でインストールできますpip次のコマンドを実行します。

pip install groupdocs-assembly-cloud

要件

• Python 3.4+
• pip パッケージマネージャー
• GroupDocs クラウド認証情報 —Client ID and Client Secretダッシュボードから

依存関係

SDK は次のパッケージを自動的にインストールします。

ドキュメント オートメーション Python クラウド REST API

GroupDocs.Assembly Cloud SDK for Python開発者は、レポート、請求書、プレゼンテーションなどの複雑なドキュメントの作成をシームレスに自動化できます。テンプレートの活用、JSON または XML ソースからのデータの結合、豊​​富な書式設定の適用、バーコードとグラフの生成はすべて、スケーラブルで安全なクラウド環境内で行われます。この API はドキュメント ワークフローを合理化し、生産性を向上させ、Python Web アプリ、スクリプト、自動化ワークフローに簡単に統合できるクロスプラットフォーム互換性を提供します。

コア機能

テンプレート主導のドキュメント生成 - テンプレートから複雑な Word、Excel、PowerPoint、PDF ドキュメントを作成します。
動的データ結合 - カスタマイズされたレポートの JSON または XML データをテンプレートに入力します。
豊富な書式設定とスタイル - 洗練されたドキュメントのテキスト、表、グラフに高度な書式設定を適用します。
条件付きコンテンツ コントロール - 条件付きロジックを使用して、データに基づいて動的コンテンツを生成します。
リストとテーブルの自動化 - データに基づいて自動更新される動的なリスト、テーブル、グラフを作成します。

高度な機能

バーコード生成 - バーコードをドキュメントに直接埋め込みます。
ハイパーリンクの挿入 - 外部リソースまたはドキュメント内にクリック可能なリンクを追加します。
ブックマークの作成 - ナビゲーションを容易にするブックマークを作成します。
チェックボックスの操作 - データに基づいてチェックボックスの値を動的に設定します。
メールの差し込み機能 - パーソナライズされたメールと添付ファイルを大規模に生成します。
数式計算 - 動的な結果を得るためにスプレッドシート内で計算を実行します。

データの操作

データ フィルタリング - フィルタを適用して、レポートの特定のデータ サブセットを選択します。
データの並べ替え - 基準に基づいてデータを特定の順序 (昇順/降順) に並べます。
データのグループ化 - 分析とプレゼンテーションを容易にするためにデータをグループに整理します。
データの書式設定 - 数値、日付、テキストの書式設定など、レポート内のデータの外観を制御します。
変数の使用 - 効率的に処理するために、テンプレート全体で値を保存および再利用します。
拡張メソッドの使用 - テンプレート内の複雑な操作には組み込み関数を利用します。

リスト、テーブル、グラフの操作

動的リスト生成 - 動的コンテンツを含む段落内、箇条書き、番号付きリストを生成します。
動的テーブル生成 - 動的コンテンツ、計算、および書式設定を含むテーブルを生成します。
グラフの生成 - 動的データを使用して折れ線グラフ、縦棒グラフ、棒グラフ、円グラフ、散布図、バブル チャートを作成します。
グラフのカスタマイズ - 式を使用して、グラフのタイトル、系列、軸のタイトル、凡例をカスタマイズします。
条件付きチャート シリーズ - 条件に基づいてチャート シリーズを条件付きで含めたり除外したりします。

ハイパーリンク、ブックマーク、バーコードの操作

ハイパーリンクの挿入 - Word、電子メール、スプレッドシート、プレゼンテーション ドキュメントにハイパーリンクを挿入します。
動的なブックマークの挿入 - ドキュメント/メールにブックマークを追加し、ナビゲーション用の名前を定義します。
チェックボックスの状態制御 - チェック タグを使用して、Word ドキュメント内のチェックボックスのオン/オフを設定します。
バーコード画像生成 - QR、DataMatrix、UPC、EAN、ISBN、PDF417、およびその他の多くのバーコード タイプを生成して挿入します。

開発者向けの機能

REST API アーキテクチャ - REST を活用して、統合とスケーラビリティを容易にします。
包括的なドキュメント - 詳細な API リファレンス、コード例、チュートリアルにアクセスします。
アクティブなコミュニティ サポート - アクティブなコミュニティ フォーラムと専用のサポートからサポートを受けられます。
クラウドベースの柔軟性 - クラウドベースの処理の拡張性と信頼性をお楽しみください。
JWT 認証 - JWT 認証を使用してデータと API リクエストを保護します。

ライセンスと認証

評価モード - 無料試用アカウントで API を試してください。
安全な認証 - 安全な API アクセスにはクライアント ID とクライアント シークレットを使用します。
MIT ライセンス - Python SDK は、以下に基づいてライセンスされています。MIT License.

サポートされているファイル形式

GroupDocs.Assembly Cloud は、さまざまな種類のドキュメントにわたるテンプレート主導の生成と変換をサポートしています。

• ワードプロセッサ: DOC、DOCX、DOCM、DOT、DOTX、DOTM、RTF、ODT、OTT、HTML、MD、TXT、MHTML、MHT
• スプレッドシート: XLS、XLSX、XLSM、XLTX、XLTM、XLSB、ODS
• プレゼンテーション: PPT、PPTX、PPTM、PPS、PPSX、PPSM、POT、POTX、POTM、ODP、OTP
• 電子メール: MSG、EML、EMLX
• Web およびその他: PDF、EPUB、XPS、OXPS、TIFF、SVG、XAML

サポートされる出力形式は、ソース テンプレートのタイプによって異なります。完全な形式マトリックスについては、documentation.

クイックスタート

API 認証情報を取得する

GroupDocs.Assembly Cloud を使用するには、次の URL でサインアップしてください。GroupDocs.Cloud Dashboardクライアント ID と クライアント シークレット を取得します。

API を初期化する

GroupDocs.Assembly Cloud SDK for Python の使用を開始するには、次のコードを使用します。

import groupdocsassemblycloud

# Get your ClientId and ClientSecret at https://dashboard.groupdocs.cloud
client_id = "YourClientId"
client_secret = "YourClientSecret"

# Create instance of the Assembly API
assembly_api = groupdocsassemblycloud.AssemblyApi(client_id, client_secret)
assembly_api.api_client.configuration.host = "https://api.groupdocs.cloud"

テンプレートと JSON データからドキュメントを組み立てる

初期化したら、次の基本的な例を使用して、テンプレートと JSON データ ソースからドキュメントを生成します。

import groupdocsassemblycloud
from groupdocsassemblycloud.models import requests

client_id = "YourClientId"
client_secret = "YourClientSecret"

assembly_api = groupdocsassemblycloud.AssemblyApi(client_id, client_secret)
assembly_api.api_client.configuration.host = "https://api.groupdocs.cloud"

# Upload the template file to cloud storage
with open("template.docx", "rb") as template_file:
    upload_request = requests.UploadFileRequest(template_file, path="template.docx")
    assembly_api.upload_file(upload_request)

# Read JSON data source
with open("data.json") as f:
    data = f.read()

template_file_info = groupdocsassemblycloud.TemplateFileInfo("template.docx")
options = groupdocsassemblycloud.AssembleOptions(template_file_info, save_format="docx", report_data=data)
request = requests.AssembleDocumentRequest(options)
result = assembly_api.assemble_document(request)

print("Generated document size = " + str(len(result)))

このクイック スタート ガイドを使用すると、Python アプリケーションで GroupDocs.Assembly Cloud を使用してドキュメント生成の自動化を開始する準備が整います。詳細については、次のサイトを参照してください。documentation.

ドキュメントを PDF に組み立てる

OpenDocument テンプレートと JSON データから PDF レポートを生成します。

import groupdocsassemblycloud
from groupdocsassemblycloud.models import requests

client_id = "YourClientId"
client_secret = "YourClientSecret"

assembly_api = groupdocsassemblycloud.AssemblyApi(client_id, client_secret)
assembly_api.api_client.configuration.host = "https://api.groupdocs.cloud"

filename = "TableFeatures.odt"
remote_name = "GroupDocs.Assembly/TableFeatures.odt"

with open("TableData.json") as f:
    data = f.read()

with open(filename, "rb") as template_file:
    upload_request = requests.UploadFileRequest(template_file, remote_name)
    assembly_api.upload_file(upload_request)

template_file_info = groupdocsassemblycloud.TemplateFileInfo(remote_name)
assemble_data = groupdocsassemblycloud.AssembleOptions(template_file_info, "pdf", data)
request = requests.AssembleDocumentRequest(assemble_data)
result = assembly_api.assemble_document(request)

print("Generated document size = " + str(len(result)))

サポートされているファイル形式を取得する

Assembly API を通じて利用できるサポートされているファイル形式の完全なリストを取得します。

import groupdocsassemblycloud
from groupdocsassemblycloud.models import requests

client_id = "YourClientId"
client_secret = "YourClientSecret"

assembly_api = groupdocsassemblycloud.AssemblyApi(client_id, client_secret)
assembly_api.api_client.configuration.host = "https://api.groupdocs.cloud"

result = assembly_api.get_supported_file_formats(requests.GetSupportedFileFormatsRequest())

for fmt in result.formats:
    print(fmt.file_format)

GitHub のサンプル プロジェクト

のGroupDocs.Assembly Cloud Python SDKリポジトリには、すぐに実行できる単体テストと以下をカバーするサンプルが含まれています。

サンプルの実行方法

1. クローンを作成するか、ダウンロードします。SDK repository2.編集Settings/servercreds.jsonそしてあなたの設定をAppSidそしてAppKey3. 依存関係をインストールします。pip install groupdocs-assembly-cloud -U4. リポジトリのルートからテストを実行します。python -m unittest discover -s test

詳細については、次のサイトをご覧ください。Getting Started.

タグ

Document Automation | Python Cloud API | GroupDocs.Assembly Cloud | REST API | Document Generation | Template-Driven | Dynamic Data Merging | Rich Formatting | Conditional Content Control | List Automation | Table Automation | Barcode Generation | Hyperlink Insertion | Bookmark Creation | Checkbox Manipulation | Mail Merge | Formula Calculations | Chart Generation | Data Filtering | Data Sorting | Data Grouping | JWT Authentication | Microsoft Word | Microsoft Excel | Microsoft PowerPoint | Report Generation | Cloud-Based Flexibility | Secure API Access | Cross-platform API