最佳化Forms服務的效能

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

最佳化Forms服務的效能

轉譯表單時，您可以設定執行階段選項，以最佳化Forms服務的效能。 為了改善Forms服務的效能，您可以執行的另一項任務是將XDP檔案儲存在存放庫中。 不過，本節不說明如何執行此工作。 （請參閱使用Java客戶端庫調用服務。）

注意

如需Forms服務的詳細資訊，請參閱AEM Forms的服務參考。

步驟的摘要

若要在轉譯表單時最佳化Forms服務的效能，請執行下列工作：

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

包含項目檔案

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

建立Forms用戶端API物件

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

設定效能運行時選項

您可以設定下列效能執行時間選項以改善Forms服務的效能：

  • 表單快取:您可以快取在伺服器快取中呈現為PDF的表單。每個表單在首次產生後都會快取。 在後續呈現時，如果快取的表單比表單設計的時間戳記還新，則會從快取中擷取表單。 透過快取表單，可改善Forms服務的效能，因為它不需要從存放庫擷取表單設計。
  • 表單參考線（已過時）的轉換時間可能會比其他轉換類型長。 建議您快取表單參考線（已淘汰），以提高效能。
  • 獨立選項:若您不需要Forms服務執行伺服器端計算，可將「獨立」選項設為， true如此即會呈現表單，且不含狀態資訊。如果您想要將互動式表單轉譯給一般使用者，然後使用者在表單中輸入資訊，並將表單提交回Forms服務，則需要狀態資訊。 然後，Forms服務執行計算操作，並將表單呈現回使用者，並將結果顯示在表單中。 如果將沒有狀態資訊的表單提交回Forms服務，則只有XML資料可供使用，且不會執行伺服器端計算。
  • 線性化PDF:組織線性化的PDF檔案，以在網路環境中實現高效的增量訪問。PDF檔案在所有方面都是有效的PDF，並與所有現有的檢視器和其他PDF應用程式相容。 也就是說，可在下載線性化的PDF時加以檢視。
  • 在用戶端上轉譯PDF表單時，此選項無法改善效能。
  • GuideRSL選項:啟用使用執行階段共用程式庫產生表單指南（已淘汰）。這表示第一個請求將下載較小的SWF檔案，以及儲存在瀏覽器快取中的較大共用庫。 如需詳細資訊，請參閱Flex檔案中的RSL 。
  • 您也可以在用戶端上轉譯表單，以改善Forms服務的效能。 (請參閱在用戶端上呈現Forms🔗 。)

轉譯表單

若要在設定效能選項後呈現表單，請使用與呈現沒有效能選項的表單相同的應用程式邏輯。

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

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

另請參閱

包含AEM Forms Java程式庫檔案

設定連接屬性

Forms服務API快速入門

轉譯互動式PDF forms

將Forms轉譯為HTML

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

使用Java API優化效能

使用Forms API(Java)演算效能最佳的表單：

  1. 包含項目檔案

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

  2. 建立Forms用戶端API物件

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

  3. 設定效能運行時選項

    • 使用其建構子建立PDFFormRenderSpec物件。
    • 調用PDFFormRenderSpec對象的setCacheEnabled方法並傳遞true來設定表單快取選項。
    • 調用PDFFormRenderSpec對象的setLinearizedPDF方法並傳遞true.來設定線性化選項

  4. 轉譯表單

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

    • 指定表單設計名稱的字串值，包括檔案名副檔名。
    • com.adobe.idp.Document物件，包含要與表單合併的資料。 如果您不想合併資料，請傳遞空白的com.adobe.idp.Document物件。
    • PDFFormRenderSpec物件，可儲存執行時選項以改善效能。
    • URLSpec物件，包含Forms服務所需的URI值。
    • 儲存檔案附件的java.util.HashMap對象。 這是可選參數，如果不想將檔案附加到表單，可以指定null。

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

  5. 將表單資料流寫入客戶端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方法，將表單資料流發送到客戶端Web瀏覽器。 將位元組陣列傳遞至write方法。

另請參閱

快速入門（SOAP模式）:使用Java API最佳化效能

包含AEM Forms Java程式庫檔案

設定連接屬性

使用Web服務API優化效能

使用Forms API（網站服務）演算效能最佳的表單：

  1. 包含項目檔案

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

  2. 建立Forms用戶端API物件

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

  3. 設定效能運行時選項

    • 使用其建構子建立PDFFormRenderSpec物件。
    • 調用PDFFormRenderSpec對象的setCacheEnabled方法並傳遞true，設定表單快取選項。
    • 叫用PDFFormRenderSpec物件的setStandAlone方法並傳遞true，以設定獨立選項。
    • 調用PDFFormRenderSpec對象的setLinearizedPDF方法並傳遞true，設定線性化選項。

  4. 轉譯表單

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

    • 指定表單設計名稱的字串值，包括檔案名副檔名。
    • BLOB物件，包含要與表單合併的資料。 如果您不想合併資料，請傳遞null。
    • 儲存運行時選項的PDFFormRenderSpecc對象。
    • 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對象。
    • 建立javax.servlet.ServletOutputStream物件，用於將表單資料流傳送至用戶端網頁瀏覽器。
    • 調用FormsResult對象的getOutputContent方法，建立包含表單資料的BLOB對象。
    • 建立位元組陣列，並調用BLOB對象的getBinaryData方法來填入。 此任務將FormsResult對象的內容分配給位元組陣列。
    • 調用javax.servlet.http.HttpServletResponse對象的write方法，將表單資料流發送到客戶端Web瀏覽器。 將位元組陣列傳遞至write方法。

另請參閱

使用Base64編碼叫用AEM Forms

本頁內容