LookML 信息中心参数

您可以通过以下两种方式之一创建信息中心。用户定义的信息中心是使用 Looker 界面创建的，相关说明请参阅创建用户定义的信息中心文档页面。您还可以使用 LookML 创建信息中心，并修改其总体设置，如本页所述。

本页介绍了会影响整个信息中心的 LookML 信息中心参数。

LookML 信息中心还包含元素，即信息中心上的数据可视化图表、文本图块和按钮。如需查看指向每种元素类型的参考页面的链接，请参阅信息中心元素参数页面。

用法示例

- dashboard: dashboard_name
  preferred_viewer: dashboards | dashboards-next
  title: "chosen dashboard title"
  description: "chosen dashboard description"
  enable_viz_full_screen: true | false
  extends: name_of_dashboard_being_extended
  extension: required
  layout: tile | static | grid | newspaper
  rows:
    - elements: [element_name, element_name, ...]
      height: N
  tile_size: N
  width: N
  refresh: N (seconds | minutes | hours | days)
  auto_run: true | false

  # DASHBOARD FILTER PARAMETERS
  crossfilter_enabled: true | false
  filters_bar_collapsed: true | false
  filters_location_top: true | false
  filters:
  - name: filter_name
    title: "chosen filter title"
    type: field_filter | number_filter | date_filter | string_filter
    model: model_name
    explore: explore_name
    field: view_name.field_name
    default_value: Looker filter expression
    allow_multiple_values: true | false
    required: true | false
    ui_config:
      type: button_group | checkboxes | range_slider | tag_list | radio_buttons |
            button_toggles | dropdown_menu | slider | day_picker | day_range_picker |
            relative_timeframes | advanced
      display: inline | popover | overflow
      options:
        min: N
        max: N
      - value options
    listens_to_filters:
    - filter_name
      field: view_name.field_name

  # EMBEDDED DASHBOARD PARAMETERS
  embed_style:
    background_color: "css_color"
    show_title: true | false
    title_color: "css_color"
    show_filters_bar: true | false
    tile_background_color: "css_color"
    tile_text_color: "css_color"

  # ELEMENTS PARAMETERS
  elements:
  # One or more element declarations

参数定义

参数名称 说明
dashboard 创建信息中心。
preferred_viewer 此参数会被忽略。
title（适用于信息中心） 更改信息中心名称向用户的显示方式。
description（适用于信息中心） 添加可在信息中心详情面板或设为列表视图的文件夹中查看的说明。
enable_viz_full_screen 定义信息中心查看者是否可以以全屏和展开视图查看信息中心图块。
extends 基于另一个 LookML 信息中心创建 LookML 信息中心。
extension 要求信息中心由另一个信息中心进行扩展。
layout 定义信息中心放置元素的方式。
rows 开始 LookML 部分，以定义应放入 layout: grid 信息中心每行中的元素。
elements（针对行） 定义应放入 layout: grid 信息中心行中的元素。
height（针对行） 定义 layout: grid 信息中心一行的高度。
tile_size 定义 layout: tile 信息中心的图块大小。
width（适用于信息中心） 为 layout: static 信息中心定义信息中心的宽度。
refresh（适用于信息中心） 设置信息中心元素自动刷新的时间间隔。
auto_run 确定信息中心在首次打开或重新加载时是否自动运行。
过滤参数
crossfilter_enabled 为信息中心启用或停用交叉过滤。
filters_bar_collapsed 添加于 21.16 为信息中心设置信息中心过滤栏的默认折叠或展开状态。
filters_location_top 添加于 22.8 为信息中心设置信息中心过滤条件栏位置（顶部或右侧）。
filters（适用于信息中心） 开始 LookML 部分，以定义信息中心过滤条件。
name（用于过滤条件） 创建过滤器。
title（用于过滤条件） 更改过滤条件名称向用户的显示方式。
type（用于过滤条件） 确定要使用的过滤条件类型。
default_value 为过滤条件设置默认值。
allow_multiple_values 限制用户只能使用一个过滤条件值。
required 要求用户输入过滤条件值才能运行信息中心。
ui_config 配置用户查看 LookML 信息中心时可用的过滤条件控件。具有子参数 type、display 和 options。
model（用于过滤条件） 指定包含 type: field_filter 过滤器的底层字段的模型。
explore（用于过滤条件） 指定包含 type: field_filter 过滤条件的底层字段的 Explore。
field 指定 type: field_filter 过滤器的底层字段。
listens_to_filters 根据用户为 type: field_filter 的其他信息中心过滤条件输入的内容，缩小 field_filter 的信息中心过滤条件的建议范围。
嵌入式信息中心参数
embed_style 开始 LookML 部分，以定义嵌入式信息中心自定义设置。
background_color 设置嵌入式信息中心的背景颜色。
show_title 指定嵌入式信息中心是否显示信息中心标题。
title_color 设置嵌入式信息中心的标题颜色。
show_filters_bar 指定过滤条件栏是否在嵌入式信息中心内显示。
tile_background_color 设置嵌入式信息中心的平铺背景颜色。
tile_text_color 设置嵌入式信息中心的图块文字颜色。
元素参数
elements（适用于信息中心） 开始 LookML 部分，以定义信息中心元素。

dashboard

dashboard 参数用于声明新的信息中心并指定信息中心的名称。字符数上限为 255；允许使用的字符包括字母 (A-Z)、数字 (0-9)、短划线 (-) 和下划线 (_)。通常，最佳实践是将每个 LookML 信息中心都放在自己的 LookML 文件中，但也可以在单个文件中声明多个信息中心。

- dashboard: sales_overview

如需显示任何内容，信息中心至少需要使用 elements 参数添加一个元素。

preferred_viewer

在 Looker 23.6 中弃用旧版信息中心之前，您可以使用 preferred_viewer 参数选择以 Looker 的默认信息中心体验或旧版信息中心格式查看和下载信息中心。

title （适用于信息中心）

本部分指的是属于信息中心的 title 参数。

title 还可以用作信息中心过滤条件的一部分，如本页的 title（用于过滤条件）部分中所述。

title 还可以用作任何信息中心元素的一部分。有关其用法的代表性示例，请参阅柱状图元素文档页面。

借助 title 参数，您可以更改信息中心名称在文件夹中以及信息中心顶部向用户显示的方式。如果未指定，则标题默认为信息中心的名称。标题文字可以进行本地化。

请参考下面的示例：

- dashboard: sales_overview
  title: "1) Sales Overview"

如果您执行了此操作，信息中心将显示为 1) 销售概览，而不是销售概览。

description （适用于信息中心）

本部分指的是属于信息中心的 description 参数。

description 也可以用作探索的一部分，如 description（适用于探索）参数文档页面中所述。

description 也可以用作字段的一部分，如 description（适用于字段）参数文档页面中所述。

借助 description 参数，您可以向 LookML 信息中心添加说明。

description 参数的内容将显示在 LookML 信息中心的信息中心详情面板的说明字段中。

当在设为列表视图的文件夹中查看时，说明会显示在信息中心列表中的信息中心标题下方。如果未指定说明，则列表仅显示信息中心标题。

说明文字可以进行本地化。

enable_viz_full_screen

此参数仅在 Looker 管理员启用全屏可视化图表设置后才生效。全屏可视化设置默认处于启用状态。

借助 enable_viz_full_screen 参数，您可以设置信息中心查看者是否可以以全屏和展开视图查看信息中心图块。它等同于信息中心设置中的允许为可视化图表使用全屏模式。

此参数接受值 true（提供全屏视图和展开视图）和 false（不提供全屏视图和展开视图）。默认值为 true。

extends

如使用 extends 重复使用代码文档页面中所述，借助 extends 参数，您可以基于一个 LookML 信息中心创建另一个 LookML 信息中心，并可选择添加或替换某些设置。extends 参数接受另一个 LookML 信息中心的名称。

扩展对象时，请注意本地化规则也适用于您的扩展。如果您要扩展某个对象，然后定义新的标签或说明，则应在项目的语言区域字符串文件中提供本地化定义。如需了解详情，请参阅本地化 LookML 模型文档页面。

extension

如使用 extends 重用代码文档页面中所述，extension 参数表示信息中心必须由另一个信息中心进行扩展。其他用户永远无法看到此信息中心，但您可以将其用作模板来创建其他可供其他用户查看的信息中心。extension 参数仅接受值 required。如果未添加 extension 参数，则无需为信息中心添加扩展程序。

layout

layout 参数用于设置 Looker 在放置信息中心元素时将使用的布局方法。它接受以下值：

rows

对于 layout: grid 信息中心，rows 参数会启动 LookML 部分，您可以在其中定义哪些元素应放入哪些行，以及每行的高度。在每行中，每个元素的宽度都相同。如果您未在此部分列出某个元素，该元素将不会显示在信息中心内。

- dashboard: sales_overview
  layout: grid
  rows:
    - elements: [element_name, element_name, ...]
      height: 200
    - elements: [element_name, element_name, ...]
      height: 300

elements

elements 参数接受以英文逗号分隔的图表元素名称列表。每个 elements 声明都会在信息中心内创建一个新行。放置在同一行中的元素将具有相同的宽度。因此，如果您在一行中放置 2 个元素，它们将各自占用可用空间的 50%。如果您在一行中放置 4 个元素，每个元素将占用可用空间的 25%。

height

height 参数用于定义行的高度（以像素为单位）。默认值为 300。

tile_size

对于 layout: tile 和 layout: static 信息中心，用于调整元素大小和位置的单位是图块大小。您以像素为单位定义 tile_size，默认值为 160。例如：

- dashboard: sales_overview
  layout: tile
  tile_size: 100

在这种情况下，具有 height: 5 和 width: 3 的信息中心元素的高度为 500 像素，宽度为 300 像素。height 和 width 参数适用于所有元素类型，有关其用法的详细信息请参阅每种可视化图表类型的文档页面。如需查看 height 和 width 的代表性使用示例，请参阅 LookML 信息中心的柱状图参数文档页面。

width

本部分指的是属于信息中心的 width 参数。

width 还可以用作信息中心元素的一部分。有关其用法的代表性示例，请参阅柱状图元素的文档页面。

对于 layout: static 信息中心，width 参数用于定义您计划使用的信息中心总宽度（以像素为单位）。如果您定义了过大的元素或一行中包含过多的元素，width 参数将不会将信息中心限制为特定大小。相反，width 设置有助于使信息中心始终位于屏幕中央。如果您未设置宽度，则默认值为 1200。

- dashboard: sales_overview
  layout: static
  width: 800

refresh

本部分指的是属于信息中心的 refresh 参数。

refresh 还可以用作信息中心元素的一部分。如需查看其使用情况的代表性示例，请参阅柱状图元素的文档页面。

借助 refresh 参数，信息中心可以定期自动重新加载，从而检索最新数据。在需要持续显示信息中心的环境中（例如办公室电视上），此功能通常很有用。请注意，必须在浏览器窗口中打开信息中心，此参数才能生效。此设置不会在后台运行，以“预热”信息中心缓存。

刷新率可以是任意数量（不含小数）的秒、分钟、小时或天。例如：

- dashboard: sales_overview
  refresh: 2 hours

设置较短的刷新间隔时请谨慎操作。由于信息中心可能包含许多查询（其中一些查询可能需要大量资源），因此某些信息中心可能会给数据库带来压力。

auto_run

auto_run 参数用于确定信息中心在首次打开或重新加载时是否会运行。默认值为 true。如果此参数设置为 false，用户需要按运行按钮才能加载信息中心。例如，如下所示的信息中心会在打开时自动运行：

- dashboard: sales_overview
  auto_run: true

无论 auto_run 设置如何，用户在更改过滤条件值后都必须点击运行按钮。这有助于防止用户在更改过滤条件时暂停或想要同时更改多个过滤条件时发生不必要的重新加载。

crossfilter_enabled

借助 crossfilter_enabled 参数，您可以为信息中心启用或停用交叉过滤。如果此参数设置为 true，则信息中心查看者可以通过点击某些数据点在信息中心内创建交叉过滤条件。

- dashboard: sales_data
  crossfilter_enabled: true

filters_bar_collapsed

借助 filters_bar_collapsed 参数，您可以为信息中心设置默认的折叠或展开状态。当此参数设置为 true 时，过滤条件栏默认处于收起状态。信息中心查看者可以点击过滤条件图标展开过滤条件栏。此设置的默认值为 false。

- dashboard: sales_data
  filters_bar_collapsed: true

filters_location_top

借助 filters_location_top 参数，您可以将信息中心过滤条件栏放置在信息中心的顶部或右侧。如果此参数设置为 true，过滤条件栏会显示在信息中心的顶部；如果设置为 false，过滤条件栏会显示在信息中心的右侧。此设置的默认值为 true。

- dashboard: sales_data
  filters_location_top: false

filters

本部分指的是属于信息中心的 filters 参数。

filters 还可以用作信息中心元素的一部分。如需查看其使用情况的代表性示例，请参阅柱状图元素的文档页面。

filters 也可以用作指标的一部分，如 filters 参数文档页面中所述。

filters 参数用于启动 LookML 部分，您可以在其中定义信息中心过滤条件。过滤条件显示在信息中心的顶部，可让用户更改信息中心元素背后的数据。

如需让过滤条件影响某个元素，必须使用 listen 参数将该元素设置为“监听”相应过滤条件。此参数适用于除 type: text 和 type: button 之外的所有元素类型。如需查看 listen 的代表性示例，请参阅 LookML 信息中心的柱状图参数文档页面。

以这种方式将过滤条件应用于元素时，过滤条件类型必须与监听过滤条件的维度或度量类型相匹配（如需了解详情，请参阅构建 LookML 信息中心）。过滤条件的格式如下：

filters:
- name: filter_name
  title: "chosen filter title"
  type: field_filter | number_filter | date_filter | string_filter
  model: model_name
  explore: explore_name
  field: view_name.field_name
  default_value: Looker filter expression
  allow_multiple_values: true | false
  required: true | false
  listens_to_filters:
  - filter_name
    field: view_name.field_name

name

本部分介绍作为信息中心过滤条件一部分的 name 参数。

name 还可以用作信息中心元素的一部分。如需查看其使用情况的代表性示例，请参阅柱状图元素的文档页面。

每个 name 声明都会创建一个新的信息中心过滤条件，并为其分配一个名称。该名称将在应受过滤条件影响的元素的 listen 参数中引用。listen 参数适用于除 type: text 之外的所有元素类型，有关其用法的详细信息请参阅每种可视化图表的文档页面。如需查看 listen 的代表性示例，请参阅 LookML 信息中心的柱状图参数文档页面。

filters:
- name: order_date

title （用于过滤条件）

本部分介绍作为信息中心过滤条件一部分的 title 参数。

title 还可以用作信息中心的一部分，如本页面的 title（适用于信息中心）部分中所述。

title 还可以用作信息中心元素的一部分。如需查看其使用情况的代表性示例，请参阅 LookML 信息柱状图参数文档页面。

借助 title 参数，您可以更改过滤条件名称在信息中心顶部向用户显示的方式。如果未指定，则标题默认为过滤器的名称。

请参考下面的示例：

filters:
- name: order_date
  title: "Order Date(s)"

如果您执行了此操作，过滤条件将显示为订单日期，而不是订单日期（多个）。

type

本部分介绍作为信息中心过滤条件一部分的 type 参数。

type 也可以用作信息中心元素的一部分，如 type（适用于 LookML 信息中心）参数文档页面中所述。

type 还可以用作联接的一部分，如 type 参数文档页面中所述。

type 还可以用作维度的一部分，如维度、过滤条件和参数类型文档页面中所述。

type 还可以用作指标的一部分，如指标类型文档页面中所述。

type 参数用于指定将放置在过滤条件中的输入类型。虽然任何类型的输入内容（例如日期）都可以写入 type: string_filter 过滤条件，但更具体的输入内容可为用户提供更量身定制的过滤条件 widget。过滤条件分为 4 种类型：

  • field_filter：如果可以指定基础维度或衡量指标，通常应选择此选项作为默认选项。使用 type: field_filter 并将过滤条件与 type:string 字段相关联，可使过滤条件建议可能的过滤条件值。
  • number_filter：允许用户输入数字/整数值或表达式。
  • date_filter：允许用户输入日期值或表达式。
  • string_filter：允许用户输入自由格式的文本。

field_filter

建议可供选择的选项，并根据您指定的基础字段更改其向用户的呈现方式。

如果您希望在用户与过滤条件互动时向其提供建议，那么这种过滤条件类型应该是您的首选。将从中提取建议的维度由 explore 和 field 参数定义，并且必须是 type: string 的字段才能生成过滤条件建议。

如果字段来自派生表，或者在探索中使用了 sql_always_where，或者字段是度量，则建议可能无法正常运行。

filters:
- name: order_date
  type: field_filter
  explore: orders
  field: orders.order_date  # must be of the form view_name.dimension_name

number_filter

不提供建议，允许用户输入整数/数值或表达式。

filters:
- name: order_value
  type: number_filter

date_filter

不提供建议，允许用户输入日期值或表达式。

filters:
- name: order_date
  type: date_filter

string_filter

不提供建议，允许用户输入自由格式的文本。

filters:
- name: customer_name
  type: string_filter

default_value

您可以使用 default_value 参数为过滤条件指定要使用的默认值。此值可为用户提供合理的起点建议，从而帮助用户。

请务必使默认值与所用过滤条件的类型相匹配。例如：

filters:
- name: order_value
  type: number_filter
  default_value: "50 to 100"

- name: order_date
  type: date_filter
  default_value: "last 30 days"

- name: customer_name
  type: string_filter
  default_value: "John Doe"

您可以使用过滤表达式来创建默认值。Looker 过滤表达式文档页面对此进行了更详细的介绍。

同时使用 default_value 和 ui_config 参数时，过滤表达式必须与为 ui_config 的 type 子参数提供的值以及支持 type 值的数据类型兼容。

您还可以使用 _localization 和 _user_attributes Liquid 变量来灵活设置默认过滤条件值。

allow_multiple_values

借助 allow_multiple_values 参数，您可以控制用户能否选择单个过滤条件值或多个过滤条件值。如果此参数设置为 true（默认值），用户可以选择多个过滤条件值。当此参数设置为 false 时，用户只能选择一个过滤条件值。

例如：

filters:
- name: Order ID
  title: Order ID
  type: field_filter
  allow_multiple_values: true
  required: false
  model: thelookstore
  explore: orders
  field: orders.id

required

借助 required 参数，您可以要求用户提供过滤条件值才能运行信息中心。默认情况下，过滤条件不需要值。如果某个过滤器不需要值，并且留空，则数据不会受到相应过滤字段的限制。如果某个过滤条件需要值，但您将其留空，则信息中心将无法运行。

filters:
  - name: State
    title: State
    type: field_filter
    required: true

ui_config

filters 的 ui_config 子参数可用于配置 LookML 信息中心的过滤条件设置。这些设置包括所用过滤条件控件的类型、过滤条件控件的位置以及可能的过滤条件值。

例如：


  filters:
  - name: City
    title: City
    type: field_filter
    default_value: San Francisco
    allow_multiple_values: true
    required: false
    ui_config:
      type: button_group
      display: inline
      options:
      - San Francisco
      - New York
      - Tokyo
    model: thelook
    explore: order_items
    field: users.city

如需详细了解如何使用界面配置过滤条件，请参阅添加和修改用户自定义的信息中心过滤条件文档页面。

type

ui_config 的 type 子参数可用于指定显示的过滤条件控件类型。

根据您为 type 输入的值，过滤条件控件可以是单选或多选。

type 支持的值取决于分配给您要过滤的字段的 LookML 数据 type。

STR = 与 string 数据类型兼容 DIST = 与 distance 数据类型兼容
NUM = 与 number 数据类型和数值型指标兼容 DUR = 与 duration 数据类型兼容
TIER = 与 tier 数据类型兼容 D&T = 与大多数日期和时间数据类型兼容
ZIP = 与 zipcode 数据类型兼容 LOC = 与 location 数据类型兼容
是/否 = 是否与 yesno 数据类型兼容 PAR = 与 parameter 参数兼容
值说明支持的数据类型
多选
button_group 过滤条件会显示一组按钮，每个按钮对应于使用 options 参数指定的每个值。 STR NUM TIER ZIP Y/N DIST DUR
checkboxes 过滤条件会显示复选框，每个通过 options 参数指定的值对应一个复选框。 STR NUM TIER ZIP Y/N DIST DUR
tag_list 过滤条件会显示一个下拉菜单，其中列出了使用 options 参数指定的每个可能值。 STR NUM TIER ZIP DIST DUR
range_slider 对于数字字段，过滤条件会显示一个滑块，用户可以使用该滑块将一系列数字设置为过滤条件的值。options 的 min 和 max 子参数用于指定过滤器的最小值和最大可能值，可以使用 default_value 参数指定默认范围。 NUM DIST DUR
单选
button_toggles 过滤条件会显示一组按钮，每个按钮对应于使用 options 参数指定的每个值。 STR NUM TIER ZIP Y/N DIST DUR PAR
radio_buttons 过滤条件会显示单选按钮，其中一个按钮用于表示任意值，另一个按钮用于表示通过 options 参数指定的每个值。 STR NUM TIER ZIP Y/N DIST DUR PAR
dropdown_menu 过滤条件会显示一个下拉菜单，其中列出了使用 options 参数指定的每个可能值。下拉菜单还为用户提供了选择任意值的选项。 STR NUM TIER ZIP Y/N DIST DUR PAR
slider 对于数字字段，过滤条件会显示一个滑块，用户可以通过在最小值和最大可能值之间滑动来选择过滤条件，这些值使用 options 参数指定。 NUM DIST DUR
日期和时间
day_picker 借助此过滤条件，用户可以选择要过滤的特定日期。 D&T 单日控件可与大多数时间范围和基于时间的类型搭配使用，但观看者只能使用此类控件选择单个日期。
day_range_picker 借助此过滤条件，用户可以选择开始日期和结束日期，以便按日期范围进行过滤。 D&T 日期范围控件可用于大多数时间范围和基于时间的类型，但查看者只能使用此类控件选择日期范围。
date_time_range_input 此过滤条件可让用户按日期和时间范围进行过滤。 D&T：日期和时间范围控件可与大多数基于时间的类型搭配使用，查看者必须使用此类控件选择日期和时间选项。
relative_timeframes 借助此过滤条件，用户可以按自定义日期范围进行过滤，也可以从预设的时间范围（例如今天、过去 7 天或过去 90 天）中进行选择。 D&T 时间范围控件可与大多数时间范围和基于时间的类型搭配使用，但观看者无法使用此类控件选择时间选项。
其他
advanced此过滤条件会显示用于应用一个或多个过滤条件或高级匹配过滤条件的选项。

如需详细了解高级控件，请参阅本页面上的使用高级控件部分。		 STR NUM TIER ZIP Y/N D&T DIST DUR LOC PAR

display

您可以使用 ui_config 的 display 子参数来设置信息中心过滤器的位置。您可以通过为 display 分配以下某个值来定位过滤条件：

  • inline：过滤条件直接显示在信息中心的顶栏中。
  • popover：摘要值显示在信息中心的顶部栏中；点击该值可查看完整过滤条件。
  • overflow：信息中心顶部栏中会显示一个更多按钮，其中包含一个数字指示器，用于指示溢出过滤器的数量；用户可以点击该按钮来查看溢出过滤器及其值。

某些过滤条件类型只能以特定方式显示。例如，type: day_picker 的过滤条件只能显示为 inline 或 overflow。如果您为过滤条件提供的 display 值对相应 type 无效，则过滤条件将显示为 inline 或 popover，以有效者为准。如需了解详情，请参阅添加和修改用户定义的信息中心过滤条件文档页面。

如需了解如何使用界面定位信息中心过滤条件，请参阅添加和修改用户定义的过滤条件文档页面。

options

ui_config 的可选子形参 options 可让您指定用户在查看 LookML 信息中心时可从中选择的值，以便临时更新信息中心过滤条件值。如果您未为 options 指定任何值，Looker 会从数据库中提取第一个值。

例如，您可以将 San Francisco、New York 和 Tokyo 设置为 users.city 字段过滤条件的可能值，如下所示：


ui_config:
  type: button_group
  display: inline
  options:
  - San Francisco
  - New York
  - Tokyo

如果 ui_config 的 type 子参数设置为 range_slider 或 slider，您可以使用 options 的 min 和 max 子参数：

  • min：设置过滤条件的最小值。
  • max：为过滤条件设置最大可能值。

例如：


ui_config:
  type: range_slider
  display: inline
  options:
    min: 0
    max: 500

model

对于 type: field_filter 的信息中心过滤条件，您需要定义一个模型，过滤条件将从中提取建议。model 参数用于指定哪个模型包含您要使用的字段。

filters:
- name: State
  title: State
  type: field_filter
  default_value: California
  model: thelookstore
  explore: users
  field: users.state

explore

本部分介绍作为信息中心过滤条件一部分的 explore 参数。

explore 也可以作为模型的一部分使用，如 explore 参数文档页面中所述。

explore 还可以用作信息中心元素的一部分。如需查看其使用情况的代表性示例，请参阅柱状图元素的文档页面。

对于 type: field_filter 的信息中心过滤条件，您需要定义一个字段，过滤条件将从中提取建议。explore 参数用于指定包含要使用的字段的探索。

filters:
- name: order_date
  type: field_filter
  explore: orders
  field: orders.order_date

field

对于 type: field_filter 的信息中心过滤条件，您需要定义一个字段，过滤条件将从中提取建议。field 参数用于指定要使用的字段。请务必使用完全限定的字段名称。换句话说，请使用 view_name.field_name，而不仅仅是 field_name。

filters:
- name: order_date
  type: field_filter
  explore: orders
  field: orders.order_date

listens_to_filters

对于 type: field_filter 的信息中心过滤条件，您可以根据用户为 type: field_filter 的另一个过滤条件输入的内容，缩小过滤条件的建议范围。

在以下示例中，为 State 过滤条件提供的建议将基于 Order ID 过滤条件中的值。为 Order ID 过滤条件选择的任何值都将具有关联的 users.state 值，并且这些值将成为 State 过滤条件的建议值。如需了解详情，请参阅添加和修改用户自定义的信息中心过滤条件文档页面。

filters:
- name: State
  title: State
  type: field_filter
  model: thelookstore
  explore: users
  listens_to_filters:
  - Order ID
  field: users.state

embed_style

embed_style 参数用于启动 LookML 部分，您可以在其中自定义嵌入式信息中心的外观。embed_style 及其关联的参数仅在嵌入式信息中心上受支持，如果信息中心未嵌入，则会被忽略。

对 embed_style 进行更改后，您必须将 LookML 部署到生产环境，才能在嵌入式 LookML 信息中心内看到 embed_style 设置。

对于以下指定颜色的嵌入式信息中心属性，颜色值可以是十六进制字符串（例如 #2ca6cd），也可以是 CSS 命名颜色字符串（例如 mediumblue）。

嵌入式信息中心自定义设置采用以下格式：

embed_style:
  background_color: "css_color"
  show_title: true | false
  title_color: "css_color"
  show_filters_bar: true | false
  tile_background_color: "css_color"
  tile_text_color: "css_color"

background_color

设置嵌入式信息中心的背景颜色。

embed_style:
  background_color: "#ffffff"

show_title

指定嵌入式信息中心标题是否对用户可见。

embed_style:
  show_title: false

title_color

设置嵌入式信息中心的标题颜色。

embed_style:
  title_color: "#008000"

show_filters_bar

指定嵌入式信息中心过滤器是否对用户可见。

此参数仅影响信息中心的表面外观，不会影响用户访问数据的能力。隐藏过滤条件栏并不会阻止用户通过其他方式更改过滤条件。如需了解如何设置安全的数据访问权限控制政策，请参阅访问权限控制和权限管理文档页面。

embed_style:
  show_filters_bar: true

tile_background_color

设置嵌入式信息中心上所有平铺的背景颜色。

embed_style:
  tile_background_color: "lightyellow"

tile_text_color

设置嵌入式信息中心上所有平铺的文字颜色。

embed_style:
  tile_text_color: "crimson"

elements

本部分涉及 dashboard 的 elements 参数。

elements 还可以用作信息中心行的一部分，如本页面上的行对应的 elements 部分中所述。

elements 参数用于启动 LookML 部分，您可以在其中定义构成信息中心的元素。有许多参数可以定义信息中心元素的外观。如需详细了解这些参数，请参阅信息中心元素参数页面。

- dashboard: sales_overview
  layout: tile
  elements:
  - name: order_count
    type: single_value
    model: ecommerce
    explore: orders
    measures: [orders.count]

请考虑您添加到 LookML 信息中心的元素的数量和复杂程度。元素越多，需要的浏览器资源就越多，从而导致信息中心呈现时间增加。同样，呈现大量数据的元素可能会影响信息中心性能。如果渲染成为问题，请考虑降低信息中心元素查询的复杂性，或创建包含较少元素的多个信息中心。