依值呈現Forms

通常，在Designer中建立的表單設計會參照Forms服務而傳遞。 表單設計可能很大，因此，參照傳遞這些設計會更有效率，以避免必須依值匯整表單設計位元組。 Forms服務也可以快取表單設計，這樣在快取時，就不需要持續讀取表單設計。

如果表單設計包含UUID屬性，則會快取該屬性。 UUID值對於所有表單設計都是唯一的，可用來唯一識別表單。 依值轉譯表單時，只有在重複使用表單時，才應快取該表單。 不過，如果表單未重複使用且必須是唯一的，則可使用使用AEM Forms API設定的快取選項，來避免快取表單。

Forms服務也可以解析連結內容在表單設計中的位置。 例如，從表單設計內參照的連結影像為相對URL。 連結的內容一律視為相對於表單設計位置。 因此，通過將相對路徑應用於絕對表單設計位置來確定連結內容的位置是一個問題。

您可以按值傳遞表單設計，而不是通過參照傳遞表單設計。 動態建立表單設計時，依值傳遞表單設計會很有效率；也就是說，當客戶端應用程式生成在運行時建立表單設計的XML時。 在這種情況下，表單設計不會儲存在物理儲存庫中，因為它儲存在記憶體中。 在執行階段以動態方式建立表單設計並依值傳遞時，您可以快取表單並改善Forms服務的效能。

依值傳遞表單的限制

表單設計依值傳遞時，會套用下列限制：

• 表單設計內不能有相對連結的內容。 所有影像和片段必須內嵌在表單設計中，或絕對參照。
• 轉譯表單後，就無法執行伺服器端計算。 如果表單已提交回Forms服務，則會擷取資料並加以傳回，而不需進行任何伺服器端計算。
• 由於HTML在執行階段只能使用連結的影像，因此無法產生內嵌影像的HTML。 這是因為Forms服務從參考的表單設計擷取影像，以支援含HTML的內嵌影像。 由於依值傳遞的表單設計沒有參考的位置，因此在顯示HTML頁面時無法擷取內嵌影像。 因此，影像參考必須是要在HTML中呈現的絕對路徑。

步驟摘要

要按值呈現表單，請執行以下步驟：

1. 包含專案檔案。
2. 建立Forms用戶端API物件。
3. 參考表單設計。
4. 按值呈現表單。
5. 將表單資料流寫入客戶端Web瀏覽器。

包含項目檔案

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

建立Forms用戶端API物件

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

參考表單設計

按值呈現表單時，必須建立com.adobe.idp.Document對象，該對象包含要呈現的表單設計。 您可以參考現有的XDP檔案，或在執行階段以動態方式建立表單設計，並將該資料填入com.adobe.idp.Document。

按值呈現表單

要按值呈現表單，請將包含表單設計的com.adobe.idp.Document實例傳遞至呈現方法的inDataDoc參數（可以是FormsServiceClient對象的任何呈現方法，如renderPDFForm、(Deprecated) renderHTMLForm等）。 此參數值通常會為與表單合併的資料保留。 同樣地，將空字串值傳遞至formQuery參數。 通常，此參數需要一個字串值，該字串值指定表單設計的名稱。

將表單資料流寫入客戶端Web瀏覽器

Forms服務依值轉譯表單時，會傳回您必須寫入用戶端網頁瀏覽器的表單資料流。 寫入客戶端Web瀏覽器時，用戶可以看到該表單。

另請參閱

使用Java API依值呈現表單

使用網站服務API依值呈現表單

包含AEM Forms Java程式庫檔案

設定連接屬性

Forms服務API快速入門

將檔案傳遞至Forms服務

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

使用Java API依值呈現表單

使用Forms API(Java)依值轉譯表單：

1. 包含項目檔案

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

2. 建立Forms用戶端API物件

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

3. 參考表單設計

   • 建立java.io.FileInputStream物件，透過使用其建構函式並傳遞指定XDP檔案位置的字串值，代表要呈現的表單設計。
   • 使用其建構子並傳遞java.io.FileInputStream物件，以建立com.adobe.idp.Document物件。

4. 按值呈現表單

   調用FormsServiceClient對象的renderPDFForm方法並傳遞以下值：

   • 空字串值。 （通常，此參數需要一個字串值，該字串值指定表單設計的名稱。）
   • 包含表單設計的com.adobe.idp.Document物件。 通常，此參數值會保留給與表單合併的資料。
   • 儲存運行時選項的PDFFormRenderSpec對象。 這是可選參數，如果您不想指定運行時選項，可以指定null。
   • URLSpec物件，包含Forms服務所需的URI值。
   • 儲存檔案附件的java.util.HashMap對象。 這是可選參數，如果不想將檔案附加到表單，可以指定null。

   renderPDFForm方法返回一個FormsResult對象，該對象包含可寫入客戶端Web瀏覽器的表單資料流。

5. 將表單資料流寫入客戶端Web瀏覽器

   • 調用FormsResult對象s getOutputContent方法，建立com.adobe.idp.Document對象。
   • 調用getContentType方法，獲取com.adobe.idp.Document對象的內容類型。
   • 通過調用setContentType方法並傳遞com.adobe.idp.Document對象的內容類型來設定javax.servlet.http.HttpServletResponse對象的內容類型。
   • 通過調用javax.servlet.http.HttpServletResponse對象的getOutputStream方法，建立用於將表單資料流寫入客戶端Web瀏覽器的javax.servlet.ServletOutputStream對象。
   • 調用com.adobe.idp.Document對象的getInputStream方法，建立java.io.InputStream對象。
   • 建立位元組陣列並分配InputStream對象的大小。 調用InputStream對象的available方法以獲取InputStream對象的大小。
   • 叫用InputStream物件的read方法並將位元組陣列傳遞為引數，以表單資料流填入位元組陣列。
   • 調用javax.servlet.ServletOutputStream對象的write方法，將表單資料流發送到客戶端Web瀏覽器。 將位元組陣列傳遞至write方法。

另請參閱

依值呈現Forms

快速入門（SOAP模式）:使用Java API根據值呈現

包含AEM Forms Java程式庫檔案

設定連接屬性

使用網站服務API依值呈現表單

使用Forms API（網站服務），依值轉譯表單：

1. 包含項目檔案

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

2. 建立Forms用戶端API物件

   建立FormsService物件並設定驗證值。

3. 參考表單設計

   • 使用其建構子建立java.io.FileInputStream物件。 傳遞指定XDP檔案位置的字串值。
   • 使用其建構子建立BLOB物件。 BLOB對象用於儲存使用密碼加密的PDF文檔。
   • 建立儲存java.io.FileInputStream對象內容的位元組陣列。 您可以使用available方法獲取java.io.FileInputStream對象的大小，以確定位元組陣列的大小。
   • 叫用java.io.FileInputStream物件的read方法並傳遞位元組陣列，以資料流資料填入位元組陣列。
   • 叫用setBinaryData方法並傳遞位元組陣列，以填入BLOB物件。

4. 按值呈現表單

   調用FormsService對象的renderPDFForm方法並傳遞以下值：

   • 空字串值。 （通常，此參數需要一個字串值，該字串值指定表單設計的名稱。）
   • 包含表單設計的BLOB物件。 通常，此參數值會保留給與表單合併的資料。
   • 儲存運行時選項的PDFFormRenderSpec對象。 這是可選參數，如果您不想指定運行時選項，可以指定null。
   • 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物件。

5. 將表單資料流寫入客戶端Web瀏覽器

   • 獲取com.adobe.idp.services.holders.FormsResultHolder對象的value資料成員的值，以建立FormResult對象。
   • 調用FormsResult對象的getOutputContent方法，建立包含表單資料的BLOB對象。
   • 調用getContentType方法，獲取BLOB對象的內容類型。
   • 通過調用setContentType方法並傳遞BLOB對象的內容類型來設定javax.servlet.http.HttpServletResponse對象的內容類型。
   • 通過調用javax.servlet.http.HttpServletResponse對象的getOutputStream方法，建立用於將表單資料流寫入客戶端Web瀏覽器的javax.servlet.ServletOutputStream對象。
   • 建立位元組陣列，並調用BLOB對象的getBinaryData方法來填入。 此任務將FormsResult對象的內容分配給位元組陣列。
   • 調用javax.servlet.http.HttpServletResponse對象的write方法，將表單資料流發送到客戶端Web瀏覽器。 將位元組陣列傳遞至write方法。

另請參閱

依值呈現Forms

使用Base64編碼叫用AEM Forms