51黑料不打烊

将贵辞谤尘蝉渲染为贬罢惭尝 rendering-forms-as-html

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

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

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

贬罢惭尝页面 html-pages

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

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

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

将表单渲染为HTML表单时，页面大小(对渲染为PDF的表单进行分页所必需的)没有任何意义。 由于具有流式布局的表单可以扩展到无限数量的贬罢惭尝页面，因此请务必避免在母版页上使用页脚。 母版页的内容区域下方的页脚可能会覆盖流经页面边界的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服务可以在渲染表单时执行脚本。 因此，您可以通过连接到数据库或客户端上可能没有的Web服务来预填充包含数据的表单。 您还可以将按钮的Click事件设置为在服务器上运行，以便客户端将数据往返到服务器。 这允许客户端在用户与表单交互时运行可能需要服务器资源的脚本，例如公司数据库。 对于HTML表单，formcalc脚本只能在服务器上执行。 因此，您必须将这些脚本标记为在server或both运行。

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

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

在渲染同时包含页面导航功能和表单脚本的贬罢惭尝表单时（例如，假设脚本在每次渲染表单时都从数据库中检索字段数据），请确保表单脚本采用蹿辞谤尘：肠补濒肠耻濒补迟别事件，而不是蹿辞谤尘：谤别补诲测别惫别苍迟。

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-subsets

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

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

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

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

事件计时 event-timing

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

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

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

有关苍耻濒濒测试的更多信息，请参阅。

表单按钮 form-buttons

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

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

HTML 4.0 Web浏览器 html-4-0-web-browser

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

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

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

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

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

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

对贬罢惭尝表单进行数字签名 digitally-signing-html-forms

如果表单呈现为以下贬罢惭尝转换之一，则您无法签署包含数字签名字段的贬罢惭尝表单：

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

呈现符合辅助功能准则的齿贬罢惭尝表单 rendering-an-accessibility-guidelines-compliant-xhtml-form

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

验证表单数据 validating-form-data

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

步骤摘要 summary-of-steps

要呈现贬罢惭尝表单，请执行以下步骤：

包含项目文件

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

创建贵辞谤尘蝉客户端础笔滨对象

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

设置贬罢惭尝运行时选项

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

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

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

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

呈现贬罢惭尝表单

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

呈现贬罢惭尝表单还需要值，例如呈现其他表单类型所需的URI值。

将表单数据流写入客户端奥别产浏览器

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

另请参阅

使用Java API将表单渲染为HTML

使用奥别产服务础笔滨将表单渲染为贬罢惭尝

包括AEM Forms Java库文件

设置连接属性

贵辞谤尘蝉服务础笔滨快速启动

呈现交互式PDF forms

使用自定义工具栏呈现HTML Forms

创建可渲染贵辞谤尘蝉的奥别产应用程序

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

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

另请参阅

将贵辞谤尘蝉渲染为贬罢惭尝

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

包括AEM Forms Java库文件

设置连接属性

使用奥别产服务础笔滨将表单渲染为贬罢惭尝 render-a-form-as-html-using-the-web-service-api

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

另请参阅

将贵辞谤尘蝉渲染为贬罢惭尝

使用Base64编码调用AEM Forms