LookML 資訊主頁參數

建立資訊主頁的方法有兩種。使用者定義的資訊主頁是使用 Looker UI 建立，詳情請參閱「建立使用者定義的資訊主頁」說明文件頁面。您也可以使用 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 篩選器基礎欄位的「探索」。
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 篩選器，但如果更具體，使用者就能獲得更符合需求的篩選器小工具。篩選器分為 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

如要進一步瞭解如何透過 UI 設定篩選器，請參閱「新增及編輯使用者定義的資訊主頁篩選器」說明文件頁面。

type

ui_config 的 type 子參數可讓您指定要顯示的篩選器控制項類型。

根據您為 type 輸入的值，篩選器控制項可以是單選或多選。

type 支援的值取決於指派給篩選欄位的 LookML 資料 type。

STR = 與 string 資料類型相容 DIST = 與 distance 資料類型相容
NUM = 與 number 資料類型和數值指標相容 DUR = 與 duration 資料類型相容
層級 = 與 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 使用者可以透過篩選器選擇要篩選的特定日期。 日期和時間：單日控制項可搭配大多數時間範圍和時間類型使用，但觀眾只能透過這類控制項選取單一日期。
day_range_picker 使用者可以透過篩選器選取開始和結束日期，篩選特定日期範圍的資料。 日期和時間：日期範圍控制項可搭配大多數時間範圍和時間類型使用，但檢視者只能透過這類控制項選取日期範圍。
date_time_range_input 使用者可透過篩選器，依日期和時間範圍篩選資料。 日期和時間：日期和時間範圍控制項可用於大多數時間類型，檢視者必須使用這類控制項選取日期和時間選項。
relative_timeframes 使用者可以透過篩選器，篩選自訂日期範圍，或從預設時間範圍中選擇，例如「今天」、「過去 7 天」或「過去 90 天」。 日期和時間：時間範圍控制項適用於大多數時間範圍和時間類型，但觀眾無法使用這類控制項選取時間選項。
其他
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。如果為篩選器提供不適用於該 type 的 display 值，篩選器會顯示 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 的另一個篩選器中輸入的內容，縮小篩選器建議範圍。

在下列範例中，系統會根據 Order ID 篩選器的值，提供 State 篩選器的建議。為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 for rows」一節。

elements 參數會啟動 LookML 區塊，您可以在其中定義組成資訊主頁的元素。有許多參數可以定義資訊主頁元素的顯示方式。如需詳細說明，請參閱「資訊主頁元素參數」頁面。

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

請考慮新增至 LookML 資訊主頁的元素數量和複雜度。元素越多，瀏覽器資源需求就越高，資訊主頁的轉譯時間也會隨之增加。同樣地，如果元素會算繪大量資料，也可能會影響資訊主頁效能。如果轉譯發生問題，請考慮減少資訊主頁元素查詢的複雜度，或建立多個元素較少的資訊主頁。