调试模板

您可以调试文档模板以解决文档生成期间发生的问题。

过程

  1. 在 Document Studio 中,打开要调试的模板。
  2. 要定义一个或多个断点,请单击切换断点 “断点”图标切换条件断点“条件”图标 工具栏按钮,或在模板编辑器中右键单击并选择调试 > 切换断点切换条件断点
    可以在数目不限的元素上设置断点。您可以设置普通断点或条件断点。条件断点与普通断点相同,但调试器仅在满足条件时停止前者。此条件不同于可对模板元素定义的任何条件,不影响模板的输出。
    注: 调试器不会在模板中任何位置未使用的查询属性的条件断点处停止。例如,如果模板正输出对象文本和对象标题,那么条件断点为对象标识,调试器不会在此点处停止。
  3. 通过单击调试文档生成 调试启动 工具栏按钮来启动调试器。 通过选择当前正处理的元素,调试器跟踪调试会话的进度。
    提示: 在“发布文档”窗口中,单击在后台运行按钮,以便此窗口不会干扰调试进程。
  4. 调试器达到具有断点的元素时停止。您可在“RPE 调试”视图中检查元素和数据上下文。 元素上下文提供了元素标识、元素类型和当前递归层次以及有关元素上的条件是否已通过的信息。数据上下文由此位置处可见的模板变量和数据元素组成。
    “RPE 调试”视图
  5. 使用以下三个选项之一恢复调试会话:
    • 下一个步骤:使调试器前进到模板中下一个元素。调试器必须在断点上停止,以使此命令生效
    • 恢复调试:恢复调试器。 调试器在下一个断点上停止,或在文档生成完成时停止。
    • 恢复正常执行:恢复执行并禁用所有断点。
  6. 要移除所有断点,请单击清除所有断点 清除断点 工具栏按钮。

反馈