「renderHTMLForm」操作(非推奨)

注意: この操作は現在推奨されていません。代わりに、「「renderHTMLForm」操作」操作を使用します。プロセスをアップグレードする場合、「renderHTMLForm」操作を使用するように変更することをお勧めします。document オブジェクトを使用してフォームデザインまたはフォームデータを参照できない場合のみに「renderHTMLForm」(非推奨)操作を使用します(非推奨操作についてを参照)。

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

例えば、アプリケーションで HTML フォームを表示して、ユーザーが HTML 対応デバイスからフォームを送信することを許可する必要があります。レンダリングするフォームデザインはネットワーク上の場所にあり、これによって参照によってフォームデザインを評価できます。また、HTML フォームは Acrobat または Adobe Reader がクライアントにインストールされているかどうかが不明な場合にも役立ちます。「renderHTMLForm」(非推奨)操作を使用して、自動化されたプロセスの一部として送信できるように、HTML としてフォームをレンダリングします。

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

Input プロパティ

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

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

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

HTML Render Options

HTML フォームのレンダリングのためのランタイムオプションを表す HTMLRenderSpec 値。

リテラル値を指定する場合、表示される次のフィールドを変更できます。

HTML Output Type:
レンダリングされたページを HTML タグまたは BODY タグで囲むかどうかを設定します。レンダリングされた HTML ページを別の HTML ページの一部にする場合、BODY タグで HTML をレンダリングします。次のいずれかの値を選択します。
Use Server Default:
(デフォルト)LiveCycle サーバー上で設定されているデフォルトの出力形式設定を使用します。出力形式設定は、管理コンソールを使用して設定されます(Forms 管理ヘルプを参照)。

Full HTML tags:
レンダリングされたページが HTML タグで囲まれます。

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

Character Set:
出力バイトストリームをエンコードするための文字セットを設定します。使用する文字セットを選択するか、または次のいずれかの値を選択します。
Use Server Default:
(デフォルト)LiveCycle サーバー上で設定されている文字セット設定を使用します。文字セット設定は、管理コンソールを使用して設定されます(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:
(デフォルト)LiveCycle サーバー上で設定されているロケール設定を使用します。ロケール設定は、管理コンソールで 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 の設定」を参照してください。
False:
フォームがサーバー上でキャッシュされません。

True:
フォームがサーバー上でキャッシュされます。

Populate XML Data:
フォームの現在の処理状態に基づいてフォームから XML データが生成されるかどうかを設定します。次のいずれかの値を選択します。
False:
(デフォルト)XML データが生成されません。

True:
XML データが生成されます。

Stand Alone Rendition:
状態情報なしでフォームをレンダリングできるかどうかを設定します。状態情報は、送信のためにユーザーによるサーバーとのやりとりが必要なレンダリングされたフォームに使用されます。次のいずれかの値を選択します。
False:
(デフォルト)状態情報なし、クライアントの Web ブラウザーで実行する埋め込み JavaScript なしでフォームがレンダリングされます。Forms サービスでは、サーバー側で計算が実行された後にフォームがレンダリングされ、結果がレンダリングされたフォームに結果が表示されます。Forms サービスとのやりとりが要求されるため、オフラインの場合にフォームを使用することはできません。

True:
状態情報および埋め込み JavaScript とともにフォームがレンダリングされます。JavaScript コードは、サーバーとやりとりすることなくクライアント上で実行されます。また、フォームはオフラインで使用できます。

dt
フォームに埋め込まれたスクリプトが実行される場所を設定します。次のいずれかの値を選択します。
dt
(デフォルト)Forms サービスではフォームデザインをチェックして、クライアントまたはサーバーのどちらでレンダリングするかどうかが決定されます。

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

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

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

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

Digital Signature CSS URI:
C:¥¥customds.css のように、HTML フォームのデジタル署名ユーザーインターフェイスに使用するカスタムスタイルシートの URI を設定します。LiveCycle サーバーから URI の場所にアクセスできる必要があります。
注意: カスタム CSS ファイルにアクセスするには、FormsIVS サンプルを使用して、指定したフォームデザインおよび出力形式に基づくカスタム CSS を生成します。

Custom CSS URI:
C:¥customcss.css のように、HTML フォームの一部として生成される内部カスケーディングスタイルシートの代わりに使用するカスタムカスケーディングスタイルシートの URI を設定します。フォームデザインが変更された場合、カスタム CSS ファイルで変更を確認します。
  • ボタン、テキスト、テキストフィールド、チェックボックスなどの新しい形式のフォームオブジェクトがフォームデザインに追加されます。

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

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

    LiveCycle サーバーから URI の場所にアクセスできる必要があります。

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

HTML Toolbar:
HTML フォームにレンダリングされるツールバーのタイプを設定します。次のいずれかの値を選択します。
Disabled:
(デフォルト)HTML ツールバーが無効です。

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

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

HTML Toolbar URI:
レンダリングされた HTML フォームに含まれる HTML ツールバーリソースの URI 位置を設定します。

Generate Tab Index
レンダリングされた HTML フォームの各フィールドのタブインデックスを作成するかどうかを設定します。タブインデックスがある HTML フォームがタブインデックスのない別の HTML ページに埋め込まれる場合、タブの不一致が発生する可能性があります。次のいずれかの値を選択します。
True:
(デフォルト)レンダリングされた HTML フォームの各フィールドにタブインデックスが作成されます。

False:
レンダリングされた 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 を構成します。

Target 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] は LiveCycle が展開されるサーバー名で、[port] はアプリケーションサーバーがクライアントソフトウェアへの HTTP アクセスを提供するために使用するポートです。次のポートは、サポートされるアプリケーションサーバーのデフォルトポートです。

  • JBoss:8080

  • WebLogic:7001

  • WebSphere:9080

Content Root URI:
フォームデザインを取得するリポジトリ内の場所を指定する URI または絶対参照を設定します。この操作でこの値を Form To Render プロパティの値と組み合わせて、フォームへの絶対パスを作成します。

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

  • Repository:リポジトリには LiveCycle サーバーにアップロードするアセットが含まれます。値 repository:/// はリポジトリのルートを参照します。最初の 2 つのスラッシュはプロトコル(repository://)の一部であり、3 番目のスラッシュはリポジトリのルートを表します。例えば、ドキュメントフォルダーはリポジトリのルートの下に作成されます。

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

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

Attachments

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

Output プロパティ

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

Rendered Form

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

Output XML

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

Page Count

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

Locale

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

HTML Output Type

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

Forms Result

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

Exceptions

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