「renderHTMLForm」操作

Form

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

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

Form Data

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

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

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) " と入力します。

Digital Signature CSS URI

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

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 ファイルを使用して渡されたスタイルのみが使用されます。

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 が構成されます。

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 フォームをレンダリングする場合にのみ必要です。依存パスが絶対パスのとき、この値は無視されます。

フォームモデル

フォームに埋め込まれるスクリプトが実行される場所を指定する 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 。

Rendered Form

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

Output XML

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

ページ数

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

Locale

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

HTML Output Type

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

Forms Result

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