Forms のレンダリング rendering-forms
このドキュメントのサンプルと例は、JEE 環境の AEM Forms のみを対象としています。
Forms サービスについて
Forms サービスを使用すると、通常は Designer で作成されるフォームを検証、処理、変換および配信する、インタラクティブなデータキャプチャクライアントアプリケーションを作成できます。フォーム作成者は、Forms サービスが様々なブラウザー環境で PDF、SWF または HTML でレンダリングする、単一のフォームデザインを開発できます。
エンドユーザーがフォームを要求すると、クライアントアプリケーションが Forms サービスに要求を送信し、このサービスが適切な形式でフォームを返します。Forms サービスは、要求を受け取るとすぐにデータをフォームデザインと結合し、目的の形式でフォームを配信します。フォームサービスの出力は、インタラクティブなフォーム(通常は PDF ドキュメント)です。インタラクティブフォームを使用すると、ユーザーはフォーム上のフィールドに入力できます。
クライアントアプリケーションの種類に応じて、フォームをクライアント web ブラウザーに書き込んだり、フォームを PDF ファイルとして保存したりできます。Web ベースのアプリケーションは、web ブラウザーにフォームを書き込むことができます。デスクトップアプリケーションは、フォームを PDF ファイルとして保存できます。Web ブラウザーや PDF ファイルに書き出す方法を示すために、「Forms のレンダリング」セクションにあるクイックスタートは、次のように構成されています。
- Java API で厳密に型指定された(SOAP モード)の例は Java サーブレットです。
- Web サービス (Java Base64) の例は Java サーブレットです。
- Web サービス(MTOM)の例は、コンソールアプリケーションです(すべてのクイックスタートに MTOM の例があるわけではありません)。
次の 2 つの方法のいずれかを使用して、フォームデザイン(XDP ファイル)または PDF ドキュメントを Forms サービスに渡すことができます。
- URL 値を使用してフォームデザインを参照できます。このアプローチでは、
URLSpec
オブジェクトを使用します。コンテンツルートは、URLSpec
オブジェクトのsetContentRootURI
メソッドを使用して Forms サービスに渡されます。フォームデザイン名(formQuery
)は別のパラメーターとして渡されます。2 つの値が連結され、フォームデザインへの絶対参照が取得されます。(「Forms のレンダリング」セクションのクイックスタートの大半は、この方法を採用してします)。 - フォームデザインを含む
com.adobe.idp.Document
を Forms サービスに渡すことができます。renderPDFForm2
およびrenderHTMLForm2
という名前の 2 つの新しいメソッドは、フォームデザインを含むcom.adobe.idp.Document
オブジェクトを受け入れます(Forms サービスにドキュメントを渡すを参照)。
Forms サービスを使用して、次のタスクを実行できます。
- インタラクティブ PDF Forms のレンダリング(インタラクティブ PDF Forms のレンダリングを参照)。
- クライアントでの Forms のレンダリング(クライアントでの Forms のレンダリングを参照)。
- フラグメントに基づいた Forms のレンダリング(フラグメントに基づいた Forms のレンダリングを参照)。
- 権限が有効な Forms のレンダリング(レンダリング権限が有効な Formsを参照)。
- Forms を HTML としてレンダリング(Forms を HTML としてレンダリングを参照)。
- カスタム CSS ファイルを使用した HTML フォームのレンダリング(カスタム CSS ファイルを使用した HTML フォームのレンダリング)
- 送信された Forms の処理(送信された Forms の処理を参照)。
- 送信された XML データを使用した PDF ドキュメントの作成(送信された XML データでの PDF ドキュメントの作成を参照)。
- フォームの事前入力(編集可能なレイアウトを使用した Forms の事前入力を参照)。
- ドキュメントを渡す(Forms サービスにドキュメントを渡すを参照)。
- フォームデータの計算(フォームデータの計算を参照)。
- アプリケーションの最適化(Forms サービスのパフォーマンスの最適化を参照。)