HTML5 forms 用のフォームテンプレートのレンダリング rendering-form-template-for-html-forms

Last update: Thu May 04 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

トピック：
Mobile Forms

作成対象：

User

CAUTION

AEM 6.4 の拡張サポートは終了し、このドキュメントは更新されなくなりました。詳細は、技術サポート期間. サポートされているバージョンを見つけるここ.

レンダリングエンドポイント render-endpoint

HTML5 forms には、フォームテンプレートのモバイルレンダリングを可能にするため、REST エンドポイントとして公開される プロファイル の概念があります。これらのプロファイルには関連する プロファイルレンダラー があります。それらは Forms OSGi サービスを呼び出すことでフォームの HTML 表現を生成する役割を持つ JSP ページです。Profile ノードの JCR パスによって、レンダーエンドポイントの URL が決まります。「default」プロファイルを指すフォームのデフォルトのレンダリングエンドポイントは、次のようになります。

https://<host>:<port>/content/xfaforms/profiles/default.html?contentRoot=<path of the folder containg form xdp>&template=<name of the xdp>

例：http://localhost:4502/content/xfaforms/profiles/default.html?contentRoot=c:/xdps&template=sampleForm.xdp

カスタムプロファイルの場合は、それに応じてエンドポイントが変更されます。例えば、hrforms という名前のカスタムプロファイルのエンドポイントは次のようになります。

http://localhost:4502/content/xfaforms/profiles/hrforms.html?contentRoot=c:/xdps&template=sampleForm.xdp

テンプレートが FormSubmission と呼ばれるアプリケーションの AEM リポジトリにある場合、URI は次のとおりです。

http://localhost:4502/content/xfaforms/profiles/default.html?
 contentRoot=crx:///content/dam/formsanddocuments/FormSubmission/1.0
 &template=sampleForm.xdp

レンダリングパラメータ render-parameters

フォームのレンダリング時にサポートされる要求パラメーターは、次のとおりです。HTML:

パラメーター

説明

テンプレート

このパラメータは、テンプレートファイルの名前を指定します。

contentRoot

このパラメーターは、テンプレートと関連するリソースが存在するパスを指定します。このパスは、サーバのファイルシステムパス、リポジトリパス、http、ftp パスのいずれかです。

submitUrl

このパラメーターは、フォームデータ xml が投稿される URL を指定します。

データをフォームテンプレートと結合 merge-data-with-form-template

パラメーター

説明

dataRef

このパラメーターはテンプレートと結合されるデータファイルの 絶対パス を指定します。このパラメーターには XML 形式データを返す REST サービスへの URL を使用できます。

data

このパラメーターは、テンプレートと結合される UTF-8 でエンコードされたデータバイトを指定します。このパラメーターが指定されている場合、HTML5 フォームでは dataRef パラメーターが無視されます。

レンダーパラメーターを渡す passing-the-render-parameter

HTML5 フォームは、レンダリングパラメーターを渡す 3 つの方法をサポートしています。 URL、キーと値のペア、プロファイルノードを使用してパラメーターを渡すことができます。レンダリングパラメーターでは、キーと値のペアが最も高い優先順位を保持し、その後にプロファイルノードが続きます。 URL リクエストパラメーターは最低の優先度を持ちます。

URL リクエストパラメーター: レンダリングパラメーターを URL で指定できます。URL リクエストパラメーターでは、パラメーターはエンドユーザーに対して表示されます。例えば送信 URL http://localhost:4502/content/xfaforms/profiles/default.html?contentRoot=/Applications/FormSubmission/1.0&template=sampleForm.xdp には、その中にテンプレートパラメーターが含まれます。
SetAttribute リクエストパラメーター: レンダリングパラメーターをキー値ペアとして指定できます。SetAttribute リクエストパラメーターでは、パラメーターはエンドユーザーには表示されません。要求を他の JSP からHTML5 フォームのプロファイルレンダラー JSP に転送し、 setAttribute すべてのレンダリングパラメーターを渡すリクエストオブジェクトで使用します。この方法の優先順位が最も高くなります。
プロファイルノードリクエストパラメーター： レンダリングパラメーターをプロファイルノードのノードプロパティとして指定できます。プロファイルノードリクエストパラメーターでは、パラメーターはエンドユーザーには表示されません。 Profile ノードは、要求が送信されるノードです。パラメーターをノードプロパティとして指定するには、CRXDE lite を使用します。

送信パラメーター submit-parameters

HTML5 フォーム送信データ；AEMサーバーでサーバー側スクリプトと web サービスを実行します。 AEMサーバーでサーバー側スクリプトと Web サービスを実行するために使用されるパラメーターについて詳しくは、 HTML5 forms サービスプロキシ.

recommendation-more-help

a6ebf046-2b8b-4543-bd46-42a0d77792da