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

レンダリングエンドポイント 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 forms はデータを送信し、AEMサーバーでサーバー側スクリプトと Web サービスを実行します。 AEMサーバーでサーバー側スクリプトと Web サービスを実行するために使用されるパラメーターについて詳しくは、 HTML5 forms サービスプロキシ.

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2