カスタム CSS ファイルを使用した HTML フォームのレンダリング

このドキュメントのサンプルと例は、JEE 環境の AEM Forms のみを対象としています。

Forms サービスは、web ブラウザーからの HTTP リクエストに応答して HTML フォームをレンダリングします。HTML フォームをレンダリングする際は、Forms サービスはカスタム CSS ファイルを参照できます。Forms サービスを使用して HTML フォームをレンダリングする際に、ビジネス要件を満たすカスタム CSS ファイルを作成し、その CSS ファイルを参照することができます。

Forms サービスは、カスタム CSS ファイルをサイレントに解析します。つまり、Forms サービスは、カスタム CSS ファイルが CSS 標準に準拠していないためにエラーが発生しても報告しません。その場合、Forms サービスは問題のスタイルを無視し、CSS ファイルにある残りのスタイルを続行します。

次のリストは、カスタム CSS ファイルでサポートしているスタイルを示します。

  • クラスレベルのセレクターとスタイルのペア:カスタム CSS ファイルに存在する場合、クラススタイルとして HTML フォームで使用したセレクターが使用されます。未使用のクラススタイルは無視されます。
  • 識別情報レベルのセレクターとスタイルのペア:HTML フォームで使用される場合は、すべての 識別情報スタイルが使用されます。
  • 要素レベルのセレクターとスタイルのペア:HTML フォームで使用される場合は、すべての要素スタイルが使用されます。
  • スタイルの優先度:スタイルの優先度(重要など)がサポートされており、カスタム CSS ファイルで使用できます。
  • メディアタイプ:1 つ以上のセレクターとスタイルのペアを @media スタイルでラップして、メディアタイプを定義できます。Forms サービスは、指定されたメディアタイプがサポートされているかどうかをチェックしません。カスタム CSS ファイルで指定されたメディアタイプは、HTML フォームにマージされます。

FormsIVS アプリケーションを使用すると、CSS ファイルのサンプルを取得できます。フォームをアップロードして「フォームデザインのテスト」ページで選択し、「GenerateCSS」をクリックします。ボタンをクリックする前に、HTML 変換タイプを設定する必要はありません。次に、保存を選択します。ビジネス要件を満たすように、この CSS ファイルを編集することができます。

メモ

カスタム CSS ファイルを使用する HTML フォームをレンダリングする前に、HTML フォームのレンダリングについて理解していることが重要です。(フォームを HTML としてレンダリングするを参照してください)。

メモ

Forms サービスについて詳しくは、AEM Forms サービスリファレンスを参照してください。

手順の概要

CSS ファイルを使用する HTML フォームをレンダリングするには、次のタスクを実行します。

  1. プロジェクトファイルを含めます。
  2. Forms Java API オブジェクトを作成します。
  3. CSS ファイルを参照します。
  4. HTML フォームをレンダリングします。
  5. フォームデータストリームをクライアントの Web ブラウザーに書き込みます。

プロジェクトファイルのインクルード

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

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

Forms サービスでサポートされている操作をプログラムで実行する前に、Forms クライアントオブジェクトを作成する必要があります。

CSS ファイルの参照

カスタム CSS ファイルを使用する HTML フォームをレンダリングするには、既存の CSS ファイルを参照していることを確認してください。

HTML フォームのレンダリング

HTML フォームをレンダリングするには、Designer で作成され、XDP ファイルとして保存されたフォームデザインを指定する必要があります。HTML 変換タイプも選択する必要があります。たとえば、Internet Explorer 5.0 以降のダイナミック HTML をレンダリングする HTML 変換タイプを指定できます。

HTML フォームのレンダリングには、他のフォームタイプのレンダリングに必要な URI などの値も必要です。

クライアント web ブラウザーへのフォームデータストリームの書き込み

Forms サービスで HTML フォームをレンダリングすると、フォームデータストリームが返されます。HTML フォームをユーザーに表示するために、返されたデータストリームをクライアント web ブラウザーに書き込む必要があります。

関連項目

Java API を使用して、CSS ファイルを使用する HTML フォームをレンダリングする

AEM Forms Java ライブラリファイルを含める

接続プロパティの設定

Forms サービス API のクイックスタート

インタラクティブ PDF Forms のレンダリング

Forms を HTML としてレンダリング

Forms をレンダリングする web アプリケーションの作成

Java API を使用して、CSS ファイルを使用する HTML フォームをレンダリングする

カスタム CSS ファイルを使用する HTML フォームを Forms API(Java)を使用してレンダリングする

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

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

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

    • 接続プロパティを含む ServiceClientFactory オブジェクトを作成します。
    • コンストラクターを使用して ServiceClientFactory オブジェクトを渡すことによって、FormsServiceClient オブジェクトを作成します。
  3. CSS ファイルの参照

    • コンストラクターを使用して HTMLRenderSpec オブジェクトを作成します。
    • カスタム CSS ファイルを使用する HTML フォームをレンダリングするには、HTMLRenderSpec オブジェクトの setCustomCSSURI メソッドを呼び出し、CSS ファイルの場所と名前を指定する文字列値を渡します。
  4. HTML フォームのレンダリング

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

    • フォームデザイン名を指定する文字列値で、ファイル名の拡張子も含まれます。Forms アプリケーションの一部であるフォームデザインを参照する場合は、必ず次のような完全なパスを指定します。Applications/FormsApplication/1.0/FormsFolder/Loan.xdp
    • HTML の環境設定タイプを指定する TransformTo enum 値。例えば、Internet Explorer 5.0 以降の動的 HTML と互換性のある HTML フォームをレンダリングするには、TransformTo.MSDHTML を指定します。
    • フォームに結合するデータを含む com.adobe.idp.Document オブジェクト。データを結合しない場合は、空の com.adobe.idp.Document オブジェクトを渡します。
    • HTML の実行時オプションが格納された HTMLRenderSpec オブジェクト。
    • Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1; SV1; .NET CLR 1.1.4322) などの HTTP_USER_AGENT ヘッダー値を指定する文字列値。
    • HTML フォームのレンダリングに必要な URI 値を格納する URLSpec オブジェクト。
    • 添付ファイルを格納する java.util.HashMap オブジェクト。これはオプションのパラメーターで、 フォームにファイルを添付しない場合は null を指定できます。

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

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

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

関連項目

カスタム CSS ファイルを使用した HTML フォームのレンダリング

クイックスタート(SOAP モード):Java API を使用して CSS ファイルを使用する HTML フォームをレンダリングします

AEM Forms Java ライブラリファイルを含める

接続プロパティの設定

Web サービス API を使用して、CSS ファイルを使用する HTML フォームをレンダリングする

Forms API(web サービス)を使用して、カスタム CSS ファイルを使用する HTML フォームをレンダリングします。

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

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

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

  3. CSS ファイルの参照

    • コンストラクターを使用して HTMLRenderSpec オブジェクトを作成します。
    • カスタム CSS ファイルを使用する HTML フォームをレンダリングするには、HTMLRenderSpec オブジェクトの setCustomCSSURI メソッドを呼び出し、CSS ファイルの場所と名前を指定する文字列値を渡します。
  4. HTML フォームのレンダリング

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

    • フォームデザイン名を指定する文字列値で、ファイル名の拡張子も含まれます。Forms アプリケーションの一部であるフォームデザインを参照する場合は、必ず次のような完全なパスを指定します。Applications/FormsApplication/1.0/FormsFolder/Loan.xdp
    • HTML の環境設定タイプを指定する TransformTo enum 値。例えば、Internet Explorer 5.0 以降の動的 HTML と互換性のある HTML フォームをレンダリングするには、TransformTo.MSDHTML を指定します。
    • フォームに結合するデータを含む BLOB オブジェクト。データを結合しない場合は、null を渡します。(編集可能なレイアウトを使用した Forms の事前入力を参照してください)。
    • HTML 実行時オプションを格納する HTMLRenderSpec オブジェクト。
    • Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1; SV1; .NET CLR 1.1.4322) などの HTTP_USER_AGENT ヘッダー値を指定する文字列値。この値を設定しない場合は、空の文字列を渡します。
    • HTML フォームのレンダリングに必要な URI 値を格納する URLSpec オブジェクト。
    • 添付ファイルを格納する java.util.HashMap オブジェクト。このパラメーターはオプションであり、フォームにファイルを添付しない場合は null を指定できます。
    • (Deprecated) renderHTMLForm メソッドによって設定された空の com.adobe.idp.services.holders.BLOBHolder オブジェクト。このパラメーター値には、レンダリングされたフォームが格納されます。
    • (Deprecated) renderHTMLForm メソッドで入力される空の com.adobe.idp.services.holders.BLOBHolder オブジェクト。このパラメーターには、出力 XML データが格納されます。
    • (Deprecated) renderHTMLForm メソッドでデータが入力される空の javax.xml.rpc.holders.LongHolder オブジェクト。この引数には、フォームのページ数が格納されます。
    • (Deprecated) renderHTMLForm メソッドでデータが入力される空の javax.xml.rpc.holders.StringHolder オブジェクト。この引数には、ロケール値が格納されます。
    • (Deprecated) renderHTMLForm メソッドでデータが入力される空の javax.xml.rpc.holders.StringHolder オブジェクト。この引数には、使用する HTML レンダリング値が格納されます。
    • この操作の結果を格納する空の com.adobe.idp.services.holders.FormsResultHolder オブジェクト。

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

  5. フォームデータストリームをクライアント 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 メソッドに渡します。

関連項目

カスタム CSS ファイルを使用した HTML フォームのレンダリング

Base64 エンコーディングを使用した AEM Forms の呼び出し

このページ