פרמטרים של תרשים טבלה (מדור קודם) עבור לוחות מחוונים של LookML

בדף הזה מוסבר איך להוסיף ולהתאים אישית רכיב בלוח הבקרה של LookML‏ type: table באמצעות פרמטרים של מרכז שליטה של LookML בקובץ dashboard.lkml.

מידע על יצירת תרשים טבלה (גרסה קודמת) דרך ממשק המשתמש של Looker זמין בדף אפשרויות של תרשים טבלה (גרסה קודמת).

דוגמה לשימוש

## BASIC PARAMETERS
name: element_name
title: 'Element Title'
type: looker_table
height: N
width: N
top: N
left: N
row: N
col: N
refresh: N (seconds | minutes | hours | days)
note:
  text: 'note text'
  state: collapsed | expanded
  display: above | below | hover

## QUERY PARAMETERS
model: model_name
explore: explore_name
dimensions: [view_name.field_name, view_name.field_name, …]
measures: [view_name.field_name, view_name.field_name, …]
sorts: [view_name.field_name asc | desc, view_name.field_name, …]
pivots: [view_name.field_name, view_name.field_name, …]
limit: N
column_limit: N
filters:
  view_name.field_name: 'Looker filter expression' | 'filter value'
listen:
  dashboard_filter_name: dimension_or_measure_name
query_timezone: 'specific timezone' | user_timezone
merged_queries:
- 'primary query definition'
- 'next source query definition'
  join_fields:
  - field_name: view_name.field_name
    source_field_name: view_name.field_name

## PLOT PARAMETERS
table_theme: editable | white | gray | transparent | unstyled
total: true | false
row_total: right | left | false
show_row_numbers: true | false
hide_totals: true | false
hide_row_totals: true | false
hidden_fields: [view_name.field_name, view_name.field_name, …]
limit_displayed_rows: true | false
limit_displayed_rows_values:
  show_hide: show | hide
  first_last: first | last
  num_rows: 'N'

## SERIES PARAMETERS
truncate_column_names: true | false
show_view_names: true | false
series_labels:
  view_name.field_name: desired series label

## FORMATTING PARAMETERS
enable_conditional_formatting: true | false
conditional_formatting_include_totals: true | false
conditional_formatting_include_nulls: true | false
conditional_formatting:
  {'desired conditional formatting'}

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

שם הפרמטר	תיאור
פרמטרים בסיסיים
name (לרכיבים)	יצירת רכיב
title (לרכיבים)	שינוי האופן שבו שם של רכיב מוצג למשתמשים
type (לרכיבים)	קובע את סוג התצוגה החזותית שתשמש ברכיב
height (לרכיבים)	המאפיין מגדיר את הגובה של רכיב ביחידות של tile_size בלוחות בקרה של layout: tile ושל layout: static
width (לרכיבים)	המאפיין מגדיר את הרוחב של רכיב ביחידות של tile_size בלוחות בקרה מסוג layout: tile ו-layout: static
top	המאפיין הזה מגדיר את המיקום מלמעלה למטה של רכיב ביחידות של tile_size בלוחות בקרה של layout: static
left	המאפיין מגדיר את המיקום של רכיב משמאל לימין ביחידות של tile_size בלוחות בקרה של layout: static
row	המאפיין הזה מגדיר את המיקום של רכיב מלמעלה למטה ביחידות של שורות בלוחות בקרה של layout: newspaper
col	המאפיין מגדיר את המיקום של רכיב משמאל לימין ביחידות של עמודות בלוחות בקרה של layout: newspaper
refresh (לרכיבים)	מגדירה את מרווח הזמן שבו הרכיב יתעדכן באופן אוטומטי
note	מתחיל קטע של LookML כדי להגדיר הערה לרכיב. לפרמטר הזה יש פרמטרים משניים: text,‏ state ו-display.
פרמטרים של שאילתה
model	הגדרת המודל שישמש לשאילתה של הרכיב
explore (לרכיבים)	הגדרת הניתוח שישמש לשאילתה של הרכיב
dimensions	הגדרת המימדים שישמשו לשאילתה של הרכיב
measures	הגדרת המדדים שישמשו לשאילתה של הרכיב
sorts	הגדרת המיון שישמש לשאילתה של הרכיב
pivots	הגדרת המאפיינים שצריך להפוך כדי להשתמש בהם בשאילתה של הרכיב
limit	הגדרת מגבלת השורות שתשמש לשאילתה של הרכיב
filters (לרכיבים)	המאפיין מגדיר את המסננים שאי אפשר לשנות בשאילתה של הרכיב
listen	המאפיין מגדיר את המסננים שאפשר לשנות בשאילתה של הרכיב, אם נוצרו filters (בשביל לוח הבקרה)
query_timezone	הגדרת אזור הזמן שבו יש להשתמש כשמריצים את השאילתה
merged_queries	הגדרת שאילתה של תוצאות ממוזגות
פרמטרים של תרשים
table_theme	החלת אחת מחמש אפשרויות צביעה של טבלה על תצוגה חזותית של טבלה
total	ההגדרה הזו קובעת אם יוצגו סיכומים של עמודות בתצוגה חזותית של טבלה.
row_total	הגדרה של הצגת סיכומים של שורות בתצוגה חזותית של טבלה
show_row_numbers	הגדרה של הצגת מספר שורה בתחילת כל שורה בטבלה
hide_totals	הגדרה שקובעת אם בתצוגה חזותית של טבלה יוצגו סכומים כוללים של עמודות
hide_row_totals	הגדרה של האפשרות להצגת סכומים של שורות בתצוגה חזותית של טבלה
hidden_fields	מציין שדות לשימוש בשאילתה אבל להסתרה בתרשים
limit_displayed_rows	הצגה או הסתרה של שורות בתרשים לפי המיקום שלהן בתוצאות
limit_displayed_rows_values	הגדרה של השורות שיוצגו או יוסתרו בתצוגה חזותית. לפרמטר הזה יש את פרמטרי המשנה show_hide,‏ first_last ו-num_rows.
פרמטרים של סדרות
truncate_column_names	קיצור כותרות העמודות באמצעות שלוש נקודות (…)
show_view_names	השם של התצוגה מופיע לצד שם השדה בכל כותרת של עמודה
series_labels	מציינים תווית מותאמת אישית לכל עמודה בתרשים
פרמטרים של עיצוב
enable_conditional_formatting	הגדרה ל-true כדי להגדיר כללים לקידוד צבעים בתצוגה חזותית של טבלה
conditional_formatting_include_totals	מציין אם הסכומים הכוללים כלולים בסכמת קידוד הצבעים
conditional_formatting_include_nulls	מציין אם ערכי null צריכים להיות מיוצגים כאפס
conditional_formatting	התג conditional_formatting והפרמטרים המשניים שלו משמשים להגדרת הכללים שלפיהם מוקצים צבעים לטבלת הוויזואליזציה.

פרמטרים בסיסיים

כשמגדירים רכיב של לוח בקרה ב-LookML, צריך לציין ערכים לפחות לפרמטרים name ו-type. פרמטרים בסיסיים אחרים כמו title,‏ height ו-width משפיעים על המיקום והמראה של רכיב בלוח הבקרה.

name

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

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

כל הצהרה של name יוצרת רכיב בלוח הבקרה חדש ומקצה לו שם. שמות הרכיבים צריכים להיות ייחודיים. לפעמים יש הפניה לשמות בפרמטר elements כשמשתמשים בלוחות בקרה של layout: grid.

- name: orders_by_date

title

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

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

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

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

דוגמה:

- name: sales_overview
  title: '1) Sales Overview'

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

type

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

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

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

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

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

הפרמטר type קובע את סוג התצוגה החזותית שתשמש ברכיב.

- name: element_name
  type: text | looker_grid | table | single_value | looker_single_record |
        looker_column | looker_bar | looker_scatter | looker_line | looker_area |
        looker_pie | looker_donut_multiples | looker_funnel | looker_timeline |
        looker_map | looker_google_map | looker_geo_coordinates | looker_geo_choropleth | looker_waterfall | looker_wordcloud | looker_boxplot

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

height

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

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

למרכזי בקרה עם פריסות tile או static

הפרמטר height מגדיר את הגובה של רכיב ביחידות של tile_size (שמוגדר בפיקסלים), עבור לוחות בקרה של layout: tile ושל layout: static.

לדוגמה, הקוד הבא מציין את הערכים tile_size: 100 ו-height: 4, כך שהגובה של רכיב orders_by_date יהיה 400 פיקסלים.

- dashboard: sales_overview
  tile_size: 100
  ...

  elements:
  - name: orders_by_date
    height: 4
    ...

למרכזי בקרה עם פריסה של newspaper

הפרמטר height מגדיר את הגובה של רכיב, ביחידות של שורה, בלוחות בקרה של layout: newspaper.

גובה ברירת המחדל של רכיב בלוח בקרה עם פריסה של עיתון הוא 6 שורות, או בערך 300 פיקסלים. הגובה המינימלי הוא שורה אחת ללוחות בקרה עם פרמטר preferred viewer שהערך שלו הוא dashboards-next. הגובה המינימלי הוא 2 שורות ללוחות בקרה עם פרמטר preferred viewer שהערך שלו הוא dashboards.

לדוגמה, הקוד הבא מגדיר את הגובה של רכיב מסוים ל-12 שורות, כלומר פי שניים מהגובה של רכיבים אחרים שמוגדרים כברירת המחדל:

- dashboard: sales_overview
  layout: newspaper
  ...

  elements:
  - name: orders_by_date
    height: 12
    ...

width

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

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

הפרמטר width מגדיר את הרוחב של אלמנט ביחידות של tile_size, עבור לוחות בקרה של layout: tile ושל layout: static.

לדוגמה, הקוד הבא מציין tile_size: 100 ו-width: 4, כך שהרוחב של רכיב orders_by_date יהיה 400 פיקסלים.

- dashboard: sales_overview
  tile_size: 100
  ...

  elements:
  - name: orders_by_date
    width: 4
    ...

הפרמטר width מגדיר את הרוחב של אלמנט ביחידות של עמודות, בלוחות בקרה של layout: newspaper.

רוחב ברירת המחדל של לוח בקרה עם פריסה של עיתון הוא 24 עמודות.

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

- dashboard: sales_overview
  layout: newspaper
  ...

  elements:
  - name: orders_by_date
    width: 12
    ...

top

הפרמטר top מגדיר את המיקום של רכיב מלמעלה למטה, ביחידות של tile_size, בלוחות בקרה של layout: static.

לדוגמה, הקוד הבא מציין את הערכים tile_size: 100 ו-top: 4, וממקם את הקצה העליון של רכיב orders_by_date במרחק של 400 פיקסלים מהחלק העליון של מרכז הבקרה.

- dashboard: sales_overview
  tile_size: 100
  ...

  elements:
  - name: orders_by_date
    top: 4
    ...

left

הפרמטר left מגדיר את המיקום של רכיב משמאל לימין, ביחידות של tile_size, בלוחות בקרה של layout: static.

לדוגמה, הקוד הבא מציין את tile_size: 100 ו-left: 4, וממקם את הקצה השמאלי של רכיב orders_by_date במרחק של 400 פיקסלים מהצד השמאלי של לוח הבקרה.

- dashboard: sales_overview
  tile_size: 100
  ...

  elements:
  - name: orders_by_date
    left: 4
    ...

row

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

לוח בקרה מתחיל בשורה 0 בחלק העליון של לוח הבקרה. בלוח בקרה עם פריסה של עיתון, גובה הרכיב הוא כברירת מחדל 6 שורות, כלומר הרכיבים בלוח הבקרה בחלק העליון של לוח הבקרה (row: 0) יתפסו כברירת מחדל את השורות 0 עד 5.

גובה כל שורה הוא 50 פיקסלים, כלומר גובה ברירת המחדל של רכיב עם 6 שורות הוא 300 פיקסלים.

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

- dashboard: sales_overview
  layout: newspaper
  ...

  elements:
  - name: orders_by_date
    row: 6
    ...

col

במקרה של לוחות בקרה מסוג layout: newspaper, הפרמטר col מגדיר את העמודה שבה ממוקם הקצה השמאלי של האלמנט.

לוחות הבקרה מחולקים ל-24 עמודות. מרכז הבקרה מתחיל בעמודה 0 בצד ימין של מרכז הבקרה. לוח בקרה עם פריסת עיתון מוגדר כברירת מחדל לרוחב של 8 עמודות לרכיב, כלומר רכיבי לוח הבקרה בצד ימין של לוח הבקרה (col: 0) יתפסו כברירת מחדל את עמודות 0 עד 7.

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

- dashboard: sales_overview
  layout: newspaper
  ...

  elements:
  - name: orders_by_date
    col: 16
    ...

refresh

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

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

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

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

- name: orders_by_date
  refresh: 2 hours

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

note

אפשר להוסיף הערות תיאוריות לרכיבים באופן הבא:

- name: element_name
  note:
    text: 'note text'
    state: collapsed | expanded
    display: above | below | hover

לפרמטר note יש את הפרמטרים המשניים text, state ו-display.

text

פרמטר המשנה text מציין את הטקסט שמוצג בהערה. אפשר להתאים את הטקסט לשוק המקומי.

state

פרמטר המשנה state קובע אם ההערה תהיה collapsed או expanded אם היא גדולה מדי ולא נכנסת לשורה אחת ברוחב של הרכיב. אם תבחרו באפשרות collapsed וההערה ארוכה מדי, היא תסתיים בשלוש נקודות (...) שאפשר ללחוץ עליהן כדי לקרוא את ההערה המלאה.

display

תת-הפרמטר display קובע איפה ההערה מוצגת ברכיב. ‫above ממקם את ההערה בחלק העליון של רכיב, below ממקם אותה בחלק התחתון של רכיב, ו-hover מחייב את המשתמש להעביר את העכבר מעל הרכיב כדי לראות את ההערה.

פרמטרים של שאילתה

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

model

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

- name: orders_by_date
  model: ecommerce

הפרמטר model מקבל קבועים של LookML. אפשר להגדיר קבוע בקובץ המניפסט של הפרויקט, ואז להשתמש בתחביר "@{constant_name}" כדי להגדיר את הקבוע כערך של model. שימוש בקבוע מאפשר להגדיר את השם של מודל במקום אחד, וזה שימושי במיוחד אם מעדכנים את השם של מודל שמשמש כמה רכיבים בלוח הבקרה.

מידע נוסף ודוגמה לשימוש בקבועים בלוחות בקרה של LookML זמינים בדף התיעוד של הפרמטר constant.

explore

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

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

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

הפרמטר explore מגדיר את ה-Explore שבו יש להשתמש בשאילתת הרכיב.

- name: orders_by_date
  explore: order

הפרמטר explore מקבל קבועים של LookML. אפשר להגדיר קבוע בקובץ המניפסט של הפרויקט, ואז להשתמש בתחביר "@{constant_name}" כדי להגדיר את הקבוע כערך של explore. שימוש בקבוע מאפשר לכם להגדיר את השם של ניתוח במיקום אחד, וזה שימושי במיוחד אם אתם מעדכנים את השם של ניתוח שמשמש כמה רכיבים בלוח הבקרה.

מידע נוסף ודוגמה לשימוש בקבועים בלוחות בקרה של LookML זמינים בדף התיעוד של הפרמטר constant.

dimensions

הפרמטר dimensions מגדיר את המאפיין או המאפיינים שבהם יש להשתמש בשאילתת הרכיב. כדי לציין את המאפיין, משתמשים בתחביר view_name.dimension_name. אם אין לשאילתה פרמטרים, אל תכללו את dimensions.

## single dimension example
- name: orders_by_date
  dimensions: order.order_date

## multiple dimension example
- name: orders_by_date
  dimensions: [order.order_date, customer.name]

measures

הפרמטר measures מגדיר את המדד או המדדים שבהם יש להשתמש בשאילתת הרכיב. משתמשים בתחביר view_name.measure_name כדי לציין את המידה. אם אין לשאילתה פרמטרים, אל תכללו את measures.

## single measure example
- name: orders_by_date
  measures: order.count

## multiple measure example
- name: orders_by_date
  measures: [order.count, order_item.count]

sorts

הפרמטר sorts מגדיר את אופן המיון של השאילתה של הרכיב. מציינים קודם את שדה המיון הראשי ואז את שדות המיון המשניים. משתמשים בתחביר view_name.field_name כדי לציין את המאפיין או המדד שלפיו רוצים למיין.

אם לא מציינים את הפרמטר sorts, הרכיב משתמש בסדר המיון שמוגדר כברירת מחדל ב-Looker. במיון בסדר עולה לא צריך להוסיף סיומת, אבל במיון בסדר יורד צריך להוסיף את הסיומת desc.

בדוגמה הבאה מוגדר מיון יחיד:

- name: orders_by_date
  sorts: order.order_date desc

בדוגמה הבאה מוגדרות כמה מיון:

- name: orders_by_date
  sorts: [order.order_date desc, customer.name]

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

- name: orders_by_category
  sorts: [orders.count desc 0]

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

- name: orders_by_cohort
  sorts: [users.count desc 2]

pivots

הפרמטר pivots מגדיר את המאפיינים שצריך להפוך בשאילתת האלמנט. כדי לציין את המאפיין, משתמשים בתחביר view_name.dimension_name. אם אין לשאילתה פרמטרים, אל תכללו את pivots.

## single pivot example
- name: orders_by_date
  pivots: customer.gender

## multiple pivot example
- name: orders_by_date
  pivots: [customer.gender, customer.age_tier]

limit

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

- name: orders_by_date
  limit: 100

filters

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

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

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

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

התחביר של filters הוא:

- name: element_name
  filters:
    orders.created_date: 2020/01/10 for 3 days
    orders.status: Shipped
    # You can create multiple filter statements

כל מסנן יכול לקבל ביטוי מסנן של Looker או קבוע ערך. אפשר גם להשתמש במשתני Liquid‏ _localization או _user_attributes בביטוי המסנן כדי לקבל ערכי מסנן גמישים.

listen

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

התחביר של listen הוא:

- name: element_name
  listen:
    filter_name_goes_here: dimension or measure on which to apply
                           the filter using view_name.field_name syntax
    # You can add more than one listen statement

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

- dashboard: sales_overview
  ...

  filters:
  - name: date
    type: date_filter

  elements:
 - name: orders_by_date
    listen:
      date: order.order_date
    ...

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

query_timezone

הפרמטר query_timezone מציין את אזור הזמן שבו תופעל השאילתה. אפשרויות אזור הזמן מפורטות בדף התיעוד ערכים של timezone. אם רוצים שהשאילתה תפעל לפי אזור הזמן של הצופה, אפשר להקצות את הערך user_timezone.

- name: orders_by_date
  query_timezone: America/Los Angeles

- name: orders_by_customer
  query_timezone: user_timezone

merged_queries

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

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

- name: merged_results_element
  title: Merged Results Tile
  type: looker_grid
  merged_queries:
  - model: ecommerce
    explore: users
    type: table
    fields: [users.state, users.count, users.city]
    sorts: [users.count desc 0]
    limit: 5000
    column_limit: 50
    query_timezone: UTC
    listen:
    - State: users.state
  - model: ecommerce
    explore: users
    type: table
    fields: [users.state, users.city]
    sorts: [users.state]
    limit: 500
    column_limit: 50
    query_timezone: UTC
    join_fields:
    - field_name: users.state
      source_field_name: users.state
    - field_name: users.city
      source_field_name: users.city
    listen:
    - State: users.state

בדוגמה הזו, רכיב לוח הבקרה משלב נתונים משתי שאילתות מקור שמבוססות על מודל users Explore ב-ecommerce. השאילתה הראשית כוללת את השדות users.state, users.count ו-users.city, והיא ממיינת את התוצאות לפי השדה users.count. שאילתת המקור השנייה כוללת את השדות users.state ו-users.city, והתוצאות ממוינות לפי השדה users.state.

הפרמטר join_field ממזג את שאילתות המקור על סמך ערכים תואמים בשדות users.state ו-users.city.

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

דוגמה: מיזוג נתוני חברה

נניח שרוצים ליצור שאילתה משולבת שכוללת מידע על חברות משני ניתוחים שונים: company_info ו-companies. אתם רוצים לצרף את השאילתות בשדות ipo.stock_symbol,‏ companies.name ו-companies.contact_email מכל ניתוח כדי ליצור שאילתה שמחזירה תוצאות לגבי שם החברה, כתובת האימייל של איש הקשר בחברה, שנת ההנפקה הראשונית, סימול המניה, מספר העובדים ומספר המשרות. אפשר להגדיר את רכיב השאילתה הממוזגת ב-LookML באופן הבא:

- name: merged_results_element
  title: Merged Results Tile
  merged_queries:
  - model: market_research
    explore: company_info
    fields: [companies.name, companies.contact_email, ipo.public_year, ipo.stock_symbol]
    filters:
      companies.contact_email: "-NULL"
      ipo.valuation_amount: NOT NULL
    sorts: [ipo.public_year desc]
  - model: company_data
    explore: companies
    fields: [companies.name, ipo.stock_symbol, companies.contact_email,
      companies.number_of_employees, jobs.job_count]
    filters:
      companies.number_of_employees: NOT NULL
      ipo.stock_symbol: "-NULL"
      companies.contact_email: "-NULL"
    sorts: [jobs.job_count desc]
    join_fields:
    - field_name: ipo.stock_symbol
      source_field_name: ipo.stock_symbol
    - field_name: companies.name
      source_field_name: companies.name
    - field_name: companies.contact_email
      source_field_name: companies.contact_email

החלת מסננים על רכיבי שאילתה שמוזגו

בדוגמה הקודמת של רכיב שאילתה שמוזג אפשר לראות איך להחיל מסננים עם קידוד קשיח ישירות בכל שאילתת מקור באמצעות הפרמטר filters. לדוגמה, המסננים companies.contact_email: "-NULL" ו-ipo.valuation_amount: NOT NULL בשאילתה הראשית מגבילים את התוצאות לחברות שיש להן כתובות אימייל תקפות ליצירת קשר ושווי שוק. המסננים האלה ברמת השאילתה מסננים מראש את הנתונים לפני מיזוג השאילתות, והמשתמש לא יכול לשנות אותם.

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

filters:
- name: Industry
  title: Industry
  type: field_filter
  ui_config:
    type: dropdown_menu
    display: inline
  model: market_research
  explore: company_info
  field: companies.industry

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

listen:
  Industry: companies.industry

לדוגמה, קוד לדוגמה הבא מוסיף את המסנן Industry לשתי שאילתות המקור ברכיב התוצאות הממוזגות מהדוגמה הקודמת.

- name: merged_results_element
  title: Merged Results Tile
  merged_queries:
  - model: market_research
    explore: company_info
    fields: [companies.name, companies.contact_email, ipo.public_year, ipo.stock_symbol]
    filters:
      companies.contact_email: "-NULL"
      ipo.valuation_amount: NOT NULL
    sorts: [ipo.public_year desc]
    listen:
      Industry: companies.industry
  - model: company_data
    explore: companies
    fields: [companies.name, ipo.stock_symbol, companies.contact_email,
      companies.number_of_employees, jobs.job_count]
    filters:
      companies.number_of_employees: NOT NULL
      ipo.stock_symbol: "-NULL"
      companies.contact_email: "-NULL"
    sorts: [jobs.job_count desc]
    join_fields:
    - field_name: ipo.stock_symbol
      source_field_name: ipo.stock_symbol
    - field_name: companies.name
      source_field_name: companies.name
    - field_name: companies.contact_email
      source_field_name: companies.contact_email
    listen:
      Industry: companies.industry

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

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

פרמטרים של תרשים

הפרמטרים הבאים תואמים לאפשרויות שבקטע Plot בעורך הוויזואליזציה של תרשימי טבלה (גרסה קודמת).

table_theme

משתמשים בפרמטר table_theme כדי להחיל על רכיב טבלה אחת מאפשרויות הצביעה הבאות של הטבלה:

• ‫editable: המאפיינים בטבלה מוצגים בכחול, המדדים בכתום והחישובים בטבלה בירוק.
• ‫white: הכותרת של הטבלה לבנה, שורות הנתונים מתחלפות בין לבן לאפור והטקסט שחור.
• ‫gray: כותרת הטבלה אפורה, שורות הנתונים מתחלפות בין לבן לאפור בהיר, והטקסט אפור כהה.
• ‫transparent: כותרת הטבלה שקופה לחלוטין, שורות הנתונים מתחלפות בין שקופות לחלוטין לבין אפור שקוף למחצה, וצבע הטקסט משתנה משחור ללבן לפי הצורך בהתאם לצבע הרקע שמופיע. הגדרת table_theme ל-transparent יכולה להיות שימושית כשמשתמשים בלוח בקרה מוטמע בהתאמה אישית, כדי שצבע הרקע של המשבצת יופיע בהמחשה.
• ‫unstyled: הכותרת של הטבלה ושורות הנתונים לבנות, והטקסט שחור.

table_theme: editable | white | gray | transparent | unstyled

total

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

total: true | false

## default value: false

row_total

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

row_total: right | left | false

## default value: false

show_row_numbers

הפרמטר show_row_numbers מגדיר אם יוצג מספר שורה בתחילת כל שורה בטבלה.

show_row_numbers: true | false

hide_totals

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

hide_totals: true | false

hide_row_totals

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

hide_row_totals: true | false

hidden_fields

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

hidden_fields: [inventory_items.count, distribution_centers.id]

limit_displayed_rows

הפרמטר limit_displayed_rows מאפשר להציג או להסתיר שורות בתרשים, על סמך המיקום שלהן בתוצאות. לדוגמה, אם בתרשים שלכם מוצג ממוצע נע ל-7 ימים, יכול להיות שתרצו להסתיר את 6 השורות הראשונות. הגדרת הערך true מאפשרת לציין את הערכים והמיקומים בתרשים שאליהם ההגדרה הזו חלה באמצעות הפרמטר limit_displays_rows_values ופרמטרי המשנה שלו.

limit_displayed_rows: true
limit_displayed_rows_values:
  show_hide: hide | show
  first_last: first | last
  num_rows: '10'

limit_displayed_rows_values

משתמשים בפרמטר limit_displayed_rows_values ובפרמטרים המשניים שלו show_hide,‏ first_last ו-num_rows עם limit_displayed_rows כדי לציין אילו שורות להציג או להסתיר בתרשים. דוגמאות לשימוש מופיעות בקטע limit_displayed_rows.

show_hide

תת-הפרמטר show_hide מגדיר אם להסתיר שורות מסוימות מהתרשים להמחשה. מגדירים את show_hide ל-show כדי להציג רק מספר מוגבל של שורות בתצוגה החזותית, ומגדירים את show_hide ל-hide כדי להחריג שורות מסוימות מהתצוגה החזותית.

first_last

פרמטר המשנה first_last מגדיר אם השורות שיוסתר או יוצגו יהיו השורות הראשונות או האחרונות בקבוצת התוצאות. אם מגדירים את first_last ל-first, השורות הראשונות מוצגות או מוסתרות, ואם מגדירים את first_last ל-last, השורות האחרונות מוצגות או מוסתרות.

num_rows

פרמטר המשנה num_rows מגדיר את מספר השורות שיוסתר או יוצג. לדוגמה, num_rows: '10' יציג או יסתיר את 10 השורות הראשונות או האחרונות של קבוצת התוצאות מההדמיה.

פרמטרים של סדרה

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

truncate_column_names

הפרמטר truncate_column_names קובע אם לקצר את הכותרות של העמודות באמצעות שלוש נקודות (...).

truncate_column_names: true | false

show_view_names

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

show_view_names: true | false

## default value: true

series_labels

מגדירים את התוויות של סדרה אחת או יותר על סמך שם הסדרה, באמצעות צמדי name: label.

בתרשים ציר, שמות הסדרות הם שמות הציר.

series_labels:
  'Yes': iOS Users
  'No': Android Users

בתרשים עם כמה מדדים, שמות הסדרות הם שמות השדות של המדדים.

series_labels:
  inventory_items.count: Inventory
  orders.count: Orders

עיצוב פרמטרים

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

enable_conditional_formatting

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

enable_conditional_formatting: true | false

conditional_formatting_include_totals

אם הערך של enable_conditional_formatting הוא true, המדיניות conditional_formatting_include_totals מציינת אם הסכומים הכוללים כלולים בסכמת קידוד הצבעים.

conditional_formatting_include_totals: true | false

conditional_formatting_include_nulls

אם הערך של enable_conditional_formatting מוגדר כ-true, הערך של conditional_formatting_include_nulls מציין אם ערכים ריקים צריכים להיות מיוצגים כאפסים.

conditional_formatting_include_nulls: true | false

conditional_formatting

אם הפרמטר enable_conditional_formatting מוגדר לערך true, משתמשים בפרמטר conditional_formatting כדי להגדיר את הכללים שלפיהם יוצגו הצבעים בתרשים של הטבלה. לכל כלל של עיצוב מותנה, אפשר לציין הגדרות באמצעות הפרמטרים הבאים:

• type
• value
• background_color
• font_color
• color_application
• bold
• italic
• strikethrough
• fields

דוגמה לכלל של עיצוב מותנה:

conditional_formatting: [{type: less than, value: 20, background_color: "#9fdee0",
  font_color: "#b15928", bold: true, italic: false, strikethrough: false,
  fields: [order_items.count], color_application: {collection_id: my-custom-colors,
  palette_id: my-custom-colors-sequential-0}}]

type

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

אם אתם מקודדים ערכים לפי צבעים בסולם, אתם יכולים להגדיר את type ל-along a scale....

אם אתם מקודדים ערכים לפי צבעים על סמך תנאי לוגי, אתם יכולים לציין אחד מהערכים הבאים במאפיין type, יחד עם ערך במאפיין value:

• equal to: הכלל חל על ערכים ששווים למספר שצוין עבור value.
• ‫not equal to: הכלל חל על ערכים שלא שווים למספר שצוין עבור value.
• ‫greater than: הכלל חל על ערכים שגדולים מהמספר שצוין ב-value.
• ‫less than: הכלל חל על ערכים שקטנים מהמספר שצוין במאפיין value.
• ‫between: הכלל חל על ערכים שנמצאים בין שני המספרים שצוינו ב-value.
• ‫not between: הכלל חל על ערכים שלא נמצאים בין שני המספרים שצוינו עבור value.
• ‫'null': הכלל חל רק על ערכי null.
• ‫not null: הכלל חל רק על ערכים שהם לא null.

type: along a scale... | equal to | not equal to | less than | between | not between | 'null' | not null

value

אם אתם מקצים צבעים לערכים על סמך תנאי לוגי שאינו 'null' או not null, צריך לציין את הערך שאליו הכלל חל. הפרמטר value מקבל מספר אחד, או אם הפרמטר type מוגדר לערך between או not between, הוא מקבל שני מספרים.

value: N | [N, N]

background_color

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

background_color: "#49cec1"

font_color

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

font_color: "#1f3e5a"

color_application

אפשר להשתמש בפרמטר color_application ובפרמטרים המשניים שלו collection_id,‏ palette_id ו-options כדי להחיל אוסף ופלטה ספציפיים של צבעים על כלל של עיצוב מותנה.

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

אפשר להשתמש בפרמטר המשנה options אם הגדרתם את type לערך along a scale.... הוא כולל את הפרמטרים המשניים הבאים:

• ‫steps: הפרמטר הזה מגביל את מספר הצבעים שמשמשים לערך שניתן, ומפריד את הנתונים למספר הקבוצות הזה. אם לא משתמשים בפרמטר הזה, הנתונים נצבעים לפי מעבר צבעים שכולל את כל הפלטה. אפשר להזין בו ערכים מ-2 עד 100.
• ‫mirror: כשהערך שלו מוגדר כ-true, הפרמטר הזה מחיל שינויי צבע שווים משני הצדדים של פלטת הצבעים עבור ערכים שווים משני הצדדים של נקודת מרכז מוגדרת. אפשר להזין בו את הערך true או false.
• ‫constraints: הפרמטר הזה מגדיר את טווח הנתונים שהעיצוב המותנה חל עליו, ומגדיר נקודת מרכז שתשמש להחלת פלטה. התחביר הבא מתקבל: constraints: {min: {type: number, value: 3}, max: {type: percentile, value: 99}, mid: {type: average}}
• ‫reverse: הפרמטר הזה קובע אם להפוך את לוח הצבעים במהלך החלת הצבע. אפשר להזין בו את הערך true או false.

bold

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

bold: true | false

italic

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

italic: true | false

strikethrough

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

strikethrough: true | false

fields

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

fields: [ view_name.field_name ]