手順の概要

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

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

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

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

Forms Client API オブジェクトの作成

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

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

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

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

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

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

関連情報

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

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

Forms API(Java)を使用してフォームデータを計算します。

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

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

  2. Forms Client API オブジェクトの作成

    • 接続プロパティを含む ServiceClientFactory オブジェクトを作成します。
    • コンストラクターを使用して ServiceClientFactory オブジェクトを渡すことにより、FormsServiceClient オブジェクトを作成します。
  3. 計算スクリプトを含むフォームの取得

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

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

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

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

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

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

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