この記事には、プレリリース情報が含まれています。リリース日、機能、および他の情報は予告なく変更される可能性があります。
受信者が制限付きの「Y 個中 X 個」オプションを選択できるようにします。回避策や推測に頼る必要はありません。
チェックボックスグループを使用すると、構造化され、ルールにバインドされた選択を取得できます。例えば、「3 つの特典を選択」、「少なくとも 2 つの選択科目を選択」、「最大 5 つの希望を選択」などです。カスタムスクリプトやレビュアーとのやり取りは必要ありません。
チェックボックスグループは、API を介して(PUT /agreements/{agreementID}/formFields エンドポイントを使用して)契約書フィールドが配置されている場合にのみ設定できます。
設定
利用対象:
- Acrobat Standard および Acrobat Pro:未サポート
- Acrobat Sign Solutions:サポート対象
- Acrobat Sign for Government:サポート対象
仕組み
チェックボックスグループは、グループ名および検証ルールを共有する 2 つ以上のチェックボックスのセットです。 検証ルールでは、受信者に次の選択を要求します。
- X 個のオプション
- 少なくとも X 個のオプション
- 最大 X 個のオプション
- N 個のうち範囲 X~Y 個のオプション
各チェックボックスには、独自のフィールド名、デフォルト状態、スタイルがあります。
ルールは、受信者がボックスを選択するときにライブで適用され、送信時に再度適用され、選択がルールを満たすまで完了を防止します。完了した契約では、各チェックボックスの状態が表示されます。
チェックボックスグループの作成(署名リクエスト)
現在、チェックボックスグループは、REST v6 API PUT /agreements/{agreementID}/formFields エンドポイントを使用して、次のように formFieldGroups パラメーターを入力することでのみ契約書にオーサリングできます。
{ "formFieldGroups": [ { "validationRule": { "minSelection": 0, "maxSelection": 0 }, "fieldNames": [ "string" ], "name": "string" } ]
明確なフォームのためのヒント
- 各チェックボックスには、短く明確なフィールド名を使用してください。
- 意図に合う最も狭いルールを選択してください(例:「範囲 2~2」ではなく「正確に 2」)。
- デフォルト値は、一般的な選択を反映し、ルール内に収まる場合にのみ設定してください。
署名エクスペリエンス
- 従来の電子サインでは、受信者がオプションを選択するとき、および送信時、明確なインライン検証メッセージとともに、グループの検証ルールが適用されます。 ルールが満たされない場合、受信者は完了できません。
- 新しい電子サインエクスペリエンスが有効で、受信者にチェックボックスグループが割り当てられている場合、受信者エクスペリエンスは、(新しい電子サインがこの機能をサポートするまで)従来の電子サイン環境にフォールバックします。
データの書き出し
- データの書き出しでは、独自のフィールド名およびオン/オフ状態を持つ各チェックボックスが一覧表示されます。
- グループのメタデータは書き出しに含まれません。それに応じて、後ろの処理を計画してください。
既知の制限
- 条件付きロジックと計算は、グループ全体ではなく個々のチェックボックスに適用されます。
- チェックボックスグループを使用するドキュメントのオーサリング中は、モバイルフォーカスモードはサポートされていません。
互換性とフォールバック
- 従来のオーサリングはチェックボックスグループをサポートしていません。グループを含むドキュメントを従来のオーサリングで開くと、グループ化されたフィールドは独立したチェックボックスとして表示され、グループルールは警告なしに失われます。
- 2025 年 10 月のリリース時点で、API を介して作成された「署名を依頼」契約書の作成がサポートされています。ライブラリテンプレート、web フォーム、一括送信のサポートは、後のマイルストーンで予定されています。それまでは、グループルールがこれらのフローに持ち込まれると想定しないでください。
- 新しいオーサリングで、グループを含んだ文書に関する警告が表示された場合は、プロンプトに従うか、新しいオーサリングで「署名を依頼」を使用してください。