使用可排程版面預先填入表單

使用可排程版面預先填入表單

預先填入表單會在轉譯的表單中向使用者顯示資料。 例如，假設使用者使用使用者名稱和密碼登入網站。 如果驗證成功，客戶端應用程式將查詢資料庫以獲取用戶資訊。 資料會合併到表單中，然後再將表單轉譯給使用者。 因此，用戶能夠在表單中查看個性化資料。

預先填入表單具有以下優點：

• 可讓使用者檢視表單中的自訂資料。
• 減少使用者填寫表單時的輸入量。
• 控制資料的放置位置，以確保資料的完整性。

下列兩個XML資料來源可預先填入表單：

• XDP資料來源，是符合XFA語法的XML（或XFDF資料，以預先填入使用Acrobat建立的表格）。
• 任意XML資料來源，包含與表單欄位名稱相符的名稱／值配對（本節中的範例使用任意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子表單包含下列欄位：

• txtPartNum
• txtDescription
• numQty
• numUnitPrice

步驟摘要

若要預先填入可排程版面的表單，請執行下列工作：

1. 包含專案檔案。
2. 建立記憶體中的XML資料來源。
3. 轉換XML資料來源。
4. 演算預先填入的表單。

包含專案檔案

將必要的檔案加入您的開發專案中。 如果要使用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轉換類進行轉換。

演算預先填入的表單

您會像轉換其他表格一樣，轉換預先填入的表格。 唯一的區別是，您使用包含XML資料來源的com.adobe.idp.Document物件來預先填入表單。

另請參閱

包含AEM Forms Java程式庫檔案

設定連接屬性

Forms Service API快速入門

轉換互動式PDF表單

建立轉譯表單的Web應用程式

使用Java API預填表單

若要使用Forms API(Java)以可排程的版面預先填入表單，請執行下列步驟：

1. 包含專案檔案

   在Java專案的類別路徑中包含用戶端JAR檔案，例如adobe-forms-client.jar。 如需這些檔案位置的詳細資訊，請參閱包含AEM Forms Java程式庫檔案。

2. 建立記憶體中的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。

   • 對用於預先填入表單的所有資料項目，重複最後兩個子步驟。

3. 轉換XML資料來源

   • 通過調用javax.xml.transform.Transformer對象的靜態newInstance方法建立javax.xml.transform.Transformer對象。
   • 調用TransformerFactory物件的newTransformer方法，以建立Transformer物件。
   • 使用其建構子建立ByteArrayOutputStream對象。
   • 使用其建構子並傳遞在步驟1中建立的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/>物件。

4. 演算預先填入的表單

   叫用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將可排程的版面預先填入表單

包含AEM Forms Java程式庫檔案

設定連接屬性

使用web service API預填表單

若要使用Forms API(web service)以可排程的版面預先填入表單，請執行下列步驟：

1. 包含專案檔案

   • 建立使用Forms服務WSDL的Java代理類。 （請參閱使用Apache Axis建立Java代理類。）
   • 將Java代理類包含到類路徑中。

2. 建立記憶體中的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。

   • 對用於預先填入表單的所有資料項目，重複最後兩個子步驟。

3. 轉換XML資料來源

   • 通過調用javax.xml.transform.Transformer對象的靜態newInstance方法建立javax.xml.transform.Transformer對象。
   • 調用TransformerFactory物件的newTransformer方法，以建立Transformer物件。
   • 使用其建構子建立ByteArrayOutputStream對象。
   • 使用其建構子並傳遞在步驟1中建立的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方法並傳遞位元組陣列。

4. 演算預先填入的表單

   叫用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物件。

另請參閱

使用Base64編碼叫用AEM Forms