默认情况下,可视化图表提示会显示所选维度和测量的值,可以帮助用户了解单个数据点的重要性。
例如,如果用户将鼠标悬停在加利福尼亚州上,根据总毛利润分组(按州分组)的地图可视化提示会显示这两个字段的值。
但是,如果您想在提示中添加默认值以外的字段,以便用户无需查看其他位置即可获取有关数据点的更多信息或上下文,该怎么办?
您可以自定义提示,以显示多个指定字段的值,包括“探索”查询中未包含的字段。
所需要素
- 流体变量 - 流动变量会将其他字段的值结合现有的“探索”查询呈现。
html
参数 - 当用户将鼠标悬停在可视化图表上时,测量的html
参数中定义的字段将呈现在提示中。- 可视化图表 - 在使用某些可视化类型时,当用户将光标悬停在数据点上时,系统会显示提示。
前提条件
自定义提示需要满足以下要求:
- 拥有创建探索的权限,以及开发 LookML 的权限。
- 了解 SQL 和 LookML 开发。
- 了解有关在 Looker 中使用 Liquid 以及 HTML 编码的基础知识。如需了解必要的背景信息,请访问
html
文档页面的 使用html
参数中的 Liquid 变量部分。 - 保存内容的权限(如果您要将可视化图表保存为 Look 或信息中心)
自定义提示的注意事项
自定义提示时,请务必注意以下事项:
html
参数中的值将成为可视化图表的 y 轴。- 您希望在 y 轴上显示的值应该是测量的
sql
参数中的值。 - 使用任何设置了格式的测量(
type: percent_of_total
的测量或带有value_format_name
或value_format
参数的测量)时,请务必对呈现的值{{ field_name._rendered_value }}
(其中field_name
是测量或维度的实际名称)使用 Liquid 语法。
示例
默认情况下,可视化图表数据点的提示将包含总毛利润和状态的值。但是,如果您想向用户提供没有在地图上显示或包含在“探索”查询中的其他信息,该怎么办?如果您想添加一个名为总毛利润的百分比(而不是州)字段的值,该怎么办?添加总毛利润百分比可帮助用户了解单个数据点的总毛利润值与整个数据集中的总毛利润率的对比情况。
如需自定义提示,请按以下步骤操作:
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 ;;
}
在开发模式中,找到要自定义的字段的 LookML 定义。
您可以从“探索”直接导航到某个字段的 LookML 定义。
确定除了原始字段之外,您还想在提示中添加的字段和值。例如,占总利润率的百分比。
将
html
参数添加到“探索”查询中引用并显示在提示中的原始测量。在这种情况下,目前位于“探索”查询中并在提示中显示的衡量指标是总毛利润。在
html
参数中,创建一个包含 Liquid 变量的表达式,将其他字段附加到现有测量的值。- 此示例使用 Liquid 变量
_rendered_value
显示 Looker 格式的值。例如,total_gross_margin
使用 Looker 格式表示两位小数,percent_of_total_gross_margin
使用 Looker 格式表示百分比两位小数。 - 您可以使用竖线字符
|
来分隔不同字段的值。 - 您还可附加其他字词,以阐明提示中显示的其他值的含义。在本例中,添加了
of total
来阐明百分比值的含义。
- 此示例使用 Liquid 变量
保存和验证代码,并在验证代码可按预期运行后将其推送到生产环境。
现在,当用户将鼠标悬停在某个数据点上时,提示会显示两个值:数据点的 total_gross_margin
值和相应的 percent_of_total_gross_margin
值。
后续步骤
使用自定义提示创建可视化图表后,您可以将其与他人共享: