充分利用 Looker 可视化图表手册：自定义提示

可视化图表提示默认会显示所选维度和测量的值，并有助于用户了解单个数据点的重要性。

例如，如果地图可视化图表基于总毛利润按州分组，那么当用户将鼠标悬停在加利福尼亚州上时，该图表的提示将会显示这两个字段的值。

用户将光标悬停在“California”上，系统会显示一个提示，其中包含“State”值“California”和“Total Gross Margin”值“$988,018.58”。

但是，如果您想在提示中添加除默认字段之外的字段，以便用户无需查看其他位置即可获取有关数据点的更多信息或背景信息，该怎么办？

您可以自定义提示，以显示多个指定字段（包括“探索”查询中不包含的字段）中的值。

成分

前提条件

若要自定义提示，您需要满足以下要求：

有关自定义提示的注意事项

在自定义提示时，请务必考虑以下事项：

  • html 参数中的值会成为可视化图表的 y 轴。
  • 您要在 y 轴上显示的值应为测量的 sql 参数中的值。
  • 使用任何格式化衡量（type: percent_of_total 衡量或包含 value_format_name 或 value_format 参数的衡量）时，请务必对呈现的值 {{ field_name._rendered_value }} 使用 Liquid 语法（其中 field_name 是衡量或维度的实际名称）。

示例

默认情况下，可视化数据点的提示将包含总毛利润和状态的值。不过，如果您想向用户提供地图上未显示或“探索”查询中未包含的其他信息，该怎么办？如果您想包含“总毛利润百分比”（而不是“状态”）字段的值，该怎么办？添加占总毛利润百分比有助于用户了解单个数据点的总毛利润值与整个数据集的总毛利润相比如何。

如需自定义提示，请按以下步骤操作：

measure: total_gross_margin {
  type: sum
  value_format_name: decimal_2
  sql: ${gross_margin} ;;
  html: {{ rendered_value }} | {{percent_of_gross_margin._rendered_value }} of total ;;
}

  1. 在开发模式下，前往要自定义的字段的 LookML 定义。

    您可以从“探索”直接前往字段的 LookML 定义。

  2. 确定除了原始字段之外，您还希望在提示中包含哪些字段和值。例如，占总毛利润的百分比。

  3. 将 html 参数添加到“探索”查询中引用并在提示中显示的原始衡量标准。在本例中，探索查询中当前使用的测量标准是总毛利润，该测量标准会显示在提示中。

  4. 在 html 参数中，使用 Liquid 变量创建一个表达式，将其他字段附加到现有衡量标准的值。

    • 此示例使用 Liquid 变量 _rendered_value 显示采用 Looker 格式的值。例如，total_gross_margin 使用 Looker 格式设置小数点后两位数，而 percent_of_total_gross_margin 使用 Looker 格式设置小数点后两位数的百分比。
    • 您可以使用竖线字符 | 来分隔不同字段的值。
    • 您还可以附加其他字词，以阐明在提示中呈现的其他值的含义。在本例中，添加了 of total 以说明百分比值的含义。

  5. 保存、验证代码，并在确认代码能否按预期运行后将其推送到生产环境。

现在，当用户将鼠标悬停在带有提示的某个数据点上时，提示将显示两个值：数据点的 total_gross_margin 值和相应的 percent_of_total_gross_margin 值。

后续步骤

使用自定义提示创建可视化图表后，您可以与他人分享：