呈现HTML5表单的表单模板

渲染端点

HTML5表单的概念为​用户档案,这些表单作为REST端点公开,以支持表单模板的移动渲染。 这些用户档案具有关联的​用户档案渲染器。 它们是JSP页,负责通过调用FormsOSGi服务生成表单的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

渲染参数

以HTML形式呈现表单时支持的请求参数包括:

参数 描述
模板
此参数指定模板文件的名称。
contentRoot
此参数指定模板和相关资源所在的路径。 此路径可以是服务器文件系统路径、存储库路径、http或ftp路径。
submitUrl
此参数指定将表单数据xml发布到的url。

将数据与表单模板合并

参数 描述
dataRef 此参数指定与模板合并的数据文件的​绝对路径。 此参数可以是以xml格式返回数据的其余服务的URL。
数据 此参数指定与模板合并的UTF-8编码数据字节。 如果指定此参数,HTML5表单将忽略dataRef参数。

传递渲染参数

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。

提交参数

HTML5表单提交数据;在AEM服务器上执行服务器端脚本和web服务。 有关用于在AEM服务器上执行服务器端脚本和Web服务的参数的详细信息,请参见HTML5 forms Service Proxy

在此页面上