调试HTML5表单

本文档包括若干疑难解答情景。 对于每种情况,都提供了一些步骤来解决问题。 按照这些步骤操作,如果问题仍然存在,请配置记录器以获取并查看日志,以获取错误/警告。 有关HTML5表单日志记录的更多详细信息,请参阅为HTML5表单生成日志

问题:呈现表单时,我看到org.apache.sling.api.SlingException页面

在异常详细信息中,搜索由​引起的单词

可能的原因是URL中的一个或多个参数不正确。

检查以下参数:

参数 描述
模板 模板的文件名
contentRoot 模板和关联资源所在的路径
dataRef 与模板合并的数据文件的绝对路径。
注意:路径定义数据文件的绝对路径。
数据 与模板合并的UTF-8编码数据字节。

问题:无法呈现表单(显示错误消息)

  1. 确保指定的参数正确无误。 有关参数的详细信息,请参阅渲染参数

  2. 登录到CRX包管理器(位于https://<server>:<port>/crx/packmgr/index.jsp),然后检查以下包是否正确安装:

    • adobe-lc-forms-content-pkg-<版本>.zip
    • adobe-lc-forms-runtime-pkg-<版本>.zip
  3. 登录到CQ Web控制台(Felix控制台),网址为: 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=<xdp文件的名称>&log=1-a9-b9-c9&debugClientLibs=true)

  2. 在桌面浏览器(如chrome)中,转到开发人员工具 — >控制台。

  3. 打开日志以标识错误类型。 有关日志的详细信息,请参阅HTML5表单的日志

  4. 转到“开发人员工具” — >“控制台”。 使用堆栈跟踪来查找导致错误的代码。 调试错误以解决问题。

    注意

    如果脚本编写失败,请检查表单的PDF格式副本期间是否也出现相同的问题。 如果是,则表单脚本逻辑中出现问题。

问题:无法提交表单

  1. 确保您有权访问AEM服务器,并且已连接到服务器。
  2. 检查参数submitUrl是否正确。
  3. 启用客户端日志,如Logs forms中所述,使用调试选项作为​1-a5-b5-c5。 然后渲染表单并单击提交。 打开浏览器调试控制台并检查是否出错。
  4. 按照HTML5表单的日志中所述找到服务器日志。 检查提交期间服务器日志中是否存在任何错误。

问题:本地化错误消息不显示

  1. 在桌面浏览器中使用附加查询参数​debugClientLibs=true​渲染表单,然后转到“开发人员工具” — >“资源”并检查文件I18N.css。

  2. 如果文件不可用,请登录CRX DE,网址为https://<server>:<port>/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. 在桌面浏览器中,转到“开发人员工具” — >“资源”。

    如果显示图像,请在“帧”中检查左侧。

在此页面上