处理提交的Forms

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

使用户能够填写交互式表单的基于Web的应用程序要求将数据提交回服务器。 使用Forms服务，您可以检索用户输入交互式表单中的数据。 检索数据后，您可以处理数据以满足业务要求。 例如，您可以将数据存储在数据库中，将数据发送到另一个应用程序，将数据发送到另一个服务，将数据合并到表单设计中，在Web浏览器中显示数据，等等。

表单数据将作为XML或PDF数据（在Designer中设置的一个选项）提交到Forms服务。 以XML形式提交的表单允许您提取单个字段数据值。 也就是说，您可以提取用户在表单中输入的每个表单字段的值。 作为PDF数据提交的表单是二进制数据，而不是XML数据。 您可以将表单另存为PDF文件，或将表单发送到其他服务。 如果要从以XML形式提交的表单中提取数据，然后使用该表单数据创建PDF文档，请调用另一个AEM Forms操作。 (请参阅 使用提交的XML数据创建PDF单据)

下图显示了提交到名为的Java Servlet的数据 HandleData 从Web浏览器中显示的交互式表单。

下表说明了图中的步骤。

处理提交的XML数据

将表单数据作为XML提交时，您可以检索表示所提交数据的XML数据。 所有表单字段在XML架构中显示为节点。 节点值对应于用户填充的值。 考虑一个贷款表单，其中表单中的每个字段都显示为XML数据中的一个节点。 每个节点的值对应于用户填充的值。 假设用户使用下表中显示的数据填写贷款表单。

下图显示了使用Forms服务客户端API检索的相应XML数据。

贷款表单中的字段。 可以使用Java XML类检索这些值。

处理提交的PDF数据

假定有一个Web应用程序调用Forms服务。 在Forms服务将交互式PDF表单呈现给客户端Web浏览器后，用户填写表单并将其作为PDF数据提交回。 当Forms服务收到PDF数据时，它可以将PDF数据发送到另一个服务或将其保存为PDF文件。 下图显示了应用程序的逻辑流。

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

处理提交的URL UTF-16数据

如果表单数据作为URL UTF-16数据提交，则客户端计算机需要Adobe Reader或Acrobat 8.1或更高版本。 此外，如果表单设计包含具有URL编码数据(HTTP Post)的提交按钮，并且数据编码选项为UTF-16，则必须在文本编辑器（例如记事本）中修改表单设计。 您可以将编码选项设置为 UTF-16LE 或 UTF-16BE （对于“提交”按钮）。 Designer不提供此功能。

步骤摘要

要处理提交的表单，请执行以下任务：

1. 包括项目文件。
2. 创建Forms客户端API对象。
3. 检索表单数据。
4. 确定表单提交是否包含文件附件。
5. 处理提交的数据。

包括项目文件

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

创建Forms客户端API对象

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

检索表单数据

要检索已提交的表单数据，您需要调用 FormsServiceClient 对象的 processFormSubmission 方法。 调用此方法时，您必须指定已提交表单的内容类型。 当数据从客户端Web浏览器提交到Forms服务时，可以作为XML或PDF数据提交。 要检索输入到表单字段中的数据，可将该数据作为XML数据提交。

您还可以通过设置以下运行时选项，从作为PDF数据提交的表单中检索表单字段：

• 将以下值传递给 processFormSubmission 方法作为内容类型参数： CONTENT_TYPE=application/pdf.
• 设置 RenderOptionsSpec 对象的 PDFToXDP 值至 true
• 设置 RenderOptionsSpec 对象的 ExportDataFormat 值至 XMLData

在调用时，您可以指定提交的表单的内容类型 processFormSubmission 方法。 以下列表指定了适用的内容类型值：

• text/xml：表示在PDF表单以XML形式提交表单数据时使用的内容类型。
• application/x-www-form-urlencoded：表示在HTML表单以XML形式提交数据时使用的内容类型。
• application/pdf：表示在PDF表单将数据提交为PDF时使用的内容类型。

您可以检索发布到Forms服务的表单数据，并确定其处理状态。 也就是说，将数据提交到Forms服务时，这并不一定意味着Forms服务已完成数据处理，数据已准备好进行处理。 例如，可以将数据提交到Forms服务，以便执行计算。 计算完成后，表单将呈现回用户，并显示计算结果。 在处理提交的数据之前，建议您确定Forms服务是否已完成处理数据。

Forms服务会返回以下值，以指示它是否已完成处理数据：

• 0（提交）： 提交的数据已准备好处理。
• 1（计算）： Forms服务对数据执行了计算操作，结果必须呈现回用户。
• 2（验证）： Forms服务已验证表单数据，必须将结果呈现回用户。
• 3（下一个）： 当前页面已更改，结果必须写入客户端应用程序。
• 4（上一个）)：当前页面已更改，结果必须写入客户端应用程序。

确定表单提交是否包含文件附件

提交到Forms服务的Forms可以包含文件附件。 例如，使用Acrobat的内置附件窗格，用户可以选择要与表单一起提交的文件附件。 此外，用户还可以使用呈现为HTML文件的HTML工具栏选择文件附件。

确定表单是否包含文件附件后，即可处理数据。 例如，可以将文件附件保存到本地文件系统。

处理提交的数据

根据提交数据的内容类型，您可以从提交的XML数据中提取单个表单字段值，或将提交的PDF数据保存为PDF文件（或将其发送到其他服务）。 要提取单个表单字段，请将提交的XML数据转换为XML数据源，然后使用检索XML数据源值 org.w3c.dom 类。

另请参阅

包括AEM Forms Java库文件

设置连接属性

Forms服务API快速启动

将文档传递到Forms服务

创建渲染Forms的Web应用程序

使用Java API处理提交的表单

使用Forms API (Java)处理提交的表单：

1. 包括项目文件

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

2. 创建Forms客户端API对象

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

3. 检索表单数据

   • 要检索发布到Java Servlet的表单数据，请创建 com.adobe.idp.Document 对象通过调用其构造函数 javax.servlet.http.HttpServletResponse 对象的 getInputStream 方法。
   • 创建 RenderOptionsSpec 对象。 通过调用 RenderOptionsSpec 对象的 setLocale 方法，并传递一个指定区域设置值的字符串值。
   注意

   您可以通过调用，指示Forms服务根据提交的PDF内容创建XDP或XML数据 RenderOptionsSpec 对象的 setPDF2XDP 方法和传递 true 并调用 setXMLData 和传递 true. 然后，您可以调用 FormsResult 对象的 getOutputXML 用于检索与XDP/XML数据对应的XML数据的方法。 (此 FormsResult 对象由 processFormSubmission 方法，这将在下一个子步骤中说明。)

   • 调用 FormsServiceClient 对象的 processFormSubmission 方法，并传递以下值：

     • 此 com.adobe.idp.Document 包含表单数据的对象。
     • 一个字符串值，指定包含所有相关HTTP标头的环境变量。 指定要处理的内容类型。 要处理XML数据，请为此参数指定以下字符串值： CONTENT_TYPE=text/xml. 要处理PDF数据，请为此参数指定以下字符串值： 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 包含表单提交结果的对象。

   • 确定Forms服务是否通过调用 FormsResult 对象的 getAction 方法。 如果此方法返回值 0，则数据已准备好处理。

4. 确定表单提交是否包含文件附件

   • 调用 FormsResult 对象的 getAttachments 方法。 此方法会返回 java.util.List 包含随表单一起提交的文件的对象。
   • 循环访问 java.util.List 用于确定是否存在文件附件的对象。 如果有文件附件，则每个元素都为 com.adobe.idp.Document 实例。 您可以通过调用 com.adobe.idp.Document 对象的 copyToFile 方法和传递 java.io.File 对象。
   注意

   此步骤仅适用于以PDF形式提交的表单。

5. 处理提交的数据

   • 如果数据内容类型为 application/vnd.adobe.xdp+xml 或 text/xml，创建应用程序逻辑以检索XML数据值。

     • 创建 com.adobe.idp.Document 对象 FormsResult 对象的 getOutputContent 方法。
     • 创建 java.io.InputStream 对象 java.io.DataInputStream 构造函数并传递 com.adobe.idp.Document 对象。
     • 创建 org.w3c.dom.DocumentBuilderFactory 对象(通过调用静态 org.w3c.dom.DocumentBuilderFactory 对象的 newInstance 方法。
     • 创建 org.w3c.dom.DocumentBuilder 对象 org.w3c.dom.DocumentBuilderFactory 对象的 newDocumentBuilder 方法。
     • 创建 org.w3c.dom.Document 对象 org.w3c.dom.DocumentBuilder 对象的 parse 方法和传递 java.io.InputStream 对象。
     • 检索XML文档中每个节点的值。 完成此任务的一种方法是创建接受两个参数的自定义方法： org.w3c.dom.Document 对象以及要检索其值的节点的名称。 此方法返回表示节点值的字符串值。 在此过程后的代码示例中，调用此自定义方法 getNodeText. 显示了该方法的主体。

   • 如果数据内容类型为 application/pdf，创建应用程序逻辑以将提交的PDF数据另存为PDF文件。

     • 创建 com.adobe.idp.Document 对象 FormsResult 对象的 getOutputContent 方法。
     • 创建 java.io.File 对象。 请确保指定PDF作为文件扩展名。
     • PDF通过调用 com.adobe.idp.Document 对象的 copyToFile 方法和传递 java.io.File 对象。

另请参阅

快速入门（SOAP模式）：使用Java API处理作为XML提交的PDF forms

快速入门（SOAP模式）：使用Java API处理作为XML提交的HTML表单

快速入门（SOAP模式）：使用Java API处理作为PDF提交的PDF forms

包括AEM Forms Java库文件

设置连接属性

使用Web服务API处理提交的PDF数据

使用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 方法，并传递一个指定区域设置值的字符串值。

   • 调用 FormsService 对象的 processFormSubmission 方法，并传递以下值：

     • 此 BLOB 包含表单数据的对象。
     • 一个字符串值，指定包含所有相关HTTP标头的环境变量。 指定要处理的内容类型。 要处理XML数据，请为此参数指定以下字符串值： CONTENT_TYPE=text/xml. 要处理PDF数据，请为此参数指定以下字符串值： 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 存储运行时选项的对象。
     • 空 BLOBHolder 由方法填充的对象。
     • 空 javax.xml.rpc.holders.StringHolder 由方法填充的对象。
     • 空 BLOBHolder 由方法填充的对象。
     • 空 BLOBHolder 由方法填充的对象。
     • 空 javax.xml.rpc.holders.ShortHolder 由方法填充的对象。
     • 空 MyArrayOf_xsd_anyTypeHolder 由方法填充的对象。 此参数用于存储与表单一起提交的文件附件。
     • 空 FormsResultHolder 使用提交表单的方法填充的对象。

     此 processFormSubmission 方法填充 FormsResultHolder 参数以及表单提交的结果。

   • 确定Forms服务是否通过调用 FormsResult 对象的 getAction 方法。 如果此方法返回值 0，则表单数据已准备好处理。 您可以获得 FormsResult 对象，方法是获取 FormsResultHolder 对象的 value 数据成员。

4. 确定表单提交是否包含文件附件

   获取 MyArrayOf_xsd_anyTypeHolder 对象的 value 数据成员( MyArrayOf_xsd_anyTypeHolder 对象已传递到 processFormSubmission 方法)。 此数据成员返回的数组 Objects. 内的每个元素 Object 数组是一个 Object与随表单一起提交的文件相对应。 您可以获取数组中的每个元素，并将其转换为 BLOB 对象。

5. 处理提交的数据

   • 如果数据内容类型为 application/vnd.adobe.xdp+xml 或 text/xml，创建应用程序逻辑以检索XML数据值。

     • 创建 BLOB 对象 FormsResult 对象的 getOutputContent 方法。
     • 通过调用 BLOB 对象的 getBinaryData 方法。
     • 创建 java.io.InputStream 对象 java.io.ByteArrayInputStream 构造函数并传递字节数组。
     • 创建 org.w3c.dom.DocumentBuilderFactory 对象(通过调用静态 org.w3c.dom.DocumentBuilderFactory 对象的 newInstance 方法。
     • 创建 org.w3c.dom.DocumentBuilder 对象 org.w3c.dom.DocumentBuilderFactory 对象的 newDocumentBuilder 方法。
     • 创建 org.w3c.dom.Document 对象 org.w3c.dom.DocumentBuilder 对象的 parse 方法和传递 java.io.InputStream 对象。
     • 检索XML文档中每个节点的值。 完成此任务的一种方法是创建接受两个参数的自定义方法： org.w3c.dom.Document 对象以及要检索其值的节点的名称。 此方法返回表示节点值的字符串值。 在此过程后的代码示例中，调用此自定义方法 getNodeText. 显示了该方法的主体。

   • 如果数据内容类型为 application/pdf，创建应用程序逻辑以将提交的PDF数据另存为PDF文件。

     • 创建 BLOB 对象 FormsResult 对象的 getOutputContent 方法。
     • 通过调用 BLOB 对象的 getBinaryData 方法。
     • 创建 java.io.File 对象。 请确保指定PDF作为文件扩展名。
     • 创建 java.io.FileOutputStream 对象，使用它的构造函数传递 java.io.File 对象。
     • PDF通过调用 java.io.FileOutputStream 对象的 write 方法和传递字节数组。

另请参阅

使用Base64编码调用AEM Forms

Business.Adobe.com 资源

Content Insights Cms Cloud Targeted Content Embedded Charts Digital Rights Management Content Management System