使用条形码表单 working-with-barcoded-forms
关于条形码表单服务 about-the-barcoded-forms-service
条形码表单服务可自动从填写和打印表单中捕获数据,并将捕获的信息集成到组织的核心IT系统中。
使用条形码表单服务,您可以向交互式PDF forms添加一维和二维条形码。 然后,您可以将条形码表单发布到网站或通过电子邮件或CD分发。 当用户使用Adobe Reader、Acrobat Professional或Acrobat Standard填写条形码表单时,条形码会自动更新以对用户提供的表单数据进行编码。 用户可以以电子方式提交表格,或打印成纸张,然后通过邮件、传真或手提方式提交表格。 您稍后可以提取用户提供的数据作为自动工作流的一部分,在审批流程和业务系统之间传送数据。
有关条形码表单服务的更多信息,请参阅 AEM Forms服务参考.
解码条形码表单数据 decoding-barcoded-form-data
您可以使用条形码表单服务API对PDF表单或包含条形码的图像中的数据进行解码。 解码表单数据是指提取位于条形码中的数据。 在从PDF表单(或图像)解码数据之前,用户必须用数据填充表单。
步骤摘要 summary-of-steps
要对PDF表单中的数据进行解码,请执行以下步骤:
- 包括项目文件。
- 创建条形码表单客户端API对象。
- 获取包含条形码数据的PDF表单。
- 从PDF表单中对数据进行解码。
- 将数据转换为XML数据源。
- 处理解码的数据。
包含项目文件
在开发项目中包含必需的文件。 如果您使用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对条形码表单数据进行解码 decode-barcoded-form-data-using-the-java-api
使用条形码表单API(Java)对表单数据进行解码:
-
包含项目文件
将客户端JAR文件包含在您Java项目的类路径中。
-
创建条形码表单客户端API对象
创建
BarcodedFormsServiceClient
对象,并使用其构造函数进行传递ServiceClientFactory
包含连接属性的对象。 -
获取包含条形码数据的PDF表单
- 创建
java.io.FileInputStream
表示PDF表单的对象,该表单通过使用其构造函数并传递指定PDF文档位置的字符串值来包含条形码数据。 - 创建
com.adobe.idp.Document
对象,并使用其构造函数进行传递java.io.FileInputStream
对象。
- 创建
-
从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
包含已解码表单数据的对象。 - 的
-
将数据转换为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数据。
note note NOTE 请勿为行分隔符和字段分隔符参数指定相同的值。 的
extractToXML
方法返回java.util.List
每个元素为org.w3c.dom.Document
对象。 表单上的每个条形码都有一个单独的元素。 也就是说,如果表单上有四个条码,则返回的中会有四个元素java.util.List
对象。 - 的
-
处理解码的数据
- 循环访问
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文件的文件对象。
- 循环访问
另请参阅
使用Web服务API对条形码表单数据进行解码 decode-barcoded-form-data-using-the-web-service-api
使用条形码表单API(Web服务)对表单数据进行解码:
-
包含项目文件
- 创建使用条形码表单服务WSDL的Microsoft .NET客户端程序集。 有关信息,请参阅 使用Base64编码调用AEM Forms.
- 引用Microsoft .NET客户端程序集。 有关信息,请参阅 使用Base64编码调用AEM Forms.
-
创建条形码表单客户端API对象
使用使用条形码表单服务WSDL的Microsoft .NET客户端程序集,创建
BarcodedFormsServiceService
对象。 -
获取包含条形码数据的PDF表单
- 创建
BLOB
对象。 的BLOB
对象用于存储包含条形码的PDF文档。 - 创建
System.IO.FileStream
对象,方法是调用其构造函数并传递一个字符串值,该字符串值表示PDF文档的文件位置以及打开文件的模式。 - 创建用于存储
System.IO.FileStream
对象。 您可以通过获取System.IO.FileStream
对象Length
属性。 - 通过调用
System.IO.FileStream
对象Read
方法及传递要读取的字节数组、起始位置及流长度。 - 填充
BLOB
通过指定对象binaryData
属性。
- 创建
-
从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
方法返回包含已解码表单数据的字符串值。 - 的
-
将数据转换为XML数据源
通过调用
BarcodedFormsServiceService
对象extractToXML
方法和传递以下值:- 包含解码数据的字符串值(请确保使用
decode
方法的返回值)。 - A
Delimiter
指定行分隔符的枚举值。 建议您指定Delimiter.Carriage_Return
. - A
Delimiter
指定字段分隔符的枚举值。 例如,指定Delimiter.Tab
. - A
XMLFormat
枚举值,指定是将条形码数据转换为XDP还是XFDF XML数据。 例如,指定XMLFormat.XDP
将数据转换为XDP数据。
note note NOTE 请勿为行分隔符和字段分隔符参数指定相同的值。 的
extractToXML
方法返回Object
每个元素都是BLOB
实例。 表单上的每个条形码都有一个单独的元素。 也就是说,如果表单上有四个条码,则返回的中会有四个元素Object
数组。 - 包含解码数据的字符串值(请确保使用
-
处理解码的数据
- 创建
System.IO.FileStream
对象,方法是调用其构造函数并传递一个字符串值,该字符串值表示安全PDF文档的文件位置。 - 创建用于存储
BLOB
由返回的对象encryptPDFUsingPassword
方法。 通过获取BLOB
对象binaryData
数据成员。 - 创建
System.IO.BinaryWriter
对象,方法是调用其构造函数并传递System.IO.FileStream
对象。 - 通过调用
System.IO.BinaryWriter
对象Write
方法和传递字节数组。
- 创建
另请参阅