本檔案中的範例和範例僅適用於JEE環境上的AEM Forms。
條碼式表單服務可自動從填寫和打印表單中擷取資料,並將擷取的資訊整合至組織的核心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物件
建立 BarcodedFormsServiceClient
對象,使用其建構子並傳遞 ServiceClientFactory
包含連接屬性的對象。
取得包含條碼式資料的PDF表單
java.io.FileInputStream
表示包含條碼式資料的PDF表單的對象,它使用其建構子並傳遞一個字串值,該字串值指定PDF文檔的位置。com.adobe.idp.Document
對象,使用其建構子並傳遞 java.io.FileInputStream
物件。從PDF表單中解碼資料
叫用 BarcodedFormsServiceClient
物件 decode
方法並傳遞下列值:
com.adobe.idp.Document
包含PDF表單的物件。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
方法並傳遞下列值:
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檔案的檔案對象。另請參閱
快速入門(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
方法,並傳遞位元組陣列、起始位置及流長度以讀取。BLOB
對象,通過賦值 binaryData
屬性(包含位元組陣列的內容)。從PDF表單中解碼資料
叫用 BarcodedFormsServiceService
物件 decode
方法並傳遞下列值:
BLOB
包含PDF表單的物件。Boolean
指定是否解碼PDF417條形碼的對象。Boolean
指定是否解碼資料矩陣條形碼的對象。Boolean
指定是否解碼QR碼條形碼的對象。Boolean
指定是否解碼codabar條形碼的對象。Boolean
指定是否解碼代碼128條形碼的對象。Bolean
指定是否解碼代碼39條形碼的對象。Boolean
指定是否解碼EAN-13條形碼的對象。Boolean
指定是否解碼EAN-8條形碼的對象。CharSet
枚舉值,它指定條碼中使用的字元集編碼值。此 decode
方法返回包含已解碼表單資料的字串值。
將資料轉換為XML資料源
調用 BarcodedFormsServiceService
物件 extractToXML
方法並傳遞下列值:
decode
方法的傳回值)。Delimiter
指定行分隔符的枚舉值。 建議您指定 Delimiter.Carriage_Return
.Delimiter
指定欄位分隔符的枚舉值。 例如,指定 Delimiter.Tab
.XMLFormat
指定是將條形碼資料轉換為XDP還是XFDF XML資料的枚舉值。 例如,指定 XMLFormat.XDP
將資料轉換為XDP資料。請勿為行分隔字元和欄位分隔字元參數指定相同的值。
此 extractToXML
方法傳回 Object
陣列,其中每個元素都是 BLOB
例項。 表單上的每個條碼都有獨立的元素。 也就是說,如果表單上有四個條碼,則傳回的中會有四個元素 Object
陣列。
處理解碼的資料
System.IO.FileStream
對象,方法是調用其建構子並傳遞一個字串值,該字串值表示安全PDF文檔的檔案位置。BLOB
由傳回的物件 encryptPDFUsingPassword
方法。 取得 BLOB
物件 binaryData
資料成員。System.IO.BinaryWriter
對象,調用其建構子並傳遞 System.IO.FileStream
物件。System.IO.BinaryWriter
物件 Write
方法,並傳遞位元組陣列。另請參閱