使用CustomToolbars呈現HTML Forms

使用自定義工具欄呈現HTML Forms

Forms服務可讓您自訂以HTML表單轉譯的工具列。 工具列可以自訂,透過覆寫預設CSS樣式來改變其外觀,並透過覆寫Java指令碼來新增動態行為。 使用名為fscmenu.xml的XML檔案自定義工具欄。 依預設,Forms服務會從內部指定的URI位置擷取此檔案。

注意

此URI位置位於adobe-forms-core.jar檔案中,該檔案位於adobe-forms-dsc.jar檔案中。 adobe-forms-dsc.jar檔案位於C:\Adobe\Adobe_Experience_Manager_forms\ folder (C:\ is the installation directory)。 您可以使用檔案擷取工具(例如Win RAR)來開啟adobe。

您可以從此位置複製fscmenu.xml,修改它以滿足您的要求,然後將它放置在自定義URI位置。 接下來,使用Forms服務API,設定執行時選項,使用指定位置的fscmenu.xml檔案產生Forms服務。 這些動作會導致Forms服務轉譯具有自訂工具列的HTML表單。

除了fscmenu.xml檔案外,您還需要獲取以下檔案:

  • fscmenu.js
  • fscattachments.js
  • fscmenu.css
  • fscmenu-v.css
  • fscmenu-ie.css
  • fscdialog.css

fscJS是與每個節點相關聯的Java指令碼。 必須為div#fscmenu節點提供一個,並為ul#fscmenuItem節點提供可選。 JS檔案實作核心工具列功能,而預設檔案可運作。

fscCSS是與特定節點相關聯的樣式表。 CSS檔案中的樣式指定工具欄外觀。 fscVCSS是垂直工具列的樣式表,會顯示在轉譯的HTML表單的左側。 fscIECSS是用於在Internet Explorer中轉譯之HTML表單的樣式表。

請確定fscmenu.xml檔案中引用了上述所有檔案。 也就是說,在fscmenu.xml檔案中,指定指向這些檔案的URI位置,以便Forms服務能夠找到它們。 預設情況下,這些檔案可在以內部關鍵字FSWebRootApplicationWebRoot開頭的URI位置中使用。

若要自訂工具列,請使用外部關鍵字FSToolBarURI取代關鍵字。 此關鍵字代表在執行時傳遞至Forms服務的URI(此方法將在本節稍後顯示)。

您也可以指定這些JS和CSS檔案的絕對位置,例如https://www.mycompany.com/scripts/misc/fscmenu.js。 在此情況下,您不需要使用FSToolBarURI關鍵字。

注意

不建議您混合參照這些檔案的方式。 也就是說,應使用FSToolBarURI關鍵字或絕對位置來引用所有URI。

您可以開啟adobe-forms-<appserver>.ear檔案,以取得JS和CSS檔案。 在此檔案中,開啟adobe-forms-res.war。 所有這些檔案都位於WAR檔案中。 adobe-forms-<appserver>.ear檔案位於AEM Forms安裝資料夾(C:\ is the installation directory)中。 您可以使用檔案擷取工具(例如WinRAR)開啟adobe-forms-<appserver>.ear。

以下XML語法顯示了fscmenu.xml檔案的示例。

 <div id="fscmenu" fscJS="FSToolBarURI/scripts/fscmenu.js" fscCSS="FSToolBarURI/fscmenu.css" fscVCSS="FSToolBarURI/fscmenu-v.css" fscIECSS="FSToolBarURI/fscmenu-ie.css"> 
         <ul class="fscmenuItem" id="Home"> 
             <li> 
                 <a href="#" fscTarget="_top" tabindex="1">Home</a> 
             </li> 
         </ul> 
         <ul class="fscmenuItem" id="Upload" fscJS="FSToolBarURI/scripts/fscattachments.js" fscCSS="FSToolBarURI/fscdialog.css"> 
             <li> 
                 <a tabindex="2">Upload Attachments</a> 
                 <ul class="fscmenuPopup" id="fscUploadAttachments"> 
                     <li> 
                         <a href="javascript:doUploadDialog();" tabindex="3">Add ...</a> 
                     </li> 
                     <li> 
                         <a href="javascript:doDeleteDialog();" tabindex="4">Delete ...</a> 
                     </li> 
                 </ul> 
             </li> 
         </ul> 
         <ul class="fscmenuItem" id="Download"> 
             <li> 
                 <a tabindex="100">Download Attachments</a> 
                 <ul class="fscmenuPopup"> 
                     <li> 
                         <a tabindex="101">None available</a> 
                     </li> 
                 </ul> 
             </li> 
         </ul> 
     </div>
注意

粗體文字代表必須參考的CSS和JS檔案的URI。

下列項目說明如何自訂工具列:

  • 更改fscJSfscCSSfscVCSSfscIECSS屬性的值(在fscmenu.xml檔案中),以使用本節中描述的方法之一(例如fscJS="FSToolBarURI/scripts/fscmenu.js")來反映引用檔案的自定義位置。
  • 必須指定所有CSS和JS檔案。 如果未修改任何檔案,請在自訂位置提供預設檔案。 您可以開啟各種檔案,如本節所述,以取得預設檔案。
  • 允許為任何檔案提供絕對參照(例如,https://www.example.com/scripts/custom-vertical-fscmenu.css)。
  • div#fscmenu節點需要的JS和CSS檔案是工具列功能的必要項。 個別ul#fscmenuItem節點可能或不具有支援的JS或CSS檔案。

變更本機值

在自定義工具欄時,可以更改工具欄的區域設定值。 也就是說,你可以用另一種語言來顯示。 下圖顯示以法文顯示的自訂工具列。

注意

無法以多種語言建立自訂工具列。 工具欄不能根據區域設定使用不同的XML檔案。

要更改工具欄的區域設定值,請確保fscmenu.xml檔案包含要顯示的語言。 以下XML語法顯示用於顯示法文工具欄的fscmenu.xml檔案。

 <div id="fscmenu" fscJS="FSToolBarURI/scripts/fscmenu.js" fscCSS="FSToolBarURI/fscmenu.css" fscVCSS="FSToolBarURI/fscmenu-v.css" fscIECSS="FSToolBarURI/fscmenu-ie.css"> 
         <ul class="fscmenuItem" id="Home"> 
             <li> 
                 <a href="#" fscTarget="_top" tabindex="1">Accueil</a> 
             </li> 
         </ul> 
         <ul class="fscmenuItem" id="Upload" fscJS="FSToolBarURI/scripts/fscattachments.js" fscCSS="FSToolBarURI/fscdialog.css"> 
             <li> 
                 <a tabindex="2">Télécharger les pièces jointes</a> 
                 <ul class="fscmenuPopup" id="fscUploadAttachments"> 
                     <li> 
                         <a href="javascript:doUploadDialog();" tabindex="3">Ajouter...</a> 
                     </li> 
                     <li> 
                         <a href="javascript:doDeleteDialog();" tabindex="4">Supprimer...</a> 
                     </li> 
                 </ul> 
             </li> 
         </ul> 
         <ul class="fscmenuItem" id="Download"> 
             <li> 
                 <a tabindex="100">Télécharger les pièces jointes</a> 
                 <ul class="fscmenuPopup"> 
                     <li> 
                         <a tabindex="101">Aucune disponible</a> 
                     </li> 
                 </ul> 
             </li> 
         </ul> 
     </div>
注意

與此部分關聯的快速入門使用此XML檔案顯示法文自定義工具欄,如上圖所示。

另外,通過調用HTMLRenderSpec對象的setLocale方法並傳遞指定區域設定值的字串值來指定有效的區域設定值。 例如,傳遞fr_FR以指定法文。 Forms服務與本地化工具列搭配。

注意

呈現使用自訂工具列的HTML表單之前,您必須知道HTML表單的呈現方式。 (請參閱將Forms呈現為HTML。)

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

步驟的摘要

要呈現包含自定義工具欄的HTML表單,請執行以下任務:

  1. 包含專案檔案。
  2. 建立Forms Java API物件。
  3. 參考自定義fscmenu XML檔案。
  4. 轉譯HTML表單。
  5. 將表單資料流寫入客戶端Web瀏覽器。

包含項目檔案

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

建立Forms Java API物件

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

參考自定義fscmenu XML檔案

要呈現包含自定義工具欄的HTML表單,請參考描述該工具欄的fscmenu XML檔案。 (本節提供fscmenu XML檔案的兩個示例。) 另外,請確保fscmenu.xml檔案正確指定所有引用檔案的位置。 如本節前面所述,請確定所有檔案均被FSToolBarURI關鍵字或其絕對位置引用。

轉譯HTML表單

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

呈現HTML表單還需要URI值等值,才能呈現其他表單類型。

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

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

另請參閱

使用Java API使用自訂工具列呈現HTML表單

使用網站服務API呈現具有自訂工具列的HTML表單

包含AEM Forms Java程式庫檔案

設定連接屬性

Forms服務API快速入門

轉譯互動式PDF forms

將Forms轉譯為HTML

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

使用Java API使用自訂工具列呈現HTML表單

使用Forms服務API(Java)轉譯包含自訂工具列的HTML表單:

  1. 包含項目檔案

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

  2. 建立Forms Java API物件

    • 建立包含連接屬性的ServiceClientFactory對象。
    • 使用其建構子並傳遞ServiceClientFactory物件,以建立FormsServiceClient物件。
  3. 參考自定義fscmenu XML檔案

    • 使用其建構子建立HTMLRenderSpec物件。
    • 若要使用工具列呈現HTML表單,請叫用HTMLRenderSpec物件的setHTMLToolbar方法,並傳遞HTMLToolbar列舉值。 例如,要顯示垂直HTML工具欄,請傳遞HTMLToolbar.Vertical
    • 通過調用HTMLRenderSpec對象的setToolbarURI方法並傳遞指定XML檔案的URI位置的字串值,指定fscmenu XML檔案的位置。
    • 如果適用,請通過調用HTMLRenderSpec對象的setLocale方法並傳遞指定區域設定值的字串值來設定區域設定值。 預設值為英文。
    注意

    與此部分關聯的快速入門將此值設定為​fr_FR

  4. 轉譯HTML表單

    調用FormsServiceClient對象的renderHTMLForm方法並傳遞以下值:

    • 指定表單設計名稱的字串值,包括檔案名副檔名。 如果您參考屬於Forms應用程式一部分的表單設計,請務必指定完整路徑,例如Applications/FormsApplication/1.0/FormsFolder/Loan.xdp
    • 指定HTML首選項類型的TransformTo枚舉值。 例如,要呈現與Internet Explorer 5.0或更高版本的動態HTML相容的HTML表單,請指定TransformTo.MSDHTML
    • com.adobe.idp.Document物件,包含要與表單合併的資料。 如果您不想合併資料,請傳遞空白的com.adobe.idp.Document物件。
    • 儲存HTML運行時選項的HTMLRenderSpec對象。
    • 指定HTTP_USER_AGENT標題值(如Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1; SV1; .NET CLR 1.1.4322))的字串值。
    • URLSpec物件,用於儲存呈現HTML表單所需的URI值。
    • 儲存檔案附件的java.util.HashMap對象。 這是可選參數,如果不想將檔案附加到表單,可以指定null

    renderHTMLForm方法返回一個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使用自訂工具列轉譯HTML表單

包含AEM Forms Java程式庫檔案

設定連接屬性

使用網站服務API呈現具有自訂工具列的HTML表單

使用Forms服務API(網站服務)轉譯包含自訂工具列的HTML表單:

  1. 包含項目檔案

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

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

  3. 參考自定義fscmenu XML檔案

    • 使用其建構子建立HTMLRenderSpec物件。
    • 若要使用工具列呈現HTML表單,請叫用HTMLRenderSpec物件的setHTMLToolbar方法,並傳遞HTMLToolbar列舉值。 例如,要顯示垂直HTML工具欄,請傳遞HTMLToolbar.Vertical
    • 通過調用HTMLRenderSpec對象的setToolbarURI方法並傳遞指定XML檔案的URI位置的字串值,指定fscmenu XML檔案的位置。
    • 如果適用,請通過調用HTMLRenderSpec對象的setLocale方法並傳遞指定區域設定值的字串值來設定區域設定值。 預設值為英文。
    注意

    與此部分關聯的快速入門將此值設定為​fr_FR

  4. 轉譯HTML表單

    調用FormsService對象的renderHTMLForm方法並傳遞以下值:

    • 指定表單設計名稱的字串值,包括檔案名副檔名。 如果您參考屬於Forms應用程式一部分的表單設計,請務必指定完整路徑,例如Applications/FormsApplication/1.0/FormsFolder/Loan.xdp
    • 指定HTML首選項類型的TransformTo枚舉值。 例如,要呈現與Internet Explorer 5.0或更高版本的動態HTML相容的HTML表單,請指定TransformTo.MSDHTML
    • BLOB物件,包含要與表單合併的資料。 如果您不想合併資料,請傳遞null
    • 儲存HTML運行時選項的HTMLRenderSpec對象。
    • 指定HTTP_USER_AGENT標題值(如Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1; SV1; .NET CLR 1.1.4322)的字串值。 如果您不想設定此值,可以傳遞空白字串。
    • URLSpec物件,用於儲存呈現HTML表單所需的URI值。
    • 儲存檔案附件的java.util.HashMap對象。 此參數為可選參數,如果不想將檔案附加到表單,則可以指定null
    • renderHTMLForm方法填入的空com.adobe.idp.services.holders.BLOBHolder物件。 此參數值儲存呈現的表單。
    • renderHTMLForm方法填入的空com.adobe.idp.services.holders.BLOBHolder物件。 此參數儲存輸出XML資料。
    • renderHTMLForm方法填入的空javax.xml.rpc.holders.LongHolder物件。 此引數會儲存表單中的頁數。
    • renderHTMLForm方法填入的空javax.xml.rpc.holders.StringHolder物件。 此參數儲存地區設定值。
    • renderHTMLForm方法填入的空javax.xml.rpc.holders.StringHolder物件。 此引數會儲存所使用的HTML呈現值。
    • 將包含此操作結果的空com.adobe.idp.services.holders.FormsResultHolder對象。

    renderHTMLForm方法會以必須寫入用戶端網頁瀏覽器的表單資料流填入作為最後一個引數值傳遞的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方法。

另請參閱

使用Base64編碼叫用AEM Forms

本頁內容