預先填入表單會在轉譯的表單中向使用者顯示資料。 例如,假設使用者使用使用者名稱和密碼登入網站。 如果驗證成功,客戶端應用程式將查詢資料庫以獲取用戶資訊。 資料會合併到表單中,然後再將表單轉譯給使用者。 因此,用戶能夠在表單中查看個性化資料。
預先填入表單具有以下優點:
下列兩個XML資料來源可預先填入表單:
您要預先填入的每個表單欄位都必須有XML元素。 XML元素名稱必須與欄位名稱相符。 如果XML元素與表單欄位不對應,或XML元素名稱與欄位名稱不符,則會忽略它。 只要指定了所有XML元素,就不需要與XML元素的顯示順序匹配。
當您預先填入已包含資料的表單時,必須指定已顯示在XML資料來源中的資料。 假設一個包含10個欄位的表單有4個欄位中的資料。 接下來,假設您要預先填入其餘6個欄位。 在這種情況下,您必須在XML資料來源中指定10個XML元素,以便預先填入表單。 如果您只指定6個元素,原始的4個欄位會是空的。
例如,您可以預先填入表單,例如範例確認表單。 (請參閱轉換互動式PDF表單中的「確認表單」)。
若要預先填入範例確認表單,您必須建立一個XML資料來源,其中包含三個XML元素,這些元素會符合表單中的三個欄位。 此表單包含下列三個欄位:FirstName
、LastName
和Amount
。 第一步是建立XML資料來源,其中包含與表單設計欄位相符的XML元素。 下一步是為XML元素指派資料值,如下列XML程式碼所示。
<Untitled>
<FirstName>Jerry</FirstName>
<LastName>Johnson</LastName>
<Amount>250000</Amount>
</Untitled>
使用此XML資料來源預先填入確認表單,然後轉譯表單後,就會顯示您指派給XML元素的資料值,如下圖所示。
具有可排列版面的表單對於向使用者顯示未確定數量的資料非常有用。 由於表單的版面會自動調整為合併的資料量,因此您不需要預先決定表單的固定版面或頁數,就像使用固定版面的表單一樣。
表單通常會填入在執行時期取得的資料。 因此,您可以建立記憶體中的XML資料來源,並將資料直接放入記憶體中的XML資料來源,以預先填入表格。
考慮使用網路應用程式,例如線上商店。 線上購物者完成購買項目後,所有購買的項目都會放入記憶體內的XML資料來源中,以便預先填入表單。 下圖顯示了此過程,如圖後的表中所述。
下表說明此圖中的步驟。
步驟 |
說明 |
---|---|
1 |
使用者從線上商店購買商品。 |
2 |
當使用者完成購買項目並按一下「提交」按鈕後,就會建立記憶體中的XML資料來源。 購買的項目和使用者資訊會放入記憶體中的XML資料來源中。 |
3 |
XML資料來源用於預先填入採購單表單(下表列出此表單的範例)。 |
4 |
採購訂單表單會轉譯至用戶端網頁瀏覽器。 |
下圖顯示了採購訂單表單的示例。 表格中的資訊可以根據XML資料中的記錄數來調整。
表單可以預先填入來自其他來源的資料,例如企業資料庫或外部應用程式。
具有可排列版面的表單,是以在設計人員中建立的表單設計為基礎。 表單設計指定一組版面配置、呈現和資料擷取規則,包括根據使用者輸入計算值。 當資料輸入表單時,就會套用規則。 新增至表單的欄位是表單設計中的子表單。 例如,在上圖中顯示的採購訂單表單中,每行都是子表單。 有關建立包含子表單的表單設計的資訊,請參閱建立具有可流式佈局的採購訂單表單。
XML資料來源可用來預先填入固定版面和可排列版面的表單。 但是,區別在於,預先填入可排列版面的XML資料來源包含重複的XML元素,這些元素會用來預先填入在表單中重複的子表單。 這些重複的XML元素稱為資料子群組。
用於預填上圖中所示採購訂單表單的XML資料源包含四個重複資料子組。 每個資料子群組都對應於購買的項目。 購買的物品包括顯示器、台燈、電話和地址簿。
以下XML資料來源用於預先填入採購單表單。
<header>
<!-- XML elements used to prepopulate non-repeating fields such as address
<!and city
<txtPONum>8745236985</txtPONum>
<dtmDate>2004-02-08</dtmDate>
<txtOrderedByCompanyName>Any Company Name</txtOrderedByCompanyName>
<txtOrderedByAddress>555, Any Blvd.</txtOrderedByAddress>
<txtOrderedByCity>Any City</txtOrderedByCity>
<txtOrderedByStateProv>ST</txtOrderedByStateProv>
<txtOrderedByZipCode>12345</txtOrderedByZipCode>
<txtOrderedByCountry>Any Country</txtOrderedByCountry>
<txtOrderedByPhone>(123) 456-7890</txtOrderedByPhone>
<txtOrderedByFax>(123) 456-7899</txtOrderedByFax>
<txtOrderedByContactName>Contact Name</txtOrderedByContactName>
<txtDeliverToCompanyName>Any Company Name</txtDeliverToCompanyName>
<txtDeliverToAddress>7895, Any Street</txtDeliverToAddress>
<txtDeliverToCity>Any City</txtDeliverToCity>
<txtDeliverToStateProv>ST</txtDeliverToStateProv>
<txtDeliverToZipCode>12346</txtDeliverToZipCode>
<txtDeliverToCountry>Any Country</txtDeliverToCountry>
<txtDeliverToPhone>(123) 456-7891</txtDeliverToPhone>
<txtDeliverToFax>(123) 456-7899</txtDeliverToFax>
<txtDeliverToContactName>Contact Name</txtDeliverToContactName>
</header>
<detail>
<!-- A data subgroup that contains information about the monitor>
<txtPartNum>00010-100</txtPartNum>
<txtDescription>Monitor</txtDescription>
<numQty>1</numQty>
<numUnitPrice>350.00</numUnitPrice>
</detail>
<detail>
<!-- A data subgroup that contains information about the desk lamp>
<txtPartNum>00010-200</txtPartNum>
<txtDescription>Desk lamps</txtDescription>
<numQty>3</numQty>
<numUnitPrice>55.00</numUnitPrice>
</detail>
<detail>
<!-- A data subgroup that contains information about the Phone>
<txtPartNum>00025-275</txtPartNum>
<txtDescription>Phone</txtDescription>
<numQty>5</numQty>
<numUnitPrice>85.00</numUnitPrice>
</detail>
<detail>
<!-- A data subgroup that contains information about the address book>
<txtPartNum>00300-896</txtPartNum>
<txtDescription>Address book</txtDescription>
<numQty>2</numQty>
<numUnitPrice>15.00</numUnitPrice>
</detail>
請注意,每個資料子群組包含四個與此資訊對應的XML元素:
資料子群組的父XML元素名稱必須與表單設計中的子表單名稱相符。 例如,在上圖中,請注意資料子群組的父XML元素名稱為detail
。 這對應於採購訂單表單所基於的表單設計中的子表單的名稱。 如果資料子群組的父XML元素名稱與子表單不符,則不會預先填入伺服器端表單。
每個資料子群組都必須包含符合子表單欄位名稱的XML元素。 表單設計中的detail
子表單包含下列欄位:
如果您嘗試預先填入包含重複XML元素的資料來源的表單,並將RenderAtClient
選項設為No
,則只會將第一個資料記錄合併到表單中。 為確保所有資料記錄都合併到表單中,請將RenderAtClient
設定為Yes
。 有關RenderAtClient
選項的資訊,請參見Client](/docs/experience-manager-65/forms/developing/rendering-forms-client.html?lang=zh-Hant)上的[ Rendering Forms。
如需Forms服務的詳細資訊,請參閱AEM Forms的服務參考。
若要預先填入可排程版面的表單,請執行下列工作:
包含專案檔案
將必要的檔案加入您的開發專案中。 如果要使用Java建立客戶端應用程式,請包括必要的JAR檔案。 如果您使用web services,請確定您包含proxy檔案。
包含專案檔案
將必要的檔案加入您的開發專案中。 如果要使用Java建立客戶端應用程式,請包括必要的JAR檔案。 如果您使用web services,請確定您包含proxy檔案。
建立記憶體中的XML資料來源
您可以使用org.w3c.dom
類別來建立記憶體中的XML資料來源,以預先填入具有可排列版面的表單。 您必須將資料放入符合表單的XML資料來源。 有關具有可流式佈局的表單與XML資料源之間關係的資訊,請參閱瞭解資料子組。
轉換XML資料來源
使用org.w3c.dom
類建立的記憶體中XML資料源可以轉換為com.adobe.idp.Document
對象,然後再用於預填充表單。 記憶體中的XML資料源可以使用Java XML轉換類進行轉換。
如果您使用Forms服務的WSDL來預先填入表單,則必須將org.w3c.dom.Document
物件轉換為BLOB
物件。
演算預先填入的表單
您會像轉換其他表格一樣,轉換預先填入的表格。 唯一的區別是,您使用包含XML資料來源的com.adobe.idp.Document
物件來預先填入表單。
另請參閱
若要使用Forms API(Java)以可排程的版面預先填入表單,請執行下列步驟:
包含專案檔案
在Java專案的類別路徑中包含用戶端JAR檔案,例如adobe-forms-client.jar。 如需這些檔案位置的詳細資訊,請參閱包含AEM Forms Java程式庫檔案。
建立記憶體中的XML資料來源
通過調用DocumentBuilderFactory
類newInstance
方法建立Java DocumentBuilderFactory
對象。
呼叫DocumentBuilderFactory
物件的newDocumentBuilder
方法,以建立Java DocumentBuilder
物件。
呼叫DocumentBuilder
物件的newDocument
方法,以實例化org.w3c.dom.Document
物件。
呼叫org.w3c.dom.Document
物件的createElement
方法,以建立XML資料來源的根元素。 這會建立代表根元素的Element
物件。 將表示元素名稱的字串值傳遞至createElement
方法。 將返回值轉換為Element
。 接著,呼叫Document
物件的appendChild
方法,將根元素附加至檔案,並將根元素物件傳遞為引數。 下列程式碼行顯示此應用程式邏輯:
Element root = (Element)document.createElement("transaction"); document.appendChild(root);
呼叫Document
物件的createElement
方法,以建立XML資料來源的標題元素。 將表示元素名稱的字串值傳遞至createElement
方法。 將返回值轉換為Element
。 接著,呼叫root
物件的appendChild
方法,將標題元素附加至根元素,並將標題元素物件傳遞為引數。 附加到標題元素的XML元素對應於表單的靜態部分。 下列程式碼行會顯示此應用程式邏輯:
Element header = (Element)document.createElement("header"); root.appendChild(header);
呼叫Document
物件的createElement
方法,建立屬於標題元素的子元素,並傳遞代表元素名稱的字串值。 將返回值轉換為Element
。 接著,呼叫其appendChild
方法來設定子元素的值,並將Document
物件的createTextNode
方法傳遞為引數。 指定顯示為子元素值的字串值。 最後,呼叫標題元素的appendChild
方法,將子元素附加至標題元素,並將子元素物件傳遞為引數。 下列程式碼行會顯示此應用程式邏輯:
Element poNum= (Element)document.createElement("txtPONum"); poNum.appendChild(document.createTextNode("8745236985")); header.appendChild(LastName);
重複表格靜態部分(在XML資料來源圖中,這些欄位如A節所示)中每個欄位的最後一個子步驟,將所有剩餘的元素新增至標題元素。(請參閱瞭解資料子群組。)
呼叫Document
物件的createElement
方法,以建立XML資料來源的詳細資料元素。 將表示元素名稱的字串值傳遞至createElement
方法。 將返回值轉換為Element
。 接著,呼叫root
物件的appendChild
方法,將詳細資料元素附加至根元素,並將詳細資料元素物件傳遞為引數。 附加到細節元素的XML元素對應於表單的動態部分。 下列程式碼行會顯示此應用程式邏輯:
Element detail = (Element)document.createElement("detail"); root.appendChild(detail);
呼叫Document
物件的createElement
方法,建立屬於詳細資料元素的子元素,並傳遞代表元素名稱的字串值。 將返回值轉換為Element
。 接著,呼叫其appendChild
方法來設定子元素的值,並將Document
物件的createTextNode
方法傳遞為引數。 指定顯示為子元素值的字串值。 最後,呼叫詳細資料元素的appendChild
方法,將子項元素附加至詳細資料元素,並將子項元素物件傳遞為引數。 下列程式碼行會顯示此應用程式邏輯:
Element txtPartNum = (Element)document.createElement("txtPartNum"); txtPartNum.appendChild(document.createTextNode("00010-100")); detail.appendChild(txtPartNum);
對所有XML元素重複最後一個子步驟,以附加至詳細資料元素。 要正確建立用於填充採購訂單表單的XML資料源,您必須將以下XML元素附加到詳細資訊元素:txtDescription
、numQty
和numUnitPrice
。
對用於預先填入表單的所有資料項目,重複最後兩個子步驟。
轉換XML資料來源
javax.xml.transform.Transformer
對象的靜態newInstance
方法建立javax.xml.transform.Transformer
對象。TransformerFactory
物件的newTransformer
方法,以建立Transformer
物件。ByteArrayOutputStream
對象。org.w3c.dom.Document
對象,建立javax.xml.transform.dom.DOMSource
對象。ByteArrayOutputStream
對象,建立javax.xml.transform.dom.DOMSource
對象。javax.xml.transform.Transformer
物件的transform
方法並傳遞javax.xml.transform.dom.DOMSource
和javax.xml.transform.stream.StreamResult
物件,以填入Java ByteArrayOutputStream
物件。ByteArrayOutputStream
對象的大小分配給位元組陣列。ByteArrayOutputStream
物件的toByteArray
方法,以填入位元組陣列。com.adobe.idp.Document
物件的建構函式並傳遞位元組陣列,以建立<a0/>物件。演算預先填入的表單
叫用FormsServiceClient
物件的renderPDFForm
方法並傳遞下列值:
com.adobe.idp.Document
物件,包含要與表單合併的資料。 請確定您使用步驟1和2中建立的com.adobe.idp.Document
物件。PDFFormRenderSpec
對象。URLSpec
物件,包含Forms服務所需的URI值。java.util.HashMap
對象。 此為可選參數,如果您不想將檔案附加到表單,可以指定null
。renderPDFForm
方法返回一個FormsResult
對象,該對象包含必須寫入客戶端Web瀏覽器的表單資料流。
javax.servlet.ServletOutputStream
物件,用來傳送表單資料串流至用戶端網頁瀏覽器。FormsResult
對象「s getOutputContent
」方法建立com.adobe.idp.Document
對象。com.adobe.idp.Document
物件的getInputStream
方法,以建立java.io.InputStream
物件。InputStream
物件的read
方法,並將位元組陣列傳入為引數,以填入表單資料流的位元組陣列。javax.servlet.ServletOutputStream
物件的write
方法,將表單資料串流傳送至用戶端網頁瀏覽器。 將位元組陣列傳遞到write
方法。另請參閱
快速入門(SOAP模式):使用Java API將可排程的版面預先填入表單
若要使用Forms API(web service)以可排程的版面預先填入表單,請執行下列步驟:
包含專案檔案
建立記憶體中的XML資料來源
通過調用DocumentBuilderFactory
類newInstance
方法建立Java DocumentBuilderFactory
對象。
呼叫DocumentBuilderFactory
物件的newDocumentBuilder
方法,以建立Java DocumentBuilder
物件。
呼叫DocumentBuilder
物件的newDocument
方法,以實例化org.w3c.dom.Document
物件。
呼叫org.w3c.dom.Document
物件的createElement
方法,以建立XML資料來源的根元素。 這會建立代表根元素的Element
物件。 將表示元素名稱的字串值傳遞至createElement
方法。 將返回值轉換為Element
。 接著,呼叫Document
物件的appendChild
方法,將根元素附加至檔案,並將根元素物件傳遞為引數。 下列程式碼行會顯示此應用程式邏輯:
Element root = (Element)document.createElement("transaction"); document.appendChild(root);
呼叫Document
物件的createElement
方法,以建立XML資料來源的標題元素。 將表示元素名稱的字串值傳遞至createElement
方法。 將返回值轉換為Element
。 接著,呼叫root
物件的appendChild
方法,將標題元素附加至根元素,並將標題元素物件傳遞為引數。 附加到標題元素的XML元素對應於表單的靜態部分。 下列程式碼行會顯示此應用程式邏輯:
Element header = (Element)document.createElement("header"); root.appendChild(header);
呼叫Document
物件的createElement
方法,建立屬於標題元素的子元素,並傳遞代表元素名稱的字串值。 將返回值轉換為Element
。 接著,呼叫其appendChild
方法來設定子元素的值,並將Document
物件的createTextNode
方法傳遞為引數。 指定顯示為子元素值的字串值。 最後,呼叫標題元素的appendChild
方法,將子元素附加至標題元素,並將子元素物件傳遞為引數。 下列程式碼行顯示此應用程式邏輯:
Element poNum= (Element)document.createElement("txtPONum"); poNum.appendChild(document.createTextNode("8745236985")); header.appendChild(LastName);
重複表格靜態部分(在XML資料來源圖中,這些欄位如A節所示)中每個欄位的最後一個子步驟,將所有剩餘的元素新增至標題元素。(請參閱瞭解資料子群組。)
呼叫Document
物件的createElement
方法,以建立XML資料來源的詳細資料元素。 將表示元素名稱的字串值傳遞至createElement
方法。 將返回值轉換為Element
。 接著,呼叫root
物件的appendChild
方法,將詳細資料元素附加至根元素,並將詳細資料元素物件傳遞為引數。 附加到細節元素的XML元素對應於表單的動態部分。 下列程式碼行顯示此應用程式邏輯:
Element detail = (Element)document.createElement("detail"); root.appendChild(detail);
呼叫Document
物件的createElement
方法,建立屬於詳細資料元素的子元素,並傳遞代表元素名稱的字串值。 將返回值轉換為Element
。 接著,呼叫其appendChild
方法來設定子元素的值,並將Document
物件的createTextNode
方法傳遞為引數。 指定顯示為子元素值的字串值。 最後,呼叫詳細資料元素的appendChild
方法,將子項元素附加至詳細資料元素,並將子項元素物件傳遞為引數。 下列程式碼行顯示此應用程式邏輯:
Element txtPartNum = (Element)document.createElement("txtPartNum"); txtPartNum.appendChild(document.createTextNode("00010-100")); detail.appendChild(txtPartNum);
對所有XML元素重複最後一個子步驟,以附加至詳細資料元素。 要正確建立用於填充採購訂單表單的XML資料源,您必須將以下XML元素附加到詳細資訊元素:txtDescription
、numQty
和numUnitPrice
。
對用於預先填入表單的所有資料項目,重複最後兩個子步驟。
轉換XML資料來源
javax.xml.transform.Transformer
對象的靜態newInstance
方法建立javax.xml.transform.Transformer
對象。TransformerFactory
物件的newTransformer
方法,以建立Transformer
物件。ByteArrayOutputStream
對象。org.w3c.dom.Document
對象,建立javax.xml.transform.dom.DOMSource
對象。ByteArrayOutputStream
對象,建立javax.xml.transform.dom.DOMSource
對象。javax.xml.transform.Transformer
物件的transform
方法並傳遞javax.xml.transform.dom.DOMSource
和javax.xml.transform.stream.StreamResult
物件,以填入Java ByteArrayOutputStream
物件。ByteArrayOutputStream
對象的大小分配給位元組陣列。ByteArrayOutputStream
物件的toByteArray
方法,以填入位元組陣列。BLOB
對象並調用其setBinaryData
方法並傳遞位元組陣列。演算預先填入的表單
叫用FormsService
物件的renderPDFForm
方法並傳遞下列值:
BLOB
物件,包含要與表單合併的資料。 請確定您使用在步驟1和步驟2中建立的BLOB
對象。PDFFormRenderSpecc
對象。 如需詳細資訊,請參閱AEM Forms API參考。URLSpec
物件,包含Forms服務所需的URI值。java.util.HashMap
對象。 此為可選參數,如果您不想將檔案附加到表單,可以指定null
。com.adobe.idp.services.holders.BLOBHolder
對象。 這可用來儲存轉譯的PDF表單。javax.xml.rpc.holders.LongHolder
對象。 (此引數將儲存表單中的頁數)。javax.xml.rpc.holders.StringHolder
對象。 (此引數將儲存地區值)。com.adobe.idp.services.holders.FormsResultHolder
對象,將包含此操作的結果。renderPDFForm
方法會以必須寫入用戶端網頁瀏覽器的表單資料流填入作為最後一個參數值傳遞的com.adobe.idp.services.holders.FormsResultHolder
物件。
com.adobe.idp.services.holders.FormsResultHolder
對象value
資料成員的值,建立FormResult
對象。FormsResult
物件的getOutputContent
方法,建立包含表單資料的BLOB
物件。getContentType
方法獲取BLOB
對象的內容類型。setContentType
方法並傳遞BLOB
物件的內容類型,以設定javax.servlet.http.HttpServletResponse
物件的內容類型。javax.servlet.http.HttpServletResponse
物件的getOutputStream
方法,建立javax.servlet.ServletOutputStream
物件,用來將表單資料串流寫入用戶端Web瀏覽器。BLOB
物件的getBinaryData
方法以填入它。 此任務將FormsResult
對象的內容分配給位元組陣列。javax.servlet.http.HttpServletResponse
物件的write
方法,將表單資料串流傳送至用戶端網頁瀏覽器。 將位元組陣列傳遞到write
方法。renderPDFForm
方法會以必須寫入用戶端網頁瀏覽器的表單資料流填入作為最後一個參數值傳遞的com.adobe.idp.services.holders.FormsResultHolder
物件。
另請參閱