テキストタグ - 基本と構文

テキストタグが必要とする正確な構造を理解して、フィールドが正しく認識され、期待どおりに動作するようにします。

テキストタグを使用すると、構造化されたプレースホルダーを文書に直接入力してフォームフィールドを作成できます。高速で強力ですが、構文が正確な場合にのみ機能します。

このページでは、テキストタグの必要な構造、各部分の機能、タグが正しく認識されるために従う必要があるルールについて説明します。

必須タグの囲み（波括弧）

すべてのテキストタグは二重波括弧で囲む必要があります：

{field-name_es_:signer-role:field-type:directive1:directive2}}

波括弧は必須で、次の 2 つの目的があります。

• Acrobat Sign にテキストタグの開始位置と終了位置を伝えます。
• 生成されるフィールドの初期幅と高さを定義します。
  • 最初の括弧のサイズ（フォント）がフィールドの高さを決定します。 
    • 最初の括弧のフォントサイズが大きいほど、フィールドが高くなります。
    • タグの残りの部分は異なるフォントサイズでも構いませんが、2 pt 以上にする必要があります。
  • 括弧間のスペース（括弧自体を含む）がフィールドの全体的な幅を決定します。 
    • 括弧間のスペースが広いほど、フィールドが幅広くなります
    • 空白文字もカウントされます。

波括弧が欠けているか形式が正しくない場合、テキストは通常のテキストとして扱われ、フィールドは作成されず、アップロード後にフォームにタグのテキストが表示されます。

テキストタグの概要とその使用時期については、テキストタグの概要を参照してください。

テキストタグの必要な構造

波括弧内では、すべてのテキストタグは次の構造に従う必要があります：

field-name_es_:signer-role:field-type:directive1:directive2

この構造は厳密です。要素の順序を変更したり、必要な部分を省略したりすると、エラーが表示されずに失敗したり、意図しない動作が発生したりする可能性があります。

必須要素（指定された順序で）

フィールド名

フィールド名は、Acrobat Sign のフォームフィールドを特定します。

• 文書内で一意である必要があります。
• スペースを含めないでください。
• レポーティングとデータ抽出に使用されます。

_es_ 識別子

_es_ 識別子は、テキストがテキストタグを表すことを Acrobat Sign に伝えます。

• _es_ は必須です。
• これがないと、タグは通常のテキストとして扱われます。

署名者ロール

署名者ロールは、フィールドがどの受信者に属するかを定義します。

• 常に署名者ロールを含めてください。
• 署名者ロールには、フィールドが対象とする受信者を示す番号を含める必要があります。 

サポートされている署名者ロール

テキストタグでは、位置指定署名者ロールを使用して受信者にフィールドを割り当てます。

サポートされている署名者ロール形式は次のとおりです：

:signerN

N は 1 から始まる数字で、署名順序における受信者の位置に対応します。

例：

• :signer1 — 最初の受信者
• :signer2 — 2 番目の受信者
• :signer3 — 3 番目の受信者

テキストタグ自体に上限制限はありません。署名者ロールは、フィールドが割り当てられるために、契約書の実際の受信者に対応している必要があります。

テキストタグは、名前付きまたはセマンティックロールをサポートしていません。位置指定の署名者ロールのみが認識されます。

このルールの例外は :prefill ロールです：

• :prefill — 契約書の送信者に割り当てられるフィールドで、契約書の送信後、最初の署名者に通知される前に入力する必要があります。
  • この位置は実際の署名サイクルより前に発生するため、数字は使用されません。

フィールドタイプ

フィールドタイプは、作成されるフォームフィールドのタイプを決定します。

一般的な例：

• :text
• :signature
• :date
• :checkbox

サポートされているフィールドタイプのみが認識されます。サポートされていないフィールドタイプは無視されます。

完全なリストとフィールド固有の動作については、テキストタグでサポートされているフィールドタイプを参照してください。

ディレクティブ（オプション）

ディレクティブは、フィールドの動作を変更します。

次に、例を示します。

• :required
• :tooltip()
• :readOnly
• :calc()
• :format()

ディレクティブはフィールドタイプの後に記述し、正しい構文に従う必要があります。

複雑なディレクティブの相互作用については、テキストタグの高度な動作を参照してください。

例：完全で有効なテキストタグ

{full_name_es_:signer1:text:required:tooltip(Enter your full legal name)}}

このタグ：

• 波括弧を使用してフィールドの境界とサイズを定義します
• テキストフィールドを作成します
• 最初の署名者に割り当てます
• それを必須にします
• 署名者にツールチップを表示します

その他のシンプルな例と複合例については、テキストタグの例を参照してください。

早期に理解すべき重要なルール

テキストタグは設計上、厳密です。次のルールに留意してください。

• タグは文書がアップロードされるときに処理されます。
• オーサリング時の検証はありません。
• エラーは警告を生成しません。
• 不正な形式のタグはプレーンテキストとして扱われます。

何かが動作しない場合は、まず構文の問題を疑い、テキストタグのトラブルシューティングを確認してください。