将 JavaScript 添加到报表

报表在 HTML 中运行时，将 JavaScript 添加至报表可提供您自己的用户界面。

关于本任务

在 IBM® Cognos® Analytics中，可以通过以下方式添加 JavaScript 。

  • 与 IBM Cognos Business Intelligence 发行版一样，您可以在 HTML 项对象中添加 JavaScript 。

    在 Cognos Analytics中，仅当报表以有限的交互性运行时， HTML 项中的 JavaScript 才会运行 (报表属性 以完全交互性运行 设置为 No)。

    注: 如果运行具有完全交互性的报告，请使用 HTML 项将仅静态 HTML 或静态 CSS 插入到报告输出中。
  • 您可以使用两种类型的“异步模块定义 (AMD)”模块来将 JavaScript 添加到报表中。

    使用此选项时，当报表以完全交互方式运行（报表属性以完全交互方式运行设置为是）时会运行 JavaScript。

    JavaScript 必须位于浏览器可访问的单独文件中。

您可以使用的两种 AMD 模块如下所示：

  1. 实施 CustomControl Module 界面的模块。
  2. 实施 Page Module 界面的模块。

通过在自定义控件对象中引用界面，可将 CustomControl Module 界面添加到报表中。 该引用是您在自定义控件的模块路径属性中指定的文件位置。 添加自定义控件可为您提供自己的用户界面，其中包括用于读取和设置参数的提示类控件或页面导航按钮。 可以通过设置配置属性来配置自定义控件。 它允许作者不必转至 JavaScript 代码本身即可更改参数，进行更改，加以保存，并将其上载到服务器。 一个 JavaScript 文件可以具有多个用途。

通过在报表页面或提示页面中引用界面，可添加 Page Module 界面。 该引用是您在页面的模块路径属性中指定的文件位置。 添加页面模块可设置提示控件的初始状态、设置提示控件自定义验证函数或读取提示控件的当前选择。

有关 Cognos Analytics 支持的 JavaScript 的信息，请参阅 Scriptable Reports 和 JavaScript 示例。

过程

  1. 要添加定制控件，请从工具箱 工具箱图标 中的 ADVANCED下，将 定制控件 图标 定制控件图标 拖至报告。
    1. 要向定制控件添加数据集，请选择定制控件，然后单击随需应变工具栏中的 添加数据集 图标 添加数据集图标 。 将数据项从 "源" 选项卡 “源”图标 拖到数据集中。
    2. 选择定制控件，然后单击 显示属性 图标 “显示属性”图标。
    3. 要指定包含要用于控件的 JavaScript 的文件的位置，请单击 模块路径 属性。
    4. 要添加用于配置定制控件的 JSON ，请单击 配置 属性。
      例如，添加用于设置控件的方向、对齐和背景色的 JSON。
      注: 必须编写 JavaScript 以接受这些配置元素。
    5. 要指定希望控件与报告交互的方式，请单击 UI 类型 属性。

      如果不想呈现界面，请将该属性设置为无。 如果不想将事件（如 mouseup）从控件传播到报表中，请将该属性设置为 UI（不含事件传播）。 如果要将事件传播到报表中，请将该属性设置为 UI（含事件传播）。

  2. 要添加页面模块界面，请打开报告页面或提示页面的属性表，单击 模块路径 属性，然后指定包含要使用的 JavaScript 的文件的位置。