使用條碼式表單

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

關於條碼式表單服務

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

使用條碼式表單服務,您可以將一維和二維條碼新增至互動式PDF forms。 然後,您可以將條碼式表單發佈至網站,或透過電子郵件或光碟分發。 當使用者使用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(位於<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物件

    使用其建構子並傳遞包含連線屬性的ServiceClientFactory物件,以建立BarcodedFormsServiceClient物件。

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

    • 建立java.io.FileInputStream對象,該對象使用其建構子並傳遞指定PDF文檔位置的字串值,來表示包含條碼資料的PDF表單。
    • 使用其建構子並傳遞java.io.FileInputStream物件,以建立com.adobe.idp.Document物件。
  4. 將資料從PDF表單解碼

    調用BarcodedFormsServiceClient對象的decode方法並傳遞以下值,將表單資料解碼:

    • 包含PDF表單的com.adobe.idp.Document物件。
    • 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對象。

  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檔案的檔案對象,將XML資料另存為XML檔案。

另請參閱

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

包含AEM Forms Java程式庫檔案

設定連接屬性

使用Web服務API對條碼式表單資料進行解碼

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

  1. 包含項目檔案

    • 建立一個Microsoft .NET客戶端程式集,該程式集將使用條碼式表單服務WSDL。 如需詳細資訊,請參閱使用Base64編碼叫用AEM Forms
    • 參考Microsoft .NET客戶端程式集。 如需詳細資訊,請參閱使用Base64編碼叫用AEM Forms中的「參考.NET用戶端程式集」。
  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方法並傳遞要讀取的位元組陣列、啟動位置和流長度,以流資料填充位元組陣列。
    • binaryData物件指派包含位元組陣列內容的屬性,以填入BLOB物件。
  4. 將資料從PDF表單解碼

    調用BarcodedFormsServiceService對象的decode方法並傳遞以下值,將表單資料解碼:

    • 包含PDF表單的BLOB物件。
    • Boolean物件,指定是否解碼PDF417條碼。
    • Boolean對象,指定是否解碼資料矩陣條形碼。
    • Boolean對象,指定是否解碼QR碼條形碼。
    • Boolean對象,指定是否解碼codabar條形碼。
    • Boolean對象,指定是否解碼代碼128條形碼。
    • Bolean對象,指定是否解碼代碼39條形碼。
    • Boolean對象,指定是否解碼EAN-13條形碼。
    • Boolean對象,指定是否解碼EAN-8條形碼。
    • CharSet枚舉值,它指定條碼中使用的字元集編碼值。

    decode方法返回包含已解碼表單資料的字串值。

  5. 將資料轉換為XML資料源

    調用BarcodedFormsServiceService對象的extractToXML方法並傳遞以下值,將解碼的資料轉換為XDP或XFDF資料:

    • 包含已解碼資料的字串值(請務必使用decode方法的傳回值)。
    • 指定行分隔符的Delimiter枚舉值。 建議您指定Delimiter.Carriage_Return
    • 指定欄位分隔字元的Delimiter枚舉值。 例如,指定Delimiter.Tab
    • XMLFormat枚舉值,指定是將條形碼資料轉換為XDP還是XFDF XML資料。 例如,指定XMLFormat.XDP將資料轉換為XDP資料。
    注意

    請勿為行分隔字元和欄位分隔字元參數指定相同的值。

    extractToXML方法會傳回Object陣列,其中每個元素都是BLOB例項。 表單上的每個條碼都有獨立的元素。 也就是說,如果表單上有四個條形碼,則返回的Object陣列中有四個元素。

  6. 處理解碼的資料

    • 調用System.IO.FileStream對象的建構子並傳遞一個字串值,該字串值表示安全PDF文檔的檔案位置。
    • 建立位元組陣列,用於儲存encryptPDFUsingPassword方法返回的BLOB對象的資料內容。 獲取BLOB對象的binaryData資料成員的值,以填充位元組陣列。
    • 通過調用其建構子並傳遞System.IO.FileStream對象來建立System.IO.BinaryWriter對象。
    • 調用System.IO.BinaryWriter對象的Write方法並傳遞位元組陣列,將位元組陣列的內容寫入PDF檔案。

另請參閱

使用Base64編碼叫用AEM Forms

本頁內容