匯入和匯出資料

關於表單資料整合服務

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

• Acrobat表單(在Acrobat中建立)是包含表單欄位的PDF檔案。
• AdobeXML表單（在設計工具中建立）是符合XMLAdobeXML Forms架構(XFA)的PDF文檔。

根據表單類型，表單資料可以存在於下列其中一種格式：

• XFDF檔案，此檔案是Acrobat表單資料格式的XML版本。
• XDP檔案，此檔案是包含表單欄位定義的XML檔案。 也可包含表單欄位資料和內嵌PDF檔案。 Designer生成的XDP檔案只有在包含嵌入式基64編碼的PDF文檔時才可使用。

您可以使用表單資料整合服務來完成下列工作：

• 將資料匯入PDF forms。 如需詳細資訊，請參閱 匯入表單資料.
• 從PDF forms匯出資料。 如需詳細資訊，請參閱 匯出表單資料.

匯入表單資料

您可以使用表單資料整合服務，將表單資料匯入互動式PDF forms。 互動式PDF表單是PDF文檔，包含一個或多個欄位，用於從用戶收集資訊或顯示自定義資訊。 表單資料整合服務不支援表單計算、驗證或指令碼。

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

若要將資料值匯入此表單，您必須具備與表單對應的有效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>

步驟摘要

要將表單資料導入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程式庫檔案.

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

您必須先建立資料整合服務用戶端，才能以程式設計方式將資料匯入PDF表單用戶端API。 建立服務客戶端時，您定義調用服務所需的連接設定。 如需詳細資訊，請參閱 設定連接屬性.

參考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匯入表單資料

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

1. 包含專案檔案。

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

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

   • 建立 ServiceClientFactory 包含連接屬性的對象。
   • 建立 FormDataIntegrationClient 對象，使用其建構子並傳遞 ServiceClientFactory 物件。

3. 參考PDF表單。

   • 建立 java.io.FileInputStream 物件，使用其建構子。 傳遞指定PDF表單位置的字串值。
   • 建立 com.adobe.idp.Document 儲存PDF表單的物件，方法是使用 com.adobe.idp.Document 建構子。 傳遞 java.io.FileInputStream 包含建構子的PDF表單的物件。

4. 參考XML資料源。

   • 建立 java.io.FileInputStream 對象，使用其建構子並傳遞一個字串值，該字串值指定包含要導入到窗體中資料的XML檔案的位置。
   • 建立 com.adobe.idp.Document 使用 com.adobe.idp.Document 建構子。 傳遞 java.io.FileInputStream 包含建構子的表單資料的物件。

5. 將資料匯入PDF表單。

   叫用「 FormDataIntegrationClient 物件 importData 方法並傳遞下列值：

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

   此 importData 方法傳回 com.adobe.idp.Document 儲存PDF表單的對象，該表單包含位於XML資料源中的資料。

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

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

另請參閱

步驟摘要

快速入門（SOAP模式）:使用Java API匯入表單資料

包含AEM Forms Java程式庫檔案

設定連接屬性

使用網站服務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 物件，使用其預設建構函式。

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

   • 建立 System.ServiceModel.BasicHttpBinding 物件，方法是取得 FormDataIntegrationClient.Endpoint.Binding 欄位。 將傳回值轉換為 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 方法。 傳遞位元組陣列、起始位置和資料流長度以讀取。
   • 填入 BLOB 對象，通過賦值 MTOM 位元組陣列內容的欄位。

4. 參考XML資料源。

   • 建立 BLOB 物件，使用其建構子。 此 BLOB 物件可用來儲存匯入表單的資料。
   • 建立 System.IO.FileStream 對象，方法是調用其建構子。 傳遞一個字串值，該字串值指定包含要導入資料的XML檔案的位置，以及開啟檔案的模式。
   • 建立位元組陣列，用於儲存 System.IO.FileStream 物件。 您可以取得 System.IO.FileStream 物件 Length 屬性。
   • 叫用 System.IO.FileStream 物件 Read 方法。 傳遞位元組陣列、起始位置和資料流長度以讀取。
   • 填入 BLOB 對象，通過賦值 MTOM 位元組陣列內容的欄位。

5. 將資料匯入PDF表單。

   叫用 FormDataIntegrationClient 物件 importData 方法並傳遞下列值：

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

   此 importData 方法傳回 BLOB 儲存PDF表單的對象，該表單包含位於XML資料源中的資料。

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

   • 建立 System.IO.FileStream 物件，方法是叫用其建構函式並傳遞代表PDF檔案之檔案位置的字串值。
   • 建立位元組陣列，用於儲存 BLOB 由傳回的物件 importData 方法。 取得 BLOB 物件 MTOM 欄位。
   • 建立 System.IO.BinaryWriter 對象，調用其建構子並傳遞 System.IO.FileStream 物件。
   • 調用 System.IO.BinaryWriter 物件 Write 方法，並傳遞位元組陣列。

另請參閱

步驟摘要

使用MTOM叫用AEM Forms

匯出表單資料

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

步驟摘要

要從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匯出表單資料

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

1. 包含專案檔案。

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

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

   • 建立 ServiceClientFactory 包含連接屬性的對象。
   • 建立 FormDataIntegrationClient 對象，使用其建構子並傳遞 ServiceClientFactory 物件。

3. 參考PDF表單。

   • 建立 java.io.FileInputStream 物件，使用其建構函式並傳遞字串值，該字串值指定PDF表單（包含要匯出的資料）的位置。
   • 建立 com.adobe.idp.Document 儲存PDF表單的物件，方法是使用 com.adobe.idp.Document 建構子。 傳遞 java.io.FileInputStream 包含建構子的PDF表單的物件。

4. 從PDF表單匯出資料。

   叫用 FormDataIntegrationClient 物件 exportData 方法並傳遞 com.adobe.idp.Document 儲存PDF表單的物件。 此方法會傳回 com.adobe.idp.Document 將表單資料儲存為XML架構的物件。

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

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

另請參閱

步驟摘要

快速入門（SOAP模式）:使用Java API匯出表單資料

包含AEM Forms Java程式庫檔案

設定連接屬性

使用網站服務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 物件，使用其預設建構函式。

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

   • 建立 System.ServiceModel.BasicHttpBinding 物件，方法是取得 FormDataIntegrationClient.Endpoint.Binding 欄位。 將傳回值轉換為 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 方法，並傳遞位元組陣列、起始位置及流長度以讀取。
   • 填入 BLOB 對象，通過賦值 MTOM 位元組陣列內容的欄位。

4. 從PDF表單匯出資料。

   叫用「 FormDataIntegrationClient 物件 exportData 方法並傳遞 BLOB 儲存PDF表單的物件。 此方法會傳回 BLOB 將表單資料儲存為XML架構的物件。

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

   • 建立 System.IO.FileStream 對象，方法是調用其建構子並傳遞一個表示XML檔案位置的字串值。
   • 建立位元組陣列，用於儲存 BLOB 由傳回的物件 exportData 方法。 取得 BLOB 物件 MTOM 欄位。
   • 建立 System.IO.BinaryWriter 對象，調用其建構子並傳遞 System.IO.FileStream 物件。
   • 調用 System.IO.BinaryWriter 物件 Write 方法，並傳遞位元組陣列。

另請參閱

步驟摘要

使用MTOM叫用AEM Forms

使用SwaRef叫用AEM Forms

Business.Adobe.com 資源

Multichannel Communication Personalized Experiences Asset Collections Content Intelligence Theme Editor Headless Cms