文件AEM 6.4Forms 指南

使用條碼式表單 working-with-barcoded-forms

Last update: Thu May 04 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

建立對象：

  • Developer
CAUTION
AEM 6.4已結束延伸支援，本檔案不再更新。 如需詳細資訊，請參閱 技術支援期. 尋找支援的版本 此處.

關於條碼式表單服務 about-the-barcoded-forms-service

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

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

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

解碼條碼式表單資料 decoding-barcoded-form-data

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

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

步驟摘要 summary-of-steps

要解碼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檔案。

NOTE
當行分隔符和欄位分隔符參數具有相同值時，條碼式表單服務無法解碼條碼資料

另請參閱

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

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

包含AEM Forms Java程式庫檔案

設定連接屬性

使用Java API將條碼式表單資料解碼 decode-barcoded-form-data-using-the-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資料。
    note note
    NOTE
    請勿為行分隔字元和欄位分隔字元參數指定相同的值。

    此 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將條碼式表單資料解碼 decode-barcoded-form-data-using-the-web-service-api

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

  1. 包含項目檔案

  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資料。
    note note
    NOTE
    請勿為行分隔字元和欄位分隔字元參數指定相同的值。

    此 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

recommendation-more-help
a6ebf046-2b8b-4543-bd46-42a0d77792da