フラグメントに基づいたフォームのレンダリング rendering-forms-based-on-fragments

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

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

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

• 接続プロパティを含む ServiceClientFactory オブジェクトを作成します。
• コンストラクターを使用して ServiceClientFactory オブジェクトを渡すことにより、FormsServiceClient オブジェクトを作成します。

URI 値を指定

• コンストラクターを使用して、URI 値を格納する URLSpec オブジェクトを作成します。
• URLSpec オブジェクトの setApplicationWebRoot メソッドを呼び出して、アプリケーションの web ルートを表す文字列値を渡します。
• URLSpec オブジェクトの setContentRootURI メソッドを呼び出して、コンテンツルート URI 値を指定する文字列値を渡します。 フォームデザインとフラグメントがコンテンツルート URI に配置されていることを確認します。 そうでない場合、Forms サービスは例外をスローします。 リポジトリを参照するには、repository:// を指定します。
• URLSpec オブジェクトの setTargetURL メソッドを呼び出して、フォームデータの送信先となるターゲット URL 値を指定する文字列値を渡します。 フォームデザインでターゲット URL を定義する場合、空の文字列を渡すことができます。 また、計算を実行するためのフォームの送信先の URL を指定することもできます。

フォームのレンダリング

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

• ファイル名拡張子を含んだフォームデザイン名を指定する文字列値。 Forms アプリケーションの一部であるフォームデザインを参照する場合は、必ず次のような完全なパスを指定します。Applications/FormsApplication/1.0/FormsFolder/Loan.xdp
• フォームに結合するデータを含む com.adobe.idp.Document オブジェクトです。 データを結合しない場合は、空の com.adobe.idp.Document オブジェクトを渡します。
• 実行時オプションを保存する PDFFormRenderSpec オブジェクト。
• URLSpec フラグメントに基づいてフォームをレンダリングするために Forms サービスで必要な URI 値を含むオブジェクト。
• 添付ファイルを格納する java.util.HashMap オブジェクト。 これはオプションのパラメーターであり、フォームにファイルを添付しない場合に null を指定できます。

renderPDFForm メソッドは、クライアントの Web ブラウザーに書き込む必要があるフォームデータストリームを含む FormsResult オブジェクトを返します。

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

• FormsResult オブジェクトの getOutputContent メソッドを呼び出して、com.adobe.idp.Document オブジェクトを作成します。
• getContentType メソッドを呼び出して、com.adobe.idp.Document オブジェクトのコンテンツタイプを取得します。
• javax.servlet.http.HttpServletResponse オブジェクトのコンテンツタイプを設定するには、setContentType メソッドを呼び出して、com.adobe.idp.Document オブジェクトのコンテンツタイプを渡します。
• javax.servlet.http.HttpServletResponse オブジェクトの getOutputStream メソッドを呼び出して、フォームデータストリームをクライアント web ブラウザーに書き込むために使用される javax.servlet.ServletOutputStream オブジェクトを作成します。
• com.adobe.idp.Document オブジェクトの getInputStream メソッドを呼び出すことによって、java.io.InputStream オブジェクトを作成します。
• InputStream オブジェクトの read メソッドを呼び出して、引数としてバイト配列を渡すことで、バイト配列を作成し、フォームデータストリームを入力します。
• javax.servlet.ServletOutputStream オブジェクトの write メソッドを呼び出して、フォームデータストリームをクライアント web ブラウザーに送信します。 バイト配列を write メソッドに渡します。

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

• Forms Service WSDL を使用する Java プロキシクラスを作成します。
• Java プロキシクラスをクラスパスに含めます。

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

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

URI 値を指定

• コンストラクターを使用して URI 値を格納する URLSpec オブジェクトを作成します。
• URLSpec オブジェクトの setApplicationWebRoot メソッドを呼び出して、アプリケーションの web ルートを表す文字列値を渡します。
• URLSpec オブジェクトの setContentRootURI メソッドを呼び出して、コンテンツルート URI 値を指定する文字列値を渡します。 フォームデザインがコンテンツルート URI に配置されていることを確認します。 そうでない場合、Forms サービスは例外をスローします。 リポジトリを参照するには、repository:// を指定します。
• URLSpec オブジェクトの setTargetURL メソッドを呼び出して、フォームデータの送信先となるターゲット URL 値を指定する文字列値を渡します。 フォームデザインでターゲット URL を定義する場合、空の文字列を渡すことができます。 また、計算を実行するためのフォームの送信先の URL を指定することもできます。

フォームのレンダリング

FormsService オブジェクトの renderPDFForm メソッドを呼び出して、次の値を渡します。

• ファイル名拡張子を含んだフォームデザイン名を指定する文字列値。 Forms アプリケーションの一部であるフォームデザインを参照する場合は、必ず次のような完全なパスを指定します。Applications/FormsApplication/1.0/FormsFolder/Loan.xdp
• フォームと結合するデータを含んだ BLOB オブジェクト。 データを結合しない場合は、null を渡します。
• 実行時オプションを保存する PDFFormRenderSpec オブジェクト。 入力ドキュメントが PDF ドキュメントの場合、「タグ付き PDF」オプションは設定できません。 入力ファイルが XDP ファイルの場合は、「タグ付き PDF」オプションを設定できます。
• Forms サービスで必要な URI 値を含む URLSpec オブジェクト。
• 添付ファイルを格納する java.util.HashMap オブジェクト。 これはオプションのパラメーターであり、フォームにファイルを添付しない場合に null を指定できます。
• メソッドによって設定される空の com.adobe.idp.services.holders.BLOBHolder オブジェクト。 このパラメーターは、レンダリングされたフォームを保存するために使用されます。
• メソッドによって設定される空の javax.xml.rpc.holders.LongHolder オブジェクト。 この引数は、フォームのページ数を保存します。
• メソッドによって設定される空の javax.xml.rpc.holders.StringHolder オブジェクト。 この引数はロケール値を格納します。
• この操作の結果を格納する空の com.adobe.idp.services.holders.FormsResultHolder オブジェクト。

renderPDFForm メソッドは、最後の引数値として渡される com.adobe.idp.services.holders.FormsResultHolder オブジェクトに、クライアント web ブラウザーに書き込む必要のあるフォームデータストリームを入力します。

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

• com.adobe.idp.services.holders.FormsResultHolder オブジェクトの value データメンバーの値を取得して、FormResult オブジェクトを作成します。
• FormsResult オブジェクトの getOutputContent メソッドを呼び出して、フォームデータを含む BLOB オブジェクトを作成します。
• getContentType メソッドを呼び出して、BLOB オブジェクトのコンテンツタイプを取得します。
• javax.servlet.http.HttpServletResponse オブジェクトのコンテンツタイプを設定するには、setContentType メソッドを呼び出して、BLOB オブジェクトのコンテンツタイプを渡します。
• javax.servlet.http.HttpServletResponse オブジェクトの getOutputStream メソッドを呼び出して、フォームデータストリームをクライアント web ブラウザーに書き込むために使用される javax.servlet.ServletOutputStream オブジェクトを作成します。
• バイト配列を作成し、BLOB オブジェクトの getBinaryData メソッドを呼び出して値を入力します。 このタスクは、FormsResult オブジェクトのコンテンツをバイト配列に割り当てます。
• javax.servlet.http.HttpServletResponse オブジェクトの write メソッドを呼び出して、フォームデータストリームをクライアント web ブラウザーに送信します。 バイト配列を write メソッドに渡します。