在用戶端呈現Forms

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

在用戶端呈現Forms

您可以使用Acrobat或Adobe Reader的用戶端轉譯功能，最佳化PDF內容的傳送，並改善Forms服務處理網路負載的能力。 此程式稱為在用戶端轉譯表單。 若要在用戶端上轉譯表單，用戶端裝置（通常為網頁瀏覽器）必須使用Acrobat 7.0或Adobe Reader 7.0或更新版本。

伺服器端指令碼執行所產生的表單變更不會反映在用戶端上呈現的表單中，除非根子表單包含設為auto的restoreState屬性。 有關此屬性的詳細資訊，請參閱Forms Designer。

步驟的摘要

要在客戶端上呈現表單，請執行以下任務：

1. 包含專案檔案。
2. 建立Forms用戶端API物件。
3. 設定客戶端呈現運行時選項。
4. 在用戶端轉譯表單。
5. 將表單寫入客戶端Web瀏覽器。

包含項目檔案

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

建立Forms用戶端API物件

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

設定客戶端呈現運行時選項

您必須將RenderAtClient運行時選項設定為true，以設定客戶端呈現運行時選項以在客戶端呈現表單。 這會導致表單傳送至呈現該表單的用戶端裝置。 如果RenderAtClient為auto（預設值），則表單設計將確定表單是否在客戶端呈現。 表單設計必須是具有可流動版面的表單設計。

您可以設定的可選運行時選項是SeedPDF選項。 SeedPDF選項將PDF容器（種子PDF文檔）與表單設計和XML資料結合。 表單設計和XML資料都會傳送至Acrobat或Adobe Reader，以便轉譯表單。 當客戶端電腦中沒有使用的字型時（例如，當最終用戶未獲許可使用表單所有者授權使用的字型時），可使用SeedPDF選項。

您可以使用Designer建立簡單的動態PDF檔案，以用作種子PDF檔案。 執行此任務需要下列步驟：

1. 確定是否需要在種子PDF檔案中嵌入任何字型。 種子PDF檔案需要包含要呈現的表單所需的其他字型。 將字型嵌入種子PDF檔案時，請確保您未違反任何字型授權協定。 在Designer中，您可以確定是否可以合法嵌入字型。 保存時，如果有無法嵌入到表單中的字型，Designer將顯示一條消息，列出不能嵌入的字型。 對於靜態PDF文檔，Designer中不顯示此消息。
2. 如果要在Designer中建立種子PDF檔案，建議至少添加包含消息的文本欄位。 訊息應針對舊版Adobe Reader的使用者，指出他們需要Acrobat 7.0或更新版本或Adobe Reader 7.0或更新版本才能檢視檔案。
3. 將種子PDF檔案儲存為動態PDF檔案，副檔名為PDF。

在用戶端轉譯表單

若要在用戶端轉譯表單，您必須確保在應用程式邏輯中包含用戶端轉譯執行階段選項，才能轉譯表單。

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

Forms服務會建立您必須寫入用戶端網頁瀏覽器的表單資料流。 將表單寫入用戶端網頁瀏覽器時，表單會由Acrobat 7.0或Adobe Reader 7.0或更新版本轉譯，且使用者可看見。

另請參閱

使用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. 設定客戶端呈現運行時選項

   • 使用其建構子建立PDFFormRenderSpec物件。
   • 叫用PDFFormRenderSpec物件的setRenderAtClient方法並傳遞列舉值RenderAtClient.Yes，以設定RenderAtClient執行時間選項。

4. 在用戶端轉譯表單

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

   • 指定表單設計名稱的字串值，包括檔案名副檔名。 如果您參考屬於AEM Forms應用程式一部分的表單設計，請務必指定完整路徑，例如Applications/FormsApplication/1.0/FormsFolder/Loan.xdp。
   • com.adobe.idp.Document物件，包含要與表單合併的資料。 如果您不想合併資料，請傳遞空白的com.adobe.idp.Document物件。
   • PDFFormRenderSpec物件，儲存在用戶端轉譯表單所需的執行階段選項。
   • 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物件的read方法，並將位元組陣列傳遞為引數，借此建立位元組陣列，並填入表單資料流。
   • 調用javax.servlet.ServletOutputStream對象的write方法，將表單資料流發送到客戶端Web瀏覽器。 將位元組陣列傳遞至write方法。

另請參閱

快速入門（SOAP模式）:使用Java API在用戶端轉譯表單

包含AEM Forms Java程式庫檔案

設定連接屬性

使用Web服務API在客戶端上呈現表單

使用Forms API（網站服務）在用戶端轉譯表單：

1. 包含項目檔案

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

2. 建立Forms用戶端API物件

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

3. 設定客戶端呈現運行時選項

   • 使用其建構子建立PDFFormRenderSpec物件。
   • 調用PDFFormRenderSpec物件的setRenderAtClient方法並傳遞字串值RenderAtClient.Yes，以設定RenderAtClient執行時間選項。

4. 在用戶端轉譯表單

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

   • 指定表單設計名稱的字串值，包括檔案名副檔名。 如果您參考屬於Forms應用程式一部分的表單設計，請務必指定完整路徑，例如Applications/FormsApplication/1.0/FormsFolder/Loan.xdp。
   • BLOB物件，包含要與表單合併的資料。 如果您不想合併資料，請傳遞null。 (請參閱使用可流動配置預填Forms。)
   • PDFFormRenderSpec物件，儲存在用戶端轉譯表單所需的執行階段選項。
   • 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