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

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

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

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

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

enable_viz_full_screen

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

• ‫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 ללוח בקרה בהגדרת המשתמש.

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). המסננים מופיעים בפורמט הבא:

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, ביטויי הסינון צריכים להיות תואמים לערך שמועבר לתת-הפרמטר 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	המסנן מאפשר למשתמשים לבחור תאריך מסוים לסינון.	D&T אפשר להשתמש באמצעי הבקרה של יום אחד עם רוב מסגרות הזמן והסוגים שמבוססים על זמן, אבל הצופים יכולים לבחור רק תאריכים בודדים עם סוג הבקרה הזה.
day_range_picker	המסנן מאפשר למשתמשים לבחור תאריך התחלה ותאריך סיום כדי לסנן לפי טווח תאריכים.	D&T אפשר להשתמש באמצעי הבקרה של טווח התאריכים עם רוב מסגרות הזמן והסוגים שמבוססים על זמן, אבל הצופים יכולים לבחור טווחי תאריכים רק עם סוג הבקרה הזה.
date_time_range_input	המסנן מאפשר למשתמש לסנן לפי טווח של תאריכים ושעות.	תאריך ושעה: אפשר להשתמש באמצעי הבקרה של טווח התאריכים והשעות עם רוב הסוגים שמבוססים על זמן, והצופים צריכים לבחור גם תאריך וגם שעה כשמשתמשים בסוג כזה של אמצעי בקרה.
relative_timeframes	המסנן מאפשר למשתמש לסנן לפי טווח תאריכים מותאם אישית או לבחור מתוך הגדרות קבועות מראש של תקופות זמן, כמו היום, 7 הימים האחרונים או 90 הימים האחרונים.	תאריך ושעה אפשר להשתמש באמצעי הבקרה של מסגרת הזמן עם רוב מסגרות הזמן והסוגים שמבוססים על זמן, אבל הצופים לא יכולים לבחור אפשרויות זמן עם סוג הבקרה הזה.
אחר
advanced	במסנן מוצגות אפשרויות להחלת מסנן אחד או יותר של מסננים או של התאמות מתקדמות. מידע נוסף על אמצעי בקרה מתקדמים זמין בקטע שימוש באמצעי בקרה מתקדמים בדף הזה.	STR NUM TIER ZIP Y/N D&T DIST DUR LOC PAR

הערה: כש-Looker יוצר אפשרויות שליטה עבור מסגרות זמן וסוגים שמבוססים על זמן, הוא מפרש אותם כסוגי נתונים שונים. שתי דוגמאות הן yesno timeframe, שמתפרש כyesno data type ולכן תומך בערכים שנתמכים על ידי הסוג yesno, ו-hour_of_day timeframe, שמתפרש כnumber data type ולכן תומך בערכים שנתמכים על ידי הסוג 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 מציין באיזה מודל נמצא השדה שרוצים להשתמש בו.

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

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
  elements:
  - name: order_count
    type: single_value
    model: ecommerce
    explore: orders
    measures: [orders.count]

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