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

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

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

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

דוגמה לשימוש

- 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.

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

שם הפרמטר	תיאור
dashboard	יוצרים לוח בקרה.
title (למרכז הבקרה)	שינוי האופן שבו שם לוח הבקרה מוצג למשתמשים.
description (למרכז הבקרה)	להוסיף תיאור שאפשר לראות בחלונית הפרטים של לוח הבקרה או בתיקייה שמוגדרת לתצוגת רשימה.
enable_viz_full_screen	הגדרת האפשרות לצופים במרכז הבקרה לראות את המשבצות של מרכז הבקרה בתצוגות במסך מלא ובתצוגות מורחבות.
enabled_dashboard_agents [תצוגה מקדימה]	ההגדרה קובעת אם הצופים בלוח הבקרה יכולים לנהל צ'אט עם סוכן לוח הבקרה במרכז השליטה של LookML.
default_dashboard_agent [תצוגה מקדימה]	מציינים את הסוכן שמוגדר כברירת מחדל במרכז הבקרה לשימוש בשאילתות בממשק שיחה במרכז הבקרה.
extends	להתבסס על מרכז שליטה אחר של 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 (למסננים)	מציינים את הניתוח שכולל את השדה הבסיסי של 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 כדי להגדיר רכיבים של לוח בקרה.

dashboard

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

- dashboard: sales_overview

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

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

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 יופיע בשדה Description בחלונית Dashboard Details של מרכז שליטה של LookML.

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

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

enable_viz_full_screen

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

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

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

enabled_dashboard_agents

תצוגה מקדימה

השימוש במוצר או בתכונה כפוף לתנאי השימוש במוצרים בגרסת טרום-GA, בחלק "תנאים כלליים לשירות" של התנאים הספציפיים לשירות. השימוש בתכונות ובמוצרים בגרסת טרום-GA הוא "כפי שהם" (As is), ויכול להיות שהתמיכה בהם תהיה מוגבלת. מידע נוסף זמין בקטע תיאור שלבי ההשקה.

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

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

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

- dashboard: sales_overview
  enabled_dashboard_agents: true

default_dashboard_agent

תצוגה מקדימה

השימוש במוצר או בתכונה כפוף לתנאי השימוש במוצרים בגרסת טרום-GA, בחלק "תנאים כלליים לשירות" של התנאים הספציפיים לשירות. השימוש בתכונות ובמוצרים בגרסת טרום-GA הוא "כפי שהם" (As is), ויכול להיות שהתמיכה בהם תהיה מוגבלת. מידע נוסף זמין בקטע תיאור שלבי ההשקה.

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

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

- dashboard: sales_overview
  default_dashboard_agent: sales_overview_agent

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

extends

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

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

extension

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

layout

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

• ‫newspaper: רכיבי לוח הבקרה יופיעו ברשת של 24 עמודות. גודל ברירת המחדל של רכיב הוא רוחב של 8 עמודות וגובה של 6 שורות. אפשר להגדיר את הרכיבים לאורך הרשת הזו באמצעות פרמטרים של רכיבים: width, height, row ו-col. אפשרות הפריסה הזו משמשת כשלוח בקרה בהגדרת המשתמש מומר למרכז שליטה של LookML, והיא גם פריסת ברירת המחדל כשיוצרים מרכז שליטה חדש של LookML דרך Looker IDE. בנוסף, newspaper ו-grid הם הפריסות היחידות שתומכות בהמרת לוח בקרה של LookML ללוח בקרה בהגדרת המשתמש.

• ‫grid: רוחב הרכיבים בלוח הבקרה יהיה דינמי, על סמך קבוצה של שורות שמגדירים באמצעות הפרמטר rows ותתי הפרמטרים שלו elements ו-height. הפריסות newspaper ו-grid הן היחידות שתומכות בהמרת מרכז שליטה של LookML ללוח בקרה בהגדרת המשתמש.

• ‫static: רכיבים של לוח בקרה יופיעו בסדר שבו הם מופיעים בקובץ LookML. צריך למקם כל רכיב בלוח הבקרה באופן ידני באמצעות הפרמטרים top ו-left. הפרמטרים האלה חלים על כל סוגי הרכיבים, ופרטים על השימוש בהם מופיעים בדפי התיעוד של כל סוג של תרשים. דוגמאות מייצגות לאופן הפעולה של top ו-left מופיעות בדף התיעוד בנושא פרמטרים של תרשימי עמודות אנכיים ללוחות בקרה של LookML. ‫static לא תומך בהמרת מרכז שליטה של LookML ללוח בקרה בהגדרת המשתמש.

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

tabs

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

חשוב: לוחות בקרה עם כרטיסיות נתמכים רק בשיטת הפריסה של לוח הבקרה newspaper.

- 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

הערה: הקטע הזה מתייחס לפרמטר width שהוא חלק מלוח בקרה.

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

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

- 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.

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

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

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

אפשר להשתמש ב-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: 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 בניתוח, או אם השדה הוא מדד.

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

הערה: הערכים ש-type תומך בהם תלויים בנתוני LookML‏ type שמוקצים לשדה שמסננים.

‫STR = תואם לסוג הנתונים string	‫DIST = תואם לסוג הנתונים distance
‫NUM = תואם לסוג הנתונים number ולמדדים מספריים	‫DUR = תואם לסוג הנתונים duration
‫TIER = תואם לסוג הנתונים tier	‫D&T = תואם לרוב סוגי הנתונים של תאריך ושעה
‫ZIP = תואם לסוג הנתונים zipcode	‫LOC = תואם לסוג הנתונים location
‫Y/N = תואם לסוג הנתונים 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	המסנן מאפשר למשתמשים לבחור תאריך מסוים לסינון.	תאריך ושעה אפשר להשתמש באמצעי הבקרה של יום אחד עם רוב מסגרות הזמן והסוגים שמבוססים על זמן, אבל הצופים יכולים לבחור רק תאריכים בודדים עם סוג הבקרה הזה.
day_range_picker	המסנן מאפשר למשתמשים לבחור תאריך התחלה ותאריך סיום כדי לסנן לפי טווח תאריכים. הערה: כשמטעינים לוח בקרה של LookML באמצעות סימנייה בדפדפן, פקדי סינון שמוגדרים עם type: day_range_picker לא שומרים ומציגים בצורה נכונה את פרמטרים של כתובת URL ואת מצב הסינון (לדוגמה, תאריך הסיום מוזז ביום אחד בממשק המשתמש). כדי לפתור את הבעיה של התצוגה הלא עקבית, צריך לעדכן את הגדרת המסנן ב-LookML ולשנות את הסוג ui_config ל-advanced. מקרה לדוגמה: ui_config: type: advanced display: inline	תאריך ושעה אפשר להשתמש באמצעי הבקרה של טווח התאריכים עם רוב מסגרות הזמן והסוגים שמבוססים על זמן, אבל הצופים יכולים לבחור רק את טווחי התאריכים שיש להם את סוג הבקרה הזה.
date_time_range_input	המסנן מאפשר למשתמש לסנן לפי טווח של תאריכים ושעות.	תאריך ושעה אפשר להשתמש באמצעי הבקרה של טווח התאריכים והשעות עם רוב הסוגים שמבוססים על זמן, והצופים צריכים לבחור גם תאריך וגם שעה באמצעות אמצעי הבקרה הזה.
relative_timeframes	המסנן מאפשר למשתמש לסנן לפי טווח תאריכים מותאם אישית או לבחור מתוך הגדרות קבועות מראש של תקופות זמן, כמו היום, 7 הימים האחרונים או 90 הימים האחרונים.	תאריך ושעה אפשר להשתמש באמצעי הבקרה של מסגרת הזמן עם רוב מסגרות הזמן והסוגים שמבוססים על זמן, אבל הצופים לא יכולים לבחור אפשרויות זמן עם סוג הבקרה הזה.
אחר
advanced	במסנן מוצגות אפשרויות להחלת מסנן אחד או יותר של מסננים או של התאמות מתקדמות. מידע נוסף על אמצעי בקרה מתקדמים זמין בקטע שימוש באמצעי בקרה מתקדמים בדף הזה.	STR NUM TIER ZIP Y/N D&T DIST DUR LOC PAR

הערה: כש-Looker יוצר אפשרויות בקרה עבור מסגרות זמן וסוגים מבוססי-זמן מסוימים, הוא מפרש אותם כסוגי נתונים שונים. שתי דוגמאות הן yesno מסגרת הזמן, שמפורשת כyesno סוג נתונים ולכן תומכת בערכים שנתמכים על ידי הסוג yesno, וhour_of_day מסגרת הזמן, שמפורשת כnumber סוג נתונים ולכן תומכת בערכים שנתמכים על ידי הסוג number.

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

הערה: הקטע הזה מתייחס לפרמטר explore שהוא חלק ממסנן ללוח בקרה.

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

אפשר להשתמש ב-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 שהוא חלק מ-dashboard.

אפשר להשתמש ב-elements גם כחלק משורה בלוח בקרה, כמו שמתואר בקטע 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

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