建構 LookML 資訊主頁

LookML 資訊主頁是由 LookML 開發人員建立，並儲存為受版本管控的檔案。根據預設，這些檔案會顯示在 Looker 執行個體的 LookML 資訊主頁資料夾中。

如要比較 LookML 資訊主頁和使用者定義的資訊主頁，請參閱「比較使用者定義的資訊主頁和 LookML 資訊主頁」說明文件。

如要建立 LookML 資訊主頁，您必須具備下列 Looker 權限：

• see_lookml_dashboards
• develop

此外，您必須存取 LookML 模型，才能使用資訊主頁中的任何資料。

建立 LookML 資訊主頁檔案

如要建構 LookML 資訊主頁，請先建立資訊主頁檔案，檔案的擴充功能為 .dashboard.lookml (雖然擴充功能的 .lookml 部分在 IDE 中不會顯示)。相關步驟如下：

1. 開啟「開發人員模式」。
2. 在「Develop」選單中，前往專案。
3. 選取 Looker IDE 檔案瀏覽器面板頂端的「Add file or folder」加號圖示，即可在現有專案資料夾外建立 LookML 資訊主頁檔案。或者，您也可以按一下資料夾的三點「資料夾選項」選單，在資料夾中建立檔案。按一下「Create Dashboard」，建立資訊主頁檔案。

1. 畫面上會顯示「Create File」視窗。在視窗中，在輸入欄位中為資訊主頁檔案命名，然後選取「Create」按鈕。

編輯 LookML 資訊主頁檔案

建立 LookML 資訊主頁檔案時，Looker 會預先在檔案中填入幾個基本資訊主頁參數，以便實作整個資訊主頁的設定。這個範本也會在檔案中預先填入幾個資訊主頁元素參數的範例，這些參數會歸入 elements 資訊主頁參數，並定義資訊主頁資訊方塊、文字和按鈕的功能和外觀。新建立的 .dashboard.lookml 檔案會包含類似下列的資訊主頁 LookML：

- dashboard: order_analysis
  title: Order Analysis
  layout: newspaper
  preferred_viewer: dashboards-next
  tile_size: 100

  filters:

  elements:
    - name: hello_world
      type: looker_column

只要處於開發模式，您就可以在 IDE 中編輯資訊主頁檔案。

您可以透過下列幾種方式建立資訊主頁：

• 手動建立：您可以使用資訊主頁參數和資訊主頁元素參數，手動建立資訊主頁。
• 複製使用者定義的資訊主頁：您可以刪除檔案中預先填入的資訊主頁 LookML，複製使用者定義的資訊主頁 LookML，然後貼到資訊主頁檔案中，藉此建立使用者定義的資訊主頁副本。
• 複製元素的資訊主頁 LookML：您可以從「探索」或「Look」複製資訊主頁 LookML，然後貼到資訊主頁檔案中。

建立資訊主頁時，請遵循資訊主頁建構的最佳做法。如要瞭解如何建立效能良好的資訊主頁，請參閱「建構效能良好的 Looker 資訊主頁時的考量事項」最佳做法頁面。

在現有 LookML 資訊主頁中新增視覺化圖表

如要將圖表視覺化效果加入現有的 LookML 資訊主頁，最簡單的方法就是使用「探索」頁面建立要轉換為資訊主頁元素的查詢：

1. 建立要新增至資訊主頁的查詢和轉換後，請按一下「探索」的「探索動作」齒輪選單。

2. 選取「取得 LookML」，即可公開 LookML。

   

3. 系統會顯示「Get LookML」視窗。在視窗中選取「Dashboard」後，選取所有 LookML 並複製。

   

接著，將 LookML 貼入資訊主頁 LookML 檔案。編輯資訊主頁 LookML 檔案時，請務必：

• 確認您處於開發模式，以便編輯資訊主頁檔案。
• 將 LookML 貼到資訊主頁的 elements 參數下方。
• 將 LookML 貼入資訊主頁檔案時，請使用正確的縮排。盡可能將縮排與資訊主頁檔案中現有的元素相符。

如有需要，您可以使用個別元素類型的說明文件頁面中說明的參數調整 LookML 參數。

新增篩選條件

將資訊主頁元素儲存到資訊主頁檔案後，建議您新增篩選器，讓資訊主頁檢視者篩選資訊主頁上的部分或所有元素。篩選器有很多用途，例如：

• 調整顯示的時間範圍
• 調整顯示的特定產品類別、客戶類型等
• 為客戶或消費者提供「查詢」類型功能

請務必建立所需的篩選器類型。這兩種類型如下：

• 您硬式編碼至資訊主頁元素的篩選器，資訊主頁檢視者無法變更
• 資訊主頁篩選器 (資訊主頁檢視者可變更)

在資訊主頁元素中硬式編碼的篩選器

您在資訊主頁元素中硬式編碼的篩選器，使用者無法變更，通常會在複製 LookML 的步驟中自動建立，如果是圖表或資訊主頁則是如此。在 LookML 資訊主頁中，這些篩選器會使用 filters 資訊主頁元素參數，如下所示：

- name: element_name
  # lots of other element parameters here
  filters:
    dimension_or_measure_name: 'looker filter expression'

資訊主頁篩選器

資訊主頁篩選器可讓觀眾以互動方式精細調整資訊主頁元素顯示的資料。如要建立資訊主頁篩選器，請按照下列步驟操作：

1. 在 LookML 資訊主頁檔案中使用 filters 參數建立資訊主頁篩選器。
2. 使用 listen 參數，將篩選器套用至個別資訊主頁元素。

建立資訊主頁篩選器

filters 參數可讓您為資訊主頁建立各種類型的互動式篩選器。

如要建立使用者可互動的資訊主頁篩選器，請在資訊主頁檔案中新增 filters 參數。例如，下列程式碼範例會建立含有篩選器 date 和 category_name 的 LookML 資訊主頁：

- dashboard: dashboard_name
  title: Dashboard Title
  layout: newspaper
  filters:
  - name: date
    title: 'Date Range'
    type: date_filter
    default_value: 30 days

  - name: category_name
    type: field_filter
    model: ecommerce
    explore: product
    field: category.name

上例中的程式碼會建立下列篩選器：

• date：日期篩選器，可讓使用者選取日期範圍。預設值為過去 30 天。
• category_name：欄位篩選器，可讓使用者依產品類別篩選。這個篩選器會根據指定 LookML 模型 (ecommerce) 和 Explore (product) 中的 category.name 欄位，動態產生選項。

將資訊主頁篩選器套用至資訊主頁元素

建立資訊主頁篩選器後，您可以使用 listen 參數將該篩選器套用至個別資訊主頁元素。以這種方式使用 listen 參數，可讓系統根據使用者在篩選器中選取的項目，動態更新已連結的元素。

舉例來說，請參考下列範例 LookML 程式碼，瞭解如何設定區域圖表元素：

- name: approved_orders_by_day
  type: looker_area
  model: ecommerce
  explore: orders
  dimensions: [orders.created_date]
  measures: [orders.count]
  filters:
    orders.status: 'approved'

approved_orders_by_day 圖表會依據 orders_created_date 維度和 orders.count 評估指標，並套用篩選器 orders.status: 'approved'，顯示已核准訂單的數量 (按天計算)。這個篩選器會固定在元素中，資訊主頁檢視者無法修改。

如要讓使用者使用前一個範例中的 date 篩選器和 category_name 篩選器篩選 approved_orders_by_day 圖表，請在資訊主頁元素中新增 listen 參數。

- name: approved_orders_by_day
  type: looker_area
  model: ecommerce
  explore: orders
  dimensions: [orders.created_date]
  measures: [orders.count]
  filters:
    orders.status: 'approved'
  listen:
    category_name: category.name
    date: orders.created_date

當資訊主頁檢視者與 category_name 篩選器或 date 篩選器互動時，approved_orders_by_day 圖表會自動更新，反映篩選結果。

listen 參數使用 filter_name: field_name 語法。在前述範例中，category_name 和 date 是篩選器的名稱，category.name 和 orders.created_date 則是用於讓資訊主頁檢視者提供篩選器輸入內容的欄位。

資訊主頁篩選器可套用至任何元素中的任何欄位 (同資料類型)。舉例來說，一個元素可將使用者輸入內容套用至訂單「建立」日期 (date: orders.created_date)，另一個元素則可將輸入內容套用至訂單「出貨」日期 (date: orders.ship_date)：

- name: element_one
  # lots of other element parameters here
  listen:
    date: orders.created_date

- name: element_two
  # lots of other element parameters here
  listen:
    date: orders.ship_date

在模型中加入資訊主頁檔案

如要在開發模式中預覽資訊主頁，或在正式版中顯示資訊主頁，則必須使用 include 陳述式，將資訊主頁納入資訊主頁所依據的模型檔案中。

常見做法是使用萬用字元，在模型中加入所有 LookML 資訊主頁：

include: "*.dashboard.lookml"

或者，如果 LookML 資訊主頁顯示在 IDE 的資料夾中，請使用該資料夾的路徑

 include: "/path/*.dashboard.lookml"

您也可以指定特定資訊主頁的檔案名稱，將該資訊主頁納入：

include: "my_dashboard.dashboard.lookml"

儲存、預覽及發布 LookML 資訊主頁

如要預覽資訊主頁，請按照下列步驟操作：

1. 按一下檔案右上角的「儲存變更」按鈕，即可儲存 .dashboard.lookml 檔案。
2. 在相關模型檔案中加入資訊主頁，然後儲存該檔案的變更。
3. 在要預覽的 .dashboard.lookml 檔案中，按一下向下箭頭「查看檔案動作」圖示，然後選取「查看資訊主頁」。

您可以進一步修改 .dashboard.lookml 檔案、儲存檔案，然後再次預覽資訊主頁。

滿意資訊主頁後，您可以將資訊主頁發布至正式環境，讓其他具備正確權限的使用者查看。發布儀表板的方式與在執行個體上發布 LookML 的其他變更相同，並取決於 Looker 執行個體的版本控制設定。

LookML 資訊主頁資料夾

發布後，LookML 資訊主頁預設會儲存在 LookML 資訊主頁資料夾中。LookML 資訊主頁資料夾位於左側導覽面板中的「資料夾」資料夾中。LookML 資訊主頁資料夾與其他資料夾有幾個不同之處：

• 您必須在至少一個模型檔案中加入 LookML 資訊主頁，才能在 LookML 資訊主頁資料夾中顯示。
• 使用者必須具備 see_lookml_dashboards 權限，才能查看 LookML 資訊主頁資料夾。
• 如要查看 LookML 資訊主頁資料夾中的資訊主頁，使用者必須存取包含資訊主頁的 LookML 模型。
• 如要查看 LookML 資訊主頁中的任何資訊方塊，資訊主頁觀看者必須存取資訊方塊所依據的 LookML 模型。
• 如要編輯 LookML 資訊主頁資料夾中的資訊主頁，您必須具備包含 LookML 資訊主頁的模型的 develop 權限。
• 如要在資訊主頁的任一資訊方塊上從這裡探索，資訊主頁檢視者必須具備資訊方塊所依據模型的 explore 權限。
• 您無法在 LookML 資訊主頁資料夾中建立資料夾。

將 LookML 資訊主頁移至 LookML 資訊主頁資料夾以外的位置

如果您具備 see_lookml_dashboards 和 develop Looker 權限，以及 LookML 資訊主頁所屬 LookML 模型的存取權，您就能將 LookML 資訊主頁移至您具備管理存取權、編輯資料夾存取層級的任何資料夾。

移動資訊主頁的方法有兩種：

• 在「LookML 資訊主頁」資料夾中選取要移動的資訊主頁，按一下資訊主頁部分頂端的「移動」按鈕，然後選取要移動資訊主頁的資料夾。詳情請參閱「組織及管理內容」說明文件。
• 在「LookML 資訊主頁」資料夾中，按一下資訊主頁的三點圖示選單，在選單中選取「移動」，然後選取要移動資訊主頁的資料夾。

如果您處於開發模式，就無法將 LookML 資訊主頁移出 LookML 資訊主頁資料夾。您可以改用「匯入」選項，將 LookML 資訊主頁複製為使用者定義的資訊主頁，並匯入其他資料夾。

如果資料夾同時包含使用者定義的資訊主頁和 LookML 資訊主頁，系統會在「LookML 資訊主頁」專區中顯示 LookML 資訊主頁。您可以在「LookML 資訊主頁」部分，將 LookML 資訊主頁移至其他資料夾，或將 LookML 資訊主頁釘選至看板。不過，與使用者定義的資訊主頁不同，LookML 資訊主頁無法重新命名，也無法從資料夾移至垃圾桶。

如果 LookML 資訊主頁的 dashboard 參數值有所變更，LookML 資訊主頁就會自動移回 LookML 資訊主頁資料夾。

查看現有 LookML 資訊主頁的 LookML

如果您具備 see_lookml 權限，只要在資訊主頁的三點 資訊主頁操作選單中選取「前往 LookML」，即可前往現有 LookML 資訊主頁的 LookML：

選取「前往 LookML」後，Looker 會前往定義 LookML 資訊主頁的資訊主頁檔案。

擴充 LookML 資訊主頁

建立 LookML 資訊主頁後，您可以擴充資訊主頁。這可讓您根據原始資訊主頁建立第二個資訊主頁，並新增或覆寫部分設定。接著，如果您變更第一個資訊主頁，第二個資訊主頁會自動繼承這些變更 (除非在第二個資訊主頁中覆寫)。詳情請參閱「使用 extends 重複使用程式碼」說明文件。

使用匯總認知度提升資訊主頁成效

LookML 開發人員可以使用匯總認知來改善 LookML 資訊主頁效能。有了匯總資料意識，開發人員就能在 LookML explore 參數下建立匯總資料表，進而針對資訊主頁中一或多個資訊方塊進行查詢最佳化。

建立並查看 LookML 資訊主頁後，您可以使用三點 Dashboard actions 選單中的「Get aggregate table LookML」選項，前提是您具備 see_lookml 權限。

詳情請參閱 aggregate_table 參數說明文件頁面。