GroupDocs.Assembly Cloud SDK for Python は、開発者が契約書、請求書、出荷レポート、販売提案書、在庫表など、ビジネスに不可欠な多様な文書を自動的に作成できるようにします。\n\nこのソリューションは完全にクラウドベースで、REST API を介してアクセスします。つまり、HTTP リクエストを送信できる任意の Python アプリケーションは、サーバー側ソフトウェアやサードパーティツールをインストールせずに、オンデマンドで文書を生成できます。\n\nプラットフォームの根幹は、特殊なプレースホルダー フィールドとプログラミング構造を含む document templates と連携して動作します。これらのプレースホルダーは、XML または JSON のデータソースから取得した値で、LINQ スタイルの式構文を使用して自動的に置換されます。\n\nこの強力な手法により、画像、チャート、バーコードを埋め込んだり、HTML 出力の背景色を設定したり、配列データから動的なテーブルやリストを作成したり、条件ロジックを適用して文書のセクションを含めたり除外したりできます。\n\nSDK は幅広い入力および出力フォーマットに対応しているため、DOCX テンプレートから PDF を生成したり、HTML レポートを作成したり、追加の変換手順なしで OpenDocument ファイルを出力したりできます。\n\nPython における典型的なワークフローは、次の3つのシンプルなステップで構成されます。\n\n1️⃣ テンプレートの作成 – Word、Excel、PowerPoint、またはサポートされている任意の Office/OpenOffice ファイルを設計し、プレースホルダー フィールドと生成ルールを挿入します。\n\n2️⃣ データソースの準備 – テンプレートで定義されたプレースホルダーに合わせて、XML または JSON 形式でデータを提供します。\n\n3️⃣ 数行の Python コードを書く – groupdocsassemblycloud パッケージを使用してテンプレートを GroupDocs Cloud Storage にアップロードし、データソースと希望する出力フォーマットを渡して AssembleDocument 操作を呼び出します。API は組み立てられた文書をレスポンスに直接返すか、後で取得できるようにクラウドに保存します。\n\nすべてのやり取りは SSL/TLS 暗号化で保護され、認証は個人の App SID と App Key によって行われます。これにより、クラウド上で処理中の文書とデータが保護されたままになります。\n\nSDK のクロスプラットフォーム特性により、文書生成をウェブサービス、バッチジョブ、デスクトップアプリケーション、またはサーバーレス関数に統合でき、印刷可能、ウェブ対応、メール対応の文書を即座に、かつ確実に提供できます。
この Python の例では、テンプレートをアップロードし、データファイルをバインドして、GroupDocs Assembly Cloud SDK を使用して出力ドキュメントを生成する方法を示します。
手順
AssemblyApi を初期化します。TemplateFileInfo と AssembleOptions を作成します。assemble_document を呼び出します。import groupdocsassemblycloud
# Initialize API client (replace with your credentials)
assembly_api = groupdocsassemblycloud.AssemblyApi('####################', '####################')
# 1️⃣ Upload the template
file_name = 'Input1.docx'
with open(file_name, 'rb') as request_file_content:
upload_request = groupdocsassemblycloud.models.requests.UploadFileRequest(
file_content=request_file_content,
path=file_name
)
assembly_api.upload_file(upload_request)
# 2️⃣ Load data source (could be XML, JSON or DOCX)
data_file = 'Input2.docx'
with open(data_file, 'rb') as data:
template_info = groupdocsassemblycloud.models.TemplateFileInfo(file_name)
# 3️⃣ Set assemble options (output format: docx)
assemble_options = groupdocsassemblycloud.models.AssembleOptions(
template_info,
"docx",
data
)
# 4️⃣ Assemble the document
request = groupdocsassemblycloud.models.requests.AssembleDocumentRequest(assemble_options)
result = assembly_api.assemble_document(request)
print("Document generated successfully:", result.path)