HTML フォームをレンダリングするときにフォームデザイン、フォームデータ、およびオプションを指定するためのプロパティ。
Form To Render
XDP ファイル名を指定する
string
値。この操作でこの値を Content Root URI プロパティの値と組み合わせて、フォームへの絶対パスを作成します。
リテラル値を指定する場合、Form To Render プロパティの下のボックスにフォームの名前を入力する必要があります。
例えば、リポジトリ内の
form designs
という名前のフォルダーには
form.xdp
という名前のフォームデザインが含まれます。フォームデザインにアクセスするには、Form To Render プロパティに "
/form.xdp
" と入力し、Content Root URI プロパティに "
repository:///formdesigns
" と入力します。作成される絶対パスは repository:///formdesigns/form.xdp で、フォームデザインにアクセスするために必要です。
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 フォームを正しく表示するために役立ちます。
Form Data
レンダリング中にフォームとマージするデータを表す
文書
値。XML 形式で提供されるフォームデータは、
deserialize
関数を使用してデシリアライズする必要があります(『
deserialize
』の「deserialize
」を参照)
。
リテラル値を指定する場合は、省略記号ボタン
をクリックして、Select Asset ダイアログボックスを開きます(
Select Asset について
を参照)。
HTML Render Options
HTML フォームのレンダリングのためのランタイムオプションを表す
HTMLRenderSpec
値。
リテラル値を指定する場合、表示される次のフィールドを変更できます。
-
HTML Output Type:
-
レンダリングされたページを
HTML
タグまたは
BODY
タグで囲むかどうかを設定します。レンダリングされた HTML ページを別の HTML ページの一部にする場合、
BODY
タグで HTML をレンダリングします。次のいずれかの値を選択します。
-
Use Server Default:
-
(デフォルト)AEM forms サーバー上で設定されているデフォルトの出力形式設定を使用します。出力形式設定は、管理コンソールを使用して設定されます(『
Forms 管理ヘルプ
』を参照)。
-
Full HTML tags:
-
レンダリングされたページが
HTML
タグで囲まれます。
-
Body Tags:
-
レンダリングされたページが
BODY
タグで囲まれます。
-
Character Set:
-
出力バイトストリームをエンコードするための文字セットを設定します。使用する文字セットを選択するか、または次のいずれかの値を選択します。
-
Use Server Default:
-
(デフォルト)AEM forms サーバー上で設定されている文字セット設定を使用します。文字セット設定は、管理コンソールから設定します。(『
Forms 管理ヘルプ
』を参照)。
-
Use Custom Value:
-
この値を選択した後、リスト内にないエンコーディングセットの正規名(Java.nio API)を入力します。文字セットのリストについては、http://java.sun.com/j2se/1.5.0/docs/guide/intl/encoding.doc.html を参照してください。
-
Start Page Number:
-
複数ページの HTML フォーム内でレンダリングを開始するページ番号を設定します。ページ番号が 0 の場合、最初のページが 0 ページであることを意味します。デフォルト値は
0
です。
-
Locale:
-
HTML フォームがレンダリングされるときに、Web ブラウザーなどのクライアントアプリケーションに検証メッセージを送信するために使用される言語を設定します。リストから言語を選択するか、または次のいずれかの値を選択します。
-
Use Server Default:
-
(デフォルト)AEM forms サーバー上で設定されているロケール設定を使用します。ロケール設定は、管理コンソールで Forms から設定します。(『
Forms 管理ヘルプ
』を参照)。
-
Use Custom Value:
-
このオプションを選択した後、リスト内にないロケールコードのロケール ID を入力します。サポートされるロケールコードのリストについては、http://java.sun.com/j2se/1.5.0/docs/guide/intl/locale.doc.html を参照してください。
-
Cache Form On Server:
-
パフォーマンスを向上させるために、レンダリングされたフォームがサーバー上でキャッシュされるかどうかを設定します。フォームデザインに埋め込まれる処理命令。「Form Rendering Cache Enabled」オプションでは、キャッシュの実行方法が決定されます。管理コンソールの「フォームレンダリングキャッシュが有効です」オプションの設定について、詳しくはForms の設定を参照してください。
-
「偽」:
-
フォームがサーバー上でキャッシュされません。
-
「真」:
-
フォームがサーバー上でキャッシュされます。
-
Populate XML Data:
-
フォームの現在の処理状態に基づいてフォームから XML データが生成されるかどうかを設定します。次のいずれかの値を選択します。
-
「偽」:
-
(デフォルト)XML データが生成されません。
-
「真」:
-
XML データが生成されます。
-
Stand Alone Rendition:
-
状態情報なしでフォームをレンダリングできるかどうかを設定します。状態情報は、送信のためにユーザーによるサーバーとのやりとりが必要なレンダリングされたフォームに使用されます。次のいずれかの値を選択します。
-
「偽」:
-
(デフォルト)状態情報なし、クライアントの Web ブラウザーで実行する埋め込み JavaScript なしでフォームがレンダリングされます。Forms サービスでは、サーバー側で計算が実行された後にフォームがレンダリングされ、結果がレンダリングされたフォームに結果が表示されます。Forms サービスとのやりとりが要求されるため、オフラインの場合にフォームを使用することはできません。
-
「真」:
-
状態情報および埋め込み JavaScript とともにフォームがレンダリングされます。JavaScript コードは、サーバーとやりとりすることなくクライアント上で実行されます。また、フォームはオフラインで使用できます。
-
dt
-
フォームに埋め込まれたスクリプトが実行される場所を設定します。次のいずれかの値を選択します。
-
dt
-
(デフォルト)Forms サービスではフォームデザインをチェックして、クライアントまたはサーバーのどちらでレンダリングするかどうかが決定されます。
-
dt
-
フォームがクライアントでレンダリングされます。サーバーで実行するスクリプトを使用しません。この値が選択される場合、サーバーで実行するスクリプトによって AEM forms サーバーで警告が生成されます。
-
dt
-
フォームがサーバーでレンダリングされます。
-
dt
-
フォームがサーバーとクライアントの両方でレンダリングされます。
-
dt
-
レンダリングに使用する XCI ファイルの URI の場所を指定する値を設定します。ルートが指定されていない場合、このファイルは AEM forms EAR ファイルが展開される場所にあると想定されます。例えば、JBoss の自動インストールで、
[Install folder]
/jboss/server/lc_turnkey/svcdata/XMLFormService フォルダー内のデフォルト XCI ファイルを参照できます。
[Install folder]
は AEM forms がインストールされる場所です。XCI ファイルの作成に関する詳細は、『
Designer ヘルプ
』を参照してください。
-
Digital Signature CSS URI:
-
C:¥¥customds.css
のように、HTML フォームのデジタル署名ユーザーインターフェイスに使用するカスタムスタイルシートの URI を設定します。AEM forms サーバーは、URI の場所にアクセスできる必要があります。
注意:
カスタム CSS ファイルにアクセスするには、FormsIVS サンプルを使用して、指定したフォームデザインおよび出力形式に基づくカスタム CSS を生成します。
-
Custom CSS URI:
-
C:¥customcss.css
のように、HTML フォームの一部として生成される内部カスケーディングスタイルシートの代わりに使用するカスタムカスケーディングスタイルシートの URI を設定します。フォームデザインが変更された場合、カスタム CSS ファイルで変更を確認します。
-
ボタン、テキスト、テキストフィールド、チェックボックスなどの新しい形式のフォームオブジェクトがフォームデザインに追加されます。
-
フォームオブジェクトがフォームデザインから削除されます。
-
ラベルやフィールドなどのフォームオブジェクトを子サブフォームから親サブフォームに移動します。
AEM forms サーバーは、URI の場所にアクセスできる必要があります。
注意:
カスタム CSS ファイルにアクセスするには、FormsIVS サンプルを使用して、指定したフォームデザインおよび出力形式に基づくカスタム CSS を生成します。
-
HTML Toolbar:
-
HTML フォームにレンダリングされるツールバーのタイプを設定します。次のいずれかの値を選択します。
-
無効:
-
(デフォルト)HTML ツールバーが無効です。
-
垂直方向:
-
HTML ツールバーが垂直位置に表示されます。
-
水平方向:
-
HTML ツールバーが水平位置に表示されます。
-
HTML Toolbar URI:
-
レンダリングされた HTML フォームに含まれる HTML ツールバーリソースの URI 位置を設定します。
-
Generate Tab Index
-
レンダリングされた HTML フォームの各フィールドのタブインデックスを作成するかどうかを設定します。タブインデックスがある HTML フォームがタブインデックスのない別の HTML ページに埋め込まれる場合、タブの不一致が発生する可能性があります。次のいずれかの値を選択します。
-
「真」:
-
(デフォルト)レンダリングされた HTML フォームの各フィールドにタブインデックスが作成されます。
-
「偽」:
-
レンダリングされた HTML フォームの各フィールドにタブインデックスが作成されません。タブインデックスがない別の HTML フォームに HTML フォームを埋め込む場合、このオプションを使用します。
-
Style Generation Level:
-
レンダリングされた HTML フォームに出力するスタイルを設定します。内部スタイルは CSS スタイルの間隔と位置に使用されます。インラインスタイルは、色、フォント、背景色などの外観スタイルに使用されます。次のいずれかの値を選択します。
-
Inline And Internal Styles:
-
(デフォルト)インライン CSS スタイルと内部 CSS スタイルの両方を使用します。内部スタイルでは、CSS スタイルの間隔と位置を使用します。インラインスタイルでは、色、フォント、背景色などの外観スタイルを使用します。
-
Only Inline Styles:
-
カスタム CSS ファイルからインライン CSS スタイルのみを使用します。
-
No Styles:
-
インラインまたは内部スタイルで任意の CSS を使用します。
User Agent
Web ブラウザーなどのクライアントアプリケーションについての情報を提供する
string
値。
USER_AGENT
がこの操作で Environment Variables プロパティの値として指定される場合、このプロパティで指定される値で上書きされます。デフォルト値は
Mozilla/3.*
です。
リテラル値を指定する場合、次のいずれかの値を選択します。
-
Use Server Default:
-
(デフォルト)Mozilla/3.* を使用します。「User Agent」設定はサーバー上で設定できません。
-
Internet Explorer 6.0:
-
ターゲットアプリケーションは Microsoft Internet Explorer です。
-
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)
" と入力します。
URL Options
HTML フォームのレンダリングに必要な URI ランタイム情報を指定する
URLSpec
値。
リテラル値を指定する場合、表示される次のフィールドを変更できます。
-
Application Web Root:
-
アプリケーション固有の Web コンテンツへのアクセスに使用されるルート位置を表す URL を設定します。この値を「Target URL」オプションの値と組み合わせて、絶対送信 URL を構成します。
-
ターゲット URL:
-
ユーザーがフォームを送信したときにクライアントアプリケーションからデータを受信する Web サービスまたは Java サーブレットにアクセスする URL を設定します。このオプションで値を設定すると、フォームデザインでターゲット 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
-
Content Root URI:
-
フォームデザインを取得するリポジトリ内の場所を指定する URI または絶対参照を設定します。この操作でこの値を Form To Render プロパティの値と組み合わせて、フォームへの絶対パスを作成します。
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 を使用して場所を指定できます。
例えば、リポジトリ内の
form designs
という名前のフォルダーには
form.xdp
という名前のフォームデザインが含まれます。フォームデザインにアクセスするには、Form To Render プロパティに "
/form.xdp
" と入力し、Content Root URI プロパティに "
repository:///formdesigns
" と入力します。作成される絶対パスは repository:///formdesigns/form.xdp で、フォームデザインにアクセスするために必要です。
-
Base URL:
-
HTTP 形式のコンテンツルート URI である URL を設定します。この値は、画像やスクリプトなどの外部依存関係への HREF 参照を含む HTML フォーム(
「renderHTMLForm」操作(非推奨)
および
「renderHTMLForm」操作
操作)をレンダリングする場合にのみ必要です。依存パスが絶対パスのとき、この値は無視されます。
添付ファイル
フォームでレンダリングされる添付ファイルを指定する
文書
値の
map
。