使用自訂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表單，請執行下列工作：

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

包含專案檔案

在您的開發專案中包含必要的檔案。 如果您使用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程式庫檔案

設定連線屬性

Forms服務API快速入門

呈現互動式PDF forms

將Forms呈現為HTML

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

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

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

1. 包含專案檔案

   在您的Java專案的類別路徑中包含使用者端JAR檔案，例如adobe-forms-client.jar。

2. 建立Forms Java API物件

   • 建立 ServiceClientFactory 包含連線屬性的物件。
   • 建立 FormsServiceClient 物件，使用它的建構函式並傳遞 ServiceClientFactory 物件。

3. 參考CSS檔案

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

4. 呈現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瀏覽器的表單資料流的物件。

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

   • 建立 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表單：

1. 包含專案檔案

   • 建立使用Forms服務WSDL的Java Proxy類別。
   • 在類別路徑中加入Java Proxy類別。

2. 建立Forms Java API物件

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

3. 參考CSS檔案

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

4. 呈現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瀏覽器。

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

   • 建立 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 方法。

另請參閱

使用自訂CSS檔案轉譯HTMLForms

使用Base64編碼叫用AEM Forms

Business.Adobe.com 資源

Multichannel Communication Managed Cloud Content As A Service Web Content Management Dynamic Media Headless Cms