文件AEM 6.5使用手冊

匯入和匯出資料 importing-and-exporting-data

Last update: Sun Jul 14 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 主題：

建立對象：

  • undefined

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

關於表單資料整合服務 about-the-form-data-integration-service

表單資料整合服務可將資料匯入PDF表單，並從PDF表單匯出資料。 匯入和匯出作業支援兩種型別的PDF forms：

  • Acrobat表單(在Acrobat中建立)是包含表單欄位的PDF檔案。
  • AdobeXML表單(在Designer中建立)是符合XMLAdobeXML Forms架構(XFA)的PDF檔案。

視PDF表單的型別而定，表單資料可以下列其中一種格式存在：

  • XFDF檔案，這是Acrobat表單資料格式的XML版本。
  • XDP檔案，此檔案是包含表單欄位定義的XML檔案。 其中也可能包含表單欄位資料和內嵌PDF檔案。 Designer產生的XDP檔案必須攜帶內嵌的base-64編碼PDF檔案，才能使用。

您可以使用表單資料整合服務完成這些工作：

NOTE
如需表單資料整合服務的詳細資訊，請參閱AEM Forms服務參考。

匯入表單資料 importing-form-data

您可以使用表單資料整合服務，將表單資料匯入互動式PDF forms中。 互動式PDF表單是一份PDF檔案，其中包含一或多個用於向使用者收集資訊或用於顯示自訂資訊的欄位。 表單資料整合服務不支援表單計算、驗證或指令碼。

若要將資料匯入到Designer中建立的表單，您必須參考有效的XDP XML資料來源。 請考量下列範例抵押貸款申請表單。

ie_ie_loanformdata

若要將資料值匯入此表單，您必須擁有與表單對應的有效XDP XML資料來源。 您無法使用任意XML資料來源，將資料匯入使用「表單資料整合」服務的表單。 任意XML資料來源和XDP XML資料來源之間的差異在於XDP資料來源符合XML Forms架構(XFA)。 下列XML代表與範例抵押應用程式表單相對應的XDP XML資料來源。

 <?xml version="1.0" encoding="UTF-8" ?>
 - <xfa:datasets xmlns:xfa="https://www.xfa.org/schema/xfa-data/1.0/">
 - <xfa:data>
 - <data>
     - <Layer>
         <closeDate>1/26/2007</closeDate>
         <lastName>Johnson</lastName>
         <firstName>Jerry</firstName>
         <mailingAddress>JJohnson@NoMailServer.com</mailingAddress>
         <city>New York</city>
         <zipCode>00501</zipCode>
         <state>NY</state>
         <dateBirth>26/08/1973</dateBirth>
         <middleInitials>D</middleInitials>
         <socialSecurityNumber>(555) 555-5555</socialSecurityNumber>
         <phoneNumber>5555550000</phoneNumber>
     </Layer>
     - <Mortgage>
         <mortgageAmount>295000.00</mortgageAmount>
         <monthlyMortgagePayment>1724.54</monthlyMortgagePayment>
         <purchasePrice>300000</purchasePrice>
         <downPayment>5000</downPayment>
         <term>25</term>
         <interestRate>5.00</interestRate>
     </Mortgage>
 </data>
 </xfa:data>
 </xfa:datasets>
NOTE
如需表單資料整合服務的詳細資訊，請參閱AEM Forms服務參考。

步驟摘要 summary-of-steps

若要將表單資料匯入PDF表單，請執行下列步驟：

  1. 包含專案檔案。
  2. 建立表單資料整合服務使用者端。
  3. 參考PDF表單。
  4. 參考XML資料來源。
  5. 將資料匯入PDF表單。
  6. 將PDF表單儲存為PDF檔案。

包含專案檔

將必要的檔案納入您的開發專案中。 如果您使用Java建立使用者端應用程式，則請包含必要的JAR檔案。 如果您使用Web服務，請務必包含Proxy檔案。

必須將下列JAR檔案新增至專案的類別路徑：

  • adobe-livecycle-client.jar
  • adobe-usermanager-client.jar
  • adobe-formdataintegration-client.jar
  • adobe-utilities.jar (如果AEM Forms部署在JBoss上，則為必要)
  • jbossall-client.jar (如果AEM Forms部署在JBoss上，則為必要)

如需關於這些JAR檔案位置的資訊，請參閱包含AEM Forms Java程式庫檔案。

建立表單資料整合服務使用者端

您必須先建立資料整合服務使用者端，才能以程式設計方式將資料從使用者端API匯入PDF。 建立服務使用者端時，您可以定義呼叫服務所需的連線設定。 如需詳細資訊，請參閱設定連線內容。

參考PDF表單

若要將資料匯入PDF表單，您必須參考在Designer中建立的XML表單或在Acrobat中建立的Acrobat表單。

參考XML資料來源

若要匯入表單資料，您必須參考有效的資料來源。 若要將資料匯入在Designer中建立的XFA XML表單，您必須使用XDP XML資料來源。 如果您參照Acrobat表單，則必須使用XFDF資料來源。 對於您想要匯入資料的每個欄位，必須指定值。 如果XML資料來源中的元素未對應至表單中的欄位，則會忽略該元素。

將資料匯入PDF表單

參考PDF表單和有效的XML資料來源後，即可將資料匯入PDF表單。

將PDF表單儲存為PDF檔案

將資料匯入表單後，可將表單儲存為PDF檔案。 儲存為PDF檔案後，使用者就可以在Adobe Reader或Acrobat中開啟表單，並使用匯入的資料檢視表單。

另請參閱

使用Java API匯入表單資料

使用網站服務API匯入表單資料

包含AEM Forms Java程式庫檔案

設定連線屬性

表單資料整合服務API快速入門

匯出表單資料

使用Java API匯入表單資料 import-form-data-using-the-java-api

使用表單資料整合API (Java)匯入表單資料：

  1. 包含專案檔案。

    在您的Java專案的類別路徑中包含使用者端JAR檔案，例如adobe-formdataintegration-client.jar。

  2. 建立表單資料整合服務使用者端。

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

  3. 參考PDF表單。

    • 使用物件的建構函式建立java.io.FileInputStream物件。 傳遞指定PDF表單位置的字串值。
    • 使用com.adobe.idp.Document建構函式建立儲存PDF表單的com.adobe.idp.Document物件。 將包含PDF表單的java.io.FileInputStream物件傳遞給建構函式。

  4. 參考XML資料來源。

    • 使用物件的建構函式建立java.io.FileInputStream物件，並傳遞字串值，指定包含要匯入表單之資料的XML檔案位置。
    • 使用com.adobe.idp.Document建構函式建立儲存表單資料的com.adobe.idp.Document物件。 將包含表單資料的java.io.FileInputStream物件傳遞給建構函式。

  5. 將資料匯入PDF表單。

    透過叫用FormDataIntegrationClient物件的importData方法並傳遞下列值，將資料匯入PDF表單：

    • 儲存PDF表單的com.adobe.idp.Document物件。
    • 儲存表單資料的com.adobe.idp.Document物件。

    importData方法傳回com.adobe.idp.Document物件，該物件儲存的PDF表單包含XML資料來源中的資料。

  6. 將PDF表單儲存為PDF檔案。

    • 建立java.io.File物件，並確定副檔名為「。PDF」。
    • 叫用Document物件的copyToFile方法，將Document物件的內容複製到檔案（請確定您使用的是importData方法傳回的Document物件）。

另請參閱

步驟摘要

快速入門(SOAP模式)：使用Java API匯入表單資料

包含AEM Forms Java程式庫檔案

設定連線屬性

使用網站服務API匯入表單資料 import-form-data-using-the-web-service-api

使用表單資料整合API （網站服務）匯入表單資料：

  1. 包含專案檔案。

    建立使用MTOM的Microsoft .NET專案。 確定您使用下列WSDL定義： http://localhost:8080/soap/services/FormDataIntegration?WSDL&lc_version=9.0.1。

    note note
    NOTE
    將localhost取代為主控AEM Forms之伺服器的IP位址。

  2. 建立表單資料整合服務使用者端。

    • 使用預設建構函式建立FormDataIntegrationClient物件。

    • 使用System.ServiceModel.EndpointAddress建構函式建立FormDataIntegrationClient.Endpoint.Address物件。 將指定WSDL的字串值傳遞至AEM Forms服務（例如，http://localhost:8080/soap/services/FormDataIntegration?blob=mtom）。 您不需要使用lc_version屬性。 當您建立服務參考時，會使用此屬性。 但是，請指定?blob=mtom以使用MTOM。

    • 取得FormDataIntegrationClient.Endpoint.Binding欄位的值，以建立System.ServiceModel.BasicHttpBinding物件。 將傳回值轉換為BasicHttpBinding。

    • 將System.ServiceModel.BasicHttpBinding物件的MessageEncoding欄位設為WSMessageEncoding.Mtom。 此值可確保使用MTOM。

    • 執行下列工作來啟用基本的HTTP驗證：

      • 將AEM表單使用者名稱指派給欄位FormDataIntegrationClient.ClientCredentials.UserName.UserName。
      • 將對應的密碼值指派給欄位FormDataIntegrationClient.ClientCredentials.UserName.Password。
      • 將常數值HttpClientCredentialType.Basic指派給欄位BasicHttpBindingSecurity.Transport.ClientCredentialType。
      • 將常數值BasicHttpSecurityMode.TransportCredentialOnly指派給欄位BasicHttpBindingSecurity.Security.Mode。

  3. 參考PDF表單。

    • 使用物件的建構函式建立BLOB物件。 此BLOB物件是用來儲存PDF表單。
    • 透過叫用它的建構函式來建立System.IO.FileStream物件。 傳遞字串值，該值會指定PDF表單的位置和開啟檔案的模式。
    • 建立位元組陣列以儲存System.IO.FileStream物件的內容。 您可以取得System.IO.FileStream物件的Length屬性來決定位元組陣列的大小。
    • 呼叫System.IO.FileStream物件的Read方法，以串流資料填入位元組陣列。 傳遞位元組陣列、起始位置以及要讀取的資料流長度。
    • 以位元組陣列的內容指派其MTOM欄位，填入BLOB物件。

  4. 參考XML資料來源。

    • 使用物件的建構函式建立BLOB物件。 此BLOB物件是用來儲存匯入表單的資料。
    • 透過叫用它的建構函式來建立System.IO.FileStream物件。 傳遞字串值，指定包含要匯入之資料的XML檔案位置，以及開啟檔案的模式。
    • 建立位元組陣列以儲存System.IO.FileStream物件的內容。 您可以取得System.IO.FileStream物件的Length屬性來決定位元組陣列的大小。
    • 呼叫System.IO.FileStream物件的Read方法，以串流資料填入位元組陣列。 傳遞位元組陣列、起始位置以及要讀取的資料流長度。
    • 以位元組陣列的內容指派其MTOM欄位，填入BLOB物件。

  5. 將資料匯入PDF表單。

    透過叫用FormDataIntegrationClient物件的importData方法並傳遞下列值，將資料匯入PDF表單：

    • 儲存PDF表單的BLOB物件。
    • 儲存表單資料的BLOB物件。

    importData方法傳回BLOB物件，該物件儲存的PDF表單包含XML資料來源中的資料。

  6. 將PDF表單儲存為PDF檔案。

    • 建立System.IO.FileStream物件，方法為叫用其建構函式，並傳遞代表PDF檔案之檔案位置的字串值。
    • 建立位元組陣列，儲存importData方法傳回的BLOB物件的資料內容。 取得BLOB物件的MTOM欄位值，以填入位元組陣列。
    • 透過叫用它的建構函式並傳遞System.IO.FileStream物件來建立System.IO.BinaryWriter物件。
    • 呼叫System.IO.BinaryWriter物件的Write方法並傳遞位元組陣列，將位元組陣列的內容寫入PDF檔案。

另請參閱

步驟摘要

使用MTOM叫用AEM Forms

匯出表單資料 exporting-form-data

您可以使用表單資料整合服務，從互動式PDF表單匯出表單資料。 匯出的資料格式取決於表單型別。 如果表單型別是在Acrobat中建立的Acrobat表單，則匯出的資料為XFDF。 如果表單型別是在Designer中建立的XML表單，則匯出的資料為XDP。

NOTE
如需表單資料整合服務的詳細資訊，請參閱AEM Forms服務參考。

步驟摘要 summary_of_steps-1

若要從PDF表單匯出表單資料，請執行下列步驟：

  1. 包含專案檔案
  2. 建立表單資料整合服務使用者端。
  3. 參考PDF表單。
  4. 從PDF表單匯出資料。
  5. 將匯出的資料儲存為XML檔案。

包含專案檔

將必要的檔案納入您的開發專案中。 如果您使用Java建立使用者端應用程式，則請包含必要的JAR檔案。 如果您使用Web服務，請務必包含Proxy檔案。

必須將下列JAR檔案新增至專案的類別路徑：

  • adobe-livecycle-client.jar
  • adobe-usermanager-client.jar
  • adobe-formdataintegration-client.jar
  • adobe-utilities.jar (如果AEM Forms部署在JBoss上，則為必要)
  • jbossall-client.jar (如果AEM Forms部署在JBoss上，則為必要)

建立表單資料整合服務使用者端

您必須先建立資料整合服務使用者端，才能以程式設計方式將資料匯入PDFformClient API。 建立服務使用者端時，您可以定義呼叫服務所需的連線設定。 如需詳細資訊，正在設定連線內容。

參考PDF表單

若要從PDF表單匯出資料，您必須參考在Designer或Acrobat中建立且包含表單資料的PDF表單。 如果您嘗試從空白的PDF表單匯出資料，您將會取得空白的XML結構描述。

從PDF表單匯出資料

參照包含表單資料的PDF表單後，即可從表單匯出資料。 資料會匯出至以表單為基礎的XML結構描述中。

將表單資料儲存為XML檔案

匯出表單資料後，可將資料儲存為XML檔案。 儲存為XML檔案後，您可以在XML檢視器中開啟XML檔案，以檢視表單資料。

另請參閱

使用Java API匯出表單資料

使用網站服務API匯出表單資料

包含AEM Forms Java程式庫檔案

設定連線屬性

表單資料整合服務API快速入門

匯入表單資料

使用Java API匯出表單資料 export-form-data-using-the-java-api

使用表單資料整合API (Java)匯出表單資料：

  1. 包含專案檔案。

    在您的Java專案的類別路徑中包含使用者端JAR檔案，例如adobe-formdataintegration-client.jar。

  2. 建立表單資料整合服務使用者端。

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

  3. 參考PDF表單。

    • 使用物件的建構函式建立java.io.FileInputStream物件，並傳遞字串值，指定包含要匯出之資料的PDF表單位置。
    • 使用com.adobe.idp.Document建構函式建立儲存PDF表單的com.adobe.idp.Document物件。 將包含PDF表單的java.io.FileInputStream物件傳遞給建構函式。

  4. 從PDF表單匯出資料。

    透過叫用FormDataIntegrationClient物件的exportData方法匯出表單資料，並傳遞儲存PDF表單的com.adobe.idp.Document物件。 此方法會傳回將表單資料儲存為XML結構描述的com.adobe.idp.Document物件。

  5. 將PDF表單儲存為PDF檔案。

    • 建立java.io.File物件，並確定副檔名為XML。
    • 叫用Document物件的copyToFile方法，將Document物件的內容複製到檔案（請確定您使用的是exportData方法傳回的Document物件）。

另請參閱

步驟摘要

快速入門(SOAP模式)：使用Java API匯出表單資料

包含AEM Forms Java程式庫檔案

設定連線屬性

使用網站服務API匯出表單資料 export-form-data-using-the-web-service-api

使用表單資料整合API （網站服務）匯出表單資料：

  1. 包含專案檔案。

    建立使用MTOM的Microsoft .NET專案。 確定您使用下列WSDL定義： http://localhost:8080/soap/services/FormDataIntegration?WSDL&lc_version=9.0.1。

    • 將localhost取代為主控AEM Forms之伺服器的IP位址。

  2. 建立表單資料整合服務使用者端。

    • 使用預設建構函式建立FormDataIntegrationClient物件。

    • 使用System.ServiceModel.EndpointAddress建構函式建立FormDataIntegrationClient.Endpoint.Address物件。 將指定WSDL的字串值傳遞至AEM Forms服務（例如，http://localhost:8080/soap/services/FormDataIntegration?blob=mtom）。 您不需要使用lc_version屬性。 當您建立服務參考時，會使用此屬性。 但是，請指定?blob=mtom以使用MTOM。

    • 取得FormDataIntegrationClient.Endpoint.Binding欄位的值，以建立System.ServiceModel.BasicHttpBinding物件。 將傳回值轉換為BasicHttpBinding。

    • 將System.ServiceModel.BasicHttpBinding物件的MessageEncoding欄位設為WSMessageEncoding.Mtom。 此值可確保使用MTOM。

    • 執行下列工作來啟用基本的HTTP驗證：

      • 將AEM表單使用者名稱指派給欄位FormDataIntegrationClient.ClientCredentials.UserName.UserName。
      • 將對應的密碼值指派給欄位FormDataIntegrationClient.ClientCredentials.UserName.Password。
      • 將常數值HttpClientCredentialType.Basic指派給欄位BasicHttpBindingSecurity.Transport.ClientCredentialType。
      • 將常數值BasicHttpSecurityMode.TransportCredentialOnly指派給欄位BasicHttpBindingSecurity.Security.Mode。

  3. 參考PDF表單。

    • 使用物件的建構函式建立BLOB物件。 此BLOB物件是用來儲存資料匯出的PDF表單。
    • 透過叫用它的建構函式來建立System.IO.FileStream物件。 傳遞字串值，該值會指定PDF表單的位置和開啟檔案的模式。
    • 建立位元組陣列以儲存System.IO.FileStream物件的內容。 您可以取得System.IO.FileStream物件的Length屬性來決定位元組陣列的大小。
    • 呼叫System.IO.FileStream物件的Read方法，並傳遞要讀取的位元組陣列、起始位置和資料流長度，以資料流資料填入位元組陣列。
    • 以位元組陣列的內容指派其MTOM欄位，填入BLOB物件。

  4. 從PDF表單匯出資料。

    透過叫用FormDataIntegrationClient物件的exportData方法，將資料匯入PDF表單，並傳遞儲存PDF表單的BLOB物件。 此方法會傳回將表單資料儲存為XML結構描述的BLOB物件。

  5. 將PDF表單儲存為PDF檔案。

    • 建立System.IO.FileStream物件，方法為叫用其建構函式，並傳遞代表XML檔案位置的字串值。
    • 建立位元組陣列，儲存exportData方法傳回的BLOB物件的資料內容。 取得BLOB物件的MTOM欄位值，以填入位元組陣列。
    • 透過叫用它的建構函式並傳遞System.IO.FileStream物件來建立System.IO.BinaryWriter物件。
    • 呼叫System.IO.BinaryWriter物件的Write方法並傳遞位元組陣列，將位元組陣列的內容寫入XML檔案。

另請參閱

步驟摘要

使用MTOM叫用AEM Forms

使用SwaRef叫用AEM Forms

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2