フォームへの計算フィールドの追加

Adobe Acrobat Sign には、契約書への署名時に署名者から入力されたデータに基づいて文書（契約書）内のフィールドを動的に更新できる機能が用意されています。これをおこなうには、計算フィールドを使用します。文書を署名のために送信する前に、計算フィールドを使用して、文書（または文書テンプレート）内のルールをセットアップすることができます。署名者が文書を操作したり、フィールド／値に基づいて文書を動的に更新したりすると、これらのルールが処理されます。

計算フィールドは、次の仕組みのいずれかを使って文書内に定義できます。

• Acrobat Sign フォームオーサリング環境
• Acrobat Sign テキストタグ（詳細については、テキストタグのドキュメントを参照）
• Adobe Acrobat PDF フォームフィールド（詳細については、『Acrobat 内でのフォームの作成リファレンスガイド』を参照）

計算フィールドのユースケース

計算フィールドは、文書を署名時に動的に更新する必要があるシナリオに使用できます。計算フィールドを使用できるユースケースのサンプルを以下にいくつか示します。なお、これらのユースケースは説明用のものです。

1. 注文フォームのセットアップ — 署名者が入手可能な商品のリストから選択して数量を指定できる注文フォームをセットアップするために、計算フィールドを使用できます。リストから商品を選択すると、選択した商品の価格がフォームに自動的に反映されます。さらに、署名者が数量を選択すると、商品の総額が自動的に計算されます。また、フォームには、注文の合計税額決定したり、顧客に対する割引のビジネスルールに基づいてボリュームディスカウントを計算したりするための、追加計算を組み込むこともできます｡

2. 契約期間満了日の自動入力 — 契約期間の長さ（6 ヶ月、12 ヶ月、24 ヶ月など）を署名時に顧客が選択できる契約書の場合、契約署名時の顧客の選択に基づいて契約の終了日を自動的に入力するために、計算フィールドを使用できます。

3. 複数の選択肢があるフォームのサインアップ — フォームの署名者が一連のオプションから選択できるサインアップフォーム（会員登録フォームなど）をセットアップするために、計算フィールドを使用できます。署名者が選んだ選択肢によって、署名者が同意している条件、契約期間、総費用といった、フォームの他の動的な側面が左右されることがあります。

計算フィールドの基礎知識

Acrobat Sign フォームにあるフォームフィールド、チェックボックスフィールド、ラジオボタンフィールドは計算フィールドとしてマークすることができます。署名時には、計算フィールドとして指定されたフィールドに署名者が値を直接入力することはできず、フォーム内に定義されたルールに基づいて計算フィールドの値が自動的に計算されます。

計算フィールドの定義は、式と書式の 2 つの要素から成ります。

計算フィールドは、Acrobat Sign テキストタグ、Acrobat Sign web アプリケーション、PDF フォームフィールドのいずれかを使って定義することができます。Acrobat Sign テキストタグまたは PDF フォームフィールドを使用して計算フィールドを定義する場合、計算式は「calc」というディレクティブを使って定義されます。計算フィールドの書式設定は、「format」というディレクティブを使って指定することができます。

例

{{someCalculatedField_es_:signer1:calc(someExpn):format(formatType, someFormat)}}

この例では、テキストタグを使用して「someCalculatedField」というフィールドを文書内に定義しています。このフィールドは、signer1 として識別される受信者に割り当てられます。このフィールドの値は、「someExpn」に指定された数式に基づいて計算されます。結果値の種類は「formatType」パラメーターで指定され、結果値は「someFormat」として定義された書式に基づいて書式設定されます。

Acrobat Sign web アプリケーションのオーサリング環境には、計算フィールドの式を定義するためのフル機能の式ビルダーが用意されています。式の作成の詳細については、「式ビルダーを使用して計算フィールドを指定する」を参照してください。

計算フィールドの式

式では、計算フィールドの値を決定するための数式／ルールを定義します。式は次の要素の 1 つ以上で構成されます。

サポートされている演算子

計算フィールドでサポートされている演算子は次のとおりです。

サポートされている関数

計算フィールド内で式を指定する際に使用できる関数は次のとおりです。

日付の各部を示す値

日付のうち、日付関連関数が演算対象となる部分を関数で指定する際に使用できる値は次のとおりです。

計算フィールドの書式設定

計算フィールドの式を指定する以外に、出力値の書式を設定することもできます。出力はテキスト（デフォルト）、数値、日付のいずれかに書式設定することができます。

テキストタグで使用する場合、書式ディレクティブは FormatType と Format の 2 つの引数を取ります。

計算フィールドを数値として書式設定する

数値形式での出力の書式設定を指定するには、次の文字を使用することができます。

計算フィールドを日付として書式設定する

日付形式での出力の書式設定を指定するには、次の文字を使用することができます。

書式設定の例

次の例では、日付および数値の計算フィールドを書式設定する方法を示しています。

• 日付として書式設定された計算フィールド：

{{myField_es_:calc(otherDateField + 3):format(date, "mmm dd, yyyy")}}

「May 22, 2016」のような出力になります。

• 数値として書式設定された計算フィールド：

{{myTax_es_:calc(total * taxrate):format(number, "$,.00") }}

「$1,987.65」のような出力になります。

式ビルダーを使用して計算フィールドを指定する

計算フィールドは、Acrobat Sign のオーサリング環境を通じて指定することができます。以下では、文書オーサリング環境で計算フィールドを定義する手順を説明します。

1. 文書にフィールドをドラッグアンドドロップします。追加したフィールドをダブルクリックして、フィールドプロパティダイアログを表示します。フィールドに適切な名前を付けます。ドロップダウンリストを使って、「値のタイプ」属性を「計算値」タイプに変更します。これで、署名時に計算に基づいてフィールド値が決定されます。

2. 計算式を「数式」というテキストフィールドに入力するか、関数ボタン（「fx」）をクリックして式ビルダーを表示します。

3. 式ビルダーを使用して、計算フィールドの式を定義します（下図を参照）。上部の式エリアには、フィールド値の計算に使用される式が表示されます。この式エリアに式を入力するか、文書オーサリング環境を使用して式を作成します。式ビルダーでは、使用可能なすべての関数のリスト、文書内の既存フォームフィールドのリスト、サポートされている演算子のリストを提供して、式の作成を支援します。式ビルダーのリストエリアで項目をダブルクリックして、フィールドまたは関数を式に追加できます。また、演算子リストで特定の演算子をクリックして、式に演算子を追加することもできます。

4. 式の定義が完了したら、「構文を確認」ボタンをクリックして式の構文をチェックした後、変更内容を保存することができます。

5. 「表示形式」ドロップダウンリストを使って、計算フィールドのタイプを設定します。

6. 「表示形式」の値が「日付」または「数値」の場合は、「日付フォーマット／数値形式」フィールドの値をドロップダウンリストを使って設定します。また、「カスタム」書式を選択して、フィールドのカスタム書式設定を定義することもできます。

通貨形式が指定された計算フィールド

計算フィールドの通貨形式により、計算値の前に通貨記号が挿入されます（それ以外の場合、計算は式で表されている単純な演算になります）。

挿入される記号は、次のルールに基づいています。

• ソースフィールドに米国の通貨検証が含まれている場合は、米国ドル記号 $ が表示されます
• ソースフィールドに英国の通貨検証が含まれている場合は、ポンド記号 £ が表示されます

通貨形式を機能させるには、計算フィールドを次のように設定する必要があります。

• 「表示形式」の値を「数値
  」に設定
• 「数値形式」の値を「通貨
  」に設定

計算で使用されるソースフィールドは、検証済みの「数値」または「通貨」のいずれかです。

計算フィールドの例

• {{shipState_es_:signer1:calc([billingState]):showif(sameAs=unchecked)}}
  • 最初の署名者に割り当てられるドキュメント内のフィールドで、「sameAs」という別のフィールド（チェックボックス）がオフになっている場合にのみ表示されます。このフィールドの値には、署名者が文書内で入力した「billingState」というフィールドの値が自動的に入力されます。
• {{total_es_:signer1:calc(q1*pr1):format(Number,”$,0.00”):align(right)}}
  • 最初の署名者に割り当てられる文書内のフィールドです。この値は、フィールド「q1」および「pr1」の値の積として自動的に計算されます。結果の値は通貨として書式設定され、結果の値の前にドル（$）記号が付けられ、小数点以下 2 位まで表示されます。また、結果の値はフィールド内で右揃えになります。
• price_es_:signer1:calc(if(pn1=”W1”,9.99,if(pn1=”W2”,5.99,if(pn1=”W3”,24.99,0))))}
  • 文書内の「price」というフィールドで、文書内の別のフィールド「pn1」で署名者により選択された値に基づいて計算されます。この例では、例えばフィールド「pn1」が W1 と等しい場合は、「price」フィールドに表示される値は「9.99」となり、フィールド「pn1」が W2 と等しい場合は、「price」フィールドに表示される値は「5.99」となります。どの値もフィールド「pn1」の値に一致しない場合、「price」フィールドに表示される値は "0" になります。この仕組みにより、計算フィールドを使用して、署名時に署名者がおこなった選択に基づいて商品の価格を自動的に入力することができます。