计算表单数据 calculating-form-data

Last update: Wed Mar 20 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

创建对象：

Developer

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

Forms服务可以计算用户在表单中输入的值并显示结果。要计算表单数据，必须执行两项任务。首先，创建用于计算表单数据的表单设计脚本。窗体设计支持三种类型的脚本。一种脚本类型在客户端运行，另一种脚本类型在服务器上运行，第三种脚本类型同时在服务器和客户端运行。本主题中讨论的脚本类型在服务器上运行。 HTML、PDF和表单指南（已弃用）转换支持服务器端计算。

在表单设计过程中，您可以使用计算和脚本提供更丰富的用户体验。可将计算和脚本添加到大多数表单字段和对象。创建表单设计脚本，以对用户输入交互式表单的数据执行计算操作。

用户在表单中输入值，然后单击“计算”按钮以查看结果。以下流程描述了允许用户计算数据的示例应用程序：

用户访问名为StartLoan.html的HTML页，该页面用作Web应用程序的起始页。此页调用一个名为的Java Servlet GetLoanForm.
此 GetLoanForm servlet呈现贷款表单。此表单包含脚本、交互式字段、计算按钮和提交按钮。
用户在表单的字段中输入值并单击计算按钮。该表单将发送至 CalculateData 执行脚本的Java Servlet。该表单将发送回用户，并在表单中显示计算结果。
用户继续输入和计算值，直到显示满意的结果。满意后，用户单击“提交”按钮处理表单。该表单将发送到另一个名为的Java Servlet ProcessForm 负责检索已提交的数据。 (请参阅处理提交的Forms.)

下图显示了应用程序的逻辑流。

cf_cf_finsrv_loancalcapp_v1

下表描述了此图中的步骤。

步骤

描述

此 GetLoanForm 从HTML起始页调用Java Servlet。

此 GetLoanForm Java Servlet使用Forms服务客户端API向客户端Web浏览器呈现贷款表单。渲染包含配置为在服务器上运行的脚本的表单与渲染不包含脚本的表单之间的区别在于，您必须指定用于执行脚本的目标位置。如果未指定目标位置，则不会执行配置为在服务器上运行的脚本。例如，请考虑本节中介绍的应用程序。此 CalculateData Java Servlet是执行脚本的目标位置。

用户将数据输入到交互式字段中，然后单击“计算”按钮。该表单将发送至 CalculateData Java Servlet，脚本的执行位置。

表单将呈现回Web浏览器，并在表单中显示计算结果。

当值满意时，用户单击“提交”按钮。该表单将发送到另一个名为的Java Servlet ProcessForm.

通常，作为PDF内容提交的表单包含客户端上执行的脚本。但是，也可以执行服务器端计算。提交按钮不能用于计算脚本。在此情况下，不会执行计算，因为Forms服务认为交互已完成。

为了说明表单设计脚本的使用，本节将检查一个简单的交互式表单，该表单包含配置为在服务器上运行的脚本。下图显示了一个表单设计，该设计包含一个脚本，该脚本添加用户在前两个字段中输入的值并在第三个字段中显示结果。

cf_cf_caldata

答：名为NumericField1的字段 B. 名为NumericField2的字段 C. 名为NumericField3的字段

此窗体设计中的脚本语法如下：

     NumericField3 = NumericField2 + NumericField1

在此窗体设计中，“计算”按钮是一个命令按钮，脚本位于该按钮的 Click 事件。当用户在前两个字段（NumericField1和NumericField2）中输入值并单击“计算”按钮时，表单将发送到Forms服务，并在其中执行脚本。 Forms服务将表单呈现回客户端设备，并在NumericField3字段中显示计算结果。

NOTE

有关创建表单设计脚本的信息，请参阅 Forms Designer.

NOTE

有关Forms服务的更多信息，请参阅 AEM Forms的服务参考.

步骤摘要 summary-of-steps

要计算表单数据，请执行以下任务：

包括项目文件。
创建Forms客户端API对象。
检索包含计算脚本的表单。
将表单数据流写回客户端Web浏览器

包含项目文件

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

创建Forms客户端API对象

您必须先创建Forms服务客户端，然后才能以编程方式执行Forms服务客户端API操作。如果您使用的是Java API，请创建 FormsServiceClient 对象。如果您使用的是Forms Web服务API，请创建 FormsServiceService 对象。

检索包含计算脚本的表单

您可以使用Forms服务客户端API创建应用程序逻辑，该逻辑处理包含配置为在服务器上运行的脚本的表单。该过程与处理提交的表单类似。 (请参阅处理提交的Forms.)

验证与已提交表单关联的处理状态为 1 (Calculate)，这意味着Forms服务正在对表单数据执行计算操作，并且结果必须写回给用户。在这种情况下，将自动执行配置为在服务器上运行的脚本。

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

验证与已提交表单关联的处理状态后， 1，则必须将结果写回客户端Web浏览器。显示表单时，计算值将显示在相应的字段中。

另请参阅

包括AEM Forms Java库文件
 使用Java API计算表单数据
 使用Web服务API计算表单数据
 设置连接属性
 Forms服务API快速启动
 呈现交互式PDF forms
创建可渲染Forms的Web应用程序

使用Java API计算表单数据 calculate-form-data-using-the-java-api

使用Forms API (Java)计算表单数据：

包含项目文件

将客户端JAR文件（如adobe-forms-client.jar）包含在Java项目的类路径中。
创建Forms客户端API对象
- 创建 ServiceClientFactory 包含连接属性的对象。
- 创建 FormsServiceClient 对象，使用它的构造函数传递 ServiceClientFactory 对象。
检索包含计算脚本的表单
- 要检索包含计算脚本的表单数据，请创建 com.adobe.idp.Document 对象通过调用其构造函数 javax.servlet.http.HttpServletResponse 对象的 getInputStream 方法。
- 调用 FormsServiceClient 对象的 processFormSubmission 方法并传递以下值：
  - 此 com.adobe.idp.Document 包含表单数据的对象。
  - 一个字符串值，它指定包含所有相关HTTP标头的环境变量。通过为指定一个或多个值来指定要处理的内容类型 CONTENT_TYPE 环境变量。例如，要处理XML和PDF数据，请为此参数指定以下字符串值： CONTENT_TYPE=application/xml&CONTENT_TYPE=application/pdf
  - 一个字符串值，它指定 HTTP_USER_AGENT 标头值；例如， Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1; SV1; .NET CLR 1.1.4322).
  - A RenderOptionsSpec 存储运行时选项的对象。
  此 processFormSubmission 方法返回 FormsResult 包含表单提交结果的对象。
- 验证与已提交表单关联的处理状态为 1 通过调用 FormsResult 对象的 getAction 方法。如果此方法返回值 1，则执行计算，并且数据可以写回客户端Web浏览器。
将表单数据流写回客户端Web浏览器
- 创建 javax.servlet.ServletOutputStream 用于将表单数据流发送到客户端Web浏览器的对象。
- 创建 com.adobe.idp.Document 对象，方法是调用 FormsResult 对象 getOutputContent 方法。
- 创建 java.io.InputStream 对象，方法是调用 com.adobe.idp.Document 对象的 getInputStream 方法。
- 创建字节数组，并通过调用 InputStream 对象的 read 方法并将字节数组作为参数传递。
- 调用 javax.servlet.ServletOutputStream 对象的 write 将表单数据流发送到客户端Web浏览器的方法。将字节数组传递给 write 方法。

另请参阅

包括AEM Forms Java库文件
 设置连接属性

使用Web服务API计算表单数据 calculate-form-data-using-the-web-service-api

使用Forms API（Web服务）计算表单数据：

包含项目文件
- 创建使用Forms服务WSDL的Java代理类。
- 将Java代理类包含在类路径中。
创建Forms客户端API对象

创建 FormsService 对象并设置身份验证值。
检索包含计算脚本的表单
- 要检索发布到Java Servlet的表单数据，请创建 BLOB 对象。
- 创建 java.io.InputStream 对象 javax.servlet.http.HttpServletResponse 对象的 getInputStream 方法。
- 创建 java.io.ByteArrayOutputStream 对象，其构造函数传递 java.io.InputStream 对象。
- 复制 java.io.InputStream 对象移入 java.io.ByteArrayOutputStream 对象。
- 通过调用 java.io.ByteArrayOutputStream 对象的 toByteArray 方法。
- 填充 BLOB 对象(通过调用其 setBinaryData 方法并将字节数组作为参数传递。
- 创建 RenderOptionsSpec 对象。通过调用 RenderOptionsSpec 对象的 setLocale 方法，并传递一个指定区域设置值的字符串值。
- 调用 FormsServiceClient 对象的 processFormSubmission 方法并传递以下值：
  - 此 BLOB 包含表单数据的对象。
  - 一个字符串值，它指定包含所有相关HTTP标头的环境变量。例如，您可以指定以下字符串值： HTTP_REFERER=referrer&HTTP_CONNECTION=keep-alive&CONTENT_TYPE=application/xml
  - 一个字符串值，它指定 HTTP_USER_AGENT 标头值；例如， Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1; SV1; .NET CLR 1.1.4322).
  - A RenderOptionsSpec 存储运行时选项的对象。有关更多信息，。
  - 空的 BLOBHolder 方法填充的对象。
  - 空的 javax.xml.rpc.holders.StringHolder 方法填充的对象。
  - 空的 BLOBHolder 方法填充的对象。
  - 空的 BLOBHolder 方法填充的对象。
  - 空的 javax.xml.rpc.holders.ShortHolder 方法填充的对象。
  - 空的 MyArrayOf_xsd_anyTypeHolder 方法填充的对象。此参数用于存储与表单一起提交的文件附件。
  - 空的 FormsResultHolder 使用提交表单的方法填充的对象。
  此 processFormSubmission 方法填充 FormsResultHolder 带有表单提交结果的参数。此 processFormSubmission 方法返回 FormsResult 包含表单提交结果的对象。
- 验证与已提交表单关联的处理状态为 1 通过调用 FormsResult 对象的 getAction 方法。如果此方法返回值 1，则执行计算，并且数据可以写回客户端Web浏览器。
将表单数据流写回客户端Web浏览器
- 创建 javax.servlet.ServletOutputStream 用于将表单数据流发送到客户端Web浏览器的对象。
- 创建 BLOB 通过调用 FormsResult 对象的 getOutputContent 方法。
- 创建字节数组，并通过调用 BLOB 对象的 getBinaryData 方法。此任务分配 FormsResult 对象。
- 调用 javax.servlet.http.HttpServletResponse 对象的 write 将表单数据流发送到客户端Web浏览器的方法。将字节数组传递给 write 方法。

另请参阅
使用Base64编码调用AEM Forms

recommendation-more-help

19ffd973-7af2-44d0-84b5-d547b0dffee2