Microsoft Word用Box Doc Gen Template Creatorアドインを使用すると、チームは、Box Doc Genプレースホルダタグを使用したBox Doc Genテンプレートの作成および編集ができます。このテンプレートにより、Box Doc Gen APIを使用してカスタムアプリケーションおよびサードパーティ製アプリケーションからのデータをもとに動的にコンテンツを生成したり、自動的に書式設定されたドキュメントを生成できるようになります。
このアドインにより、条件付きロジック、算術計算、動的に書式設定が適用される表やリストを作成し、カスタムドキュメントを動的に生成することができます。
Box Doc Genテンプレートを構成する際、構造化されたJSONデータをアップロードしてコンテンツにタグを入力することも、手動でタグを作成することもできます。
この記事では、挿入可能なタグを手動で生成する方法について説明します。
前提条件
Box Doc Genテンプレートの作成を開始する前に、Microsoft Word用Box Doc Gen Template Creatorアドインをインストールしてください。 アドインは、インストールに成功すると、Microsoft Word内のリボンメニューに表示されます。 選択すると、Box Doc Genパネルが右側に表示されます。
Box Doc Genテンプレートの作成
Box Doc Genテンプレートを作成するには、以下の手順に従います。
- 既存のMicrosoft Wordドキュメントを開くか、新しいドキュメントを作成します。 Microsoft WordデスクトップアプリケーションもMicrosoft Wordオンライン版も使用できます。
- Box Doc Genテンプレートの一部として、コンテンツの下書き作成および構成を開始します。
- 下書きが完成したら、Box Doc Gen Template Creatorアドインを使用してBox Doc Genの変数を挿入します。 [独自のタグを作成] を選択して、タグを新たに作成します。
手動によるタグの作成
Box Doc Genテンプレートの作成では、[ドキュメントタグ]、[ロジック]、[表と箇条書き] のほか、[Box Signタグ] も使用できます。
テキストタグ
テキストタグをBox Doc Genテンプレートに追加すると、ドキュメントの生成処理中にBox Doc Genによって動的に自動入力できます。
テキストタグの種類には、テキスト、日付、数字が含まれます。
テキストタグを作成するには、以下の手順に従います。
- [テキストタグ] セクションで [新規作成] をクリックします。
- タグ名を指定します (例: companyName)。
- 種類を選択します (例: [テキスト])。
- [タグを作成] をクリックします。
これにより、以下に示すようにテキストタグ (companyName) が作成されます。 このタグをMicrosoft Wordドキュメントに追加するには、動的テキストを挿入する位置にカーソルを移動し、テキストタグ名をクリックしてタグを適用します。
テンプレートに追加できるBox Doc Genテンプレートタグのリストや詳細な手順については、Box Doc Genテンプレートへのタグの追加に関する記事を参照してください。
画像タグ
画像タグをBox Doc Genテンプレートに追加すると、ドキュメントの生成処理中にBox Doc Genによって動的に自動入力できます。
画像タグを作成するには、以下の手順に従います。
- [画像タグ] セクションで [新規作成] をクリックします。
- タグ名を指定します (例: companyLogo)。
- 画像のBase64コードを指定します。
- 必要に応じて、代替テキスト、高さ、幅を指定します。
- [タグを作成] をクリックします。
これにより、画像タグ (companyLogo) が作成されます。 この画像タグをMicrosoft Wordドキュメントに追加するには、画像を挿入する位置にカーソルを移動し、タグをクリックして適用します。 指定したサイズのプレースホルダ画像がドキュメントに挿入されます。
プレースホルダ画像の代替テキストを表示すると、プレースホルダの代替テキストには、指定した代替テキストとともにcompanyLogoの画像パスが含まれます。 APIリクエストを作成してドキュメントを生成する場合、companyLogoに対するJSONデータにはBase64形式の画像の値が含まれます。
例:
{
"image-path": "companyLogo”,
"alt-text": "ここに代替テキストを入力"
}
次のステップ
次の手順では、作成されたBox Doc Genタグをテンプレートに追加します。 Box Doc Genタグを使用すると、動的なテキスト、画像、表、リスト、計算、コンテンツのブロック、条件付きロジックなどを挿入できます。