使用條碼式表單

本檔案中的範例和範例僅適用於JEE環境上的AEM Forms。

關於條碼式表單服務

條碼式表單服務可自動從填寫和打印表單中擷取資料，並將擷取的資訊整合至組織的核心IT系統中。

使用條碼式表單服務，您可以將一維和二維條碼新增至互動式PDF forms。 然後，您可以將條碼式表單發佈至網站，或透過電子郵件或光碟分發。 當使用者使用Adobe Reader、Acrobat Professional或Acrobat Standard填入條碼式表單時，條碼會自動更新，以編碼使用者提供的表單資料。 用戶可以以電子方式提交表單，或將表單打印成紙張，然後通過郵件、傳真或手提提交。 您稍後可以在自動化工作流程中擷取使用者提供的資料，並將資料路由至核准流程和業務系統之間。

如需條碼式表單服務的詳細資訊，請參閱 AEM Forms服務參考.

解碼條碼式表單資料

您可以使用條碼式表單服務API來解碼來自PDF表單或包含條碼之影像的資料。 解碼表單資料意味著提取位於條形碼中的資料。 在從PDF表單（或影像）解碼資料之前，用戶必須將資料填充到表單中。

步驟摘要

要解碼PDF表單中的資料，請執行以下步驟：

1. 包含專案檔案。
2. 建立條碼式formsClient API物件。
3. 取得包含條碼式資料的PDF表單。
4. 將資料從PDF表單中解碼。
5. 將資料轉換為XML資料源。
6. 處理已解碼的資料。

包含項目檔案

在您的開發專案中加入必要的檔案。 如果您使用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將條碼式表單資料解碼

使用網站服務API將條碼式表單資料解碼

包含AEM Forms Java程式庫檔案

設定連接屬性

使用Java API將條碼式表單資料解碼

使用條碼式表單API(Java)將表單資料解碼：

1. 包含項目檔案

   在Java項目的類路徑中包含客戶端JAR檔案。

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程式庫檔案

設定連接屬性

使用網站服務API將條碼式表單資料解碼

使用條碼式表單API（網站服務）將表單資料解碼：

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