調試HTML5表單

本檔案包含數個疑難排解案例。 對於每種情況,都提供一些步驟來排解問題。 請依照下列步驟操作,如果問題持續發生,請設定記錄器以取得並檢閱記錄檔,以取得錯誤/警告。 如需HTML5表單記錄的詳細資訊,請參閱產生HTML5表單的記錄

問題:轉譯表單時,我會看到org.apache.sling.api.SlingException頁面

在例外詳細資訊中,搜索由​引起的字

可能是因為URL中的一或多個參數不正確。

檢查下列參數:

參數 說明
範本 範本的檔案名稱
contentRoot 範本和相關資源所在的路徑
dataRef 與範本合併之資料檔案的絕對路徑。
注意:路徑定義資料檔案的絕對路徑。
資料 與範本合併的UTF-8編碼資料位元組。

問題:無法呈現表單(顯示錯誤消息)

  1. 請確定指定的參數正確無誤。 有關參數的詳細資訊,請參閱Render Parameters

  2. 登入CRX套件管理器(位於https://<server>:<port>/crx/packmgr/index.jsp),並檢查下列套件是否已正確安裝:

    • adobe-lc-forms-content-pkg-<version>.zip
    • adobe-lc-forms-runtime-pkg-<version>.zip
  3. 登入CQ Web主控台(Felix Console),網址為https://<server>:<port>/system/console/bundles。

    請確定下列套件組合的狀態為「作用中」:

    • scala-lang.bundle [osgi]

    (com.adobe.livecyclescala-lang.bundle)

    • AdobeXFA Forms轉譯器

    (com.adobe.livecycle.adobe-lc-forms-core)

    • AdobeXFA Forms LC連接器

    (com.adobe.livecycle.adobe-lc-forms-lc-connector)

問題:表單轉譯不含樣式

  1. 在瀏覽器中,開啟​開發人員工具。 確認profile.css可供使用。

  2. 如果profile.css檔案不可用,請在https://<server>:<port>/crx/de登入CRX DE。

  3. 在左側的資料夾階層中,導覽至/etc/clientlibs/fd/xfaforms/。 開啟資料夾中列出的css.txt檔案。

    • 側面像
    • 執行階段
    • 滾動導覽
    • 工具列
    • xfalib
  4. 確認css.txt內提及的檔案存在於CRX DE lite中,網址為/libs/fd/xfaforms/clientlibs/xfalib/css。

    #base=css
    application.css
    dialog.css
    datepicker.css
    scribble.css
    listboxwidget.css
    
  5. 如果提及的檔案不可用,請再次安裝adobe-lc-forms-runtime-pkg-<version>.zip套件。

問題:遇到錯誤

  1. 在表單URL中,新增查詢參數debugClientLibs並將其值設為true(例如:https://<server>:<port>/content/xfaforms/profiles/test.html?contentRoot=<some path>&template=<name of xdp file>&log=1-a9-b9-c9&debugClientLibs=true)

  2. 在案頭瀏覽器(例如chrome)中,前往開發人員工具 — >主控台。

  3. 開啟記錄檔以識別錯誤類型。 如需記錄檔的詳細資訊,請參閱HTML5表單的🔗記錄檔。

  4. 前往開發人員工具 — >主控台。 使用堆疊追蹤來找出造成錯誤的程式碼。 對錯誤進行偵錯以解決問題。

    注意

    如果指令碼失敗,請檢查表單的PDF轉譯期間是否也出現相同問題。 如果是,則表單指令碼邏輯出現問題。

問題:無法提交表單

  1. 請確定您擁有存取AEM伺服器的權限,且已連線至伺服器。
  2. 檢查參數submitUrl是否正確。
  3. 使用調試選項​1-a5-b5-c5​啟用HTML5表單🔗的日誌中提及的客戶端日誌。 然後呈現表單並按一下提交。 開啟瀏覽器偵錯主控台,並檢查是否有錯誤。
  4. HTML5表單的記錄找到伺服器記錄。 檢查提交期間伺服器記錄中是否有任何錯誤。

問題:本地化錯誤訊息未顯示

  1. 在案頭瀏覽器中使用其他查詢參數​debugClientLibs=true​轉譯表單,然後前往「開發人員工具 — >資源」並檢查檔案I18N.css。

  2. 如果檔案無法使用,請前往https://<server>:<port>/crx/de登入CRX DE。

  3. 在左側的資料夾階層中,導覽至/libs/fd/xfaforms/clientlibs/I18N,並確認下列檔案和資料夾存在:

    • Namespace.js
    • LogMessages.js
    • 語言資料夾
  4. 如果上述任何檔案或資料夾不存在,請再次安裝​adobe-lc-forms-runtime-pkg-<version>.zip​套件。

  5. 導航到與區域設定名稱同名的資料夾並檢查其內容。 資料夾必須包含下列檔案:

    • I18N.js
    • js.txt
  6. 檢查js.txt的內容,並確認其包含下列項目。

    ../Namespace.js
    I18N.js
    ../LogMessages.js
    

問題:影像未顯示

  1. 請確定影像URL正確。

  2. 檢查您的瀏覽器是否支援此類型的影像。

  3. 在例外詳細資訊中,搜索由​引起的字

    可能是因為URL中的一或多個參數不正確。

    檢查下列參數:
    步驟文字

參數 說明
範本 範本的檔案名稱
contentRoot 範本和相關資源所在的路徑
dataRef 與範本合併之資料檔案的絕對路徑。
注意:路徑定義資料檔案的絕對路徑。
資料 與範本合併的UTF-8編碼資料位元組。
  1. 在案頭瀏覽器中,前往開發人員工具 — >資源。

    如果顯示影像,請在「幀」的左側檢查。

本頁內容