添加 JavaScript 代码元素

对您在模板中使用的每个代码块使用 JavaScript 代码元素。
限制: “新功能”图标 JavaScript 代码元素只在 V2 模板中提供。

关于此任务

JavaScript 的范围从简单参数到复杂脚本。
  • 对于简单参数,可以将脚本应用于元素(例如文本元素)的内容。双击文本元素,选择脚本表达式选项卡,然后输入脚本。
  • 对于复杂脚本,可以使用此项任务来应用使用了 JavaScript 代码元素的脚本。
使用 JavaScript 代码元素而不使用元素的“脚本表达式”选项卡的优势在于:
  • 可以复用其他用户的脚本。
  • 可以将计算分组,而不用担心它们的执行顺序。
  • 可以创建常规和复杂数据结构(例如集合)并不断地向它们添加。
    注: 不能在另一个 JavaScript 代码或文本元素中调用一个 JavaScript 代码元素中定义的函数。

JavaScript 文件 utils.js 包括在安装文件及预定义的中央管理组件文件中,供您用于简单 JavaScript(例如在报告输出中包括当前日期)。

要查看模板中现有 JavaScript 代码的列表,请单击模板 > 复审 JavaScript。这时,会打开“搜索”视图并显示使用 JavaScript 的元素的列表。在此上下文中,不会将本机过滤器视为 JavaScript。搜索结果中不会列出本机过滤器。

过程

  1. 在开始使用 JavaScript 之前,请先保存您的模板。
  2. 在“选用板”视图中,选择 “JavaScript 代码”图标 JavaScript 代码元素,然后将该元素拖到模板内容编辑器。
  3. 双击 JavaScript 代码元素。
  4. 在“脚本表达式”选项卡中,从树中选择一个变量来应用 JavaScript 代码。
  5. 使用下列其中一个选项来输入 JavaScript 代码:
    • 在此窗口中手动编写脚本
    • 将编辑器外部的脚本复制并粘贴到此窗口
    • 单击包括脚本并从您的计算机、远程服务器或中央管理组件中选择一个文件
  6. 可选: 如果从 XHTML 中复制了脚本,那么可以执行下列操作:
    • 选择 XHTML 输入选项以允许编辑使用脚本中包含的 XHTML 标记。
    • 清除 XHTML 输入选项以从脚本中除去所有 XHTML 标记。
    如果复制富文本格式文本或在条件中使用富文本格式文本,那么必须选择 XHTML 输入选项。
    要点: 无效的 XHTML 将使文档生成失败。保存更改之前,请验证 XHTML 是否有效。
  7. 可选: 如果将模板生成为 XHTML 输出,那么可以执行下列操作:
    • 选择 XHTML 输出选项以解析脚本并将脚本呈现为富文本格式文本。
    • 清除 XHTML 输出选项以将脚本作为纯文本加以处理。
    此选择会应用到表达式中的所有数据源属性。不能在脚本同时使用纯文本和 XHTML。

    如果正在复制富文本格式文本或者临时创建富文本格式文本,那么必须选择 XHTML 输出选项。

  8. 输入文本之后,单击测试脚本以验证代码。 如果 JavaScript 中存在错误,那么文档生成可能无法成功完成。
  9. 单击确定以保存更改。 代码块可在元素中折叠。可以展开代码以在模板内容编辑器中查看代码。

在 JavaScript 编辑器中工作

使用 JavaScript 编辑器利用着色格式化和行号来处理您的脚本。

过程

  1. 双击 JavaScript 代码元素。JavaScript 代码元素的输入代码”窗口将打开。
  2. 可选: 如果要包括来自另一个文件的新脚本,请单击包括脚本,然后从您的计算机、远程服务器或中央管理组件中选择一个文件。 单击确定以关闭该窗口,然后双击该元素以再次打开“JavaScript 代码元素的输入代码”窗口。
  3. 单击在编辑器中打开以在 Eclipse JavaScript 编辑器中输入脚本。 这时,脚本会作为临时 .js 文件在新的编辑器选项卡中打开,您可以编辑 JavaScript。
  4. 通过“大纲”视图中的选项来管理脚本。
  5. 保存更改。
  6. 关闭临时 JavaScript 编辑器选项卡。 返回“JavaScript 代码元素的输入代码”窗口。
  7. 单击测试脚本以验证代码。
  8. 单击确定以保存更改并退出窗口。

反馈