フォームデータの計算

Formsサービスでは、ユーザーがフォームに入力した値を計算し、結果を表示できます。 フォームデータを計算するには、2つのタスクを実行する必要があります。 まず、フォームデータを計算するフォームデザインスクリプトを作成します。 フォームデザインは、3種類のスクリプトをサポートしています。 1つのスクリプトタイプはクライアントで実行され、別のスクリプトタイプはサーバーで実行され、3つ目のスクリプトタイプはサーバーとクライアントの両方で実行されます。 このトピックで説明されているスクリプトタイプは、サーバー上で実行されます。 サーバー側の計算は、HTML、PDF、およびForm Guide(非推奨)の変換に対してサポートされています。

フォームデザインのプロセスの一環として、演算とスクリプトを使用し、ユーザーの操作性を向上させることができます。 演算とスクリプトは、フォーム内のほとんどのフィールドとオブジェクトに追加できます。 ユーザーがインタラクティブフォームに入力したデータに対して演算操作を実行するには、フォームデザインのスクリプトを作成する必要があります。

ユーザーがフォームに値を入力し、「Calculate」ボタンをクリックして結果を表示します。 次のプロセスは、ユーザーにデータの計算を許可するアプリケーションの例を説明しています。

  • ユーザーがStartLoan.htmlというHTMLページにアクセスし、Webアプリケーションの開始ページとして機能します。 このページは、という名前のJavaサーブレットを呼び出 GetLoanFormします。
  • サーブレットはローンフォームをレンダリングします。 GetLoanForm このフォームには、スクリプト、インタラクティブフィールド、計算ボタン、送信ボタンが含まれています。
  • ユーザーがフォームのフィールドに値を入力し、「計算」ボタンをクリックします。 フォームが CalculateData Javaサーブレットに送信され、スクリプトが実行されます。 フォームがユーザーに送り返され、計算結果がフォームに表示されます。
  • ユーザは、満足のいく結果が表示されるまで値の入力と計算を続けます。 問題が解決したら、「送信」ボタンをクリックしてフォームを処理します。 送信されたデータを取得する別のJavaサーブレット ProcessForm に、フォームが送信されます。 (提出したFormsの 処理を参照)。

次の図に、アプリケーションのロジックのフローを示します。

cf_cf_finsrv_loancalcapp_v1

次の表に、この図の手順を示します。

ステップ

説明

1

HTML開始ページから GetLoanForm Javaサーブレットが呼び出されます。

2

Javaサーブレットは、FormsサービスのクライアントAPIを使用して、ローンフォームをクライアントWebブラウザーにレンダリングします。 GetLoanForm サーバー上で実行するように設定されたスクリプトが含まれるフォームのレンダリングと、スクリプトが含まれないフォームのレンダリングの違いは、スクリプトの実行に使用するターゲットの場所を指定する必要があるということです。 ターゲットーの場所を指定しない場合、サーバー上で実行するように設定されたスクリプトは実行されません。 例えば、この節で紹介するアプリケーションについて考えてみましょう。 Javaサーブレットは、 CalculateData スクリプトが実行されるターゲットの場所です。

3

ユーザーがインタラクティブフィールドにデータを入力し、「計算」ボタンをクリックします。 フォームが CalculateData Javaサーブレットに送信され、スクリプトが実行されます。

4

フォームがWebブラウザーにレンダリングされ、計算結果がフォームに表示されます。

5

値が十分な場合は、「送信」ボタンをクリックします。 フォームは、という別のJavaサーブレットに送信され ProcessFormます。

通常、PDFコンテンツとして送信されるフォームには、クライアント上で実行されるスクリプトが含まれます。 ただし、サーバー側の計算を実行することもできます。 「送信」ボタンは、スクリプトの計算には使用できません。 この場合、Formsサービスがインタラクションを完了と見なすので、計算は実行されません。

フォームデザインのスクリプトの使用方法を説明するために、この節では、サーバー上で実行するように設定されたスクリプトを含むシンプルなインタラクティブフォームについて調べます。 次の図に示すフォームデザインには、ユーザーが最初の2つのフィールドに入力した値を追加し、その結果を3つ目のフィールドに表示するスクリプトが含まれています。

cf_cf_caldata

A. NumericField1という名前のフィールド B. NumericField2という名前のフィールド C. NumericField3という名前のフィールド

このフォームデザインにあるスクリプトの構文は次のとおりです。

     NumericField3 = NumericField2 + NumericField1

このフォームデザインでは、「計算」ボタンはコマンドボタンで、スクリプトはこのボタンの Click イベントにあります。 ユーザーが最初の2つのフィールド(NumericField1とNumericField2)に値を入力し、「Calculate」ボタンをクリックすると、フォームがFormsサービスに送信され、そこでスクリプトが実行されます。 Formsサービスは、フォームをクライアントデバイスにレンダリングし返し、計算の結果をNumericField3フィールドに表示します。

メモ

フォームデザインスクリプトの作成について詳しくは、「 Formsデザイナ」を参照してください。

メモ

For more information about the Forms service, see Services Reference for AEM Forms.

手順の概要

フォームデータを計算するには、次のタスクを実行します。

  1. プロジェクトファイルを含めます。
  2. FormsクライアントAPIオブジェクトを作成します。
  3. 演算スクリプトを含むフォームを取得します。
  4. フォームデータストリームをクライアントのWebブラウザーに書き戻します

プロジェクトファイルを含める

必要なファイルを開発プロジェクトに含めます。 Javaを使用してクライアントアプリケーションを作成する場合は、必要なJARファイルを含めます。 Webサービスを使用している場合は、プロキシファイルを必ず含めてください。

FormsクライアントAPIオブジェクトの作成

プログラムでFormsサービスのクライアントAPI操作を実行する前に、Formsサービスクライアントを作成する必要があります。 Java APIを使用している場合は、 FormsServiceClient オブジェクトを作成します。 FormsWebサービスAPIを使用している場合は、 FormsServiceService オブジェクトを作成します。

演算スクリプトを含むフォームの取得

FormsサービスクライアントAPIを使用して、サーバー上で実行するように設定されたスクリプトが含まれるフォームを処理するアプリケーションロジックを作成します。 このプロセスは、送信されたフォームの処理と似ています。 (提出したFormsの 処理を参照)。

送信されたフォームに関連付けられている処理状態が 1 (Calculate)、つまり、Formsサービスがフォームデータに対して計算操作を実行しており、結果をユーザーに書き戻す必要があることを確認します。 この場合、サーバー上で実行するように設定されたスクリプトが自動的に実行されます。

フォームデータストリームをクライアントのWebブラウザーに書き戻します

送信されたフォームに関連付けられている処理状態が正しいことを確認した後 1、結果をクライアントのWebブラウザーに書き戻す必要があります。 フォームが表示されると、計算値が適切なフィールドに表示されます。

関連項目

AEM Forms Java ライブラリファイルを含める
フォームデータの計算Java API フォームデータWebサービスAPI接続プロパティの設定接続プロパティの設定WebサービスAPI FormsサービスAPI開始の計算クイックFormsの計算インタラクティブPDF formsの作成Web アプリケーションの使用

Java APIを使用してフォームデータを計算する

FormsAPI(Java)を使用してフォームデータを計算するには:

  1. プロジェクトファイルを含める

    Javaプロジェクトのクラスパスに、adobe-forms-client.jarなどのクライアントJARファイルを含めます。

  2. FormsクライアントAPIオブジェクトの作成

    • 接続プロパティを含む ServiceClientFactory オブジェクトを作成します。
    • Create an FormsServiceClient object by using its constructor and passing the ServiceClientFactory object.
  3. 演算スクリプトを含むフォームの取得

    • 演算スクリプトを含むフォームデータを取得するには、コンストラクターを使用し、コンストラクター内からオブジェクトの com.adobe.idp.Document メソッドを呼び出して、 javax.servlet.http.HttpServletResponse getInputStream オブジェクトを作成します。

    • オブジェクトの FormsServiceClient processFormSubmission メソッドを呼び出し、次の値を渡します。

      • フォームデータを含む com.adobe.idp.Document オブジェクトです。
      • 関連するすべてのHTTPヘッダーを含む環境変数を指定するstring値。 処理するコンテンツタイプを指定するには、 CONTENT_TYPE 環境変数に1つ以上の値を指定する必要があります。 例えば、XMLデータとPDFデータを処理するには、このパラメーターに次の文字列値を指定します。 CONTENT_TYPE=application/xml&CONTENT_TYPE=application/pdf
      • ヘッダー値を指定するstring値 HTTP_USER_AGENT 。例えば、 Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1; SV1; .NET CLR 1.1.4322)
      • 実行時オプションを格納する RenderOptionsSpec オブジェクト。

      この processFormSubmission メソッドは、フォーム送信の結果を含む FormsResult オブジェクトを返します。

    • 送信されたフォームに関連付けられている処理状態が、 1 オブジェクトの FormsResult getAction メソッドを呼び出して確認します。 このメソッドが値を返す場合 1、計算が実行され、データをクライアントWebブラウザーに書き戻すことができます。

  4. フォームデータストリームをクライアントのWebブラウザーに書き戻します

    • フォームデータストリームをクライアントのWebブラウザーに送信するために使用する javax.servlet.ServletOutputStream オブジェクトを作成します。
    • オブジェクトの com.adobe.idp.Document メソッドを呼び出して、 FormsResult オブジェクトを作成し getOutputContent ます。
    • オブジェクトの java.io.InputStream メソッドを呼び出して、 com.adobe.idp.Document オブジェクトを作成 getInputStream します。
    • バイト配列を作成し、 InputStream オブジェクトの read メソッドを呼び出して、バイト配列を引数として渡すことで、フォームデータストリームを設定します。
    • オブジェクトの javax.servlet.ServletOutputStream write メソッドを呼び出して、フォームデータストリームをクライアントのWebブラウザーに送信します。 バイト配列を write メソッドに渡します。

関連項目

AEM Forms Java ライブラリファイルを含める
接続プロパティの設定

WebサービスAPIを使用してフォームデータを計算する

FormsAPI(Webサービス)を使用してフォームデータを計算するには:

  1. プロジェクトファイルを含める

    • FormsサービスのWSDLを使用するJavaプロキシクラスを作成します。
    • クラスパスにJavaプロキシクラスを含めます。
  2. FormsクライアントAPIオブジェクトの作成

    オブジェクトを作成し、認証値を設定し FormsService ます。

  3. 演算スクリプトを含むフォームの取得

    • Javaサーブレットに投稿されたフォームデータを取得するには、コンストラクタを使用して BLOB オブジェクトを作成します。

    • オブジェクトの java.io.InputStream メソッドを使用して、 javax.servlet.http.HttpServletResponse オブジェクトを作成し getInputStream ます。

    • Create a java.io.ByteArrayOutputStream object by using its constructor and passing the length of the java.io.InputStream object.

    • オブジェクトの内容を java.io.InputStream オブジェクトにコピー java.io.ByteArrayOutputStream します。

    • オブジェクトのメソッドを呼び出して、 java.io.ByteArrayOutputStream バイト配列を作成し toByteArray ます。

    • メソッドを呼び出し、バイト配列を引数として渡して、 BLOB setBinaryData オブジェクトを入力します。

    • コンストラクタを使用して RenderOptionsSpec オブジェクトを作成します。オブジェクトのメソッドを呼び出し、ロケール値を指定する文字列値を渡すことで、 RenderOptionsSpec setLocale ロケール値を設定します。

    • オブジェクトの FormsServiceClient processFormSubmission メソッドを呼び出し、次の値を渡します。

      • フォームデータを含む BLOB オブジェクトです。
      • 関連するすべてのHTTPヘッダーが含まれる環境変数を指定するstring値。 例えば、次の文字列値を指定できます。 HTTP_REFERER=referrer&HTTP_CONNECTION=keep-alive&CONTENT_TYPE=application/xml
      • ヘッダー値を指定するstring値 HTTP_USER_AGENT 。例えば、 Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1; SV1; .NET CLR 1.1.4322)
      • 実行時オプションを格納する RenderOptionsSpec オブジェクト。 その他の情報, .
      • メソッドによって入力される空の BLOBHolder オブジェクトです。
      • メソッドによって入力される空の javax.xml.rpc.holders.StringHolder オブジェクトです。
      • メソッドによって入力される空の BLOBHolder オブジェクトです。
      • メソッドによって入力される空の BLOBHolder オブジェクトです。
      • メソッドによって入力される空の javax.xml.rpc.holders.ShortHolder オブジェクトです。
      • メソッドによって入力される空の MyArrayOf_xsd_anyTypeHolder オブジェクトです。 このパラメーターは、フォームと共に送信された添付ファイルを保存するために使用されます。
      • 送信されたフォームを使用してメソッドによって入力される空の FormsResultHolder オブジェクト。

      この processFormSubmission メソッドは、フォーム送信の結果を FormsResultHolder パラメーターに入力します。 この processFormSubmission メソッドは、フォーム送信の結果を含む FormsResult オブジェクトを返します。

    • 送信されたフォームに関連付けられている処理状態が、 1 オブジェクトの FormsResult getAction メソッドを呼び出して確認します。 このメソッドが値を返す場合 1、計算が実行され、データをクライアントWebブラウザーに書き戻すことができます。

  4. フォームデータストリームをクライアントのWebブラウザーに書き戻します

    • フォームデータストリームをクライアントのWebブラウザーに送信するために使用する javax.servlet.ServletOutputStream オブジェクトを作成します。
    • オブジェクトの BLOB メソッドを呼び出して、フォームデータを含む FormsResult オブジェクトを作成し getOutputContent ます。
    • バイト配列を作成し、 BLOB オブジェクトの getBinaryData メソッドを呼び出して値を設定します。 このタスクは、 FormsResult オブジェクトの内容をバイト配列に割り当てます。
    • オブジェクトの javax.servlet.http.HttpServletResponse write メソッドを呼び出して、フォームデータストリームをクライアントのWebブラウザーに送信します。 バイト配列を write メソッドに渡します。

Base64エンコーディングを使用した​AEM Formsの呼び出しも参照してください。

このページ