פרמטרים של מרכז שליטה של LookML

יש שתי דרכים ליצור מרכזי בקרה. לוחות בקרה בהגדרת המשתמש נוצרים באמצעות ממשק המשתמש של Looker, והם מתוארים בדף התיעוד יצירת לוחות בקרה בהגדרת המשתמש. אפשר גם ליצור מרכזי בקרה באמצעות LookML ולשנות את ההגדרות הכלליות שלהם, כפי שמתואר בדף הזה.

בדף הזה מתוארים הפרמטרים של מרכז השליטה של LookML שמשפיעים על כל מרכז השליטה.

מרכז שליטה של LookML מכיל גם רכיבים, שהם התצוגות החזותיות של הנתונים, משבצות הטקסט, הלחצנים וקבוצות המשבצות במרכז השליטה. בדף Dashboard element parameters יש קישורים לדפי העזר של כל סוג רכיב בלוח הבקרה.

דוגמה לשימוש

- dashboard: dashboard_name
  title: "chosen dashboard title"
  description: "chosen dashboard description"
  enable_viz_full_screen: true | false
  enabled_dashboard_agents: true | false
  default_dashboard_agent: agent_name
  extends: name_of_dashboard_being_extended
  extension: required
  layout: tile | static | grid | newspaper
  tabs:
  - name: Tab 1
    label: Tab 1
  - name: Tab 2
    label: Tab 2
  - name: Tab 3
    label: Tab 3
  - name: Tab 4
    label: Tab 4
  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
    model: model_name
    explore: explore_name
    field: view_name.field_name
    default_value: Looker filter expression
    allow_multiple_values: true | false
    required: true | false
    vis_filter: 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
  tab_name:
  # Optional - for organizing elements onto tabs. Must be declared for each element individually.
  group:
  # Optional - for organizing elements into a tile group. Must be declared for each child element individually.

הגדרות הפרמטרים

שם הפרמטר תיאור
dashboard יוצרים מרכז בקרה.
title (למרכז הבקרה) לשנות את האופן שבו שם מרכז הבקרה מוצג למשתמשים.
description (למרכז הבקרה) מוסיפים תיאור שאפשר לראות בחלונית פרטי מרכז הבקרה או בתיקייה שמוגדרת לתצוגת רשימה.
enable_viz_full_screen להגדיר אם הצופים במרכז הבקרה יכולים לראות את המשבצות של מרכז הבקרה בתצוגה מורחבת ובמסך מלא.
enabled_dashboard_agents להגדיר אם הצופים במרכז הבקרה יכולים להתכתב בצ'אט עם מרכז הבקרה של LookML באמצעות סוכן של מרכז הבקרה.
default_dashboard_agent מציינים את סוכן ברירת המחדל של מרכז הבקרה שבו רוצים להשתמש לשאילתות בממשק שיחה במרכז הבקרה.
extends לבסס את מרכז השליטה של LookML על מרכז שליטה אחר של LookML.
extension צריך להרחיב את מרכז הבקרה באמצעות מרכז בקרה אחר.
layout מגדירים את האופן שבו מרכז הבקרה יציב רכיבים.
tabs נוסף בגרסה 26.4 מוסיף כרטיסיות למרכז הבקרה כדי לארגן את הרכיבים במרכז הבקרה. כדי לציין באיזו כרטיסייה יופיע רכיב, צריך להשתמש בפרמטר הזה בשילוב עם הפרמטר tab_name של הרכיבים.
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 להגדיר את סרגל הסינון של מרכז הבקרה כמכווץ או מורחב כברירת מחדל.
filters_location_top להגדיר את המיקום של סרגל הסינון של מרכז הבקרה כלמעלה או מימין.
filters (למרכז הבקרה) מתחילים קטע של LookML כדי להגדיר מסננים של מרכז הבקרה.
name (למסננים) יוצרים מסנן.
‫title (למסננים) לשנות את האופן שבו שם המסנן מוצג למשתמשים.
type (למסננים) בוחרים את סוג המסנן שרוצים להשתמש בו.
default_value הגדרת ערך ברירת מחדל למסנן.
allow_multiple_values להגביל את המשתמשים לערך מסנן אחד.
required לדרוש מהמשתמשים להזין ערך סינון כדי להריץ את מרכז הבקרה.
ui_config להגדיר את אמצעי הבקרה של המסננים שזמינים למשתמשים כשהם צופים במרכז בקרה של LookML. יש לו את תתי-הפרמטרים type,‏ display ו-options.
model (למסננים) (אופציונלי) מציינים את המודל שמכיל את השדה הבסיסי של מסנן type: field_filter.
‫explore (למסננים) מציינים את ה-Explore שמכיל את השדה הבסיסי של מסנן type: field_filter.
field צריך לציין את השדה הבסיסי של מסנן type: field_filter.
listens_to_filters צמצום ההצעות למסננים של מרכז הבקרה field_filter על סמך מה שהמשתמש מזין למסננים של מרכז בקרה אחר type: field_filter.
vis_filter אפשר להגדיר מסנן שיופיע ישירות במשבצת של התצוגה החזותית במקום בסרגל המסננים של מרכז הבקרה.
פרמטרים של מרכז בקרה מוטמע
embed_style מתחילים קטע של LookML כדי להגדיר התאמות אישיות של מרכז בקרה מוטמע.
background_color הגדרת צבע הרקע של מרכז בקרה מוטמע.
show_title מציינים אם הכותרת של מרכז הבקרה גלויה במרכז בקרה מוטמע.
title_color הגדרת הצבע של הכותרת של מרכז בקרה מוטמע.
show_filters_bar ההגדרה קובעת אם סרגל המסננים יוצג בלוח בקרה מוטמע.
tile_background_color הגדרת צבע הרקע של המשבצת במרכז בקרה מוטמע.
tile_text_color הגדרת צבע הטקסט של המשבצת במרכז בקרה מוטמע.
פרמטרים של רכיבים
elements (למרכז הבקרה) מתחילים קטע של LookML כדי להגדיר רכיבים בלוח הבקרה.
group (לרכיבים) כדי לארגן את הרכיבים בלוח הבקרה בקבוצת משבצות, מציינים את השם של רכיב type: group.

dashboard

הפרמטר dashboard מצהיר על מרכז בקרה חדש ומציין את השם שלו. האורך המקסימלי הוא 255 תווים, והתווים המותרים הם אותיות (A-Z), מספרים (0-9), מקפים (-) וקווים תחתונים (_). בדרך כלל, השיטה המומלצת היא למקם כל מרכז שליטה של LookML בקובץ LookML משלו, אבל אפשר להצהיר על כמה מרכזי שליטה בקובץ אחד.

- dashboard: sales_overview

כדי להציג משהו, צריך להוסיף למרכז הבקרה לפחות רכיב אחד באמצעות הפרמטר elements.

preferred_viewer (הוצאה משימוש)

לפני שהוצאנו משימוש את מרכז הבקרה הקודם ב-Looker 23.6, הפרמטר preferred_viewer אפשר לבחור את הפורמט לצפייה במרכז הבקרה ולהורדה שלו, כממשק מרכז הבקרה שמוגדר כברירת מחדל ב-Looker או כמרכז בקרה קודם.

title (למרכז הבקרה)

הפרמטר title מאפשר לשנות את האופן שבו שם מרכז הבקרה יופיע למשתמשים בתיקיות ובחלק העליון של מרכז הבקרה. אם לא מציינים כותרת, ברירת המחדל היא השם של מרכז הבקרה. אפשר להתאים את טקסט הכותרת לשוק המקומי.

לדוגמה:

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

אם תעשו את זה, במקום שמרכז הבקרה יופיע בתור סקירה כללית של המכירות, הוא יופיע בתור 1) סקירה כללית של המכירות.

description (למרכז הבקרה)

הפרמטר description מאפשר להוסיף תיאור למרכז שליטה של LookML.

התוכן של הפרמטר description יופיע בשדה Description בחלונית Dashboard Details של מרכז שליטה של LookML.

התיאור מוצג מתחת לשם של מרכז הבקרה ברשימות של מרכזי בקרה כשמציגים אותן בתיקייה שמוגדרת לתצוגת רשימה. אם לא צוין תיאור, ברשימה יוצג רק שם מרכז הבקרה.

אפשר להתאים לשוק המקומי את הטקסט של התיאור.

enable_viz_full_screen

הפרמטר הזה משפיע רק כשאדמין ב-Looker מפעיל את ההגדרה תרשימי מסך מלא. ההגדרה תצוגה חזותית במסך מלא מופעלת כברירת מחדל.

הפרמטר enable_viz_full_screen מאפשר להגדיר אם הצופים במרכז הבקרה יכולים לראות את המשבצות של מרכז הבקרה בתצוגה מורחבת ובמסך מלא. היא מקבילה להגדרה Allow full-screen mode for visualizations בלוח הבקרה.

הפרמטר הזה מקבל את הערכים true (תצוגות במסך מלא ותצוגות מורחבות זמינות) ו-false (תצוגות במסך מלא ותצוגות מורחבות לא זמינות). ערך ברירת המחדל הוא true.

enabled_dashboard_agents

הפרמטר enabled_dashboard_agents מאפשר לכם לקבוע אם הצופים במרכז השליטה יכולים להתכתב בצ'אט עם מרכז השליטה של LookML באמצעות סוכן של מרכז השליטה.

הפרמטר הזה פועל רק אם ההגדרה סוכני מרכז הבקרה מופעלת במופע של Looker בדף הניהול של Gemini ב-Looker.

הפרמטר הזה מקבל את הערכים true (הצ'אט מופעל) ו-false (הצ'אט מושבת). אם הפרמטר הזה לא נכלל בקובץ של לוח הבקרה של LookML, ערך ברירת המחדל שלו הוא true בשכבת ה-API.

- dashboard: sales_overview
  enabled_dashboard_agents: true

default_dashboard_agent

הפרמטר default_dashboard_agent מציין את השם של סוכן מרכז הבקרה שמוגדר כברירת מחדל שצריך לשייך למרכז שליטה של LookML. צריך להצהיר על הסוכן שצוין באמצעות הפרמטר agent של LookML.

כשצופים מתחילים שיחה עם מרכז הבקרה, ההגדרות של הנציג שמוגדר כברירת מחדל, כמו מצב חשיבה והצגת מידע על תוצאות ניפוי הבאגים, חלות על השיחה.

- dashboard: sales_overview
  default_dashboard_agent: sales_overview_agent

אם המדיניות enabled_dashboard_agents מוגדרת כ-true והמדיניות default_dashboard_agent לא מוגדרת, המשתמשים עדיין יכולים להתכתב בצ'אט עם מרכז הבקרה באמצעות הגדרות ברירת המחדל, בלי הוראות מותאמות אישית.

extends

כפי שמתואר בדף התיעוד שימוש חוזר בקודים באמצעות extends, הפרמטר extends מאפשר לבסס מרכז שליטה אחד של LookML על מרכז שליטה אחר של LookML, ואולי להוסיף או לשנות הגדרות מסוימות. הפרמטר extends מקבל את השם של מרכז שליטה אחר של LookML.

extension

כפי שמתואר בדף התיעוד שימוש חוזר בקוד עם extends, הפרמטר extension מציין שחובה להרחיב את מרכז הבקרה באמצעות מרכז בקרה אחר. מרכז הבקרה הזה אף פעם לא גלוי למשתמשים אחרים, אבל אפשר להשתמש בו כתבנית ליצירת מרכזי בקרה אחרים שגלויים למשתמשים אחרים. הפרמטר extension מקבל רק את הערך required. אם הפרמטר extension לא נכלל, לא נדרש תוסף למרכז הבקרה.

layout

הפרמטר layout מגדיר את שיטת הפריסה שבה Looker ישתמש כשהוא ימקם רכיבים בלוח הבקרה. אפשר להזין בו את הערכים הבאים:

tabs

מוסיף כרטיסיות לארגון רכיבים במרכזי בקרה. tabs מגדיר את המספר, השמות והתוויות של הכרטיסיות שמופיעות במרכזי הבקרה. הרכיבים מאורגנים בכרטיסיות של מרכז הבקרה באמצעות הפרמטר tab_name.

- dashboard: sales_overview
  layout: tile
  tabs:
  - name: Tab 1
    label: Tab 1
  - name: Tab 2
    label: Tab 2
  - name: Tab 3
    label: Tab 3
  - name: Tab 4
    label: Tab 4

tab_name

מציינת באיזו כרטיסייה בלוח הבקרה יופיע רכיב מסוים. צריך לציין את המאפיין tab_name לכל רכיב בנפרד.

- dashboard: sales_overview
  layout: tile
  tabs:
  - name: Tab 1
    label: Tab 1
  - name: Tab 2
    label: Tab 2
  - name: Tab 3
    label: Tab 3
  - name: Tab 4
    label: Tab 4
  elements:
  - name: order_count
    type: single_value
    model: ecommerce
    explore: orders
    measures: [orders.count]
    tab_name: Tab 1

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

במרכזי בקרה מסוג layout: static, הפרמטר width מגדיר את הרוחב הכולל של מרכז הבקרה שבו אתם מתכננים להשתמש, בפיקסלים. הפרמטר width לא יגביל את מרכז הבקרה לגודל מסוים אם תגדירו רכיב גדול מדי או יותר מדי רכיבים בשורה. במקום זאת, ההגדרה width עוזרת לשמור על מרכז לוח הבקרה במסך. אם לא מגדירים רוחב, ברירת המחדל היא 1,200.

- dashboard: sales_overview
  layout: static
  width: 800

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

הפרמטר 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 מתחיל את הקטע ב-LookML שבו מגדירים מסננים של מרכז הבקרה. המסננים מופיעים בחלק העליון של לוח הבקרה ומאפשרים למשתמשים לשנות את הנתונים שמאחורי הרכיבים בלוח הבקרה.

כדי שמסנן ישפיע על רכיב, צריך להגדיר את הרכיב כך שיגיב למסנן הזה באמצעות הפרמטר listen. הפרמטר הזה רלוונטי לכל סוגי הרכיבים חוץ מ-type: text,‏ type: button ו-type: group. לדוגמה מייצגת לאופן הפעולה של listen, עיין בדף מאמרי העזרה פרמטרים של תרשים עמודות אנכי במרכזי שליטה של LookML.

כשמחילים מסננים על רכיב בצורה הזו, סוג המסנן חייב להתאים לסוג המאפיין או המדד שמאזין למסנן (פרטים נוספים זמינים במאמר יצירת מרכזי שליטה של LookML).

המסננים נראים כך:

filters:
- name: filter_name
  title: "chosen filter title"
  type: field_filter | number_filter | date_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
  vis_filter: true | false
  listens_to_filters:
  - filter_name
    field: view_name.field_name

name

כל הצהרת name יוצרת מסנן חדש של מרכז הבקרה ומקצה לו שם. השם יופיע בפרמטר listen של רכיבים שיושפעו מהמסנן. הפרמטר listen חל על כל סוגי הרכיבים מלבד type: text,‏ type: button ו-type: group, ופרטים על השימוש בו מופיעים בדפי התיעוד של כל סוג תצוגה חזותית בנפרד. בדף התיעוד פרמטרים של תרשים עמודות אנכי במרכזי שליטה של LookML מופיעה דוגמה מייצגת לאופן הפעולה של listen.

filters:
- name: order_date

title (למסננים)

הפרמטר title מאפשר לשנות את האופן שבו שם המסנן יופיע למשתמשים בחלק העליון של מרכז הבקרה. אם לא מציינים כותרת, ברירת המחדל היא שם המסנן.

לדוגמה:

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

אם תעשו את זה, במקום שהמסנן יופיע בתור תאריך ההזמנה, הוא יופיע בתור תאריכי ההזמנה.

type

הפרמטר type מציין את סוג הקלט שיוצב במסנן. בדרך כלל, type: field_filter צריכה להיות ברירת המחדל, כי היא מקשרת את המסנן ישירות למאפיין או למדד בסיסיים ומספקת למשתמש ווידג'ט מסנן מותאם אישית. אלה סוגי המסננים:

  • field_filter: בדרך כלל זו צריכה להיות ברירת המחדל, כשאתם יכולים לציין מאפיין או מדד בסיסיים. אם משתמשים ב-type: field_filter ומשייכים את המסנן לשדה type:string, המסנן יציע ערכי סינון אפשריים.
  • ‫number_filter: מאפשר למשתמש להזין מספר, ערך של מספר שלם או ביטוי.
  • ‫date_filter: מאפשר למשתמש להזין ערך תאריך או ביטוי.

  • ‫string_filter (הוצא משימוש): הסוג string_filter כבר לא נתמך מאז שהממשק של מרכז הבקרה הקודם הוצא משימוש ב-Looker 23.6 (מידע נוסף זמין בהערות המוצר). אם רוצים מסנן להזנת טקסט חופשי בלי רשימה נפתחת של הצעות, אפשר לעיין בדוגמה לשימוש ב-field_filter.

field_filter

ההצעה של האפשרויות לבחירה והאופן שבו הן מוצגות למשתמשים משתנים בהתאם לשדה הבסיסי שאתם מציינים.

זהו סוג המסנן המומלץ במצבים שבהם אתם רוצים להציע הצעות למשתמשים בזמן שהם מקיימים אינטראקציה עם המסנן. המאפיין שממנו יישלפו ההצעות מוגדר באמצעות הפרמטרים explore ו-field, והוא חייב להיות שדה של type: string כדי ליצור הצעות לסינון.

יכול להיות שההצעות לא יפעלו אם השדה מגיע מטבלה נגזרת, אם נעשה שימוש ב-sql_always_where ב-Explore או אם השדה הוא מדד.

הדוגמה הבאה היא של LookML לסוג field_filter:

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

אם רוצים מסנן קלט של טקסט חופשי בלי רשימה נפתחת של הצעות, משתמשים ב-type: field_filter ואז מגדירים את סוג הפקד באמצעות ui_config: type: advanced (ראו הגדרת ממשק המשתמש).

בדוגמה הבאה מוצג מסנן שמשתמש בקלט טקסט חופשי ללא הצעות:

filters:
- name: customer_name
  type: field_filter
  explore: orders
  field: customer.name
  ui_config:
    type: advanced

number_filter

לא מוצגות הצעות, והמשתמש יכול להזין ערך או ביטוי של מספר שלם או מספר.

filters:
- name: order_value
  type: number_filter

date_filter

לא מוצגות הצעות, והמשתמש יכול להזין ערך או ביטוי של תאריך.

filters:
- name: order_date
  type: date_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: field_filter
  explore: orders
  field: customer.name
  default_value: "John Doe"

אפשר להשתמש בביטויי סינון כדי ליצור ערכי ברירת מחדל. בדף העזרה בנושא ביטויי סינון ב-Looker מופיע מידע נוסף.

כשמשתמשים גם בפרמטר default_value וגם בפרמטר ui_config, ביטויי הסינון צריכים להתאים לערך שניתן לתת-הפרמטר type של ui_config ולסוגי הנתונים שתומכים בערך type.

אפשר גם להשתמש במשתני ה-Liquid‏ _localization ו-_user_attributes כדי להגדיר ערכי ברירת מחדל גמישים למסננים.

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

תת-הפרמטר ui_config של filters מאפשר לקבוע את הגדרות הסינון של מרכז שליטה של 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

תת-הפרמטר type של ui_config מאפשר לציין את סוגי פקדי הסינון שמוצגים.

בהתאם לערך שמזינים בשדה 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 בשדות מספריים, המסנן מציג פס הזזה שמאפשר למשתמשים להגדיר טווח של מספרים כערך של המסנן. תת-הפרמטרים min ו-max של options משמשים כדי לציין את הערכים המינימליים והמקסימליים האפשריים של המסנן, ואפשר לציין את טווח ברירת המחדל באמצעות הפרמטר 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 המסנן מאפשר למשתמשים לבחור תאריך התחלה ותאריך סיום כדי לסנן לפי טווח תאריכים. תאריך ושעה אפשר להשתמש בפקד טווח התאריכים עם רוב מסגרות הזמן והסוגים שמבוססים על זמן, אבל הצופים יכולים לבחור רק את טווחי התאריכים שיש להם פקד מהסוג הזה.
date_time_range_input המסנן מאפשר למשתמש לסנן לפי טווח של תאריכים ושעות. תאריך ושעה אפשר להשתמש בפקד של טווח התאריכים והשעות עם רוב הסוגים שמבוססים על זמן, והצופים חייבים לבחור גם את אפשרויות התאריך וגם את אפשרויות השעה בסוג הפקד הזה.
relative_timeframes המסנן מאפשר למשתמש לסנן לפי טווח תאריכים בהתאמה אישית או לבחור מתוך מסגרות זמן מוגדרות מראש, כמו היום, 7 הימים האחרונים או 90 הימים האחרונים. תאריך ושעה אפשר להשתמש בפקד מסגרת הזמן עם רוב מסגרות הזמן והסוגים שמבוססים על זמן, אבל הצופים לא יכולים לבחור אפשרויות זמן עם פקד מהסוג הזה.
אחר
advancedהמסנן מציג אפשרויות להחלת מסנן אחד או יותר או מסננים של התאמות מתקדמות.

מידע נוסף על אמצעי בקרה מתקדמים זמין בקטע שימוש באמצעי בקרה מתקדמים בדף הזה. 		STR NUM TIER ZIP Y/N D&T DIST DUR LOC PAR

display

אפשר להשתמש בתת-הפרמטר display של ui_config כדי להגדיר את המיקום של מסנן מרכז הבקרה. כדי למקם מסנן, מקצים אחד מהערכים הבאים ל-display:

  • ‫inline: המסנן מוצג ישירות בסרגל העליון של לוח הבקרה.
  • ‫popover: ערך סיכום מופיע בסרגל העליון של לוח הבקרה. לוחצים על הערך כדי לראות את המסנן המלא.
  • ‫overflow: הלחצן עוד מופיע בסרגל העליון של מרכז הבקרה עם אינדיקטור מספרי של מספר המסננים הנוספים. המשתמשים יכולים ללחוץ על הלחצן כדי לראות את המסננים הנוספים ואת הערכים שלהם.

יש סוגי מסננים שאפשר להציג רק בדרכים מסוימות. לדוגמה, מסננים של type: day_picker יכולים להופיע רק בתור inline או overflow. אם תתנו למסנן ערך display שלא תקין ל-type, המסנן יוצג בתור inline או popover, בהתאם לערך התקין. מידע נוסף זמין בדף התיעוד הוספה ועריכה של מסננים בלוחות בקרה בהגדרת המשתמש.

למידע על מיקום מסננים של לוח הבקרה באמצעות ממשק המשתמש, ראו את דף התיעוד הוספה ועריכה של מסננים בהגדרת המשתמש.

options

תת-הפרמטר האופציונלי options של ui_config מאפשר לציין את הערכים שהמשתמש יכול לבחור מהם כדי לעדכן באופן זמני את ערכי המסננים של מרכז שליטה כשהמשתמשים צופים במרכז שליטה של LookML. אם לא מציינים ערכים ל-options, Looker שולף את הערכים הראשונים ממסד הנתונים.

לדוגמה, אפשר להגדיר את San Francisco,‏ New York ו-Tokyo כערכים האפשריים של מסנן בשדה users.city באופן הבא:


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

אם תת-הפרמטר type של ui_config מוגדר כ-range_slider או כ-slider, אפשר להשתמש בתת-הפרמטרים min ו-max של options:

  • ‫min: הגדרת הערך המינימלי האפשרי למסנן.
  • ‫max: הגדרת הערך המקסימלי האפשרי למסנן.

לדוגמה:


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

model

במסננים של מרכז הבקרה של type: field_filter, הפרמטר model מגדיר את המודל של השדה שבו רוצים להשתמש. הפרמטר model הוא אופציונלי, וברירת המחדל שלו היא המודל שבו נכלל מרכז הבקרה.

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

explore

במסננים של לוח הבקרה מסוג type: field_filter, צריך להגדיר שדה שממנו המסנן ישלוף הצעות. הפרמטר explore מציין איזה 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

vis_filter

הפרמטר vis_filter מאפשר להגדיר מסנן כמסנן ברמת התצוגה החזותית שמופיע ישירות במשבצות של תצוגות חזותיות ספציפיות, במקום בסרגל המסננים העליון של מרכז הבקרה.

כשהפרמטר vis_filter מוגדר לערך true, המסנן מופיע בסרגל המסננים בחלק העליון של כל משבצת שמושפעת ממנו (מוגדר באמצעות הפרמטר listen ברכיב בלוח הבקרה). ערך ברירת המחדל הוא false, והוא מציג את המסנן כמסנן רגיל ברמת מרכז הבקרה בסרגל המסננים העליון. ההגדרה vis_filter: false לא נחוצה למסננים רגילים של מרכז הבקרה.

לדוגמה:

filters:
- name: order_date
  title: "Order Date"
  type: date_filter
  default_value: "last 30 days"
  vis_filter: true

מידע נוסף על מסננים ברמת התצוגה החזותית זמין בדף התיעוד מסננים במשבצות של תצוגות חזותיות.

embed_style

הפרמטר embed_style מתחיל את הקטע של LookML שבו מתאימים אישית את המראה של לוח בקרה מוטמע. הפרמטר embed_style והפרמטרים שמשויכים אליו נתמכים רק במרכזי בקרה מוטמעים, והמערכת מתעלמת מהם אם מרכז הבקרה לא מוטמע.

אחרי שמבצעים שינויים ב-embed_style, צריך לפרוס את LookML בסביבת הייצור כדי לראות את ההגדרות של embed_style במרכז השליטה המוטמע של LookML.

במאפיינים הבאים של מרכז הבקרה המוטמע שמציינים צבע, ערך הצבע יכול להיות מחרוזת הקסדצימלית כמו #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

הפרמטר elements מתחיל את הקטע ב-LookML שבו מגדירים את הרכיבים שירכיבו את מרכז הבקרה. יש הרבה פרמטרים שיכולים להגדיר את המראה של רכיב בלוח הבקרה. הם מתוארים בפירוט בדף פרמטרים של רכיבים בלוח הבקרה.

- dashboard: sales_overview
  layout: tile
  tabs:
  - name: Tab 1
    label: Tab 1
  - name: Tab 2
    label: Tab 2
  - name: Tab 3
    label: Tab 3
  elements:
  - name: order_count
    type: single_value
    model: ecommerce
    explore: orders
    measures: [orders.count]
    tab_name: Tab 1

group

מארגן את רכיבי לוח הבקרה בקבוצת משבצות במרכז שליטה של LookML. כדי להשתמש בקבוצות של משבצות במרכז בקרה של LookML, האדמין ב-Looker צריך להפעיל את התכונה Dashboard Tile Groups בגרסת טרום-השקה (Preview), ומרכז הבקרה צריך להשתמש בשיטת הפריסה של מרכז הבקרה newspaper.

כדי ליצור קבוצת משבצות ולהוסיף לה אלמנטים ב-LookML, מבצעים את השלבים הבאים:

  1. מגדירים קונטיינר של קבוצת משבצות בקטע elements באמצעות type: group, ומציינים את name, title, row, col, width ו-height (ואם רוצים, גם את tab_name, title_hidden ו-aria_description). רכיבים של type: group הם קונטיינרים חזותיים ולא מקבלים פרמטרים של שאילתה כמו model, explore או listen.
  2. בכל רכיב בלוח הבקרה שרוצים להציב בתוך קבוצת המשבצות, מוסיפים את הפרמטר group ומגדירים את הערך שלו ל-name של הרכיב type: group.

כשמארגנים רכיבים בקבוצת משבצות, חשוב לזכור את הנקודות הבאות:

  • לרכיבים שנמצאים בתוך קבוצת משבצות, הפרמטרים row ו-col מגדירים את מיקום הרכיב ביחס לפינה השמאלית העליונה (row: 0, col: 0) של מאגר הקבוצה, ולא של לוח הבקרה.
  • במרכזי בקרה עם כרטיסיות, הערך של tab_name של רכיב צאצא חייב להתאים לערך של tab_name של קבוצת ההורה.
  • ‫Looker לא תומך בקבוצות של משבצות בתצוגת עץ (הצבת רכיב type: group בתוך קבוצה אחרת של משבצות).
- dashboard: sales_overview
  layout: newspaper
  elements:
  - name: revenue_metrics_group
    title: "Revenue Metrics"
    type: group
    row: 0
    col: 0
    width: 24
    height: 8
  - name: total_revenue
    title: "Total Revenue"
    type: single_value
    model: ecommerce
    explore: orders
    measures: [orders.total_revenue]
    group: revenue_metrics_group
    row: 0
    col: 0
    width: 8
    height: 6