使用條碼式表單 working-with-barcoded-forms
關於條碼式表單服務 about-the-barcoded-forms-service
條碼式表單服務可自動從填寫和打印表單中擷取資料,並將擷取的資訊整合至組織的核心IT系統中。
使用條碼式表單服務,您可以將一維和二維條碼新增至互動式PDF forms。 然後,您可以將條碼式表單發佈至網站,或透過電子郵件或光碟分發。 當使用者使用Adobe Reader、Acrobat Professional或Acrobat Standard填入條碼式表單時,條碼會自動更新,以編碼使用者提供的表單資料。 用戶可以以電子方式提交表單,或將表單打印成紙張,然後通過郵件、傳真或手提提交。 您稍後可以在自動化工作流程中擷取使用者提供的資料,並將資料路由至核准流程和業務系統之間。
如需條碼式表單服務的詳細資訊,請參閱 AEM Forms服務參考.
解碼條碼式表單資料 decoding-barcoded-form-data
您可以使用條碼式表單服務API來解碼來自PDF表單或包含條碼之影像的資料。 解碼表單資料意味著提取位於條形碼中的資料。 在從PDF表單(或影像)解碼資料之前,用戶必須將資料填充到表單中。
步驟摘要 summary-of-steps
要解碼PDF表單中的資料,請執行以下步驟:
- 包含專案檔案。
- 建立條碼式formsClient API物件。
- 取得包含條碼式資料的PDF表單。
- 將資料從PDF表單中解碼。
- 將資料轉換為XML資料源。
- 處理已解碼的資料。
包含項目檔案
在您的開發專案中加入必要的檔案。 如果您使用Java建立客戶端應用程式,請包括必要的JAR檔案。 如果您使用Web服務,請確定您包含Proxy檔案。
必須將以下JAR檔案添加到項目的類路徑中:
- adobe-livecycle-client.jar
- adobe-usermanager-client.jar
- adobe-barcodedforms-client.jar
- adobe-utilities.jar(若AEM Forms部署在JBoss上則為必要)
- jbossall-client.jar(若AEM Forms部署在JBoss上則為必要)
- 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物件
在以程式設計方式執行條碼式表單服務操作之前,您必須建立Barcoded Forms服務用戶端。 如果您使用Java API,請建立 BarcodedFormsServiceClient
物件。 如果您使用條碼式表單網站服務API,請建立 BarcodedFormsServiceService
物件。
取得包含條碼式資料的PDF表單
您必須取得包含已填入使用者資料之條碼的PDF表單。
從PDF表單中解碼資料
取得包含條碼的PDF表單(或影像)後,您就可以將資料解碼。 條碼式Forms服務支援下列條碼類型:
- PDF417條形碼。
- 資料矩陣條形碼。
- QR碼條碼。
- 科達巴條形碼。
- 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)將表單資料解碼:
-
包含項目檔案
在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表單的物件。 - 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檔案的檔案對象。
- 重複
另請參閱
快速入門(SOAP模式):使用Java API解碼條碼式表單資料
使用網站服務API將條碼式表單資料解碼 decode-barcoded-form-data-using-the-web-service-api
使用條碼式表單API(網站服務)將表單資料解碼:
-
包含項目檔案
- 建立會使用條碼式表單服務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
方法,並傳遞位元組陣列。
- 建立
另請參閱