HTML5 forms服务代理

上次更新： 2023-12-07

HTML5表单服务代理是一种用于注册提交服务的代理的配置。要配置服务代理，请通过请求参数指定提交服务的URL submissionServiceProxy.

Service Proxy的优势

服务代理消除了以下情况：

HTML5表单工作流需要为HTML5表单用户打开提交服务“/content/xfaforms/submission/default”。它向更广泛的意外受众公开AEM服务器。
服务URL将嵌入到表单的运行时模型中。无法更改服务URL路径。
提交分为两步。要提交表单数据，提交至少需要两次历程才能到达服务器。因此，会增加服务器的负载。
HTML5表单以POST请求而不是PDF请求发送数据。对于同时涉及PDF和HTML5表单的工作流，需要两种不同的方法来处理提交。

HTML5表单可以使用以下拓扑连接到AEM服务器。

HTML5 forms服务代理拓扑

HTML5表单连接到AEM服务器以运行服务器端脚本、Web服务和提交。 HTML5表单的XFA运行时使用对“/bin/xfaforms/submitaction”端点的Ajax调用和各种参数连接到AEM服务器。 HTML5 forms连接AEM服务器以执行以下操作：

标记为在服务器上运行的脚本称为服务器端脚本。下表列出了服务器端脚本和Web服务中使用的所有参数。

参数	描述
活动	活动包含触发请求的事件。例如，单击、退出或更改
contextSom	contextSom包含执行事件的对象的SOM表达式。
模板	模板包含用于呈现表单的模板。
contentRoot	contentRoot包含用于呈现表单的模板根目录。
数据	数据包含用于呈现表单的bata字节。
formDom	formDom包含JSON格式的HTML5表单的DOM。
数据包	数据包被指定为表单。
debugDir	debugDir包含用于呈现表单的调试目录。

单击“提交”按钮时，HTML5表单会向服务器发送数据。下表列出了HTML5表单发送到服务器的所有参数。

如果请求参数中不存在提交URL，则提交服务代理将充当传递。它充当传递函数。它将请求发送到/bin/xfaforms/submitaction终结点，并将响应发送到XFA运行时。

如果submiturl出现在请求参数中，则提交服务代理会选择拓扑。

如果AEM服务器发布数据，则代理服务将充当传递服务器。它将请求发送到/bin/xfaforms/submitaction终结点，并将响应发送到XFA运行时。
如果代理将数据发布，则代理服务会将除submitUrl之外的所有参数传递给 /bin/xfaforms/submitaction 终结点并接收响应流中的xml字节。然后，代理服务将数据xml字节发布到submitUrl进行处理。
在将数据(POST请求)发送到服务器之前，HTML5表单验证服务器的连接性和可用性。为了验证连接性和可用性，HTML表单向服务器发送一个空的head请求。如果服务器可用，HTML5表单向服务器发送数据(POST请求)。如果服务器不可用，则会显示错误消息， 无法连接到服务器， 将显示。该预先检测可以防止用户重新填写表单的麻烦。代理servlet处理head请求并且不会引发异常。