文档AEM 6.4Forms 指南

计算表单数据 calculating-form-data

Last update: Thu May 04 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

创建对象：

  • Developer
CAUTION
AEM 6.4已结束扩展支持，本文档将不再更新。 有关更多详细信息，请参阅 技术支助期. 查找支持的版本 此处.

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

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

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

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

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

cf_cf_finsrv_loancalcapp_v1

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

步骤
描述
1
的 GetLoanForm Java Servlet将从HTML开始页调用。
2
的 GetLoanForm Java Servlet使用Forms服务客户端API将贷款表单渲染到客户端Web浏览器。 呈现包含配置为在服务器上运行的脚本的表单与呈现不包含脚本的表单之间的区别在于，您必须指定用于执行脚本的目标位置。 如果未指定目标位置，则不会执行配置为在服务器上运行的脚本。 例如，请考虑此部分中引入的应用程序。 的 CalculateData Java Servlet是执行脚本的目标位置。
3
用户将数据输入到交互字段中并单击“计算”按钮。 表单将发送到 CalculateData Java Servlet，执行脚本。
4
表单会呈现回Web浏览器，并且计算结果会显示在表单中。
5
当值满意时，用户单击“提交”按钮。 表单将被发送到另一个名为 ProcessForm.

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

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

cf_cf_caldata

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

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

     NumericField3 = NumericField2 + NumericField1

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

NOTE
有关创建表单设计脚本的信息，请参阅 Forms Designer.
NOTE
有关Forms服务的更多信息，请参阅 AEM Forms服务参考.

步骤摘要 summary-of-steps

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

  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计算表单数据 calculate-form-data-using-the-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计算表单数据 calculate-form-data-using-the-web-service-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

recommendation-more-help
a6ebf046-2b8b-4543-bd46-42a0d77792da