Box Status
印刷

テンプレートタグの追加

End User , Established , P4 , Box Doc Gen

JSONデータからまたはBox Doc Gen Template CreatorアドインでBox Doc Genテンプレートタグを生成したら、それらのタグをドキュメントに挿入できます。

Box Doc Genテンプレートタグを使用すると、テキスト、画像、表、リスト、計算、条件付きロジックなどを動的に挿入できます。

以下のJSONデータのサンプルに、テンプレート内でタグとして使用できるフィールドを示します。

{

    "order": {

        "id": "Inv1203",

        "date": "18-08-2023",

        "customerName": "Example Corporation",

        "currency": "$",

        "amount": 5060.5,

        "billingAddress": {

            "street": "Example street",

            "city": "Example city",

            "zip": "EX-456"

        },

        "products": 

            {

                "id": 1,

                "name": "A4用紙",

                "quantity": 100,

                "price": 29,

                "amount": 2900

            },

            {

                "id": 2,

                "name": "インクカートリッジ",

                "quantity": 40,

                "price": 39,

                "amount": 1560

            },

            {

                "id": 3,

                "name": "接着テープ",

                "quantity": 20,

                "price": 30,

                "amount": 600.5

            }

        ]

    }

}

テキストタグ

テキストタグの種類には、テキスト、日付、または数字が含まれます。

テキストタグを挿入するには:

  1. Box Doc Gen Template Creatorアドインで、[ドキュメントタグ] > [テキストタグ] に移動します。
  2. ドキュメント内のテキストタグを挿入する場所 (例: order.id) にカーソルを配置します。
  3. テキストタグをクリックします。

この操作により、{{order.id}} テキストタグがドキュメントの指定した場所に挿入されます。 テンプレートタグのその他の例については、テンプレートタグのリファレンスガイドと例を参照してください。

注: Box Doc Genテンプレートタグでは、タグ内のキーワード間のスペースまたはハイフンがサポートされていません。 例えば、{{company name}} や {{company-name}} はサポートされません。

画像タグ

画像タグをBox Doc Genテンプレートに追加すると、ドキュメントの生成処理中にBox Doc Genによって動的に自動入力するようにできます。 JSONデータのBase64エンコード文字列は、Box Doc Gen Template Creatorアドインによって自動的に画像として認識され、ドキュメントに画像が適用されます。

画像タグを挿入するには:

  1. Box Doc Gen Template Creatorアドインで、[ドキュメントタグ] > [画像タグ] に移動します。
  2. ドキュメント内の画像タグを挿入する場所にカーソルを配置します。
  3. 画像タグをダブルクリックして挿入します。

この操作により、プレースホルダ画像が挿入されます。この画像は、Box Doc Gen API、ワークフロー、その他の上流システムによる入力データに動的に置き換えられます。

注: プレースホルダ画像のサイズと配置は、Microsoft Wordの機能を使用して変更でき、 これらのプロパティは出力ドキュメントで維持されます。 また、画像を挿入する前に、[幅]、[高さ]、[代替テキスト] などのプロパティを定義することもできます。

表とリスト

入力データの配列を使用して、表またはリストを動的に作成できます。 請求書の項目、発注リスト、注文書などのデータを表に動的に反映させることができます。

以下に例を示します。

  • productsは、動的な表またはリストとして表示することができる配列です。
  • id、name、quantity、price、amountは、配列内の変数であり、個々の列として動的な表に表示されます。

表の挿入

  1. Box Doc Gen Template Creatorアドインで、[表と箇条書き] > [表] に移動します。
  2. [表レコード] セクションで、JSONデータに含まれている配列 (例: products) を表示します。
  3. 表のデータを提供する配列を選択します。
  4. [列レコード] で、列となるフィールド (例: id、name、quantity、price) を選択します。
  5. [表を挿入] をクリックします。

この操作により、動的なフィールド (id、name、quantity、price) を含む表が挿入されます。

リストの挿入

  1. Box Doc Gen Template Creatorアドインで、[表と箇条書き] > [リスト] に移動します。
  2. [書式設定] で、リストに [箇条書き]、[番号]、または [書式設定なし] を指定します。 [箇条書き] または [番号] を選択した場合は、さらに、これらのリストの種類に [スタイル] を選択します。
  3. [リストレコード] で、リストに設定する項目が保持されている配列を選択します。
  4. [フィールド] で、リスト項目となる値を選択します。
  5. [リストを挿入] をクリックします。

タグのその他の例については、テンプレートタグのリファレンスガイドと例を参照してください。

ロジック

条件

条件付きロジックを使用すると、ドキュメントの生成プロセスで得られるデータまたは条件に基づいて、コンテンツを表示したり非表示にしたりできます。 これを使用して、ドキュメントのセクションを含めたり除外したりできます。

条件を挿入するには:

  1. Box Doc Gen Template Creatorアドインで、[ロジック] > [条件] に移動します。
  2. IFステートメントで、[フィールド] と [値] を使用して必要な条件を作成します (例: 国コードがUSの場合)。
  3. AND演算子またはOR演算子を使用して、さらに条件を追加することもできます。
  4. 別のステートメントを追加するには、ELSE IF演算子を使用して、さらに条件を追加します。
  5. IFおよびELSE IFに一致しない条件には、ELSEを使用します。

表を伴う条件

Doc Genでは、表や画像など、任意のコンテンツを条件に応じて表示できます。

{{ if invoice.customerId isPresent }}

ID 名前 数量 価格
{{tablerow item in invoice.items}}
{{item.id}} {{item.name}} {{item.quantity}} {{item.price}}
{{endtablerow}}

{{ endif }}

 

計算

Box Doc Genテンプレートは動的な計算をサポートしています。 手動でタグ付け言語に計算コードを書き込むか、Box Doc Gen Template Creatorアドインを使用することができます。

例:

  • 請求書の個々の明細項目から正味請求額の合計を決定する: Sum (請求書の個々の明細項目の金額)
  • 最大調達額の上限を設定する: 5% * 正味発注額

計算を挿入するには:

  1. Box Doc Gen Template Creatorアドインで、[ロジック] > [計算] に移動します。
  2. [フィールド] で、算術/集約演算を実行するためのタグを選択します。
  3. 最初のフィールドと次のフィールドの間で実行する演算を選択します。
  4. 次のタグを選択します。
  5. 集計演算を実行するには、特定のタグに [fx] (関数) ドロップダウンメニューを選択し、集約演算を選択します。
  6. 計算を組み立てると、作成した式の簡単なプレビューがプレビューセクションに表示されます。
  7. 式を挿入するには、[計算を挿入] をクリックします。

タグのその他の例については、テンプレートタグのリファレンスガイドと例を参照してください。

Box Signタグ

生成したドキュメントを電子サインまたは承認用に送信する場合は、Box SignテンプレートタグをBox Doc Genテンプレートに追加できます。

Box Signテンプレートタグを挿入するには:

  1. Box Doc Gen Template Creatorアドインで、[Box Signタグ] に移動します。
  2. Box Doc Genテンプレートで生成した最終的なドキュメントの署名または承認に必要な [受信者数] を選択します。
  3. 生成したドキュメントに対して署名または承認を行う必要がある受信者ごとに、Box Signテンプレートタグを挿入できます。
    1. Box Signテンプレートタグを選択すると、選択した受信者によるフィールドへの入力または署名が必須か省略可能かを指定することもできます。
    2. テキスト、日付、署名のフィールドのサイズは、フォントのサイズを調整することで縦方向に、中括弧の間にスペースを追加することで横方向に変更できます。
    3. 最適な結果を得るには、タグを表に挿入するか、ドキュメントの本文とは異なるテキストスタイルを使用するようタグを変更します。
  4. 必要なBox Signテンプレートタグをテンプレートにすべて挿入したら、最終的なドキュメントの生成されたBox Signフィールドにタグが表示されないようにタグのフォントの色を白に変更し、署名フィールドでのみ置き換えられるようにします。
注: Box Signテンプレートタグ内で署名の順序を設定することはできません。 署名の順序は、Box Signテンプレートタグのプロパティを定義する際に、Box Doc Gen Template Creatorアドインで設定する必要があります。 Box Signテンプレートタグに表示される数字は、ドキュメント内の受信者を示すものであり、署名の順序を示すものではありません。

テンプレートタグのその他の例

タグのその他の例については、テンプレートタグのリファレンスガイドと例を参照してください。

関連記事