條碼式表單服務可自動從填寫和打印表單中擷取資料,並將擷取的資訊整合到組織的核心IT系統中。
使用條碼式表單服務,您可以將一維和二維條碼新增至互動式PDF forms。 然後,您可以將條碼式表單發佈至網站,或透過電子郵件或光碟分發。 當使用者使用Adobe Reader、Acrobat Professional或Acrobat Standard填入條碼式表單時,條碼會自動更新,以編碼使用者提供的表單資料。 用戶可以以電子方式提交表單,或將表單打印成紙張,然後通過郵件、傳真或手提提交。 您稍後可以在自動化工作流程中擷取使用者提供的資料,並將資料路由至核准流程和業務系統之間。
如需條碼式表單服務的詳細資訊,請參閱AEM Forms的服務參考。
您可以使用條碼式表單服務API來解碼PDF表單或包含條碼之影像的資料。 解碼表單資料意味著提取位於條形碼中的資料。 在從PDF表單(或影像)解碼資料之前,使用者必須先將資料填入表單中。
如需條碼式表單服務的詳細資訊,請參閱AEM Forms的服務參考。
要解碼PDF表單中的資料,請執行以下步驟:
包含項目檔案
在您的開發專案中加入必要的檔案。 如果您使用Java建立客戶端應用程式,請包括必要的JAR檔案。 如果您使用Web服務,請確定您包含Proxy檔案。
必須將以下JAR檔案添加到項目的類路徑中:
如果AEM Forms部署在非JBOSS的受支援J2EE應用程式伺服器上,則您需要將adobe-utilities.jar和jbossall-client.jar取代為部署AEM Forms的J2EE應用程式伺服器專屬的JAR檔案。 有關所有AEM Forms JAR檔案的位置資訊,請參閱包含AEM Forms Java庫檔案。
建立條碼式表單用戶端API物件
在以程式設計方式執行條碼式表單服務操作之前,您必須建立Barcoded Forms服務用戶端。 如果您使用Java API,請建立BarcodedFormsServiceClient
物件。 如果您使用條碼式表單網站服務API,請建立BarcodedFormsServiceService
物件。
取得包含條碼式資料的PDF表單
您必須取得包含已填入使用者資料條碼的PDF表單。
將資料從PDF表單解碼
取得包含條碼的PDF表單(或影像)後,您就可以將資料解碼。 條碼式Forms服務支援下列條碼類型:
在解碼API中以十六進位輸入的字元集表示條碼的內容已編碼為十六進位字串。 例如,如果以格式將UTF-8指定為字元編碼,並在解碼操作中指定了十六進位,則條形碼的內容在解碼輸出的<xb:content
>元素中被編碼為十六進位字串。 您可以在用戶端應用程式中建立應用程式邏輯,借此轉換此十六進位值以取得原始內容。
將資料轉換為XML資料源
將表單資料解碼後,可將其轉換為XDP或XFDF資料。 例如,假設您要將資料匯入其他表單。 若要將資料匯入XFA表單,則必須將資料轉換為XDP資料。 如需詳細資訊,請參閱匯入表單資料。
處理解碼的資料
您可以處理轉換後的資料,以符合您的業務需求。 例如,將資料解碼並轉換後,可將其保存到檔案、將其儲存在企業資料庫中、填入其他表單等。 本節將討論如何將轉換後的資料另存為XML檔案。
當行分隔符和欄位分隔符參數具有相同值時,條碼式表單服務無法解碼條碼資料
另請參閱
使用條碼式表單API(Java)將表單資料解碼:
包含項目檔案
在Java項目的類路徑中包含客戶端JAR檔案。
建立條碼式表單用戶端API物件
使用其建構子並傳遞包含連線屬性的ServiceClientFactory
物件,以建立BarcodedFormsServiceClient
物件。
取得包含條碼式資料的PDF表單
java.io.FileInputStream
對象,該對象使用其建構子並傳遞指定PDF文檔位置的字串值,來表示包含條碼資料的PDF表單。java.io.FileInputStream
物件,以建立com.adobe.idp.Document
物件。將資料從PDF表單解碼
調用BarcodedFormsServiceClient
對象的decode
方法並傳遞以下值,將表單資料解碼:
com.adobe.idp.Document
物件。java.lang.Boolean
物件,指定是否解碼PDF417條碼。java.lang.Boolean
對象,指定是否解碼資料矩陣條形碼。java.lang.Boolean
對象,指定是否解碼QR碼條形碼。java.lang.Boolean
對象,指定是否解碼codabar條形碼。java.lang.Boolean
對象,指定是否解碼代碼128條形碼。java.lang.Boolean
對象,指定是否解碼代碼39條形碼。java.lang.Boolean
對象,指定是否解碼EAN-13條形碼。java.lang.Boolean
對象,指定是否解碼EAN-8條形碼。com.adobe.livecycle.barcodedforms.CharSet
枚舉值,它指定條碼中使用的字元集編碼值。decode
方法返回包含已解碼表單資料的org.w3c.dom.Document
對象。
將資料轉換為XML資料源
調用BarcodedFormsServiceClient
對象的extractToXML
方法並傳遞以下值,將解碼的資料轉換為XDP或XFDF資料:
org.w3c.dom.Document
物件(請務必使用decode
方法的傳回值)。com.adobe.livecycle.barcodedforms.Delimiter
枚舉值。 建議您指定Delimiter.Carriage_Return
。com.adobe.livecycle.barcodedforms.Delimiter
枚舉值。 例如,指定Delimiter.Tab
。com.adobe.livecycle.barcodedforms.XMLFormat
枚舉值,指定是將條形碼資料轉換為XDP還是XFDF XML資料。 例如,指定XMLFormat.XDP
將資料轉換為XDP資料。請勿為行分隔字元和欄位分隔字元參數指定相同的值。
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檔案的檔案對象,將XML資料另存為XML檔案。另請參閱
快速入門(SOAP模式):使用Java API解碼條碼式表單資料
使用條碼式表單API(網站服務)將表單資料解碼:
包含項目檔案
建立條碼式表單用戶端API物件
使用佔用條碼式表單服務WSDL的Microsoft .NET客戶端程式集,通過調用其預設建構子來建立BarcodedFormsServiceService
對象。
取得包含條碼式資料的PDF表單
BLOB
物件。 BLOB
對象用於儲存包含條形碼的PDF文檔。System.IO.FileStream
對象,該字串值表示PDF文檔的檔案位置以及開啟檔案的模式。System.IO.FileStream
對象內容的位元組陣列。 通過獲取System.IO.FileStream
對象的Length
屬性,可以確定位元組陣列的大小。System.IO.FileStream
對象的Read
方法並傳遞要讀取的位元組陣列、啟動位置和流長度,以流資料填充位元組陣列。binaryData
物件指派包含位元組陣列內容的屬性,以填入BLOB
物件。將資料從PDF表單解碼
調用BarcodedFormsServiceService
對象的decode
方法並傳遞以下值,將表單資料解碼:
BLOB
物件。Boolean
物件,指定是否解碼PDF417條碼。Boolean
對象,指定是否解碼資料矩陣條形碼。Boolean
對象,指定是否解碼QR碼條形碼。Boolean
對象,指定是否解碼codabar條形碼。Boolean
對象,指定是否解碼代碼128條形碼。Bolean
對象,指定是否解碼代碼39條形碼。Boolean
對象,指定是否解碼EAN-13條形碼。Boolean
對象,指定是否解碼EAN-8條形碼。CharSet
枚舉值,它指定條碼中使用的字元集編碼值。decode
方法返回包含已解碼表單資料的字串值。
將資料轉換為XML資料源
調用BarcodedFormsServiceService
對象的extractToXML
方法並傳遞以下值,將解碼的資料轉換為XDP或XFDF資料:
decode
方法的傳回值)。Delimiter
枚舉值。 建議您指定Delimiter.Carriage_Return
。Delimiter
枚舉值。 例如,指定Delimiter.Tab
。XMLFormat
枚舉值,指定是將條形碼資料轉換為XDP還是XFDF XML資料。 例如,指定XMLFormat.XDP
將資料轉換為XDP資料。請勿為行分隔字元和欄位分隔字元參數指定相同的值。
extractToXML
方法會傳回Object
陣列,其中每個元素都是BLOB
例項。 表單上的每個條碼都有獨立的元素。 也就是說,如果表單上有四個條形碼,則返回的Object
陣列中有四個元素。
處理解碼的資料
System.IO.FileStream
對象的建構子並傳遞一個字串值,該字串值表示安全PDF文檔的檔案位置。encryptPDFUsingPassword
方法返回的BLOB
對象的資料內容。 獲取BLOB
對象的binaryData
資料成員的值,以填充位元組陣列。System.IO.FileStream
對象來建立System.IO.BinaryWriter
對象。System.IO.BinaryWriter
對象的Write
方法並傳遞位元組陣列,將位元組陣列的內容寫入PDF檔案。另請參閱