信息中心参数

您可以通过以下两种方法之一创建信息中心。用户定义的信息中心通过 Looker 界面创建，详情请参阅创建用户定义的信息中心文档页面。您还可以使用 LookML 创建信息中心，并修改此页面的总体设置（如本页所述）。

信息中心有几个影响整个信息中心的设置，详见下文。它还将包含一组数据可视化图表，这些可视化图表称为“元素”。每种元素的 LookML 在各种文档类型中进行了介绍。

用法示例

- dashboard: dashboard_name
  preferred_viewer: dashboards | dashboards-next
  title: "desired dashboard title"
  description: "desired dashboard description"
  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: "desired 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

参数定义

具有 UNSUPPORTED BY LEGACY 标签的参数仅在使用默认信息中心体验呈现时才会生效，具体方法是使用 preferred_viewer: dashboards-next 或者将旧版 LookML 信息中心转换为用户定义的信息中心，然后升级用户定义的信息中心。

参数名称	说明
dashboard	创建信息中心。
preferred_viewer	选择将信息中心显示为信息中心还是旧版信息中心。
title（适用于信息中心）	更改信息中心名称向用户显示的方式。
description（适用于信息中心）	添加占位符说明，以便在信息中心转换为用户定义的信息中心时使用。
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	不受旧版支持为同样使用preferred_viewer: dashboards-next的信息中心启用或停用交叉过滤。
filters_bar_collapsed	新增 21.16 不支持的旧版将信息中心过滤器栏设置为同样使用 preferred_viewer: dashboards-next 的信息中心的默认收起或展开。
filters_location_top	新增 22.8 不支持的旧版将信息中心过滤器栏位置设置为也使用 preferred_viewer: dashboards-next 的信息中心顶部或右侧。
filters（适用于信息中心）	启动 LookML 部分以定义信息中心过滤条件。
name（适用于过滤条件）	创建过滤器。
title（适用于过滤条件）	更改过滤器名称向用户显示的方式。
type（适用于过滤条件）	确定要使用的过滤条件类型。
default_value	根据需要为过滤器设置默认值。
allow_multiple_values	限制用户只能使用一个过滤条件值。
required	要求用户输入过滤条件值才能运行信息中心。
ui_config	不支持的旧版 可配置当用户查看在新版信息中心中呈现的 LookML 信息中心时可用的过滤器控件，其中 preferred_viewer 设置为 dashboards-next（而非旧版信息中心，preferred_viewer 设置为 dashboards）。具有子参数 type、display 和 options。
model（适用于过滤条件）	指定包含 type: field_filter 过滤条件底层字段的模型。
explore（适用于过滤条件）	指定包含 type: field_filter 过滤条件底层字段的“探索”。
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 参数至少添加一个元素。

注意：如果您针对已移出 LookML 信息中心文件夹的信息中心更改了 LookML 信息中心 dashboard 参数的值，LookML 信息中心会自动移回 LookML 信息中心文件夹。

preferred_viewer

通过 preferred_viewer 参数，您可以选择查看和下载信息中心的格式。它接受以下值：

• dashboards：旧版信息中心的基于 AngularJS 的渲染程序。

• dashboards-next：基于 React 的渲染程序，适用于默认信息中心体验。

preferred_viewer: dashboards将转换为成版信息中心的 LookML 信息中心可以通过升级用户指定的信息中心来呈现。

title（适用于信息中心）

本部分引用了信息中心中的 title 参数。

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

title 也可以用作任何信息中心元素的一部分。柱形图元素文档页面中提供了使用情形的代表性示例。

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

请参考下面的示例：

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

如果是这样，信息中心将不再显示 Sales Overview，而会显示为 1) Sales Overview。

description（适用于信息中心）

本部分引用了信息中心中的 description 参数。

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

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

从 Looker 21.20 开始，description 参数的内容将显示在 LookML 信息中心信息中心详情面板的说明文本框中。

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

以文件夹的形式显示查看时，说明会显示在信息中心列表的信息中心标题下方。如果未指定说明，列表将仅显示信息中心标题。

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

extends

如通过扩展项重复使用代码文档页面所述，借助 extends 参数，您可以将一个 LookML 信息中心基于另一个 LookML 信息中心，从而可能添加或替换某些设置。extends 参数接受另一个 LookML 信息中心的名称。

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

extension

如此页面所述，extension 参数表示信息中心必须由其他信息中心扩展。此信息中心永远不对其他用户显示，但可以用作模板来创建对其他用户可见的其他信息中心。extension 参数仅接受值 required。如果不包含 extension 参数，则无需为信息中心提供扩展程序。

layout

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

• newspaper：信息中心元素将以 24 列的网格形式显示。元素的默认大小为 8 列宽和 6 行高。元素可沿此网格进行配置，由 width、height、row 和 col 元素参数指定。用户定义的信息中心转换为 LookML 信息中心时，系统会使用此布局选项；当通过 Looker IDE 创建新的 LookML 信息中心时，此布局选项将用作默认布局。此外，当 preferred_viewer 设置为 dashboards-next 时，newspaper 是唯一支持从 LookML 信息中心转换为用户定义的信息中心的布局。

• grid：信息中心元素将以动态宽度显示，具体取决于您使用 rows 参数及其子参数 elements 和 height 定义的一组行。当 preferred_viewer 设置为 dashboards-next 时，grid 不支持从 LookML 信息中心转换为用户定义的信息中心。

• static：信息中心元素将按照其在 LookML 文件中的列出顺序显示。每个信息中心元素都必须使用 top 和 left 参数手动放置。这些参数适用于所有元素类型，有关每个元素类型的用法的详细信息，请参阅每种可视化图表类型的文档页面。如需查看有关 top 和 left 的工作原理的代表性示例，请参阅 LookML 信息中心的柱形图参数文档页面。当 preferred_viewer 设置为 dashboards-next 时，static 不支持从 LookML 信息中心转换为用户定义的信息中心。

• tile：信息中心元素将按照其在 LookML 文件中的列出顺序显示。信息中心的宽度是动态的，基于浏览器的宽度。信息中心元素会在浏览器内动态确定位置，以填充可用空间。当 preferred_viewer 设置为 dashboards-next 时，tile 不支持从 LookML 信息中心转换为用户定义的信息中心。

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 设置如何，用户都必须在更改过滤条件值后点击 Run 按钮。这样，当用户更改过滤器期间暂停时，或者想要同时更改多个过滤器时，也可以避免不必要的重新加载。

crossfilter_enabled

此参数仅适用于通过将 preferred_viewer 参数设置为 dashboards-next 来使用 Looker 的默认信息中心体验呈现的 LookML 信息中心。

借助 crossfilter_enabled 参数，您可以为也使用 preferred_viewer: dashboards-next 的信息中心启用或停用交叉过滤器。当此参数设为 true 时，信息中心查看者可以通过点击某些数据点来创建交叉过滤器。

- dashboard: sales_data
  preferred_viewer: dashboards-next
  crossfilter_enabled: true

crossfilter_enabled 将不会在使用 preferred_viewer: dashboards 的 LookML 信息中心上生效。不过，如果使用 crossfilter_enabled 和 preferred_viewer: dashboards 的 LookML 信息中心已转换为用户定义的信息中心并升级，crossfilter_enabled 将会在升级后的信息中心生效。

filters_bar_collapsed

此参数仅适用于通过将 preferred_viewer 参数设置为 dashboards-next 来使用 Looker 的默认信息中心体验呈现的 LookML 信息中心。

借助 filters_bar_collapsed 参数，您可以将信息中心过滤器栏设置为同样使用 preferred_viewer: dashboards-next 的信息中心的默认收起或展开状态。当此参数设置为 true 时，过滤条件栏默认处于收起状态。信息中心查看者可以点击过滤器图标展开过滤器栏。此设置的默认值为 false。

- dashboard: sales_data
  preferred_viewer: dashboards-next
  filters_bar_collapsed: true

filters_bar_collapsed 将不会在使用 preferred_viewer: dashboards 的 LookML 信息中心上生效。不过，如果使用 filters_bar_collapsed 和 preferred_viewer: dashboards 的 LookML 信息中心已转换为用户定义的信息中心并升级，filters_bar_collapsed 将会在升级后的信息中心生效。

filters_location_top

此参数仅适用于通过将 preferred_viewer 参数设置为 dashboards-next 来使用 Looker 的默认信息中心体验呈现的 LookML 信息中心。

借助 filters_location_top 参数，您可以将信息中心过滤条件栏放置在同样使用 preferred_viewer: dashboards-next 的信息中心的顶部或右侧。当此参数设置为 true 时，过滤栏会显示在信息中心的顶部；设置为 false 时，过滤栏会显示在信息中心的右侧。此设置的默认值为 true。

- dashboard: sales_data
  preferred_viewer: dashboards-next
  filters_location_top: false

filters_location_top 将不会在使用 preferred_viewer: dashboards 的 LookML 信息中心上生效。不过，如果使用 filters_location_top 和 preferred_viewer: dashboards 的 LookML 信息中心已转换为用户定义的信息中心并升级，filters_location_top 将会在升级后的信息中心生效。

filters

本部分引用了信息中心中的 filters 参数。

filters 也可以用作信息中心元素的一部分。如需了解使用情形的示例，请参阅柱形图元素文档页面。

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

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

为了使影响某个元素的过滤条件，必须使用 listen 参数将该元素设为该监听器的“监听”。此参数适用于 type: text 以外的所有元素类型，有关每种用法的详细信息，请参阅各个可视化图表类型的文档页面。如需查看有关 listen 工作原理的代表性示例，请参阅 LookML 信息中心的柱形图参数文档页面。

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

filters:
- name: filter_name
  title: "desired 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 过滤器中，但更具体的描述可以为用户提供更加个性化的过滤器微件。过滤条件有 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 液体变量来设置灵活的默认过滤条件值。

allow_multiple_values

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

对于使用旧版信息中心体验的 LookML 信息中心，如果 preferred_viewer 设置为 dashboards，allow_multiple_values 可应用于任何 type 的过滤条件。

例如：

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

此参数仅适用于通过将 preferred_viewer 参数设置为 dashboards-next 来使用 Looker 的默认信息中心体验呈现的 LookML 信息中心。

filters 的 ui_config 子参数可让您通过将 preferred_viewer 参数设置为 dashboards-next，来配置当 LookLook 信息中心作为信息中心（而非 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

您使用 ui_config 子参数指定的设置将不会在使用 preferred_viewer: dashboards 的 LookML 信息中心中生效。不过，如果使用 ui_config 和 preferred_viewer: dashboards 的 LookML 信息中心已转换为用户定义的信息中心并升级，ui_config 将会在升级后的信息中心生效。

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

type

通过 ui_config 的 type 子参数，您可以指定当用户以信息中心（而非旧版信息中心）的形式查看 LookML 信息中心时显示的过滤器控件类型。

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

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

[

[

值	说明	支持的数据类型
多选
button_group	过滤器会显示一组按钮，使用 options 参数指定的每个值都有一个按钮。	S N T ZC YN DI DU
checkboxes	过滤器会显示复选框，每个复选框对应一个使用 options 参数指定的值。	S N T ZC YN DI DU
tag_list	该过滤器会显示一个下拉菜单，其中列出了使用 options 参数指定的所有可能的值。	S N T ZC DI DU
range_slider	对于数字字段，过滤器会显示一个滑块，供用户将一系列数字设置为该过滤器的值。options 的 min 和 max 子参数用于指定过滤器的最小值和最大值，而默认范围可以使用 default_value 参数指定。	N DI DU
单选
button_toggles	过滤器会显示一组按钮，使用 options 参数指定的每个值都有一个按钮。	S N T ZC YN DI DU P
radio_buttons	过滤器显示单选按钮，其中的任意值按钮对应一个按钮，options 参数所指定的每个值对应一个按钮。	S N T ZC YN DI DU P
dropdown_menu	该过滤器会显示一个下拉菜单，其中列出了使用 options 参数指定的每个可能的值。该下拉菜单还为用户提供了用于选择任意值的选项。	S N T ZC YN DI DU P
slider	对于数字字段，过滤器会显示一个滑块，让用户通过滑动可能的最小值和最大值选择过滤器，这些最小值是使用 options 参数指定的。	N DI DU
日期和时间
day_picker	借助该过滤条件，用户可以选择要过滤的具体日期。	DT^* 大多数日期/时间范围类型均可与单日控件搭配使用，但观看者只能选择具有此类控件的单个日期。
day_range_picker	该过滤条件允许用户选择开始日期和结束日期，以针对特定的日期范围进行过滤。	DT^* 大多数时间范围和基于时间的类型可以使用日期范围控件，但观看者只能选择此类控件的日期范围。
date_time_range_input	借助该过滤条件，用户可以根据日期和时间范围进行过滤。	DT^* 对于大多数基于时间的类型，可以使用日期和时间控件，且观看者必须同时选择日期和时间控件。
relative_timeframes	借助该过滤条件，用户可以按自定义的日期范围进行过滤，也可以从时间范围预设（例如今天、过去 7 天、过去 90 天等）中进行选择。	DT^* 时间范围控件可与大多数时间范围和基于时间的类型一起使用，但观看者无法选择具有此类控件的时间选项。
其他
advanced	该过滤条件提供了用于应用一个或多个过滤条件或高级匹配过滤条件的选项。 请参阅此页面上的使用高级控件部分，详细了解高级控件。	S N T ZC YN DT DI DU L P
^*关于日期和时间数据的说明 ：在 Looker 为控件创建选项时，一些时间范围和基于时间的类型会解读为不同的数据类型。两个示例是 yesno 时间范围（解释为 yesno 数据类型，因此支持 yesno 类型支持的值）和 hour_of_day 时间范围（解析为 number 数据类型），因此支持 number 类型支持的值。

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 信息中心添加的元素数量和复杂性。添加的元素越多，所需的浏览器资源就越多，因而会延长信息中心的呈现时间。同样，呈现大量数据的元素可能会影响信息中心的性能。如果渲染会成为一个问题，请考虑简化元素，或创建多个元素较少的信息中心。