使用條碼式表單

最後更新： 2024年7月14日
  • 適用對象：
  • Experience Manager 6.5
  • 主題：

建立對象：

  • 開發人員

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

關於條碼式Forms服務

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

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

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

解碼條碼式表單資料

您可以使用條碼式表單服務API，將PDF表單或包含條碼之影像中的資料解碼。 解碼表單資料表示擷取條碼中的資料。 在可從PDF表單（或影像）解碼資料之前，使用者必須先將資料填入表單。

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

步驟摘要

若要解碼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 (位於<安裝目錄>/Adobe/Adobe_Experience_Manager_forms/sdk/client-libs\thirdparty)

如果將AEM Forms部署在受支援的J2EE應用程式伺服器（不是JBOSS）上，則您必須將adobe-utilities.jar和jbossall-client.jar取代為特定於已部署AEM Forms之J2EE應用程式伺服器的JAR檔案。 如需有關所有AEM Forms JAR檔案位置的資訊，請參閱包含AEM Forms Java程式庫檔案。

建立條碼式表單使用者端API物件

您必須先建立條碼式Forms服務使用者端，才能以程式設計方式執行條碼式表單服務作業。 如果您使用Java API，請建立BarcodedFormsServiceClient物件。 如果您使用條碼式表單Web服務API，請建立BarcodedFormsServiceService物件。

取得包含條碼資料的PDF表單

取得內含已填入使用者資料之條碼的PDF表單。

從PDF表單解碼資料

取得包含條碼的PDF表單（或影像）後，您就可以將資料解碼。 條碼Forms服務支援下列型別的條碼：

  • PDF417條碼。
  • 資料矩陣條碼。
  • QR碼條碼。
  • 程式碼標籤條碼。
  • 代碼128條碼。
  • 代碼39條碼。
  • ean-13條碼。
  • EAN-8條碼

在解碼API中將字元集輸入設為十六進位表示，條碼的內容會編碼為十六進位字串。 例如，如果在表單中將UTF-8指定為字元編碼，並在解碼作業中指定Hex，則條碼的內容會在解碼輸出中編碼為< xb:content>專案中的Hex字串。 您可以在使用者端應用程式中建立應用程式邏輯，轉換此十六進位值以取得原始內容。

將資料轉換為XML資料來源

將表單資料解碼後，可將其轉換為XDP或XFDF資料。 例如，假設您要將資料匯入另一個表單。 若要將資料匯入XFA表單，您必須將資料轉換為XDP資料。 如需詳細資訊，請參閱匯入表單資料。

處理解碼的資料

您可以處理轉換後的資料，以符合業務需求。 例如，解碼並轉換資料後，您可以將其儲存至檔案、儲存在企業資料庫中、填入其他表單等。 本節討論如何將轉換的資料儲存為XML檔案。

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

另請參閱

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

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

包含AEM Forms Java程式庫檔案

設定連線屬性

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

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

  1. 包含專案檔案

    在您的Java專案的類別路徑中包含使用者端JAR檔案。

  2. 建立條碼式表單使用者端API物件

    使用它的建構函式並傳遞包含連線屬性的ServiceClientFactory物件來建立BarcodedFormsServiceClient物件。

  3. 取得包含條碼資料的PDF表單

    • 使用它的建構函式，並傳遞指定PDF檔案位置的字串值，來建立代表包含條碼式資料的PDF表單的java.io.FileInputStream物件。
    • 使用它的建構函式並傳遞java.io.FileInputStream物件來建立com.adobe.idp.Document物件。

  4. 解碼PDF表單中的資料

    透過叫用BarcodedFormsServiceClient物件的decode方法並傳遞下列值來解碼表單資料：

    • 包含PDF表單的com.adobe.idp.Document物件。
    • java.lang.Boolean物件，指定是否要解碼PDF417條碼。
    • 指定是否要解碼資料矩陣條碼的java.lang.Boolean物件。
    • 指定是否要解碼QR碼條碼的java.lang.Boolean物件。
    • 指定是否要解碼程式碼標籤條碼的java.lang.Boolean物件。
    • java.lang.Boolean物件，指定是否要解碼代碼128條碼。
    • java.lang.Boolean物件，指定是否要解碼代碼39條碼。
    • 指定是否要解碼EAN-13條碼的java.lang.Boolean物件。
    • 指定是否要解碼EAN-8條碼的java.lang.Boolean物件。
    • 指定條碼中所使用字元集編碼值的com.adobe.livecycle.barcodedforms.CharSet列舉值。

    decode方法傳回包含已解碼表單資料的org.w3c.dom.Document物件。

  5. 將資料轉換為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物件中有四個元素。

  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檔案的File物件，將XML資料儲存為XML檔案。

另請參閱

快速入門(SOAP模式)：使用Java API將條碼式表單資料解碼

包含AEM Forms Java程式庫檔案

設定連線屬性