「renderHTMLForm」操作

指定されたフォームを取得し、フォームデータをマージして、Web ブラウザーなどのクライアントアプリケーション用に HTML フォームに変換します。この操作を使用して、XDP ファイル(*.xdp)のみをレンダリングできます。異なる形式をサポートするために作成される HTML フォームの種類を選択できます。また、カスタム CSS ファイルを追加することによって、レンダリングされた HTML フォームの表示形式を設定することもできます。CSS ファイルを使用して表示形式を設定することに加えて、レイアウトデザインのテクニックを使用して、レンダリングされた HTML フォームでのオフセットシフトの問題を解決することも検討してください( Designer ヘルプ で、 「Designer の使用」/「Forms の作成」/「HTML フォームの作成」/「HTML フォームのレイアウトの考慮点」 を参照してください)。この操作を使用して、アプリケーションの一部であるフォームデザインまたはフォームデータを使用し、ドキュメントの値としてフォームデザインおよびフォームデータを使用します。

この操作の利点は、次のとおりです。

  • すべてのアセットが単一のアプリケーションに含まれるため、アプリケーションの移植性が最大化されます。

  • document 変数としてフォームデザインまたはフォームデータを評価できるため、プロセスデザインが簡素化されます。

    例えば、アプリケーションで HTML フォームを表示して、ユーザーが HTML 対応デバイスからフォームを送信することを許可する必要があります。また、すべてのデバイスに Acrobat または Adobe Reader がインストールされているわけではないため、HTML フォームは有益です。renderHTMLForm 操作を使用して、 document 値として指定されたフォームデザインから HTML フォームをレンダリングします。自動化されたプロセスの一部としてフォームを送信できるように、レンダリングされた HTML フォームをユーザーに表示します。

    注意: 「renderHTMLForm」操作(非推奨) 操作は、 document 変数を作成してフォームデザインまたはフォームデータを保存することができない場合にのみ使用します。ネットワーク上、ローカルファイルシステム、または HTTP ロケーションで動的に参照されるフォームデザインまたはフォームデータのドキュメント変数を作成することはできません。

    General プロパティグループと Route Evaluation プロパティグループについて詳しくは、 共通の操作プロパティ を参照してください。

Input プロパティ

HTML フォームをレンダリングするためのフォームデザインおよびフォームデータを指定するためのプロパティ。

Form

HTML フォームにレンダリングするアプリケーション内のフォームデザインを指定する 文書 値。

リテラル値を指定する場合は、省略記号ボタン をクリックして、Select Asset ダイアログボックスを開きます( Select Asset について を参照)。

Form Data

レンダリング中にフォームとマージするデータを表す 文書 値。XML 形式で提供されるフォームデータは、 deserialize 関数を使用してデシリアライズする必要があります。( deserialize deserialize を参照)

リテラル値を指定する場合は、省略記号ボタン をクリックして、Select Asset ダイアログボックスを開きます( Select Asset について を参照)。

Template Options プロパティ

フォームデザインの場所、ロケール、エンコーディングなどのフォームデザインオプションを指定するためのプロパティ。

Content Root URI

URI または絶対参照を指定する string 値。これによって、フォームデザインで使用される相対アセットを取得するためのリポジトリ内のフォルダーが指定されます。例えば、フォームデザインが ../myImage.gif のようにイメージを相対的に参照する場合、myImage.gif は repository:// に配置する必要があります。デフォルト値は repository:// で、これはリポジトリのルートレベルをポイントします。

URI または絶対参照に次のソースを使用できます。

  • Repository:リポジトリには AEM forms サーバーにアップロードするアセットが含まれます。値 repository:/// はリポジトリのルートを参照します。最初の 2 つのスラッシュはプロトコル(repository://)の一部であり、3 番目のスラッシュはリポジトリのルートを表します。

  • Directory in the file system of the AEM forms server:C:¥ [foldername] のように、AEM forms サーバー上の場所を指定できます。アプリケーションの移植性を確保したい場合、サーバー上の場所を使用することはお勧めしません。

  • Network directory:¥¥[folder name] などの、ネットワーク上の場所を指定できます。

  • Web location that is accessible by using HTTP:Web サーバー上の場所にファイルをアップロードした後、http:// [server name] : [port number] / [folder name] のように、URL を使用して場所を指定できます。

Locale

HTML フォームがレンダリングされるときに、Web ブラウザーなどのクライアントアプリケーションに検証メッセージを送信するために使用される言語を指定する string 値。

リテラル値を指定する場合、リストから言語を選択するか、または次のいずれかの値を選択します。

Use Server Default:(デフォルト)AEM forms サーバー上で設定されているロケール設定を使用します。ロケール設定は、管理コンソールを使用して設定します(『 Forms 管理ヘルプ 』を参照)。

Use Custom Value:このオプションを選択した後、リスト内にないロケールコードのロケール ID を入力します。サポートされるロケールコードのリストについては、http://java.sun.com/j2se/1.5.0/docs/guide/intl/locale.doc.html を参照してください。

Character Set

レンダリングされたフォームをエンコードするために使用される文字セットを指定する string 値。

リテラル値を指定する場合、文字セットを選択するか、または次のいずれかの値を使用します。

Use Server Default:(デフォルト)AEM フォームサーバー上で設定されている文字セット設定を使用することを選択します。文字セット設定は、管理コンソールを使用して設定されます(『 Forms 管理ヘルプ 』を参照)。

Use Custom Value:リスト内にないエンコーディングセットの正規名(Java.nio API)を選択して入力します。文字セットのリストについては、http://java.sun.com/j2se/1.5.0/docs/guide/intl/encoding.doc.html を参照してください。

HTML オプション

HTML フォームのレンダリングのためのパラメーターを設定するプロパティ。

Transform To

生成する HTML フォームを指定する TransformTo 値。

リテラル値を指定する場合、デフォルトは指定されません。次のいずれかの値を選択します。

AUTO:Forms サービスで実行する最適な変換が決定されます。

XHTML:XHTML 標準に準拠している HTML が生成されます。

NoScriptXHTML:CSS2 仕様との互換性があり、XHTML 1.0 に準拠している HTML が生成されます。HTML 出力にはクライアント側の JavaScript は含まれませんが、サーバー側の JavaScript を含めることはできます。

HTML4:HTML 要素の絶対位置がサポートされない古いブラウザーとの互換性がある HTML が生成されます。

MSDHTML:Internet Explorer 5.0 以降用の動的 HTML との互換性がある HTML が生成されます。

AHTML:アクセシビリティが向上したブラウザー(Internet Explorer 5 以降)との互換性がある HTML が生成されます。

StaticHTML:ユーザーが HTML フォームのフィールドに入力することを許可しない HTML が生成されます。「Static HTML」は情報を表示するために役立つプロセスです。

AccessibleXHTML:XHTML 1.0 標準に準拠している HTML が生成されます。HTML フォーム内の要素は、相対単位 em を使用して配置されます。相対単位の使用は、視力やその他の障害のあるユーザーがコンテンツにアクセスできるようにするためにツールが使用される場合に、HTML フォームを正しく表示するために役立ちます。

NoScriptAccessibleXHTML:XHTML 1.0 標準および CSS2 仕様に準拠している HTML が生成されます。また、XHTML には、サーバー側の JavaScript を含めることはできますが、クライアント側の JavaScript は含まれません。相対単位である em タグを使用することによって HTML フォーム内の要素が配置されます。相対単位の使用は、視力やその他の障害のあるユーザーがコンテンツにアクセスできるようにするためにツールが使用される場合に、HTML フォームを正しく表示するために役立ちます。

HTML Output Type

レンダリングされたページを HTML タグまたは BODY タグで囲むかどうかを指定する Output Type 値。レンダリングされた HTML ページを別の HTML ページの一部にする場合、 BODY タグで HTML をレンダリングします。次のいずれかの値を選択します。

Use Server Default:(デフォルト)AEM forms サーバー上で設定されているデフォルトの出力形式設定を使用します。出力形式設定は、管理コンソールの Forms から設定します。(『 Forms 管理ヘルプ 』を参照)。

Full HTML tags:レンダリングされたページが HTML タグで囲まれます。これによって、完全な HTML ページになります。

Body Tags:レンダリングされたページが BODY タグで囲まれます。

Start Page Number

複数ページの HTML フォームのレンダリングを開始するページ番号を指定する int 値。ページ番号が 0 の場合、最初のページが 0 ページであることを意味します。値が指定されない場合、0 が使用されます。

Populate XML Data

フォームの現在の処理状態に基づいて XML データがフォームから生成されるかどうかを指定する boolean 値。値 True は XML データを生成することを意味します。値 False は XML データを生成しないことを意味します。

リテラル値を指定する場合、デフォルトでは「Populate XML Data」の選択が解除されます。このチェックボックスを選択すると、フォームの現在の処理状態に基づいて XML データが生成されます。このチェックボックスの選択を解除すると、フォームの処理状態に基づいて XML データが生成されません。

User Agent

Web ブラウザーなどのクライアントアプリケーションについての情報を提供する string 値。 USER_AGENT がこの操作で Environment Variables プロパティの値として指定される場合、このプロパティで指定される値で上書きされます。デフォルト値は Mozilla/3.* です。

リテラル値を指定する場合、次のいずれかの値を選択します。

Use Server Default:(デフォルト)Mozilla/3.* を使用します。「User Agent」設定はサーバー上で設定できません。

Internet Explorer 6.0:ターゲットアプリケーションは Microsoft Internet Explorer 6.0 です。

Mozilla Firefox 2.0:ターゲットアプリケーションは Mozilla Firefox 2.0 です。

Mozilla Firefox 3.0:ターゲットアプリケーションは Mozilla Firefox 3.0 です。

Use Custom Value:このオプションを選択した後、ターゲットデバイス上のクライアントアプリケーションを入力します。例えば、Microsoft Internet Explorer 7.0 の場合は " Mozilla/4.0 (compatible; MSIE 7.0; Windows NT 5.1) " と入力します。

Advanced HTML Options プロパティ

HTML の外観を制御するパラメーターを設定するためのプロパティ。

Digital Signature CSS URI

HTML フォームのデジタル署名ユーザーインターフェイスに使用するカスタムスタイルシート用の CSS ファイルの URI(例: C:¥¥customds.css )を指定する string 値。AEM forms サーバーは、URI の場所にアクセスできる必要があります。

注意: カスタム CSS ファイルにアクセスするには、FormsIVS サンプルを使用して、指定したフォームデザインおよび出力形式に基づくカスタム CSS を生成します。

Custom CSS URI

C:¥customcss.css のように、HTML フォームの一部として生成される内部カスケーディングスタイルシートの代わりに使用するカスタムカスケーディングスタイルシートの URI を指定する string 値。フォームデザインが変更された場合、カスタム CSS ファイルを確認します。

  • ボタン、テキスト、テキストフィールド、チェックボックスなどの新しい形式のフォームオブジェクトがフォームデザインに追加されます。

  • フォームオブジェクトがフォームデザインから削除されます。

  • ラベルやフィールドなどのフォームオブジェクトを子サブフォームから親サブフォームに移動します。

    AEM forms サーバーは、URI の場所にアクセスできる必要があります。

    注意: カスタム CSS ファイルにアクセスするには、FormsIVS サンプルを使用して、指定したフォームデザインおよび出力形式に基づくカスタム CSS を生成します。

HTML Toolbar

HTML フォームにレンダリングされるツールバーのタイプを指定する HTMLToolbar 値。

リテラル値を指定する場合、次のいずれかの値を選択します。

Disabled:(デフォルト)HTML ツールバーが無効です。

Vertical:HTML ツールバーが垂直位置に表示されます。

Horizontal:HTML ツールバーが水平位置に表示されます。

HTML Toolbar URI

レンダリングされた HTML フォームが含まれる HTML ツールバーリソースの URI 位置を指定する string 値。

Generate Tab Index

レンダリングされた HTML フォームに各フィールドのタブインデックスを作成するかどうかを指定する boolean 値。タブインデックスがある HTML フォームがタブインデックスのない別の HTML ページに埋め込まれる場合、タブの不一致が発生する可能性があります。HTML フォームをタブインデックスのない別の HTML フォームに埋め込む場合、各フォームフィールドのタブインデックスを生成しません。

リテラル値を指定する場合、デフォルトでは「Generate Tab Index」の選択が解除されます。「Generate Tab Index」チェックボックスを選択すると、HTML フォーム内の各フォームフィールドにタブインデックスが作成されます。各フォームフィールドのタブインデックスを作成しない場合は、このチェックボックスの選択を解除します。

Style Generation Level

レンダリングされた HTML フォームの出力のスタイルを指定する StyleGenerationLevel 値。内部スタイルとは、CSS スタイルの間隔と位置のことです。インラインスタイルとは、色、フォント、背景色などの外観スタイルのことです。

リテラル値を指定する場合、次のいずれかの値を選択します。

Inline And Internal Styles:(デフォルト)インライン CSS スタイルと内部 CSS スタイルの両方を使用します。内部スタイルは CSS スタイルの間隔と位置に使用されます。インラインスタイルは、色、フォント、背景色などの外観スタイルに使用されます。

Only Inline Styles:カスタム CSS ファイルからインライン CSS スタイルのみを使用します。このオプションでは、HTML ページの head タグの内側からすべての内部スタイルを削除します。

No Styles:インラインスタイルまたは内部スタイルで CSS を使用しません。外部 CSS ファイルを使用して渡されたスタイルのみが使用されます。

Render Options プロパティ

HTML フォームのレンダリングオプションのためのプロパティ。

Cache Form On Server

サーバー上でフォームデザインがキャッシュされるかどうかを指定する boolean 値。サーバー上のフォームのキャッシュによって、サーバー上でレンダリングされるフォームのパフォーマンスが向上します。フォームデザインに埋め込まれる処理命令。「Form Rendering Cache Enabled」オプションでは、キャッシュの実行方法が決定されます。管理コンソールの「フォームレンダリングキャッシュが有効です」オプションの設定に関する詳細は、「 Forms の設定 」を参照してください。

リテラル値を指定する場合、デフォルトでは「Better Performance For Templates That Don’t Change Often」チェックボックスが選択されます。このチェックボックスを選択すると、AEM forms サーバー上でフォームデザインにキャッシュがレンダリングされます。フォームのキャッシュが不要な場合は、このチェックボックスの選択を解除します。

Stand Alone Rendition

状態情報なしでフォームをレンダリングできるかどうかを指定する boolean 値。状態情報は、送信のためにユーザーによるサーバーとのやりとりが必要なインタラクティブなフォームのレンダリングに使用されます。状態情報付きで PDF フォームをレンダリングする場合、JavaScript と一緒にレンダリングされます。オフラインでフォームを使用できるようになります。

リテラル値を指定する場合、デフォルトでは「Render Without State Information」チェックボックスが選択されます。

  • このチェックボックスを選択すると、状態情報および埋め込み JavaScript 付きで PDF フォームがレンダリングされます。JavaScript コードは、サーバーとやりとりすることなくクライアント上で実行されます。また、フォームはオフラインで使用できます。

  • このチェックボックスの選択を解除すると、状態情報および埋め込み JavaScript なしで PDF フォームがレンダリングされます。サーバー側の計算が実行された後、Forms サービスによってフォームがレンダリングされます。計算の結果は、レンダリングされたフォームに表示されます。Forms サービスとのやりとりが要求されるため、フォームをオフラインにすることはできません。

Application Web Root

アプリケーションに固有の Web コンテンツへのアクセスに使用されるルートの場所を表す URL を指定する string 値。この値を「Target URL」オプションの値と組み合わせて、絶対送信 URL を構成します。

ターゲット URL

ユーザーがフォームを送信したときにクライアントアプリケーションからデータを受信する Web サービスまたは Java サーブレットにアクセスする URL を表す string 値。このオプションで値を設定すると、フォームデザインでターゲット URL がこのプロパティで指定された値に設定されます。このオプションが絶対 URL ではない場合、「Application Web Root」オプションの値と組み合わせて、絶対 URL が構成されます。

注意: Target URL プロパティは、「Submit」ボタンに設定される URL を使用する Designer 8.2 で作成されたフォームデザインのために空白のままにしておく必要があります。「Target Version」が Acrobat 9.1 以降および Adobe Reader 9.1 以降に設定され、Designer 9 以降で作成されたフォームデザインでは、常に「Submit」ボタンで設定された URL を使用します。

Workspace の場合、 http:// [server name] : [port] /workspace-server/submit の値を入力します。ここで、 [server name] は AEM forms が展開されるサーバー名で、 [port] はアプリケーションサーバーがクライアントソフトウェアへの HTTP アクセスを提供するために使用するポートです。サポートされるアプリケーションサーバーのデフォルトのポートは、以下のとおりです。

  • JBoss:8080

  • WebLogic:7001

  • WebSphere:9080

ベース URL

HTTP 形式のコンテンツルート URI である URL を指定する string 値。この値は、画像やスクリプトなどの外部依存関係への HREF 参照を含む HTML フォームをレンダリングする場合にのみ必要です。依存パスが絶対パスのとき、この値は無視されます。

Additional Options プロパティ

HTML フォームのレンダリング時に追加オプションを指定するためのプロパティ。

フォームモデル

フォームに埋め込まれるスクリプトが実行される場所を指定する FormModel 値。

リテラル値を指定する場合、次のいずれかの値を選択します。

Use Form Template Default:
(デフォルト)Forms サービスではフォームデザインをチェックして、クライアントまたはサーバーのどちらでレンダリングするかどうかが決定されます。

dt
フォームがクライアントでレンダリングされます。サーバーで実行するスクリプトを使用しません。この値が選択される場合、サーバーで実行するスクリプトによって AEM forms サーバーで警告が生成されます。

dt
フォームがサーバーでレンダリングされます。

dt
フォームがサーバーとクライアントの両方でレンダリングされます。

XCI URI

レンダリングに使用する XCI ファイルの URI 位置を指定する string 値。ルートが指定されていない場合、このファイルは AEM forms EAR ファイルが展開される場所にあると想定されます。例えば、JBoss の自動インストールで、 [Install folder] /jboss/server/lc_turnkey/svcdata/XMLFormService フォルダー内のデフォルト XCI ファイルを参照できます。 [Install folder] は AEM forms がインストールされる場所です。カスタム XCI ファイルの作成に関する詳細は、Designer ヘルプ』を参照してください。

添付ファイル

フォームでレンダリングされる添付ファイルを指定する 文書 値の map

Output プロパティ

HTML フォームの保存のためのプロパティ。

Rendered Form

レンダリングされたフォームの結果を保存するプロセスデータモデル内の場所。データタイプは 文書 です。

その他の Outputプロパティ

HTML フォームのレンダリングの結果を保存するためのプロパティ。

Output XML

操作によって生成されたコンテンツを表す整形式の XML を保存するためのプロセスデータモデル内の場所。データタイプは 文書 です。

ページ数

ページ数を保存するためのプロセスデータモデル内の場所。データタイプは long です。

Locale

レンダリングされた HTML フォームのロケールコードを保存するプロセスデータモデル内の場所。データタイプは string です。

HTML Output Type

BODY 要素とそのコンテンツのみが含まれる生成された HTML データを保存するためのプロセスデータモデル内の場所。データタイプは string です。

Forms Result

すべての出力結果を組み合わせられた複雑な値で保存するためのプロセスデータモデル内の場所。データタイプは FormsResult です。

Exceptions

この操作によって、HTML フォームのレンダリング中にエラーが発生した場合に RenderFormException 例外がスローされます。