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

Forms服务会响应来自Web浏览器的HTTP请求，将表单呈现为HTML。 呈现表单作为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 event中，而不是form:readyevent中。

位于表单：ready事件中的表单脚本在表单的初始渲染期间仅执行一次，且不会为后续页面检索执行。 相反，会为呈现表单的每个页面导航执行表单：计算事件。

您可以在提交表单之前调用自定义脚本。 此功能适用于所有可用的浏览器。 但是，仅当用户渲染具有其HTML表单时，才能使用该插件 Output Type 属性设置为 Form Body. 当 Output Type is Full HTML. 有关配置此功能的步骤，请参阅管理帮助中的配置表单。

您必须先定义一个在提交表单之前调用的回调函数，其中函数的名称为 _user_onsubmit. 假定函数不会引发任何异常，或者如果引发了异常，则会忽略该异常。 建议将JavaScript函数放置在html的标题部分；但是，您可以在脚本标记(包括 xfasubset.js.

当formserver呈现包含下拉列表的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 方法。

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

有关空测试的更多信息，请参阅 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浏览器中显示的表单上的按钮。 在这种情况下，表单数据会发送到执行客户端脚本的服务器。

建议将表单逻辑放置在计算事件中，该事件在HTML4.0的服务器上运行，在MSDHTML或CSS2HTML的客户端上运行。

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

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

以下脚本将维护 fillColor 的值 hiddenField. 假定此脚本位于字段的 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标记中，而不是呈现在主体标记(不是完整HTML页面)中的HTML表单。

验证表单数据 validating-form-data

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

步骤摘要 summary-of-steps

要渲染HTML表单，请执行以下步骤：

包含项目文件

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

创建Forms客户端API对象

在以编程方式将数据导入PDFformClient 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 Service 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