C++ 向けドキュメントアセンブリ

GroupDocs.Assembly Cloud API のラッパーとしての C++ SDK。C++ アプリケーションから高度にカスタマイズされたレポート、契約書、請求書などを直接作成できます。

  • cURL 用 GroupDocs.Assembly Cloud SDK
  • .NET 用 GroupDocs.Assembly Cloud SDK
  • Java 用 GroupDocs.Assembly Cloud SDK
  • Python 用 GroupDocs.Assembly Cloud SDK
  • PHP 用 GroupDocs.Assembly Cloud SDK
  • Ruby 用 GroupDocs.Assembly Cloud SDK
  • Node.js 用 GroupDocs.Assembly Cloud SDK
  • Go 用 GroupDocs.Assembly Cloud SDK
  • Swift 用 GroupDocs.Assembly Cloud SDK
無料トライアルを開始

GroupDocs.Assembly Cloud SDK for C++ は、Assembly Cloud REST API の高水準かつクロスプラットフォームのラッパーを提供し、開発者が C++ アプリケーションからリッチにフォーマットされたドキュメントを直接生成できるようにします。このソリューションは、特殊なプレースホルダフィールドと生成ルールを含むテンプレート(ドキュメント)と、データソース(XML または JSON)を組み合わせて構成されています。テンプレートとデータをクラウドに送信すると、サービスは指定したフォーマット(DOCX、PDF、HTML など)で最終出力を組み立てて即時に返します。

なぜ Assembly Cloud を使用するのか?

  • ゼロインストール - すべての重い処理はクラウドで行われ、C++ のコードは HTTP 呼び出しのみを行えばよい。
  • 幅広いフォーマット対応 - 追加のライブラリ不要で Word、Excel、PowerPoint、PDF、OpenDocument、グラフィックなど多様なフォーマットを生成。
  • 高度なテンプレート構文 - 画像、グラフ、バーコード、条件付きセクション、ループ、数式、メール本文までテンプレートに直接埋め込み可能。
  • セキュリティ - 通信は SSL/TLS で保護され、個人アクセスキーで認証されるため、機密データが安全なクラウド環境から外に出ることはありません。

C++ での典型的なワークフロー

  1. あなたの App SID と App Key で SDK を設定 します。
  2. UploadFile エンドポイントを使ってテンプレート(例:InvoiceTemplate.docx)を GroupDocs Cloud Storage にアップロードします。
  3. アセンブリオプションを準備し、テンプレートパス、データソース(invoice.json または invoice.xml)、および出力フォーマットを指定します。
  4. AssembleDocument API を呼び出します - サービスがテンプレートにデータをマージし、すべての式を評価して組み立てたドキュメントを返します。
  5. 結果を API レスポンスから直接、またはストレージ API 経由でダウンロードし、さらに処理します。

このアプローチにより、複雑な複数ページのレポート、パーソナライズされた文書(メールマージ)、請求書、契約書、静的コンテンツと動的データを組み合わせた任意のドキュメントの作成が可能です。SDK は軽量で、C++11 と cURL をサポートする任意の OS で動作するため、デスクトップアプリケーション、サーバーサイドサービス、コンテナ化されたマイクロサービスに容易に統合できます。

Assembly Cloud REST API の機能

単一の API コールでテンプレートからドキュメントを生成

LINQ スタイルの式でデータソース(XML、JSON)をバインド

画像、グラフ、外部ドキュメントを出力に埋め込み

配列データから動的なテーブルやリストを作成

テンプレート内の条件付きコンテンツブロック(IF/ELSE)

組み立て中に数式や連続計算を適用

ドキュメント内でバーコード(QR、Code128 等)を生成

SSL/TLS および個人アクセスキーによる安全なデータ転送

メール本文の作成と生成ドキュメントの即時添付

C++ で REST API を使ってドキュメントを生成

以下の例は典型的なワークフローを示しています: SDK の設定、テンプレートのアップロード、アセンブリオプションの設定、生成済みドキュメント受け取りのための Assemble エンドポイント呼び出し。

手順:

  1. App SIDApp Key で SDK を初期化。
  2. Word テンプレート (Input1.docx) を GroupDocs Cloud Storage にアップロード。
  3. アップロード済みテンプレートを指す TemplateFileInfo を作成。
  4. 希望の出力フォーマット (docx) とデータソース (Input2.json) を設定。
  5. assembleDocument を呼び出して最終ドキュメントを生成。
using namespace groupdocs::assembly;
using namespace groupdocs::assembly::cloud::api;

// 1. 認証情報で SDK を設定
auto config = std::make_shared<Configuration>(L"####################", L"####################");
auto assemblyApi = std::make_shared<AssemblyApi>(config);

// 2. テンプレートファイルをアップロード
auto fileName = L"Input1.docx";
auto requestFileContent = std::shared_ptr<std::istream>(
    new std::ifstream(std::filesystem::path(fileName), std::istream::binary));
std::shared_ptr<UploadFileRequest> uploadDocumentRequest(
    new UploadFileRequest(requestFileContent, std::make_shared<std::wstring>(fileName)));
assemblyApi->uploadFile(uploadDocumentRequest);

// 3. アセンブリオプションの準備
auto fileInfo = std::make_shared<TemplateFileInfo>();
fileInfo->setFilePath(fileName);

auto assembleOptions = std::make_shared<AssembleOptions>();
assembleOptions->setSaveFormat("docx");
assembleOptions->setReportData(std::filesystem::path(L"Input2.json"));   // データソース
assembleOptions->setTemplateFileInfo(fileInfo);

// 4. ドキュメントの組み立て
auto request = std::make_shared<AssembleDocumentRequest>(assembleOptions);
assemblyApi->assembleDocument(request);

サポートと学習リソース

GroupDocs.Assembly Cloud は他の言語向けの SDK も提供しています:

  日本語
8d45f93