פרמטרים של תרשים Boxplot ללוחות בקרה של LookML

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

מידע על יצירת תרשים Boxplot דרך ממשק המשתמש של Looker זמין בדף התיעוד אפשרויות של תרשים Boxplot.

דוגמה לשימוש

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

## BASIC PARAMETERS
name: element_name
title: 'Element Title'
type: looker_boxplot
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
fields: [view_name.field_name, view_name.field_name, view_name.field_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, …]
limit: N
filters:
  view_name.field_name: 'looker filter expression'
listen:
  dashboard_filter_name: view_name.field_name
query_timezone: 'specific timezone' | user_timezone
hidden_fields: [view_name.field_name, view_name.field_name, …]

## SERIES PARAMETERS

color_application:
  collection_id: 'collection ID'
  palette_id: 'palette ID'
  options:
    reverse: true | false

## STYLE PARAMETERS

show_view_names: true | false

## X-AXIS PARAMETERS

show_x_axis_label: true | false
x_axis_label: 'desired x-axis label'
show_x_axis_ticks: true | false
x_axis_gridlines: true | false
x_axis_reversed: true | false
x_axis_zoom: true | false

## Y-AXIS PARAMETERS

show_y_axis_labels: true | false
y_axis_labels: ['desired y-axis label']
show_y_axis_ticks: true | false
y_axis_gridlines: true | false
y_axis_min: ['N']
y_axis_max: ['N']
y_axis_tick_density: default | custom
y_axis_tick_density_custom: 'N'
y_axis_reversed: true | false
y_axis_value_format: ['Excel-style formatting']
y_axis_zoom: true | false

## ADVANCED VISUALIZATION CONFIGURATION PARAMETERS
advanced_vis_config: 'Highcharts JSON snippet'

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

שם הפרמטר	תיאור
פרמטרים בסיסיים
‫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 (לרכיבים)	הגדרת הניתוח בכלי הניתוחים שישמש לשאילתה של הרכיב
fields	הגדרת השדות שישמשו לשאילתה של הרכיב. אפשר להשתמש ב-dimensions במקום ב-measures וב-measures.
dimensions	הגדרת המאפיינים שישמשו לשאילתה של הרכיב
measures	הגדרת המדדים שישמשו לשאילתה של הרכיב
sorts	הגדרת המיון שישמש לשאילתה של הרכיב
limit	הגדרת מגבלת השורות שתשמש לשאילתה של הרכיב
‫filters (לרכיבים)	הגדרת המסננים שאי אפשר לשנות בשאילתה של הרכיב
listen	המאפיין מגדיר את המסננים שאפשר לשנות בשאילתה של הרכיב, אם נוצרו filters (ללוח בקרה)
query_timezone	הפרמטר הזה מגדיר את אזור הזמן שבו צריך להשתמש כשמריצים את השאילתה
hidden_fields	מציינים את השדות שרוצים להשתמש בהם בשאילתה אבל להסתיר בתרשים
פרמטרים של סדרות
color_application	החלת אוסף צבעים ולוח צבעים על התרשים
פרמטרים של סגנון
show_view_names	הצגה או הסתרה של שמות התצוגות בתוויות של התרשים
פרמטרים של ציר X
show_x_axis_label	הצגה או הסתרה של התווית של ציר ה-X
x_axis_label	הגדרת תווית מותאמת אישית לציר ה-X
show_x_axis_ticks	הצגת ערכים בציר ה-X
x_axis_gridlines	הארכת קווי הרשת מציר ה-X
x_axis_reversed	הופך את הכיוון של ציר ה-x
x_axis_zoom	המדיניות קובעת אם מותר לבצע זום לאורך ציר ה-x
פרמטרים של ציר Y
show_y_axis_labels	הצגה או הסתרה של התווית של ציר ה-Y
y_axis_labels	הגדרה של תווית מותאמת אישית לציר Y
show_y_axis_ticks	הצגת ערכים בציר ה-Y
y_axis_gridlines	הארכת קווי הרשת מציר ה-y
y_axis_min	הגדרת ערך מינימלי לציר ה-Y
y_axis_max	הגדרת ערך מקסימלי לציר Y
y_axis_tick_density	הפרמטר y_axis_tick_density_custom מאפשר להגדיר צפיפות מותאמת אישית של סימוני יחידות בציר ה-Y
y_axis_tick_density_custom	ההגדרה הזו קובעת את צפיפות הסימונים בציר ה-Y כש-y_axis_tick_density מוגדר ל-custom
y_axis_reversed	הופך את הכיוון של ציר ה-y
y_axis_value_format	הגדרת פורמט המספרים של הערכים בציר ה-Y
y_axis_zoom	המדיניות קובעת אם מותר לבצע זום לאורך ציר ה-Y. האפשרות מושבתת אם x_axis_zoom: false.
פרמטרים מתקדמים להגדרת ויזואליזציה
advanced_viz_config	מקבל קטע JSON של HighCharts שיכול לבטל כמה הגדרות של ויזואליזציה

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

כשמגדירים רכיב של לוח בקרה ב-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.

בנוסף, ברכיבים של type: looker_boxplot צריך לציין לפחות מאפיין אחד ושניים, שלושה או חמישה מהסוגים הבאים של מדדים (שצריך לציין בסדר הזה):

• מינימום: מדד שמייצג את ערך הנתונים המינימלי. אפשר להגדיר את זה ב-LookML כמדד של type: min.
• אחוזון 25: מדד שמייצג את האחוזון ה-25, או את הרבעון הראשון. רבע מערכי הנתונים קטנים מהערך הזה או שווים לו. אפשר להגדיר את זה ב-LookML כמדד של type: percentile עם הערך של percentile שמוגדר ל-25.
• חציון: מדד שמייצג את החציון או את נקודת האמצע של מערך הנתונים, או את הרבעון השני. מחצית מערכי הנתונים קטנים מהערך הזה או שווים לו. אפשר להגדיר את זה ב-LookML כמדד של type: median.
• אחוזון 75: מדד שמייצג את האחוזון ה-75, או את הרבעון השלישי. שלושה רבעים מערכי הנתונים קטנים מהערך הזה או שווים לו. אפשר להגדיר את זה ב-LookML כמדד של type: percentile עם הערך של percentile שמוגדר ל-75.
• מקסימום: מדד שמייצג את הערך המקסימלי. אפשר להגדיר את זה ב-LookML כמדד של type: max.

אפשר להשתמש בפרמטר fields או בשני הפרמטרים dimensions ו-measures כדי לציין את המאפיינים והמדדים שעליהם מבוסס רכיב התרשים מסוג boxplot. מידע נוסף על יצירת תרשים boxplot בממשק המשתמש של Looker זמין בקטע יצירת תרשים boxplot בדף התיעוד אפשרויות של תרשים boxplot.

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

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.

fields

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

## single field example
- name: orders_by_date
  fields: order.order_date

## multiple fields example
- name: orders_by_date
  fields: [order.order_date, order.order_count]

אם משתמשים בפרמטר fields, אין צורך להשתמש בפרמטרים dimensions ו-measures.

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]

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

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

דוגמאות נוספות לשימוש בפרמטר 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

hidden_fields

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

hidden_fields: [inventory_items.count, distribution_centers.id]

פרמטרים של סדרות

color_application

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

אם יש לכם את מזהה האוסף ואת מזהה הפלטה של הפלטה שבה אתם רוצים להשתמש, אתם יכולים להזין את המזהים האלה לפרמטרים המשניים collection_id ו-palette_id. מזהה אוסף או מזהה פלטה יכולים להיות קוד אלפאנומרי או להתבסס על השם של אוסף הצבעים. קודים אלפאנומריים משמשים לאוספים המקוריים של Looker. הם ספציפיים למופע ונראים כך:

color_application:
  collection_id: 1297dk12-86a7-4xe0-8dfc-82de20b3806a
  palette_id: 93c8aeb7-3f8a-4ca7-6fee-88c3617516a1

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

color_application:
  collection_id: blue-tone-collection
  palette_id: blue-tone-collection-categorical-0

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

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

color_application:
  collection_id: blue-tone-collection
  palette_id: blue-tone-collection-categorical-0
  options:
    reverse: true

פרמטרים של סגנון

show_view_names

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

show_view_names: true | false

## default value: true

פרמטרים של ציר X

show_x_axis_label

הפרמטר הזה קובע אם תוצג תווית בציר X.

show_x_axis_label: true | false

## default value: true

x_axis_label

הפרמטר הזה מציין תווית לציר ה-x. אפשר להשתמש בפרמטר הזה כש-show_x_axis_label מוגדר ל-true.

x_axis_label: Order Date

show_x_axis_ticks

הפרמטר הזה קובע אם תוויות הערכים מוצגות על ציר ה-X.

show_x_axis_ticks: true | false

## default value: true

x_axis_gridlines

הפרמטר הזה קובע אם קווי הרשת יורחבו מציר ה-X.

x_axis_gridlines: true | false

## default value: false

x_axis_reversed

הפרמטר הזה מגדיר את הכיוון של ציר ה-X. כשמגדירים את x_axis_reversed לערך false, הערכים גדלים משמאל לימין. אם הערך הוא true, הערכים יורדים משמאל לימין.

x_axis_reversed: true | false

x_axis_zoom

הפרמטר הזה מציין אם המשתמשים יכולים להגדיל את התצוגה של ציר ה-x בתרשים. כש-x_axis_zoom מוגדר ל-true, אפשר להשתמש בהגדלה. כשמגדירים את x_axis_zoom לערך false, אי אפשר לשנות את מרחק התצוגה.

אם המדיניות x_axis_zoom מוגדרת לערך false, האפשרות y_axis_zoom מושבתת.

x_axis_zoom: true | false

# default value: true

פרמטרים של ציר Y

show_y_axis_labels

הפרמטר הזה קובע אם התוויות מוצגות בציר Y.

show_y_axis_labels: true | false

## default value: true

y_axis_labels

הפרמטר הזה מציין תווית לציר ה-Y. אפשר להשתמש בפרמטר הזה כש-show_y_axis_labels מוגדר ל-true.

y_axis_labels: ['label']

show_y_axis_ticks

הפרמטר הזה קובע אם הערכים מוצגים בציר ה-Y.

show_y_axis_ticks: true | false

## default value: true

y_axis_gridlines

הפרמטר הזה קובע אם קווי הרשת יורחבו מציר ה-y.

y_axis_gridlines: true | false

## default value: true

y_axis_min

הפרמטר הזה מגדיר את הערך המינימלי של ציר ה-y.

y_axis_min: ['10']

## default value: true

y_axis_max

הפרמטר הזה מגדיר את הערך המקסימלי של ציר ה-Y.

y_axis_max: ['100']

## default value: true

y_axis_tick_density

הפרמטר הזה מאפשר להגדיר את צפיפות הסימונים בציר ה-Y. מגדירים את הערך y_axis_tick_density ל-custom כדי להפעיל את התכונה הזו, ואז משתמשים בפרמטר y_axis_tick_density_custom כדי להגדיר את הצפיפות.

y_axis_tick_density: default | custom

## default value: default

y_axis_tick_density_custom

הפרמטר הזה מאפשר להגדיר את צפיפות הסימונים בציר ה-Y, אם y_axis_tick_density מוגדר ל-custom. הפונקציה מקבלת מספר שלם שמייצג את מספר הסימונים שרוצים להציג.

y_axis_tick_density_custom: 10

## default value: 5

y_axis_reversed

הפרמטר הזה מגדיר את הכיוון של ציר ה-Y. כשמגדירים את y_axis_reversed לערך false, הערכים גדלים ככל שעולים בציר. כשמגדירים את הערך true, הערכים יורדים ככל שמתרחקים מראשית הציר.

## y_axis_reversed: true | false

# default value: false

y_axis_value_format

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

הערך שמציינים לפרמטר y_axis_value_format צריך להיות מוקף במירכאות כפולות:

y_axis_value_format: "*00#.00"

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

אלה כמה מאפשרויות העיצוב הנפוצות ביותר:

פורמט הערך	משמעות
#	מספר שלם (123)
*00#	מספר שלם עם אפסים מובילים עד 3 ספרות (001)
0.##	מספר עם עד 2 ספרות אחרי הנקודה העשרונית (1. או 1.2 או 1.23)
0.00	מספר עם בדיוק 2 ספרות אחרי הנקודה העשרונית (1.23)
*00#.00	מספר עם אפסים מובילים עד 3 מקומות ועם 2 ספרות אחרי הנקודה העשרונית (01.23)
#,###	מספר עם פסיק בין אלפים (1,234)
#,##0.00	מספר עם פסיק בין אלפים ו-2 ספרות אחרי הנקודה העשרונית (1,234.00)
0.000,," M"	מספר במיליונים עם 3 ספרות אחרי הנקודה העשרונית (1.234 מיליון). החלוקה ב-1,000,000 מתבצעת באופן אוטומטי.
$#	דולרים עם 0 ספרות עשרוניות (‎$123)
$0.00	דולרים עם 2 ספרות אחרי הנקודה העשרונית (‎$123.00)
$#,##0.00	דולרים עם פסיק בין אלפים ו-2 ספרות אחרי הנקודה העשרונית (‎$1,234.00)
#%	אחוז עם 0 ספרות אחרי הנקודה העשרונית (1%). הכפלה ב-100 מתבצעת באופן אוטומטי.
0.00%	אחוז עם 2 ספרות אחרי הנקודה העשרונית (1.00%). הכפלה ב-100 מתבצעת באופן אוטומטי.
0.00\%	אחוז עם 2 ספרות אחרי הנקודה העשרונית (1.00%). הכפלה ב-100 לא מתבצעת באופן אוטומטי.

y_axis_zoom

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

אם y_axis_zoom מוגדר כ-false, המשתמשים לא יכולים להגדיל חלקים קטנים יותר בציר ה-y. עם זאת, יכול להיות שהמשתמשים עדיין יוכלו להגדיל חלקים קטנים יותר של ציר ה-x אם הפרמטר x_axis_zoom מוגדר לערך true.

אם x_axis_zoom מוגדר לערך false, ‏ y_axis_zoom מושבת.

y_axis_zoom: true | false

# default value: true

הגדרות מתקדמות של תרשימים להמחשה

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

advanced_vis_config

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

advanced_vis_config: "{ series: [{ formatters: [{ select: 'value >= 50', style: { color: 'orange' } }]}]}"

# This example changes the color to orange for any series value that is greater than or equal to 50.

# default value: null