使用自訂CSS檔案呈現HTMLForms

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

Forms服務會以靜默方式解析自訂CSS檔案。 也就是說，如果自訂CSS檔案不符合CSS標準，Forms服務不會報告可能遇到的錯誤。 在此情況下，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. 將表單資料流寫入客戶端Web瀏覽器。

包含項目檔案

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

建立Forms Java API物件

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

參考CSS檔案

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

轉譯HTML表單

要呈現HTML表單，必須指定在「設計器」中建立並另存為XDP檔案的表單設計。 您也必須選取HTML轉換類型。 例如，您可以指定HTML轉換類型，用於為Internet Explorer 5.0或更新版本轉譯動態HTML。

呈現HTML表單還需要值，如呈現其他表單類型所需的URI值。

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

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. 將表單資料流寫入客戶端Web瀏覽器

   • 建立 com.adobe.idp.Document 對象，方法是調用 FormsResult 物件s 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 將表單資料流傳送至用戶端網頁瀏覽器的方法。 將位元組陣列傳遞至 write 方法。

另請參閱

使用自訂CSS檔案呈現HTMLForms

快速入門（SOAP模式）:使用Java API轉譯使用CSS檔案的HTML表單

包含AEM Forms Java程式庫檔案

設定連接屬性

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

使用Forms API（網站服務）演算使用自訂CSS檔案的HTML表單：

1. 包含項目檔案

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

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 作為最後一個引數值傳遞的物件，具有必須寫入用戶端網頁瀏覽器的表單資料流。

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

另請參閱

使用自訂CSS檔案呈現HTMLForms

使用Base64編碼叫用AEM Forms