處理已提交的Forms handling-submitted-forms
本檔案中的範例和範例僅適用於JEE環境上的AEM Forms 。
讓使用者能夠填寫互動式表單的網頁式應用程式,需要資料提交回伺服器。 使用Forms服務,您可以擷取使用者在互動式表單中輸入的資料。 擷取資料後,您可以處理資料以符合業務需求。 例如,您可以將資料儲存在資料庫中、將資料傳送至其他應用程式、將資料傳送至其他服務、將資料合併至表單設計、在網頁瀏覽器中顯示資料等等。
表單資料會以XML或PDF資料(在Designer中設定的選項)提交至Forms服務。 以XML形式提交的表單可讓您擷取個別欄位資料值。 也就是說,您可以擷取使用者在表單中輸入的每個表單欄位的值。 以PDF資料形式提交的表單是二進位資料,而非XML資料。 您可以將表單儲存為PDF檔案,或將表單傳送至其他服務。 如果您想要從以XML格式提交的表單中擷取資料,然後使用表單資料來建立PDF檔案,請叫用另一個AEM Forms作業。 (請參閱 使用已提交的XML資料建立PDF檔案)
下圖顯示提交至名為的Java Servlet的資料 HandleData
從網頁瀏覽器中顯示的互動式表單。
下表說明圖表中的步驟。
HandleData
Java Servlet作為XML資料。HandleData
Java Servlet包含用來擷取資料的應用程式邏輯。處理提交的XML資料 handling-submitted-xml-data
表單資料以XML格式提交時,您可以擷取代表已提交資料的XML資料。 所有表單欄位都會顯示為XML結構描述中的節點。 節點值對應至使用者填入的值。 考慮貸款表單,其中表單中的每個欄位都會顯示為XML資料中的節點。 每個節點的值與使用者填入的值相對應。 假設使用者填入貸款表單,其資料顯示於下清單單。
下圖顯示使用Forms服務使用者端API擷取的對應XML資料。
貸款表單中的欄位。 這些值可以使用Java XML類別來擷取。
處理提交的PDF資料 handling-submitted-pdf-data
假設有一個叫用Forms服務的Web應用程式。 在Forms服務將互動式PDF表單轉譯給使用者端Web瀏覽器後,使用者會填寫表單並將其提交回PDF資料。 Forms服務收到PDF資料時,會將PDF資料傳送至其他服務或儲存為PDF檔案。 下圖顯示應用程式的邏輯流程。
下表說明此圖表中的步驟。
處理提交的URL UTF-16資料 handling-submitted-url-utf-16-data
如果表單資料以URL UTF-16資料提交,使用者端電腦會需要Adobe Reader或Acrobat 8.1或更新版本。 此外,如果表單設計包含具有URL編碼資料(HTTP Post)的提交按鈕,且資料編碼選項為UTF-16,則表單設計必須在文字編輯器(例如記事本)中修改。 您可以將編碼選項設為 UTF-16LE
或 UTF-16BE
針對「提交」按鈕。 Designer不提供此功能。
步驟摘要 summary-of-steps
若要處理提交的表單,請執行下列工作:
- 包含專案檔案。
- 建立Forms使用者端API物件。
- 擷取表單資料。
- 決定表單提交是否包含檔案附件。
- 處理提交的資料。
包含專案檔案
將必要的檔案納入您的開發專案中。 如果您使用Java建立使用者端應用程式,請包含必要的JAR檔案。 如果您使用Web服務,請確定您包含Proxy檔案。
建立Forms使用者端API物件
您必須先建立Forms服務使用者端,才能以程式設計方式執行Forms服務使用者端API作業。 如果您使用Java API,請建立 FormsServiceClient
物件。 如果您使用Forms Web服務API,請建立 FormsService
物件。
擷取表單資料
若要擷取提交的表單資料,請叫用 FormsServiceClient
物件的 processFormSubmission
方法。 叫用此方法時,您必須指定已提交表單的內容型別。 從使用者端Web瀏覽器將資料提交至Forms服務時,資料可以以XML或PDF資料形式提交。 若要擷取輸入表單欄位中的資料,資料可以提交為XML資料。
您也可以設定下列執行階段選項,從提交為PDF資料的表單中擷取表單欄位:
- 將下列值傳遞至
processFormSubmission
方法當作content type引數: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時要使用的內容型別。
application/pdf
. 使用Java API快速入門以XML格式提交的處理PDF forms示範如何處理從PDF表單提交的提交XML資料。 此快速入門中指定的內容型別為 text/xml
. 同樣地,使用Java API快速入門以XML格式提交的處理HTML表單會示範如何處理從HTML表單提交的已提交XML資料。 此快速入門中指定的內容型別為application/x-www-form-urlencoded。您可以擷取發佈至Forms服務的表單資料,並判斷其處理狀態。 也就是說,將資料提交至Forms服務時,未必代表Forms服務已完成資料處理,而資料已準備好進行處理。 例如,資料可提交至Forms服務,以便執行計算。 計算完成後,表單會轉譯回使用者並顯示計算結果。 在處理提交的資料之前,建議您先判斷Forms服務是否已完成資料處理。
Forms服務會傳回下列值,指出是否已完成資料處理:
- 0 (提交): 已提交的資料已準備好進行處理。
- 1 (計算): Forms服務已對資料執行計算操作,且必須將結果轉譯回使用者。
- 2 (驗證): Forms服務已驗證表單資料,必須將結果轉譯回使用者。
- 3 (下一個): 目前頁面已變更,結果必須寫入使用者端應用程式。
- 4 (上一個):目前頁面已變更,且結果必須寫入使用者端應用程式。
決定表單提交是否包含檔案附件
提交至Forms服務的Forms可包含檔案附件。 例如,使用Acrobat的內建附件窗格,使用者可以選擇要與表單一起提交的檔案附件。 此外,使用者也可以使用以HTML檔案呈現的HTML工具列來選取檔案附件。
確定表單是否包含檔案附件後,即可處理資料。 例如,您可以將檔案附件儲存至本機檔案系統。
處理提交的資料
根據提交資料的內容型別,您可以從提交的XML資料中擷取個別表單欄位值,或將提交的PDF資料儲存為PDF檔案(或將其傳送至其他服務)。 若要擷取個別表單欄位,請將提交的XML資料轉換為XML資料來源,然後使用擷取XML資料來源值 org.w3c.dom
類別。
另請參閱
使用Java API處理提交的表單 handle-submitted-forms-using-the-java-api
使用Forms API (Java)處理提交的表單:
-
包含專案檔案
在您的Java專案的類別路徑中包含使用者端JAR檔案,例如adobe-forms-client.jar。
-
建立Forms使用者端API物件
- 建立
ServiceClientFactory
包含連線屬性的物件。 - 建立
FormsServiceClient
物件,使用它的建構函式並傳遞ServiceClientFactory
物件。
- 建立
-
擷取表單資料
- 若要擷取發佈至Java Servlet的表單資料,請建立
com.adobe.idp.Document
物件,方法是使用其建構函式javax.servlet.http.HttpServletResponse
物件的getInputStream
建構函式中的方法。 - 建立
RenderOptionsSpec
物件(使用其建構函式)。 透過叫用RenderOptionsSpec
物件的setLocale
方法並傳遞字串值,該值會指定地區設定值。
note note NOTE 您可以透過叫用「 」,指示Forms服務從提交的PDF內容建立XDP或XML資料 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
,資料已準備好處理。
- 若要擷取發佈至Java Servlet的表單資料,請建立
-
決定表單提交是否包含檔案附件
- 叫用
FormsResult
物件的getAttachments
方法。 此方法會傳回java.util.List
包含以表單提交的檔案的物件。 - 逐一檢視
java.util.List
物件,用來判斷是否有檔案附件。 如果有檔案附件,則每個元素都會是com.adobe.idp.Document
執行個體。 您可以透過叫用com.adobe.idp.Document
物件的copyToFile
方法和傳遞java.io.File
物件。
note note NOTE 此步驟僅適用於表單以PDF提交的情況。 - 叫用
-
處理提交的資料
-
如果資料內容型別為
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檔案中每個節點的值。 完成此工作的一種方式是建立接受兩個引數的自訂方法:
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
使用網站服務API處理提交的PDF資料 handle-submitted-pdf-data-using-the-web-service-api
使用Forms API (網站服務)處理提交的表單:
-
包含專案檔案
- 建立使用Forms服務WSDL的Java Proxy類別。
- 將Java Proxy類別納入您的類別路徑中。
-
建立Forms使用者端API物件
建立
FormsService
物件並設定驗證值。 -
擷取表單資料
-
若要擷取發佈至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
資料成員。
-
-
決定表單提交是否包含檔案附件
取得
MyArrayOf_xsd_anyTypeHolder
物件的value
資料成員(MyArrayOf_xsd_anyTypeHolder
物件已傳遞至processFormSubmission
方法)。 此資料成員傳回陣列Objects
. 內的每個元素Object
陣列是一個Object
與表單一起提交的檔案相對應。 您可以取得陣列中的每個元素,並將其轉型為BLOB
物件。 -
處理提交的資料
-
如果資料內容型別為
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檔案中每個節點的值。 完成此工作的一種方式是建立接受兩個引數的自訂方法:
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
方法並傳遞位元組陣列。
- 建立
-
另請參閱