Skip to main content
Box Doc Genでは、さまざまなタイプのフォームフィールドを使用して、PDFテンプレートからドキュメントを生成できます。 この記事では、サポートされている各フィールドタイプと、ドキュメントの生成時にそのフィールドに入力する方法について説明します。

サポートされているフィールドタイプ

Box Doc Genでは、PDFテンプレート内の以下のフィールドタイプをサポートしています。
  • テキストフィールド
  • ラジオボタン
  • チェックボックス
  • ドロップダウン
この記事の例では、上記すべてのフィールドタイプを含むイベント登録フォームを使用しています。

生成方法ごとのサポート状況

各フィールドタイプのサポート状況は、ドキュメントの生成方法によって異なります。
PDFテンプレートは、Box for Salesforceアプリでサポートされていません。
次の例は、Box Doc Genでサポートされている各フィールドタイプを含む、入力済みのイベント登録フォームです。
テキストフィールド、チェックボックス、ラジオボタン、ドロップダウンを使用したイベント登録フォーム。

テキストフィールド

Box Doc Genにより、PDFテンプレート内のテキストフィールドは、指定した値に置き換えられます。 ドキュメント生成リクエストの一部として、フィールド名とその値を渡します。 APIを使用してドキュメントを生成するには、APIコールで使用するJSONスキーマでフィールド名とその値を渡します。 例えば、firstnameという名前のテキストフィールドに入力するには、次のように指定します。

ラジオボタン

ラジオボタンでは、グループ内のオプションを1つだけ選択できます。 この例のフォームにある [Session Preference (セッションの設定)] では、[Morning (午前)]、[Afternoon (午後)]、[Evening (夜)] というラジオボタンが使用されています。 [Afternoon (午後)] を選択すると、他のオプションは自動的に選択解除されます。 仕組み:
  • グループ名と、選択したいオプションを指定します。 値は、PDF内で定義されているオプションと完全に一致している必要があり、大文字と小文字が区別されます。
  • グループ内の1つのオプションが選択されます。
  • 以前に選択されていたオプションがあれば、自動的に選択解除されます。
対応していない操作:
  • 同じグループ内で複数のオプションを選択すること。 ラジオボタンは単一選択のみです。
  • すべてのオプションを選択解除すること。 フィールドを省略した場合は、警告が表示されることなく、テンプレートのデフォルト値が選択されたままになります。
  • 近似一致。 例えば、afternoonAfternoonは一致していません。
APIを使用してドキュメントを生成するには、JSONスキーマでフィールド名とその値を渡します。 例えば、SessionPreferenceラジオボタングループ内のオプションを選択するには、次のように指定します。
次の表では、値が無効な場合や値が指定されていない場合の動作について説明しています。

チェックボックス

チェックボックスを使用すると、PDFフォーム内で1つ以上のオプションを選択またはクリアできます。 この例のフォームにある [Language Preferences (言語の設定)] では、チェックボックスを使用しています。[English (英語)] と [German (ドイツ語)] はオン、[French (フランス語)]、[Spanish (スペイン語)]、[Mandarin (標準中国語)] はオフになっています。 仕組み:
  • 各チェックボックスは、名前ごとに true (オン) またはfalse (オフ) に設定します。 各チェックボックスは、独立したフィールドです。
  • 各チェックボックスは、個別にオンまたはオフにできます。
  • ラジオボタンとは異なり、同時に複数のチェックボックスをオンにできます。
  • チェックボックスをfalseに設定すると、テンプレートでそのチェックボックスがデフォルトでオンになっていても、明示的にオフになります。
対応していない操作:
  • trueまたはfalse以外の値を渡すこと。 yes1のような値は認識されません。
  • 1つのフィールド名で複数のチェックボックスを制御すること。 各チェックボックスには個別の入力が必要です。
APIを使用してドキュメントを生成するには、JSONスキーマでフィールド名とその値を渡します。 例えば、Englishというチェックボックスをオンにして、Frenchというチェックボックスをオフにするには、次のように指定します。
次の表では、値が無効な場合や値が指定されていない場合の動作について説明しています。

ドロップダウン

Box Doc Genでは、生成されるドキュメント内のドロップダウンメニューのオプションを設定できます。 ドロップダウンフィールドでは、固定のリストから値を選択できます。 この例のフォームでは、[Country (国)]、[Dietary Requirements (食事制限)]、[T-Shirt Size (Tシャツのサイズ)] がドロップダウンになっています。 選択できるのはすでにリストに存在する値のみで、任意の値を入力することはできません。 仕組み:
  • フィールド名と、選択したいオプションを指定します。 値は、利用可能なオプションのいずれかと完全に一致している必要があり、大文字と小文字が区別されます。
  • リスト内の1つのオプションが選択されます。
  • 値を指定しなかった場合、Box Doc Genでは、警告が表示されることなく、テンプレートのデフォルト値が使用されます。
対応していない操作:
  • 複数のオプションを選択すること。 サポートされているのは、単一選択のみです。
  • あらかじめ定義されたリストに存在しない自由形式のテキストを入力すること。
  • 近似一致。 例えば、united kingdomUnited Kingdomは一致していません。
APIを使用してドキュメントを生成するには、JSONスキーマでフィールド名とその値を渡します。 例えば、ドロップダウンメニューの値を設定するには、次のように指定します。
次の表では、値が無効な場合や値が指定されていない場合の動作について説明しています。
最終更新日 2026年8月19日