将Forms渲染为HTML rendering-forms-as-html

本文档中的示例和示例仅适用于JEE环境上的AEM Forms。

Forms服务将表单渲染为HTML，以响应来自Web浏览器的HTTP请求。 将表单渲染为HTML的好处是，客户端Web浏览器所在的计算机不需要Adobe Reader、Acrobat或Flash Player(适用于表单指南（已弃用）)。

要将表单渲染为HTML，必须将表单设计另存为XDP文件。 保存为PDF文件的表单设计无法呈现为HTML。 在Designer中开发将作为HTML呈现的表单设计时，请考虑以下条件：

HTML页面 html-pages

当窗体设计呈现为HTML窗体时，每个第二级子窗体呈现为HTML页（面板）。 您可以在Designer中查看子表单的层次结构。 属于根子表单的子表单（根子表单的默认名称为form1）是面板子表单。 以下示例显示了窗体设计的子窗体。

     form1
         Master Pages
         PanelSubform1
             NestedDynamicSubform
                 TextEdit1
         PanelSubform2
             TextEdit1
         PanelSubform3
             TextEdit1
         PanelSubform4
             TextEdit1

当窗体设计呈现为HTML窗体时，面板不受任何特定页面大小的限制。 如果您有动态子表单，则应将它们嵌套在面板子表单中。 动态子表单能够扩展到无限数量的HTML页。

当表单呈现为HTML表单时，页面大小(对呈现为PDF的表单进行分页所必需的)没有任何意义。 由于具有流式布局的表单可以扩展到无限数量的HTML页，因此请务必避免在母版页上使用页脚。 母版页上HTML区域下面的页脚可能会覆盖流过页面边界的内容内容。

您必须使用xfa.host.pageUp和xfa.host.pageDown方法明确地在面板之间移动。 您可以通过向Forms服务发送表单并让Forms服务将表单渲染回客户端设备（通常是Web浏览器）来更改页面。

.fsc-ds-ssb：此样式表适用于符号字段为空的字段。

.fsc-ds-ssv：此样式表适用于存在有效符号字段的情况。

.fsc-ds-ssc：此样式表适用于存在有效符号字段但数据已更改的情况。

.fsc-ds-ssi：此样式表适用于存在无效签名字段的情况。

.fsc-ds-popup-bg：未使用此样式表属性。

。fsc-ds-popup-btn：未使用此样式表属性。

正在运行脚本 running-scripts

表单作者指定脚本是在服务器上还是客户端上执行。 Forms服务创建用于执行表单智能的分布式事件处理环境，该环境可通过使用runAt属性在客户端和服务器之间分发。 有关此特性或在表单设计中创建脚本的信息，请参阅Forms Designer

Forms服务可以在渲染表单时执行脚本。 因此，您可以通过连接到数据库或客户端上可能没有的Web服务来预填充包含数据的表单。 您还可以将按钮的Click事件设置为在服务器上运行，以便客户端将数据往返到服务器。 这允许客户端在用户与表单交互时运行可能需要服务器资源的脚本，例如企业数据库。 对于HTML表单，formcalc脚本只能在服务器上执行。 因此，您必须将这些脚本标记为在server或both运行。

您可以通过调用xfa.host.pageUp和xfa.host.pageDown方法设计在页面（面板）之间移动的表单。 此脚本放置在按钮的Click事件中，runAt属性设置为Both。 您选择Both的原因是，Adobe Reader或Acrobat(对于呈现为PDF的表单)无需转至服务器即可更改页面，而HTML表单则可通过将数据舍入到服务器来更改页面。 即，将表单发送到Forms服务，并将表单呈现为HTML，同时显示新页面。

建议不要为脚本变量和表单字段指定相同的名称，例如项目。 某些Web浏览器（如Internet Explorer）可能无法初始化与表单字段同名的变量，从而导致出现脚本错误。 为表单字段和脚本变量指定不同的名称是一种好的做法。

在呈现包含页面导航功能和表单脚本的HTML表单时（例如，假设脚本在每次呈现表单时都从数据库中检索字段数据），请确保表单脚本采用form：calculate事件，而不是form：readyevent。

form：ready事件形式的表单脚本在表单的初始渲染期间只执行一次，而不会在后续页面检索中执行。 相反，对于渲染表单的每个页面导航执行form：calculate事件。

您可以在提交表单之前调用自定义脚本。 此功能在所有可用的浏览器上运行。 但是，它只能在用户渲染其Output Type属性设置为Form Body的HTML表单时使用。 当Output Type为Full HTML时，它将不起作用。 有关配置此功能的步骤，请参阅管理帮助中的配置表单。

首先定义在提交表单之前调用的回调函数，该函数的名称为_user_onsubmit。 假定函数不会引发任何异常，或者如果引发异常，将忽略该异常。 建议将JavaScript函数放置在html的head部分中；但是，您可以在包含xfasubset.js的脚本标记结尾之前的任意位置声明该函数。

当表单服务器呈现包含下拉列表的XDP时，除了创建下拉列表之外，还会创建两个隐藏的文本字段。 这些文本字段存储下拉列表的数据（一个字段存储选项的显示名称，另一个字段存储选项的值）。 因此，每次用户提交表单时，都会提交下拉列表的整个数据。 假设您不希望每次都提交那么多的数据，则可以编写自定义脚本来禁用它。 例如：下拉列表的名称为drpOrderedByStateProv，它封装在子表单标题下。 HTML输入元素的名称将为header[0].drpOrderedByStateProv[0]。 存储和提交下拉列表数据的隐藏字段的名称具有以下名称： header[0].drpOrderedByStateProv_DISPLAYITEMS_[0] header[0].drpOrderedByStateProv_VALUEITEMS_[0]

如果不想发布数据，可以通过以下方式禁用这些输入元素。var __CUSTOM_SCRIPTS_VERSION = 1; //enabling the feature function _user_onsubmit() { var elems = document.getElementsByName("header[0].drpOrderedByStateProv_DISPLAYITEMS_[0]"); elems[0].disabled = true; elems = document.getElementsByName("header[0].drpOrderedByStateProv_VALUEITEMS_[0]"); elems[0].disabled = true; }

header[0].drpOrderedByStateProv_DISPLAYITEMS_[0] header[0].drpOrderedByStateProv_VALUEITEMS_[0]

var __CUSTOM_SCRIPTS_VERSION = 1; //enabling the feature
    function _user_onsubmit() {
    var elems = document.getElementsByName("header[0].drpOrderedByStateProv_DISPLAYITEMS_[0]");
    elems[0].disabled = true;
    elems = document.getElementsByName("header[0].drpOrderedByStateProv_VALUEITEMS_[0]");
    elems[0].disabled = true;
    }

XFA子集 xfa-subsets

在创建要呈现为HTML的表单设计时，必须将脚本限制为JavaScript语言脚本的XFA子集。

在客户端上运行或在客户端和服务器上运行的脚本必须写入到XFA子集中。 在服务器上运行的脚本可以使用完整的XFA脚本模型，也可以使用FormCalc。 有关使用JavaScript的信息，请参阅Forms Designer。

在客户端上运行脚本时，只有正在显示的当前面板可以使用脚本；例如，当显示面板B时，您无法针对面板A中的字段编写脚本。 在服务器上运行脚本时，可以访问所有面板。

在客户端上运行的脚本中使用脚本对象模型(SOM)表达式时要小心。 在客户端上运行的脚本仅支持SOM表达式的简化子集。

事件计时 event-timing

XFA子集定义映射到HTML事件的XFA事件。 计算事件和验证事件的时间在行为上略有差异。 在Web浏览器中，退出字段时会执行完全计算事件。 当您对字段值做出更改时，计算事件不会自动执行。 您可以通过调用xfa.form.execCalculate方法强制计算事件。

在Web浏览器中，验证事件仅在退出字段或提交表单时执行。 您可以使用xfa.form.execValidate方法强制验证事件。

在Web浏览器中显示的Forms(与Adobe Reader或Acrobat不同)符合必填字段的XFA null测试（错误或警告）。

有关null测试的更多信息，请参阅Forms Designer。

表单按钮 form-buttons

单击提交按钮会将表单数据发送到Forms服务，并显示表单处理过程的结束。 可以将preSubmit事件设置为在客户端或服务器上运行。 如果将preSubmit事件配置为在客户端上运行，则它会在提交表单之前运行。 否则，在提交表单期间，preSubmit事件将在服务器上运行。 有关preSubmit事件的详细信息，请参阅Forms Designer。

如果按钮没有与其关联的客户端脚本，则会将数据提交到服务器，在服务器上执行计算，并重新生成HTML表单。 如果按钮包含客户端脚本，则不会将数据发送到服务器，并且客户端脚本将在Web浏览器中执行。

HTML4.0 Web浏览器 html-4-0-web-browser

仅支持HTML4.0的Web浏览器无法支持XFA子集客户端脚本模型。 在创建可在HTML4.0和MSDHTML或CSS2HTML中运行的表单设计时，标记为在客户端运行的脚本实际上将在服务器上运行。 例如，假设用户单击了位于HTML4.0 Web浏览器中显示的表单上的按钮。 在这种情况下，表单数据将发送到执行客户端脚本的服务器。

建议您将表单逻辑放置在计算事件中，这些计算事件在HTML为4.0的服务器以及用于MSDHTML或CSS2HTML的客户端上运行。

维护演示文稿更改 maintaining-presentation-changes

在HTML页面（面板）之间移动时，只会保留数据的状态。 不会维护诸如背景颜色或必填字段设置之类的设置（如果与初始设置不同）。 要保持表示状态，您必须创建表示字段表示状态的字段（通常为隐藏字段）。 如果向字段的Calculate事件添加脚本，该脚本根据隐藏字段值更改演示文稿，则在HTML页面（面板）之间来回移动时，可以保留演示状态。

以下脚本根据hiddenField的值维护字段的fillColor。 假定此脚本位于字段的Calculate事件中。

     If (hiddenField.rawValue == 1)
         this.fillColor = "255,0,0"
     else
         this.fillColor = "0,255,0"

对HTML表单进行数字签名 digitally-signing-html-forms

如果包含数字签名字段的HTML表单呈现为以下HTML转换之一，则无法对该表单进行签名：

有关对文档进行数字签名的信息，请参阅数字签名和认证文档

呈现符合辅助功能准则的XHTML表单 rendering-an-accessibility-guidelines-compliant-xhtml-form

您可以渲染符合辅助功能准则的完整HTML表单。 也就是说，表单在完整HTML标签中呈现，而不是在body标签中呈现HTML表单(不是完整的HTML页面)。

验证表单数据 validating-form-data

在将表单渲染为HTML表单时，建议您限制对表单字段使用验证规则。 HTML表单可能不支持某些验证规则。 例如，当将MM-DD-YYYY验证模式应用于窗体设计中以HTML窗体呈现的Date/Time字段时，即使正确键入了日期，该模式也无法正常工作。 但是，此验证模式可正确用于呈现为PDF的表单。

步骤摘要 summary-of-steps

要呈现HTML表单，请执行以下步骤：

包含项目文件

在开发项目中包含必要的文件。 如果要使用Java创建客户端应用程序，请包含必要的JAR文件。 如果使用Web服务，请确保包含代理文件。

创建Forms客户端API对象

您必须先创建表单数据集成服务客户端，然后才能以编程方式将数据导入PDF表单客户端API。 创建服务客户端时，您可以定义调用服务所需的连接设置。

设置HTML运行时选项

在渲染HTML表单时，您可以设置HTML运行时选项。 例如，您可以将工具栏添加到HTML表单，以使用户能够选择位于客户端计算机上的文件附件，或检索使用HTML表单呈现的文件附件。 默认情况下，HTML工具栏处于禁用状态。 要将工具栏添加到HTML表单，必须以编程方式设置运行时选项。 默认情况下，HTML工具栏由以下按钮组成：

当HTML表单上出现HTML工具栏时，用户可以选择最多十个文件与表单数据一起提交。 提交文件后，Forms服务即可检索文件。

将表单渲染为HTML时，您可以指定用户代理值。 用户代理值提供浏览器和系统信息。 这是一个可选值，您可以传递空字符串值。 使用Java API快速入门呈现HTML表单展示了如何获取用户代理值并将其用于HTML呈现表单。

要发布表单数据的HTTP URL，可以通过使用Forms服务客户端API设置目标URL来指定，也可以在XDP表单设计中包含的提交按钮中指定。 如果在表单设计中指定了目标URL，请不要使用Forms服务客户端API设置值。

呈现HTML表单

要呈现HTML表单，请指定在Designer中创建并另存为XDP文件的表单设计。 选择HTML转换类型。 例如，您可以指定用于呈现Internet Explorer 5.0或更高版本的动态HTML的HTML转换类型。

呈现HTML表单还需要值，例如呈现其他表单类型所需的URI值。

将表单数据流写入客户端Web浏览器

当Forms服务渲染HTML表单时，它会返回一个您必须写入客户端Web浏览器的表单数据流。 在写入客户端Web浏览器时，HTML表单对用户可见。

另请参阅

使用Java API将表单渲染为HTML

使用Web服务API将表单渲染为HTML

包括AEM Forms Java库文件

设置连接属性

Forms服务API快速启动

呈现交互式PDF forms

使用自定义工具栏呈现HTMLForms

创建可渲染Forms的Web应用程序

使用Java API将表单渲染为HTML render-a-form-as-html-using-the-java-api

使用Forms API (Java)渲染HTML表单：

另请参阅

将Forms渲染为HTML

快速入门(SOAP模式)：使用Java API呈现HTML表单

包括AEM Forms Java库文件

设置连接属性

使用Web服务API将表单渲染为HTML render-a-form-as-html-using-the-web-service-api

使用Forms API（Web服务）渲染HTML表单：

另请参阅

将Forms渲染为HTML

使用Base64编码调用AEM Forms