Box Developerドキュメント

Box Doc Gen

ガイド Box Doc Gen

Box Doc Gen

Box Doc Genを使用すると、採用通知書、売買契約書、請求書、契約書などのビジネスドキュメントを生成できます。BoxにアップロードされたBox Doc Genテンプレートに基づいた、Box Doc Gen APIを使用して動的に入力できるデータフィールドを含むドキュメントを生成できます。

Box Doc Genでは、Box Doc Genテンプレートの使用時に英語のテンプレートタグを利用する機能のみがサポートされています。お客様には、Box Doc Genがご希望の言語の要件をサポートしているかどうかをテストおよび確認することをお勧めします。

前提条件

  • Microsoft Wordへのアクセス権限

Box Doc Genを使用するには、ドキュメントテンプレートの作成に必要になるため、Microsoft Wordへのアクセス権限が必要です。Box Doc Genアドインを利用してコード不要のエクスペリエンスを実現するか、Word内でタグ付きスクリプトを適用してドキュメントを準備することができます。

Box Doc Genは、ビジネスドキュメントの動的な生成を容易にすることを目的としていますが、Boxでは、ユーザーのMicrosoft Wordに対するアクセス権限を制御していないことに注意してください。ユーザーは、ドキュメントテンプレートを効果的に作成するために必要なMicrosoft Wordに対する権限やアクセス権限があることを確認する必要があります。

Box Doc Gen APIの機能

Box Doc Gen APIを使用すると、以下のことが可能です。

  • ドキュメントをBox Doc Genテンプレートとして設定する。
  • Boxに保存したBox Doc Genテンプレートに基づいてドキュメントを生成する。
  • Box Doc Genテンプレートやドキュメント生成ジョブの詳細を調査する。

Box Doc Gen APIバージョン

Box Doc Gen APIはBox APIバージョン2025.0でリリースされました。Box Doc Gen APIのエンドポイントに対するすべてのAPIリクエストでは、box-versionヘッダーを2025.0に設定して、有効なAPIバージョンを指定する必要があります。

詳細については、APIのバージョン戦略を参照してください。

Box Doc Genのワークフロー

Box Doc Genのワークフローを表すフロー図

  1. Box Doc Genテンプレートを作成します。
  1. Box Doc Gen UIを使用してBoxにテンプレートを追加します。この時点では、以下のことが可能です。
  • Box内の既存のファイルをDoc Genテンプレートとして設定する。
  • ドキュメントを作成またはアップロードして、Box Doc Genテンプレートとして設定する。
  1. Box Doc Gen APIを使用してドキュメントを生成する。