處理已提交的Forms

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

讓使用者能夠填寫互動式表單的網頁型應用程式，需要將資料提交回伺服器。 使用Forms服務，您可以擷取使用者在互動式表單中輸入的資料。 擷取資料後，您就可以處理資料以符合您的業務需求。 例如，您可以將資料儲存在資料庫中、將資料發送到其他應用程式、將資料發送到其他服務、將資料合併到表單設計中、在Web瀏覽器中顯示資料等。

表單資料會以XML或PDF資料的形式提交至Forms服務，這是在Designer中設定的選項。 以XML提交的表單可讓您擷取個別欄位資料值。 也就是說，您可以擷取使用者在表單中輸入之每個表單欄位的值。 作為PDF資料提交的表單是二進位資料，而不是XML資料。 您可以將表單儲存為PDF檔案，或將表單傳送至其他服務。 如果要從提交為XML的表單中提取資料，然後使用表單資料建立PDF文檔，請調用其他AEM Forms操作。 (請參閱 使用已提交的XML資料建立PDF文檔)

下圖顯示提交至名為 HandleData 從顯示在網頁瀏覽器中的互動式表單。

下表說明圖表中的步驟。

處理已提交的XML資料

表單資料以XML形式提交時，您可以擷取代表已提交資料的XML資料。 所有表單欄位在XML架構中都顯示為節點。 節點值與使用者填入的值對應。 請考慮使用貸款表單，表單中的每個欄位在XML資料中都顯示為節點。 每個節點的值都與使用者填入的值對應。 假設使用者填入貸款表單，其中顯示以下表單的資料。

下圖顯示使用Forms服務用戶端API擷取的對應XML資料。

貸款表單中的欄位。 這些值可以使用Java XML類檢索。

處理提交的PDF資料

請考慮叫用Forms服務的Web應用程式。 在Forms服務將互動式PDF表單轉譯給用戶端網頁瀏覽器後，使用者會填入表單並將其提交回PDF資料。 Forms服務收到PDF資料時，可將PDF資料傳送至其他服務，或儲存為PDF檔案。 下圖顯示應用程式的邏輯流程。

下表說明此圖中的步驟。

處理提交的URL UTF-16資料

如果表單資料以URL UTF-16資料提交，用戶端電腦需要Adobe Reader或Acrobat 8.1或更新版本。 此外，如果表單設計包含具有URL編碼資料(HTTP Post)的提交按鈕，且資料編碼選項為UTF-16，則必須在文字編輯器（如記事本）中修改表單設計。 您可以將編碼選項設定為 UTF-16LE 或 UTF-16BE （針對提交按鈕）。 Designer不提供此功能。

步驟摘要

要處理已提交的表單，請執行以下任務：

1. 包含專案檔案。
2. 建立Forms用戶端API物件。
3. 擷取表單資料。
4. 確定表單提交是否包含檔案附件。
5. 處理提交的資料。

包含項目檔案

在您的開發專案中加入必要的檔案。 如果要使用Java建立客戶端應用程式，請包括必要的JAR檔案。 如果您使用Web服務，請確定您包含Proxy檔案。

建立Forms用戶端API物件

您必須先建立Forms服務用戶端，才能以程式設計方式執行Forms服務用戶端API作業。 如果您使用Java API，請建立 FormsServiceClient 物件。 如果您使用Forms網站服務API，請建立 FormsService 物件。

擷取表單資料

若要擷取已提交的表單資料，請叫用 FormsServiceClient 物件 processFormSubmission 方法。 叫用此方法時，您必須指定已提交表單的內容類型。 當資料從用戶端網頁瀏覽器提交至Forms服務時，可以以XML或PDF資料的形式提交。 若要擷取輸入表單欄位中的資料，可以以XML資料提交資料。

您也可以設定下列執行階段選項，從提交為PDF資料的表單中擷取表單欄位：

• 將下列值傳遞至 processFormSubmission 方法作為內容類型參數： CONTENT_TYPE=application/pdf.
• 設定 RenderOptionsSpec 物件 PDFToXDP 值 true
• 設定 RenderOptionsSpec 物件 ExportDataFormat 值 XMLData

在叫用 processFormSubmission 方法。 以下清單指定了適用的內容類型值：

• text/xml:表示PDF表單以XML提交表單資料時要使用的內容類型。
• application/x-www-form-urlencoded:表示HTML表單以XML提交資料時要使用的內容類型。
• application/pdf:代表PDF表單以PDF提交資料時要使用的內容類型。

您會擷取張貼至Forms服務的表單資料，並判斷其處理狀態。 也就是說，將資料提交至Forms服務時，並不代表Forms服務已完成資料處理，且資料已準備好處理。 例如，資料可提交至Forms服務，以便執行計算。 計算完成後，表單將呈現給用戶並顯示計算結果。 處理提交的資料之前，建議您判斷Forms服務是否已完成資料處理。

Forms服務會傳回下列值，指出其是否已完成資料處理：

• 0（提交）: 已提交的資料已準備好進行處理。
• 1（計算）: Forms服務對資料執行了計算操作，且必須將結果轉譯給使用者。
• 2（驗證）: Forms服務驗證的表單資料和結果必須呈現給使用者。
• 3（下一個）: 當前頁面已更改，結果必須寫入客戶端應用程式。
• 4(上一個):當前頁面已更改，結果必須寫入客戶端應用程式。

確定表單提交是否包含檔案附件

提交至Forms服務的Forms可包含檔案附件。 例如，使用Acrobat的內建附件窗格，使用者可以選取要連同表單一併提交的檔案附件。 此外，用戶還可以使用HTML工具欄選擇檔案附件，該工具欄使用HTML檔案呈現。

在您確定表單是否包含檔案附件後，您就可以處理資料。 例如，您可以將檔案附件保存到本地檔案系統。

處理提交的資料

根據已提交資料的內容類型，您可以從已提交的XML資料中提取個別的表單欄位值，或將已提交的PDF資料儲存為PDF檔案（或將其傳送至其他服務）。 若要擷取個別表單欄位，請將提交的XML資料轉換為XML資料來源，然後使用 org.w3c.dom 類別。

另請參閱

包含AEM Forms Java程式庫檔案

設定連接屬性

Forms服務API快速入門

將檔案傳遞至Forms服務

建立可轉譯Forms的網頁應用程式

使用Java API處理提交的表單

使用Forms API(Java)處理已提交的表單：

1. 包含項目檔案

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

2. 建立Forms用戶端API物件

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

3. 擷取表單資料

   • 若要擷取張貼至Java Servlet的表單資料，請建立 com.adobe.idp.Document 對象，使用其建構子並調用 javax.servlet.http.HttpServletResponse 物件 getInputStream 方法。
   • 建立 RenderOptionsSpec 物件，使用其建構子。 調用 RenderOptionsSpec 物件 setLocale 方法，並傳遞指定區域設定值的字串值。
   注意

   您可以指示Forms服務叫用 RenderOptionsSpec 物件 setPDF2XDP 方法與傳遞 true 同時呼叫 setXMLData 傳遞 true. 然後，您可以叫用 FormsResult 物件 getOutputXML 檢索與XDP/XML資料對應的XML資料的方法。 ( FormsResult 物件由傳回 processFormSubmission 方法，將在下一個子步驟中說明。)

   • 叫用 FormsServiceClient 物件 processFormSubmission 方法，並傳遞下列值：

     • 此 com.adobe.idp.Document 包含表單資料的物件。
     • 一個字串值，它指定包括所有相關HTTP標題的環境變數。 指定要處理的內容類型。 要處理XML資料，請為此參數指定以下字串值： CONTENT_TYPE=text/xml. 若要處理PDF資料，請為此參數指定下列字串值： CONTENT_TYPE=application/pdf.
     • 指定 HTTP_USER_AGENT 標題值，例如。 Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1; SV1; .NET CLR 1.1.4322). 此參數值為選用值。
     • A RenderOptionsSpec 儲存運行時選項的對象。

     此 processFormSubmission 方法傳回 FormsResult 包含表單提交結果的物件。

   • 判斷Forms服務是否已借由叫用 FormsResult 物件 getAction 方法。 如果此方法傳回值 0，則資料已準備好供處理。

4. 確定表單提交是否包含檔案附件

   • 叫用 FormsResult 物件 getAttachments 方法。 此方法會傳回 java.util.List 包含隨表單提交的檔案的物件。
   • 重複 java.util.List 物件，以判斷是否有檔案附件。 如果有檔案附件，則每個元素都是 com.adobe.idp.Document 例項。 您可以叫用 com.adobe.idp.Document 物件 copyToFile 方法和傳遞 java.io.File 物件。
   注意

   只有在表單以PDF形式提交時，此步驟才適用。

5. 處理提交的資料

   • 如果資料內容類型為 application/vnd.adobe.xdp+xml 或 text/xml，建立應用程式邏輯以擷取XML資料值。

     • 建立 com.adobe.idp.Document 對象，方法是調用 FormsResult 物件 getOutputContent 方法。
     • 建立 java.io.InputStream 對象，方法是調用 java.io.DataInputStream 建構子和傳遞 com.adobe.idp.Document 物件。
     • 建立 org.w3c.dom.DocumentBuilderFactory 物件，方法是呼叫靜態 org.w3c.dom.DocumentBuilderFactory 物件 newInstance 方法。
     • 建立 org.w3c.dom.DocumentBuilder 對象，方法是調用 org.w3c.dom.DocumentBuilderFactory 物件 newDocumentBuilder 方法。
     • 建立 org.w3c.dom.Document 對象，方法是調用 org.w3c.dom.DocumentBuilder 物件 parse 方法和傳遞 java.io.InputStream 物件。
     • 檢索XML文檔中每個節點的值。 完成此工作的一種方式是建立接受兩個參數的自訂方法：the org.w3c.dom.Document 對象和要檢索其值的節點的名稱。 此方法會傳回代表節點值的字串值。 在此程式後的程式碼範例中，此自訂方法稱為 getNodeText. 此方法的內文如所示。

   • 如果資料內容類型為 application/pdf，建立應用程式邏輯，將提交的PDF資料儲存為PDF檔案。

     • 建立 com.adobe.idp.Document 對象，方法是調用 FormsResult 物件 getOutputContent 方法。
     • 建立 java.io.File 物件，使用其公用建構函式。 請務必將PDF指定為副檔名。
     • 叫用以填入PDF檔案 com.adobe.idp.Document 物件 copyToFile 方法和傳遞 java.io.File 物件。

另請參閱

快速入門（SOAP模式）:使用Java API處理以XML提交的PDF forms

快速入門（SOAP模式）:使用Java API處理以XML提交的HTML表單

快速入門（SOAP模式）:使用Java API處理以PDF形式提交的PDF forms

包含AEM Forms Java程式庫檔案

設定連接屬性

使用網站服務API處理已提交的PDF資料

使用Forms API（網站服務）處理提交的表單：

1. 包含項目檔案

   • 建立使用Forms服務WSDL的Java代理類。
   • 將Java代理類包含到類路徑中。

2. 建立Forms用戶端API物件

   建立 FormsService 對象和設定驗證值。

3. 擷取表單資料

   • 若要擷取張貼至Java Servlet的表單資料，請建立 BLOB 物件，使用其建構子。

   • 建立 java.io.InputStream 對象，方法是調用 javax.servlet.http.HttpServletResponse 物件 getInputStream 方法。

   • 建立 java.io.ByteArrayOutputStream 對象，使用其建構子並傳遞長度 java.io.InputStream 物件。

   • 複製 java.io.InputStream 物件 java.io.ByteArrayOutputStream 物件。

   • 叫用 java.io.ByteArrayOutputStream 物件 toByteArray 方法。

   • 填入 BLOB 對象 setBinaryData 方法，並將位元組陣列傳遞為引數。

   • 建立 RenderOptionsSpec 物件，使用其建構子。 調用 RenderOptionsSpec 物件 setLocale 方法，並傳遞指定區域設定的字串值。

   • 叫用 FormsService 物件 processFormSubmission 方法，並傳遞下列值：

     • 此 BLOB 包含表單資料的物件。
     • 一個字串值，它指定包括所有相關HTTP標題的環境變數。 指定要處理的內容類型。 要處理XML資料，請為此參數指定以下字串值： CONTENT_TYPE=text/xml. 若要處理PDF資料，請為此參數指定下列字串值： CONTENT_TYPE=application/pdf.
     • 指定 HTTP_USER_AGENT 標題值；例如， Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1; SV1; .NET CLR 1.1.4322).
     • A RenderOptionsSpec 儲存運行時選項的對象。
     • 空白 BLOBHolder 由方法填入的物件。
     • 空白 javax.xml.rpc.holders.StringHolder 由方法填入的物件。
     • 空白 BLOBHolder 由方法填入的物件。
     • 空白 BLOBHolder 由方法填入的物件。
     • 空白 javax.xml.rpc.holders.ShortHolder 由方法填入的物件。
     • 空白 MyArrayOf_xsd_anyTypeHolder 由方法填入的物件。 此參數用於儲存隨表單提交的檔案附件。
     • 空白 FormsResultHolder 由方法填入且已提交表單的物件。

     此 processFormSubmission 方法填入 FormsResultHolder 參數與表單提交結果。

   • 判斷Forms服務是否已借由叫用 FormsResult 物件 getAction 方法。 如果此方法傳回值 0，表單資料就緒即可處理。 您可以取得 FormsResult 物件，方法是取得 FormsResultHolder 物件 value 資料成員。

4. 確定表單提交是否包含檔案附件

   取得 MyArrayOf_xsd_anyTypeHolder 物件 value 資料成員( MyArrayOf_xsd_anyTypeHolder 物件已傳遞至 processFormSubmission 方法)。 此資料成員返回 Objects. 內的每個元素 Object 陣列是 Object與隨表單提交的檔案對應。 您可以取得陣列內的每個元素，並將其轉換為 BLOB 物件。

5. 處理提交的資料

   • 如果資料內容類型為 application/vnd.adobe.xdp+xml 或 text/xml，建立應用程式邏輯以擷取XML資料值。

     • 建立 BLOB 對象，方法是調用 FormsResult 物件 getOutputContent 方法。
     • 叫用 BLOB 物件 getBinaryData 方法。
     • 建立 java.io.InputStream 對象，方法是調用 java.io.ByteArrayInputStream 建構函式並傳遞位元組陣列。
     • 建立 org.w3c.dom.DocumentBuilderFactory 物件，方法是呼叫靜態 org.w3c.dom.DocumentBuilderFactory 物件 newInstance 方法。
     • 建立 org.w3c.dom.DocumentBuilder 對象，方法是調用 org.w3c.dom.DocumentBuilderFactory 物件 newDocumentBuilder 方法。
     • 建立 org.w3c.dom.Document 對象，方法是調用 org.w3c.dom.DocumentBuilder 物件 parse 方法和傳遞 java.io.InputStream 物件。
     • 檢索XML文檔中每個節點的值。 完成此工作的一種方式是建立接受兩個參數的自訂方法：the org.w3c.dom.Document 對象和要檢索其值的節點的名稱。 此方法會傳回代表節點值的字串值。 在此程式後的程式碼範例中，此自訂方法稱為 getNodeText. 此方法的內文如所示。

   • 如果資料內容類型為 application/pdf，建立應用程式邏輯，將提交的PDF資料儲存為PDF檔案。

     • 建立 BLOB 對象，方法是調用 FormsResult 物件 getOutputContent 方法。
     • 叫用 BLOB 物件 getBinaryData 方法。
     • 建立 java.io.File 物件，使用其公用建構函式。 請務必將PDF指定為副檔名。
     • 建立 java.io.FileOutputStream 對象，使用其建構子並傳遞 java.io.File 物件。
     • 叫用以填入PDF檔案 java.io.FileOutputStream 物件 write 方法，並傳遞位元組陣列。

另請參閱

使用Base64編碼叫用AEM Forms

Business.Adobe.com 資源

Content Insights Cms Cloud Targeted Content Embedded Charts Digital Rights Management Content Management System