使用条形码表单

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

关于条形码表单服务

条形码表单服务可自动从填写和打印表单中捕获数据，并将捕获的信息集成到组织的核心IT系统中。

使用条形码表单服务，您可以向交互式PDF forms添加一维和二维条形码。 然后，您可以将条形码表单发布到网站或通过电子邮件或CD分发。 当用户使用Adobe Reader、Acrobat Professional或Acrobat Standard填写条形码表单时，条形码会自动更新以对用户提供的表单数据进行编码。 用户可以以电子方式提交表格，或打印成纸张，然后通过邮件、传真或手提方式提交表格。 您稍后可以提取用户提供的数据作为自动工作流的一部分，在审批流程和业务系统之间传送数据。

有关条形码表单服务的更多信息，请参阅 AEM Forms服务参考.

解码条形码表单数据

您可以使用条形码表单服务API对PDF表单或包含条形码的图像中的数据进行解码。 解码表单数据是指提取位于条形码中的数据。 在从PDF表单（或图像）解码数据之前，用户必须用数据填充表单。

步骤摘要

要对PDF表单中的数据进行解码，请执行以下步骤：

1. 包括项目文件。
2. 创建条形码表单客户端API对象。
3. 获取包含条形码数据的PDF表单。
4. 从PDF表单中对数据进行解码。
5. 将数据转换为XML数据源。
6. 处理解码的数据。

包含项目文件

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

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

• adobe-livecycle-client.jar
• adobe-usermanager-client.jar
• adobe-barcodedforms-client.jar
• adobe-utilities.jar(在JBoss上部署AEM Forms时必需)
• jbossall-client.jar(在JBoss上部署AEM Forms时必需)
• xercesImpl.jar(位于 <install directory="">/Adobe/Adobe_Experience_Manager_forms/sdk/client-libs\thirdparty)

如果AEM Forms部署在非JBOSS的受支持J2EE应用程序服务器上，则您将需要将adobe-utilities.jar和jbossall-client.jar替换为特定于部署了AEM Forms的J2EE应用程序服务器的JAR文件。 有关所有AEM Forms JAR文件的位置的信息，请参阅 包括AEM Forms Java库文件.

创建条形码表单客户端API对象

在以编程方式执行条形码表单服务操作之前，必须创建条形码Forms服务客户端。 如果您使用的是Java API，请创建 BarcodedFormsServiceClient 对象。 如果您使用条形码表单Web服务API，请创建 BarcodedFormsServiceService 对象。

获取包含条形码数据的PDF表单

您必须获取包含已填充用户数据的条形码的PDF表单。

从PDF表单中解码数据

获取包含条形码的PDF表单（或图像）后，可以对数据进行解码。 条形码Forms服务支持以下类型的条形码：

• PDF417条形码。
• 数据矩阵条形码。
• 二维码条码。
• 科达巴尔条形码。
• 码128条形码。
• 39码条形码。
• EAN-13条形码。
• EAN-8条形码。

在解码API中输入为十六进制的字符集意味着条形码的内容被编码为十六进制字符串。 例如，如果UTF-8以格式指定为字符编码，而在解码操作中指定十六进制，则条形码的内容将在< xb:content>元素。 您可以通过在客户端应用程序中创建应用程序逻辑来转换此十六进制值以获取原始内容。

将数据转换为XML数据源

对表单数据进行解码后，可将其转换为XDP或XFDF数据。 例如，假定您要将数据导入其他表单。 要将数据导入XFA表单，则必须将数据转换为XDP数据。 有关信息，请参阅 导入表单数据.

处理解码的数据

您可以处理转换后的数据以满足您的业务需求。 例如，在对数据进行解码和转换后，您可以将其保存到文件中，将其存储在企业数据库中，填充其他表单，等等。 本节讨论如何将转换后的数据另存为XML文件。

另请参阅

使用Java API对条形码表单数据进行解码

使用Web服务API对条形码表单数据进行解码

包括AEM Forms Java库文件

设置连接属性

使用Java API对条形码表单数据进行解码

使用条形码表单API(Java)对表单数据进行解码：

1. 包含项目文件

   将客户端JAR文件包含在您Java项目的类路径中。

2. 创建条形码表单客户端API对象

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

3. 获取包含条形码数据的PDF表单

   • 创建 java.io.FileInputStream 表示PDF表单的对象，该表单通过使用其构造函数并传递指定PDF文档位置的字符串值来包含条形码数据。
   • 创建 com.adobe.idp.Document 对象，并使用其构造函数进行传递 java.io.FileInputStream 对象。

4. 从PDF表单中解码数据

   通过调用 BarcodedFormsServiceClient 对象 decode 方法和传递以下值：

   • 的 com.adobe.idp.Document 包含PDF表单的对象。
   • A java.lang.Boolean 指定是否对PDF417条形码进行解码的对象。
   • A java.lang.Boolean 指定是否对数据矩阵条形码进行解码的对象。
   • A java.lang.Boolean 指定是否对QR代码条形码进行解码的对象。
   • A java.lang.Boolean 指定是否对codabar条形码进行解码的对象。
   • A java.lang.Boolean 指定是否解码代码128条形码的对象。
   • A java.lang.Boolean 指定是否解码代码39条形码的对象。
   • A java.lang.Boolean 指定是否对EAN-13条形码进行解码的对象。
   • A java.lang.Boolean 指定是否解码EAN-8条形码的对象。
   • A com.adobe.livecycle.barcodedforms.CharSet 用于指定条形码中使用的字符集编码值的枚举值。

   的 decode 方法返回 org.w3c.dom.Document 包含已解码表单数据的对象。

5. 将数据转换为XML数据源

   通过调用 BarcodedFormsServiceClient 对象 extractToXML 方法和传递以下值：

   • 的 org.w3c.dom.Document 包含解码数据的对象(确保您使用 decode 方法的返回值)。
   • A com.adobe.livecycle.barcodedforms.Delimiter 指定行分隔符的枚举值。 建议您指定 Delimiter.Carriage_Return.
   • A com.adobe.livecycle.barcodedforms.Delimiter 指定字段分隔符的枚举值。 例如，指定 Delimiter.Tab.
   • A com.adobe.livecycle.barcodedforms.XMLFormat 枚举值，指定是将条形码数据转换为XDP还是XFDF XML数据。 例如，指定 XMLFormat.XDP 将数据转换为XDP数据。
   注意

   请勿为行分隔符和字段分隔符参数指定相同的值。

   的 extractToXML 方法返回 java.util.List 每个元素为 org.w3c.dom.Document 对象。 表单上的每个条形码都有一个单独的元素。 也就是说，如果表单上有四个条码，则返回的中会有四个元素 java.util.List 对象。

6. 处理解码的数据

   • 循环访问 java.util.List 对象来获取每个 org.w3c.dom.Document 位于列表中的对象。
   • 对于列表中的每个元素，转换 org.w3c.dom.Document 对象 com.adobe.idp.Document 对象。 (转换 org.w3c.dom.Document 对象 com.adobe.idp.Document 对象（使用Java API示例在解码条形码表单数据中显示）。
   • 通过调用 com.adobe.idp.Document 对象 copyToFile，并传递表示XML文件的文件对象。

另请参阅

快速入门（SOAP模式）：使用Java API解码条形码表单数据

包括AEM Forms Java库文件

设置连接属性

使用Web服务API对条形码表单数据进行解码

使用条形码表单API（Web服务）对表单数据进行解码：

1. 包含项目文件

   • 创建使用条形码表单服务WSDL的Microsoft .NET客户端程序集。 有关信息，请参阅 使用Base64编码调用AEM Forms.
   • 引用Microsoft .NET客户端程序集。 有关信息，请参阅 使用Base64编码调用AEM Forms.

2. 创建条形码表单客户端API对象

   使用使用条形码表单服务WSDL的Microsoft .NET客户端程序集，创建 BarcodedFormsServiceService 对象。

3. 获取包含条形码数据的PDF表单

   • 创建 BLOB 对象。 的 BLOB 对象用于存储包含条形码的PDF文档。
   • 创建 System.IO.FileStream 对象，方法是调用其构造函数并传递一个字符串值，该字符串值表示PDF文档的文件位置以及打开文件的模式。
   • 创建用于存储 System.IO.FileStream 对象。 您可以通过获取 System.IO.FileStream 对象 Length 属性。
   • 通过调用 System.IO.FileStream 对象 Read 方法及传递要读取的字节数组、起始位置及流长度。
   • 填充 BLOB 通过指定对象 binaryData 属性。

4. 从PDF表单中解码数据

   通过调用 BarcodedFormsServiceService 对象 decode 方法和传递以下值：

   • 的 BLOB 包含PDF表单的对象。
   • A Boolean 指定是否对PDF417条形码进行解码的对象。
   • A Boolean 指定是否对数据矩阵条形码进行解码的对象。
   • A Boolean 指定是否对QR代码条形码进行解码的对象。
   • A Boolean 指定是否对codabar条形码进行解码的对象。
   • A Boolean 指定是否解码代码128条形码的对象。
   • A Bolean 指定是否解码代码39条形码的对象。
   • A Boolean 指定是否对EAN-13条形码进行解码的对象。
   • A Boolean 指定是否解码EAN-8条形码的对象。
   • A CharSet 用于指定条形码中使用的字符集编码值的枚举值。

   的 decode 方法返回包含已解码表单数据的字符串值。

5. 将数据转换为XML数据源

   通过调用 BarcodedFormsServiceService 对象 extractToXML 方法和传递以下值：

   • 包含解码数据的字符串值(请确保使用 decode 方法的返回值)。
   • A Delimiter 指定行分隔符的枚举值。 建议您指定 Delimiter.Carriage_Return.
   • A Delimiter 指定字段分隔符的枚举值。 例如，指定 Delimiter.Tab.
   • A XMLFormat 枚举值，指定是将条形码数据转换为XDP还是XFDF XML数据。 例如，指定 XMLFormat.XDP 将数据转换为XDP数据。
   注意

   请勿为行分隔符和字段分隔符参数指定相同的值。

   的 extractToXML 方法返回 Object 每个元素都是 BLOB 实例。 表单上的每个条形码都有一个单独的元素。 也就是说，如果表单上有四个条码，则返回的中会有四个元素 Object 数组。

6. 处理解码的数据

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

另请参阅

使用Base64编码调用AEM Forms

Business.Adobe.com 资源

Personalized Experiences Customer Communications Embedded Charts Dynamic Media Customer Experience Management Digital Asset Management