使用自訂CSS檔案轉譯HTMLForms

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

Forms服務會根據來自網頁瀏覽器的HTTP請求轉譯HTML表單。呈現HTML表單時，Forms服務可參考自訂CSS檔案。您可以建立自訂CSS檔案以符合您的業務需求，並在使用Forms服務轉譯HTML表單時參考該CSS檔案。

Forms服務會以無訊息方式剖析自訂CSS檔案。也就是說，Forms服務不會報告在自訂CSS檔案不符合CSS標準時可能遇到的錯誤。在此情況下，Forms服務會忽略樣式，繼續處理CSS檔案中的其餘樣式。

下列清單指定自訂CSS檔案支援的樣式：

類別層級選擇器樣式配對：如果存在於自訂CSS檔案中，則會使用用於HTML表單中作為類別樣式的選取器。未使用的類別樣式會被忽略。
識別碼層級選擇器樣式配對：所有識別碼樣式都會在HTML表單中使用。
元素層級選擇器樣式配對：所有元素樣式都會在HTML表單中使用。
樣式優先順序：支援樣式優先順序（如重要），並可用於自訂CSS檔案。
媒體型別：您可以用樣式包住一個或多個選擇器樣式配對@media定義媒體型別。 Forms服務不會檢查指定的媒體型別是否受支援。自訂CSS檔案中指定的媒體型別會在HTML表單中合併。

您可以使用FormsIVS應用程式擷取範例CSS檔案。上傳表單，在「測試表單設計」頁面中選取表單，然後按一下「產生CSS」。按一下按鈕之前，您不需要設定HTML轉換型別。接著選取「儲存」。您可以編輯此CSS檔案以符合您的業務需求。

注意

在轉譯使用自訂CSS檔案的HTML表單之前，請務必充分瞭解如何轉譯HTML表單。 (請參閱將Forms呈現為HTML.)

注意

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

步驟摘要

若要呈現使用CSS檔案的HTML表單，請執行下列工作：

包含專案檔案。
建立Forms Java API物件。
參考CSS檔案。
呈現HTML表單。
將表單資料流寫入使用者端網頁瀏覽器。

包含專案檔案

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

建立Forms Java API物件

您必須先建立Forms使用者端物件，才能以程式設計方式執行Forms服務支援的操作。

參考CSS檔案

若要呈現使用自訂CSS檔案的HTML表單，請確定您參考現有的CSS檔案。

呈現HTML表單

若要呈現HTML表單，您必須指定在Designer中建立並儲存為XDP檔案的表單設計。您也必須選取HTML轉換型別。例如，您可以指定轉譯Internet Explorer 5.0或更新版本之動態HTML的HTML轉換型別。

呈現HTML表單也需要值，例如呈現其他表單型別所需的URI值。

將表單資料流寫入使用者端網頁瀏覽器

Forms服務轉譯HTML表單時，會傳回您必須寫入使用者端網頁瀏覽器的表單資料流，才能讓使用者看到HTML表單。

另請參閱

使用Java API呈現使用CSS檔案的HTML表單

包含AEM Forms Java程式庫檔案

使用Java API呈現使用CSS檔案的HTML表單

使用Forms API (Java)呈現使用自訂CSS檔案的HTML表單：

包含專案檔案

在您的Java專案的類別路徑中包含使用者端JAR檔案，例如adobe-forms-client.jar。
建立Forms Java API物件
- 建立 ServiceClientFactory 包含連線屬性的物件。
- 建立 FormsServiceClient 物件，使用它的建構函式並傳遞 ServiceClientFactory 物件。
參考CSS檔案
- 建立 HTMLRenderSpec 物件（使用其建構函式）。
- 若要呈現使用自訂CSS檔案的HTML表單，請叫用 HTMLRenderSpec 物件的 setCustomCSSURI 方法，並傳遞字串值，以指定CSS檔案的位置和名稱。
呈現HTML表單

叫用 FormsServiceClient 物件的 (Deprecated) (Deprecated) renderHTMLForm 方法並傳遞下列值：
- 字串值，指定表單設計名稱，包括副檔名。如果您參照的表單設計屬於Forms應用程式的一部分，請務必指定完整路徑，例如 Applications/FormsApplication/1.0/FormsFolder/Loan.xdp.
- A TransformTo 指定HTML偏好設定型別的列舉值。例如，若要呈現與Internet Explorer 5.0或更新版本的動態HTML相容的HTML表單，請指定 TransformTo.MSDHTML.
- A com.adobe.idp.Document 包含要與表單合併之資料的物件。如果您不想合併資料，請傳遞空白 com.adobe.idp.Document 物件。
- 此 HTMLRenderSpec 儲存HTML執行階段選項的物件。
- 字串值，指定 HTTP_USER_AGENT 標頭值，例如 Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1; SV1; .NET CLR 1.1.4322).
- A URLSpec 儲存轉譯HTML表單所需的URI值的物件。
- A java.util.HashMap 儲存檔案附件的物件。此為選用引數，您可以指定 null 如果您不想將檔案附加至表單。
此 (Deprecated) renderHTMLForm 方法傳回 FormsResult 包含必須寫入使用者端Web瀏覽器的表單資料流的物件。
將表單資料流寫入使用者端網頁瀏覽器
- 建立 com.adobe.idp.Document 物件(透過叫用 FormsResult 物件 getOutputContent 方法。
- 取得的內容型別 com.adobe.idp.Document 物件(透過叫用其 getContentType 方法。
- 設定 javax.servlet.http.HttpServletResponse 物件的內容型別，透過叫用其 setContentType 方法和傳遞的內容型別 com.adobe.idp.Document 物件。
- 建立 javax.servlet.ServletOutputStream 用來將表單資料流寫入使用者端網頁瀏覽器的物件，方法是叫用 javax.servlet.h\ttp.HttpServletResponse 物件的 getOutputStream 方法。
- 建立 java.io.InputStream 物件(透過叫用 com.adobe.idp.Document 物件的 getInputStream 方法。
- 建立位元組陣列，並叫用 InputStream 物件的 read 方法，並將位元組陣列作為引數傳遞。
- 叫用 javax.servlet.ServletOutputStream 物件的 write 將表單資料流傳送至使用者端Web瀏覽器的方法。將位元組陣列傳遞至 write 方法。

另請參閱

使用自訂CSS檔案轉譯HTMLForms

快速入門（SOAP模式）：使用Java API呈現使用CSS檔案的HTML表單

包含AEM Forms Java程式庫檔案

設定連線屬性

使用Web服務API呈現使用CSS檔案的HTML表單

使用Forms API （Web服務）呈現使用自訂CSS檔案的HTML表單：

包含專案檔案
- 建立使用Forms服務WSDL的Java Proxy類別。
- 在類別路徑中加入Java Proxy類別。
建立Forms Java API物件

建立 FormsService 物件並設定驗證值。
參考CSS檔案
- 建立 HTMLRenderSpec 物件（使用其建構函式）。
- 若要呈現使用自訂CSS檔案的HTML表單，請叫用 HTMLRenderSpec 物件的 setCustomCSSURI 方法，並傳遞字串值，以指定CSS檔案的位置和名稱。
呈現HTML表單

叫用 FormsService 物件的 (Deprecated) renderHTMLForm 方法並傳遞下列值：
- 字串值，指定表單設計名稱，包括副檔名。如果您參照的表單設計屬於Forms應用程式的一部分，請務必指定完整路徑，例如 Applications/FormsApplication/1.0/FormsFolder/Loan.xdp.
- A TransformTo 指定HTML偏好設定型別的列舉值。例如，若要呈現與Internet Explorer 5.0或更新版本的動態HTML相容的HTML表單，請指定 TransformTo.MSDHTML.
- A BLOB 包含要與表單合併之資料的物件。如果您不想合併資料，請傳遞 null. (請參閱使用可流動版面預先填入Forms.)
- 此 HTMLRenderSpec 儲存HTML執行階段選項的物件。
- 字串值，指定 HTTP_USER_AGENT 標頭值，例如 Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1; SV1; .NET CLR 1.1.4322). 如果您不想設定此值，可以傳遞空字串。
- A URLSpec 儲存轉譯HTML表單所需的URI值的物件。
- A java.util.HashMap 儲存檔案附件的物件。此為選用引數，您可以指定 null 如果您不想將檔案附加至表單。
- 空白 com.adobe.idp.services.holders.BLOBHolder 由填入的物件 (Deprecated) renderHTMLForm 方法。此引數值會儲存演算後的表單。
- 空白 com.adobe.idp.services.holders.BLOBHolder 由填入的物件 (Deprecated) renderHTMLForm 方法。此引數會儲存輸出XML資料。
- 空白 javax.xml.rpc.holders.LongHolder 由填入的物件 (Deprecated) renderHTMLForm 方法。此引數會儲存表單中的頁數。
- 空白 javax.xml.rpc.holders.StringHolder 由填入的物件 (Deprecated) renderHTMLForm 方法。此引數會儲存地區設定值。
- 空白 javax.xml.rpc.holders.StringHolder 由填入的物件 (Deprecated) renderHTMLForm 方法。此引數會儲存所使用的HTML演算值。
- 空白 com.adobe.idp.services.holders.FormsResultHolder 將包含此作業結果的物件。
此 (Deprecated) renderHTMLForm 方法填入 com.adobe.idp.services.holders.FormsResultHolder 以表單資料流傳遞作為最後一個引數值的物件，必須寫入使用者端Web瀏覽器。
將表單資料流寫入使用者端網頁瀏覽器
- 建立 FormResult 物件，方法是取得 com.adobe.idp.services.holders.FormsResultHolder 物件的 value 資料成員。
- 建立 BLOB 包含表單資料的物件(透過叫用 FormsResult 物件的 getOutputContent 方法。
- 取得的內容型別 BLOB 物件(透過叫用其 getContentType 方法。
- 設定 javax.servlet.http.HttpServletResponse 物件的內容型別，透過叫用其 setContentType 方法和傳遞的內容型別 BLOB 物件。
- 建立 javax.servlet.ServletOutputStream 用來將表單資料流寫入使用者端網頁瀏覽器的物件，方法是叫用 javax.servlet.http.HttpServletResponse 物件的 getOutputStream 方法。
- 建立位元組陣列，並透過叫用 BLOB 物件的 getBinaryData 方法。此任務指派 FormsResult 物件至位元組陣列。
- 叫用 javax.servlet.http.HttpServletResponse 物件的 write 將表單資料流傳送至使用者端Web瀏覽器的方法。將位元組陣列傳遞至 write 方法。