计算表单数据

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

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

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

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

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

下表介绍了此图中的步骤。

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

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

A. 名为NumericField1的字段 B. 名为NumericField2的字段 C. 名为NumericField3的字段

位于此表单设计中的脚本的语法如下所示：

     NumericField3 = NumericField2 + NumericField1

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

步骤摘要

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

1. 包括项目文件。
2. 创建Forms客户端API对象。
3. 检索包含计算脚本的表单。
4. 将表单数据流写回客户端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库文件

设置连接属性

Forms Service API快速入门

呈现交互式PDF forms

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

使用Java API计算表单数据

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

1. 包含项目文件

   将客户端JAR文件（如Java项目的类路径中的adobe-forms-client.jar）包含在内。

2. 创建Forms客户端API对象

   • 创建 ServiceClientFactory 包含连接属性的对象。
   • 创建 FormsServiceClient 对象，并使用其构造函数进行传递 ServiceClientFactory 对象。

3. 检索包含计算脚本的表单

   • 要检索包含计算脚本的表单数据，请创建 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浏览器。

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

   • 创建 javax.servlet.ServletOutputStream 用于将表单数据流发送到客户端web浏览器的对象。
   • 创建 com.adobe.idp.Document 对象 FormsResult 对象s getOutputContent 方法。
   • 创建 java.io.InputStream 对象 com.adobe.idp.Document 对象 getInputStream 方法。
   • 通过调用 InputStream 对象 read 方法并将字节数组作为参数进行传递。
   • 调用 javax.servlet.ServletOutputStream 对象 write 将表单数据流发送到客户端web浏览器的方法。 将字节数组传递到 write 方法。

另请参阅

包括AEM Forms Java库文件

设置连接属性

使用Web服务API计算表单数据

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

1. 包含项目文件

   • 创建使用Forms服务WSDL的Java代理类。
   • 将Java代理类包含到类路径中。

2. 创建Forms客户端API对象

   创建 FormsService 对象，并设置身份验证值。

3. 检索包含计算脚本的表单

   • 要检索发布到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浏览器。

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

   • 创建 javax.servlet.ServletOutputStream 用于将表单数据流发送到客户端web浏览器的对象。
   • 创建 BLOB 通过调用包含表单数据的对象 FormsResult 对象 getOutputContent 方法。
   • 创建一个字节数组，并通过调用 BLOB 对象 getBinaryData 方法。 此任务分配 FormsResult 对象。
   • 调用 javax.servlet.http.HttpServletResponse 对象 write 将表单数据流发送到客户端web浏览器的方法。 将字节数组传递到 write 方法。

另请参阅

使用Base64编码调用AEM Forms

Business.Adobe.com 资源

Asset Collections Theme Editor Managed Cloud Version History Digital Rights Management Content Management System