瀑布图代码示样

瀑布图可视化显示初始值如何通过一系列中间值增加和减少，从而生成最右侧柱形中显示的最终累积值。

关于本任务

有关 IBM Accelerator Catalog上的瀑布图自定义可视化代码样本的更多信息，请参阅 瀑布图。

注: 此代码样本适用于高级定制可视化开发者。 它为开发人员提供了扩展可视化的机会。 如果您不是可视化开发者，那么 IBM® Cognos® Analytics with Watson 会随附一组可供使用的功能强大的可视化。

从 IBM Cognos Analytics with Watson 11.1.6 起支持瀑布图可视化

此自定义可视化代码示样提供了在瀑布图可视化中显示非常具体的数据的一种方法（请参阅 waterfall_sample_data.xlslx）。

一些瀑布图可视化的示例如下所示：
  • 添加企业在一个季度内收入和成本的增加和减少量后，查看净收入。
  • 一年中产品的累计销售额，包括年度总计。
Value Type 字段必须使用包含以下特定值的列：
  • TOTAL（灰色）：在某一点上的总值
  • ADJUSTMENT（黄色）：可能不适合归类为 DELTA 的可选手动调整
  • DELTA（绿色或红色）：值的正或负变化

有一些代码示样可供自定义可视化的开发人员使用。 这些代码示样说明了 customvis 库和工具的某些方面。 每个示样的主要重点不是可视化的完整性，而是展示特定功能的运作方式。

要查看瀑布图可视化样本的源代码和打包捆绑软件 (.zip 文件) ，请转至此公共 GitHub 存储库。 要下载文件，请浏览至此目录的根目录，然后单击克隆或下载。

有关更多信息，请参阅 定制可视化代码样本。

有关定制可视化的更多信息，请参阅 开发定制可视化。 有关入门的绝佳教程，请参阅 自定义可视化-教程。

有三种方法可使用此示样自定义可视化。
  • 可以上载压缩捆绑包（.zip 文件）。

    有关更多信息，请参阅打包定制可视化。

  • 您可以使用 customvis pack 对样本进行打包，并将捆绑软件 (zip 文件) 上载到 IBM Cognos Analytics with Watson

    有关更多信息，请参阅打包定制可视化。

  • 可以通过在包含示样的文件夹内运行 customvis start，以在本地运行任何示样。 之后，您可以使用 IBM Cognos Analytics with Watson "仪表板" 或 "报告" 中的 预览版本 在仪表板或报告中插入自定义可视化。

    有关更多信息，请参阅 在自定义可视化中使用 D3 样本。

以下步骤展示了如何使用瀑布图可视化并向其中填充数据。

过程

  1. 创建仪表板，然后单击工具栏中的 可视化 更改可视化图标 图标。
  2. 单击 定制 选项卡。
    如果没有可用的定制可视项，那么可以通过单击 定制 选项卡上的 添加定制可视项 添加自定义可视项 图标来添加定制可视项。
  3. 从 " 定制可视化 " 窗格中，选择瀑布图可视化。
  4. 上载 Waterfall_sample_data.xlsx (https://public.dhe.ibm.com/software/data/sw-library/cognos/mobile/C11/custom_visualizations/data/Waterfall_sample_data.xlsx) 并将其用作数据源。
  5. 通过从 " 源 " 窗格中的 Waterfall_sample_data.xlsx 拖动以下数据项来创建瀑布图可视化 "数据"图标:
    • 将 Month 拖到 Categories 字段上。
    • 将 Type 拖到 Value type 字段上。
    • 将 Police Holders 拖到 Value 字段上。

    此瀑布图可视化示样显示了一家虚构保险公司的数据。 它显示了 2019 年各月投保人总数的变化。

    瀑布图

后续步骤

此可视化中可调整的特定属性的说明：

属性 用途
基数比率 基数与图表高度的比率。 基数位于“总计”列下。 如果要调整条形总高度，请使用此属性。
显示更改 切换以查看桥的更改。
总行数 要将行分类为总计行类别，数据中的行值必须与在此属性中指定的类型类字符串匹配。
调整行 要将行分类为调整行类别，数据中的行值必须与在此属性中指定的类型类字符串匹配。
增量行 要将行分类为增量行类别，数据中的行值必须与在此属性中指定的类型类字符串匹配。