导入和导出数据

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

关于表单数据集成服务

表单数据集成服务可以将数据导入PDF表单，并从PDF表单导出数据。 导入和导出操作支持两种类型的PDF forms:

• Acrobat表单(在Acrobat中创建)是包含表单字段的PDF文档。
• AdobeXML表单（在Designer中创建）是符合XMLAdobeXML Forms架构(XFA)的PDF文档。

表单数据可以以下列格式之一存在，具体取决于PDF表单的类型：

• XFDF文件，是Acrobat表单数据格式的XML版本。
• XDP文件，即包含表单字段定义的XML文件。 它还可能包含表单字段数据和嵌入的PDF文件。 仅当Designer生成的XDP文件包含嵌入的基本64编码PDF文档时，才能使用它。

您可以使用表单数据集成服务完成以下任务：

• 将数据导入PDF forms。 有关信息，请参阅 导入表单数据.
• 从PDF forms导出数据。 有关信息，请参阅 导出表单数据.

导入表单数据

您可以使用表单数据集成服务将表单数据导入交互式PDF forms。 交互式PDF表单是PDF文档，其中包含一个或多个用于从用户收集信息或显示自定义信息的字段。 表单数据集成服务不支持表单计算、验证或脚本编写。

要将数据导入在Designer中创建的表单，必须引用有效的XDP XML数据源。 请考虑以下示例抵押申请表。

要将数据值导入此表单，您必须具有与表单对应的有效XDP XML数据源。 不能使用任意XML数据源通过表单数据集成服务将数据导入表单。 任意XML数据源与XDP XML数据源的区别在于，XDP数据源符合XML Forms架构(XFA)。 以下XML表示与示例抵押申请表单对应的XDP XML数据源。

 <?xml version="1.0" encoding="UTF-8" ?>
 - <xfa:datasets xmlns:xfa="https://www.xfa.org/schema/xfa-data/1.0/">
 - <xfa:data>
 - <data>
     - <Layer>
         <closeDate>1/26/2007</closeDate>
         <lastName>Johnson</lastName>
         <firstName>Jerry</firstName>
         <mailingAddress>JJohnson@NoMailServer.com</mailingAddress>
         <city>New York</city>
         <zipCode>00501</zipCode>
         <state>NY</state>
         <dateBirth>26/08/1973</dateBirth>
         <middleInitials>D</middleInitials>
         <socialSecurityNumber>(555) 555-5555</socialSecurityNumber>
         <phoneNumber>5555550000</phoneNumber>
     </Layer>
     - <Mortgage>
         <mortgageAmount>295000.00</mortgageAmount>
         <monthlyMortgagePayment>1724.54</monthlyMortgagePayment>
         <purchasePrice>300000</purchasePrice>
         <downPayment>5000</downPayment>
         <term>25</term>
         <interestRate>5.00</interestRate>
     </Mortgage>
 </data>
 </xfa:data>
 </xfa:datasets>

步骤摘要

要将表单数据导入PDF表单，请执行以下步骤：

1. 包括项目文件。
2. 创建表单数据集成服务客户端。
3. 引用PDF表单。
4. 引用XML数据源。
5. 将数据导入PDF表单。
6. 将PDF表单另存为PDF文件。

包含项目文件

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

必须将以下JAR文件添加到项目的类路径中：

• adobe-livecycle-client.jar
• adobe-usermanager-client.jar
• adobe-formdataintegration-client.jar
• adobe-utilities.jar(在JBoss上部署AEM Forms时必需)
• jbossall-client.jar(在JBoss上部署AEM Forms时必需)

有关这些JAR文件的位置的信息，请参阅 包括AEM Forms Java库文件.

创建表单数据集成服务客户端

在以编程方式将数据导入PDF表单客户端API之前，您必须创建数据集成服务客户端。 在创建服务客户端时，您可以定义调用服务所需的连接设置。 有关信息，请参阅 设置连接属性.

引用PDF表单

要将数据导入PDF表单，您必须引用在Designer中创建的XML表单或在Acrobat中创建的Acrobat表单。

引用XML数据源

要导入表单数据，必须引用有效的数据源。 要将数据导入在Designer中创建的XFA XML表单，必须使用XDP XML数据源。 如果引用Acrobat表单，则必须使用XFDF数据源。 对于要将数据导入的每个字段，必须指定一个值。 如果位于XML数据源中的元素与表单中的字段不对应，则将忽略该元素。

将数据导入PDF表单

在引用PDF表单和有效的XML数据源后，可以将数据导入PDF表单。

将PDF表单另存为PDF文件

将数据导入表单后，可以将表单另存为PDF文件。 保存为PDF文件后，用户可以在Adobe Reader或Acrobat中打开表单，并查看包含导入数据的表单。

另请参阅

使用Java API导入表单数据

使用Web服务API导入表单数据

包括AEM Forms Java库文件

设置连接属性

表单数据集成服务API快速入门

导出表单数据

使用Java API导入表单数据

使用表单数据集成API(Java)导入表单数据：

1. 包括项目文件。

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

2. 创建表单数据集成服务客户端。

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

3. 引用PDF表单。

   • 创建 java.io.FileInputStream 对象。 传递指定PDF表单位置的字符串值。
   • 创建 com.adobe.idp.Document 用于存储PDF表单的对象 com.adobe.idp.Document 构造函数。 传递 java.io.FileInputStream 包含构造函数的PDF表单的对象。

4. 引用XML数据源。

   • 创建 java.io.FileInputStream 对象，并传递一个字符串值，该字符串值指定包含要导入表单数据的XML文件的位置。
   • 创建 com.adobe.idp.Document 使用 com.adobe.idp.Document 构造函数。 传递 java.io.FileInputStream 包含构造函数表单数据的对象。

5. 将数据导入PDF表单。

   通过调用将数据导入PDF表单 FormDataIntegrationClient 对象 importData 方法和传递以下值：

   • 的 com.adobe.idp.Document 用于存储PDF表单的对象。
   • 的 com.adobe.idp.Document 用于存储表单数据的对象。

   的 importData 方法返回 com.adobe.idp.Document 用于存储包含位于XML数据源中的数据的PDF表单的对象。

6. 将PDF表单另存为PDF文件。

   • 创建 java.io.File 对象，并确保文件扩展名为“。PDF”。
   • 调用 Document 对象 copyToFile 复制内容的方法 Document 对象到文件(确保使用 Document 由返回的对象 importData 方法)。

另请参阅

步骤摘要

快速入门（SOAP模式）：使用Java API导入表单数据

包括AEM Forms Java库文件

设置连接属性

使用Web服务API导入表单数据

使用表单数据集成API（Web服务）导入表单数据：

1. 包括项目文件。

   创建使用MTOM的Microsoft .NET项目。 确保使用以下WSDL定义： http://localhost:8080/soap/services/FormDataIntegration?WSDL&lc_version=9.0.1.

   注意

   替换 localhost 具有托管AEM Forms的服务器的IP地址。

2. 创建表单数据集成服务客户端。

   • 创建 FormDataIntegrationClient 对象。

   • 创建 FormDataIntegrationClient.Endpoint.Address 对象 System.ServiceModel.EndpointAddress 构造函数。 将指定WSDL的字符串值传递到AEM Forms服务(例如， http://localhost:8080/soap/services/FormDataIntegration?blob=mtom.) 您无需使用 lc_version 属性。 在创建服务引用时，会使用此属性。 但是，请指定 ?blob=mtom 来使用MTOM。

   • 创建 System.ServiceModel.BasicHttpBinding 对象，方法是获取 FormDataIntegrationClient.Endpoint.Binding 字段。 将返回值转换为 BasicHttpBinding.

   • 设置 System.ServiceModel.BasicHttpBinding 对象 MessageEncoding 字段 WSMessageEncoding.Mtom. 此值可确保使用MTOM。

   • 通过执行以下任务，启用基本HTTP身份验证：

     • 将AEM表单用户名分配给字段 FormDataIntegrationClient.ClientCredentials.UserName.UserName.
     • 为字段分配相应的密码值 FormDataIntegrationClient.ClientCredentials.UserName.Password.
     • 指定常量值 HttpClientCredentialType.Basic 到字段 BasicHttpBindingSecurity.Transport.ClientCredentialType.
     • 指定常量值 BasicHttpSecurityMode.TransportCredentialOnly 到字段 BasicHttpBindingSecurity.Security.Mode.

3. 引用PDF表单。

   • 创建 BLOB 对象。 此 BLOB 对象用于存储PDF表单。
   • 创建 System.IO.FileStream 对象。 传递一个字符串值，以指定PDF表单的位置以及打开文件的模式。
   • 创建用于存储 System.IO.FileStream 对象。 您可以通过获取 System.IO.FileStream 对象 Length 属性。
   • 通过调用 System.IO.FileStream 对象 Read 方法。 传递字节数组、开始位置和流长度以读取。
   • 填充 BLOB 通过指定对象 MTOM 字段中，显示字节数组的内容。

4. 引用XML数据源。

   • 创建 BLOB 对象。 此 BLOB 对象用于存储导入到表单中的数据。
   • 创建 System.IO.FileStream 对象。 传递一个字符串值，以指定包含要导入数据的XML文件的位置以及打开文件的模式。
   • 创建用于存储 System.IO.FileStream 对象。 您可以通过获取 System.IO.FileStream 对象 Length 属性。
   • 通过调用 System.IO.FileStream 对象 Read 方法。 传递字节数组、开始位置和流长度以读取。
   • 填充 BLOB 通过指定对象 MTOM 字段中，显示字节数组的内容。

5. 将数据导入PDF表单。

   通过调用将数据导入PDF表单 FormDataIntegrationClient 对象 importData 方法和传递以下值：

   • 的 BLOB 用于存储PDF表单的对象。
   • 的 BLOB 用于存储表单数据的对象。

   的 importData 方法返回 BLOB 用于存储包含位于XML数据源中的数据的PDF表单的对象。

6. 将PDF表单另存为PDF文件。

   • 创建 System.IO.FileStream 对象，方法是调用其构造函数并传递一个表示该PDF文件位置的字符串值。
   • 创建用于存储 BLOB 由返回的对象 importData 方法。 通过获取 BLOB 对象 MTOM 字段。
   • 创建 System.IO.BinaryWriter 对象，方法是调用其构造函数并传递 System.IO.FileStream 对象。
   • 通过调用 System.IO.BinaryWriter 对象 Write 方法和传递字节数组。

另请参阅

步骤摘要

使用MTOM调用AEM Forms

导出表单数据

您可以使用表单数据集成服务从交互式PDF表单导出表单数据。 导出的数据的格式取决于表单类型。 如果表单类型是在Acrobat中创建的Acrobat表单，则导出的数据为XFDF。 如果表单类型是在Designer中创建的XML表单，则导出的数据为XDP。

步骤摘要

要从PDF表单导出表单数据，请执行以下步骤：

1. 包含项目文件
2. 创建表单数据集成服务客户端。
3. 引用PDF表单。
4. 从PDF表单导出数据。
5. 将导出的数据另存为XML文件。

包含项目文件

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

必须将以下JAR文件添加到项目的类路径中：

• adobe-livecycle-client.jar
• adobe-usermanager-client.jar
• adobe-formdataintegration-client.jar
• adobe-utilities.jar(在JBoss上部署AEM Forms时必需)
• jbossall-client.jar(在JBoss上部署AEM Forms时必需)

创建表单数据集成服务客户端

在以编程方式将数据导入PDF表单客户端API之前，您必须创建数据集成服务客户端。 在创建服务客户端时，您可以定义调用服务所需的连接设置。 有关信息， 设置连接属性.

引用PDF表单

要从PDF表单导出PDF，必须引用在Designer或Acrobat中创建并包含表单数据的表单。 如果尝试从空的PDF表单导出数据，您将获得空的XML架构。

从PDF表单导出数据

引用包含表单数据的PDF表单后，可以从表单导出数据。 数据在基于表单的XML架构中导出。

将表单数据另存为XML文件

导出表单数据后，可以将数据另存为XML文件。 保存为XML文件后，可以在XML查看器中打开XML文件以查看表单数据。

另请参阅

使用Java API导出表单数据

使用Web服务API导出表单数据

包括AEM Forms Java库文件

设置连接属性

表单数据集成服务API快速入门

导入表单数据

使用Java API导出表单数据

使用表单数据集成API(Java)导出表单数据：

1. 包括项目文件。

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

2. 创建表单数据集成服务客户端。

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

3. 引用PDF表单。

   • 创建 java.io.FileInputStream 对象，并传递一个字符串值，该字符串值指定包含要导出数据的PDF表单的位置。
   • 创建 com.adobe.idp.Document 用于存储PDF表单的对象 com.adobe.idp.Document 构造函数。 传递 java.io.FileInputStream 包含构造函数的PDF表单的对象。

4. 从PDF表单导出数据。

   通过调用 FormDataIntegrationClient 对象 exportData 方法和通过 com.adobe.idp.Document 用于存储PDF表单的对象。 此方法将返回 com.adobe.idp.Document 将表单数据存储为XML模式的对象。

5. 将PDF表单另存为PDF文件。

   • 创建 java.io.File 对象，并确保文件扩展名为XML。
   • 调用 Document 对象 copyToFile 复制内容的方法 Document 对象到文件(确保使用 Document 由返回的对象 exportData 方法)。

另请参阅

步骤摘要

快速入门（SOAP模式）：使用Java API导出表单数据

包括AEM Forms Java库文件

设置连接属性

使用Web服务API导出表单数据

使用表单数据集成API（Web服务）导出表单数据：

1. 包括项目文件。

   创建使用MTOM的Microsoft .NET项目。 确保使用以下WSDL定义： http://localhost:8080/soap/services/FormDataIntegration?WSDL&lc_version=9.0.1.

   • 替换 localhost 具有托管AEM Forms的服务器的IP地址。

2. 创建表单数据集成服务客户端。

   • 创建 FormDataIntegrationClient 对象。

   • 创建 FormDataIntegrationClient.Endpoint.Address 对象 System.ServiceModel.EndpointAddress 构造函数。 将指定WSDL的字符串值传递到AEM Forms服务(例如， http://localhost:8080/soap/services/FormDataIntegration?blob=mtom.) 您无需使用 lc_version 属性。 在创建服务引用时，会使用此属性。 但是，请指定 ?blob=mtom 来使用MTOM。

   • 创建 System.ServiceModel.BasicHttpBinding 对象，方法是获取 FormDataIntegrationClient.Endpoint.Binding 字段。 将返回值转换为 BasicHttpBinding.

   • 设置 System.ServiceModel.BasicHttpBinding 对象 MessageEncoding 字段 WSMessageEncoding.Mtom. 此值可确保使用MTOM。

   • 通过执行以下任务，启用基本HTTP身份验证：

     • 将AEM表单用户名分配给字段 FormDataIntegrationClient.ClientCredentials.UserName.UserName.
     • 为字段分配相应的密码值 FormDataIntegrationClient.ClientCredentials.UserName.Password.
     • 指定常量值 HttpClientCredentialType.Basic 到字段 BasicHttpBindingSecurity.Transport.ClientCredentialType.
     • 指定常量值 BasicHttpSecurityMode.TransportCredentialOnly 到字段 BasicHttpBindingSecurity.Security.Mode.

3. 引用PDF表单。

   • 创建 BLOB 对象。 此 BLOB 对象用于存储从中导出数据的PDF表单。
   • 创建 System.IO.FileStream 对象。 传递一个字符串值，以指定PDF表单的位置以及打开文件的模式。
   • 创建用于存储 System.IO.FileStream 对象。 您可以通过获取 System.IO.FileStream 对象 Length 属性。
   • 通过调用 System.IO.FileStream 对象 Read 方法及传递要读取的字节数组、起始位置及流长度。
   • 填充 BLOB 通过指定对象 MTOM 字段中，显示字节数组的内容。

4. 从PDF表单导出数据。

   通过调用将数据导入PDF表单 FormDataIntegrationClient 对象 exportData 方法和通过 BLOB 用于存储PDF表单的对象。 此方法将返回 BLOB 将表单数据存储为XML模式的对象。

5. 将PDF表单另存为PDF文件。

   • 创建 System.IO.FileStream 对象，方法是调用其构造函数并传递表示XML文件位置的字符串值。
   • 创建用于存储 BLOB 由返回的对象 exportData 方法。 通过获取 BLOB 对象 MTOM 字段。
   • 创建 System.IO.BinaryWriter 对象，方法是调用其构造函数并传递 System.IO.FileStream 对象。
   • 通过调用 System.IO.BinaryWriter 对象 Write 方法和传递字节数组。

另请参阅

步骤摘要

使用MTOM调用AEM Forms

使用SwaRef调用AEM Forms

Business.Adobe.com 资源

Personalized Experiences Responsive Forms Theme Editor Content As A Service Version History Digital Rights Management