调试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-<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)

    • AdobeXFAForms渲染器

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

    • AdobeXFAFormsLC连接器

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

问题: 无样式的表单渲染

  1. 在您的浏览器中,打开“开 发人员工具”。 确保用户档案.css可用。

  2. 如果用户档案.css文件不可用,请登录https://<server>:<port>/crx/de的CRX DE。

  3. 在左侧的文件夹层次结构中,导航到/etc/clientlibs/fd/xfaforms/。 打开文件夹中列出的css.txt文件。

    • 配置文件
    • 运行时
    • 滚动导航
    • 工具栏
    • xfalib
  4. 验证css.txt中提及的文件是否在CRX DElite中,地址为/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. 使用调试选项(1-a5- b5-c5)为HTML 5表单启 用日志中所述的客户端日志。 然后渲染表单并单击“提交”。 打开浏览器调试控制台并检查是否有错误。
  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. 在桌面浏览器中,转到“开发人员工具”->“资源”。

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

在此页面上