HTML5表单的呈现表单模板 rendering-form-template-for-html-forms

CAUTION
AEM 6.4已结束扩展支持,本文档将不再更新。 有关更多详细信息,请参阅 技术支助期. 查找支持的版本 此处.

呈现端点 render-endpoint

HTML5表单的概念是 用户档案 作为REST端点公开,以启用表单模板的移动渲染。 这些用户档案已关联 配置文件渲染器. 它们是JSP页,负责通过调用Forms OSGi服务来生成表单的HTML表示。 “配置文件”节点的JCR路径确定呈现端点的URL。 指向“default”配置文件的表单的默认渲染端点如下所示:

https://<主机>:<端口>/content/xfaforms/profiles/default.html?contentRoot=<包含xdp表单的文件夹的路径>&template=<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
此参数指定 绝对路径 与模板合并的数据文件的名称。 此参数可以是指向rest服务的URL,该服务将以xml格式返回数据。
数据
此参数指定与模板合并的UTF-8编码数据字节。 如果指定此参数,则HTML5窗体将忽略dataRef参数。

传递呈现参数 passing-the-render-parameter

HTML5表单支持三种传递呈现参数的方法。 您可以通过URL、键值对和配置文件节点传递参数。 在呈现参数中,键值对具有最高优先级,其后跟配置文件节点。 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 请求对象来传递所有渲染参数。 此方法具有最高的优先级。

  • 配置文件节点请求参数: 您可以将渲染参数指定为配置文件节点的节点属性。 在配置文件节点请求参数中,最终用户看不到这些参数。 “配置文件”节点是发送请求的节点。 要将参数指定为节点属性,请使用CRXDE lite。

提交参数 submit-parameters

HTML5个表单提交数据;在AEM服务器上执行服务器端脚本和web服务。 有关在AEM服务器上执行服务器端脚本和Web服务的参数的详细信息,请参阅 HTML5表单服务代理.

recommendation-more-help
a6ebf046-2b8b-4543-bd46-42a0d77792da