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

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

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

דוגמה לשימוש

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

## QUERY PARAMETERS
model: model_name
explore: explore_name
fields: [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, …]
pivots: [view_name.field_name, view_name.field_name, …]
fill_fields: [view_name.field_name, view_name.field_name, …]
subtotals: [view_name.field_name, view_name.field_name, …]
total: true | false
row_total: right | left | false
limit: N
column_limit: N
filters:
  view_name.field_name: 'Looker filter expression' | 'filter value'
filter_expression:  'Looker custom filter expression'
listen:
  dashboard_filter_name: view_name.field_name
query_timezone: 'specific timezone' | user_timezone
analysis_config: # can only be used when the Forecasting Labs feature is enabled
  forecasting:
  - confidence_interval: N
    field_name: view_name.field_name
    forecast_n: N
    forecast_interval: day | month | a time frame with dimension fill
    seasonality: N
merged_queries:
- 'primary query definition'
- 'next source query definition'
  join_fields:
  - field_name: view_name.field_name
    source_field_name: view_name.field_name

## COLUMN PARAMETERS
auto_size_all_columns: true | false
column_order: [view_name.field_name, view_name.field_name, …]
pinned_columns:
    view_name.field_name: left

## PLOT PARAMETERS
table_theme: editable | white | gray | transparent | unstyled
show_row_numbers: true | false
hide_totals: true | false
hide_row_totals: true | false
transpose: 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_text: true | false
show_view_names: true | false
size_to_fit: true | false
dynamic_fields:
- table_calculation: {'table calculation definition'}
- measure: {'custom measure or custom filtered measure definition'}
- dimension: {'custom dimension definition'}
series_labels:
    view_name.field_name: 'Series Label'
series_column_widths:
    view_name.field_name: N
series_cell_visualizations:
    view_name.field_name:
        is_active: true | false
        palette:
            palette_id: 'palette ID'
            collection_id: 'collection ID'
            custom_colors:
            - 'color value'
        value_display: true | false
series_text_format:
    view_name.field_name:
        fg_color: 'color value'
        bg_color: 'color value'
        bold: true | false
        italic: true | false
        align: left | center | right
series_collapsed:
    view_name.field_name: true | false
series_value_format:
    view_name.field_name:
        format_string: 'value formatting string'

## FORMATTING PARAMETERS
color_application:
    collection_id: 'collection ID'
    palette_id: 'palette ID'
header_font_color: 'color value'
header_background_color: 'color value'
header_text_alignment: left | center | right
header_font_size: N
rows_font_size: N
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_state	ההגדרה קובעת אם ההערה תכווץ או תורחב אם היא גדולה מדי ולא נכנסת לשורה אחת ברוחב של הרכיב
note_display	ההגדרה קובעת איפה ההערה מוצגת ברכיב
note_text	מציינת את הטקסט שמוצג בהערה
פרמטרים של שאילתה
model	הגדרת המודל שישמש לשאילתה של הרכיב
‫explore (לרכיבים)	הגדרת הניתוח בכלי הניתוחים שישמש לשאילתה של הרכיב
fields	הגדרת השדות שישמשו לשאילתה של הרכיב. אפשר להשתמש ב-dimensions במקום ב-measures וב-measures.
dimensions	הגדרת המאפיינים שישמשו לשאילתה של הרכיב
measures	הגדרת המדדים שישמשו לשאילתה של הרכיב
sorts	הגדרת המיון שישמש לשאילתה של הרכיב
pivots	הגדרת המאפיינים שישמשו כמאפייני ציר בשאילתה של הרכיב
fill_fields	הגדרת המאפיינים שמשתמשים באפשרות מילוי מאפיינים
subtotals	הגדרת השדות שמוצג בהם סיכום ביניים
total	ההגדרה הזו קובעת אם יוצגו סיכומים של עמודות בתרשים טבלה.
row_total	ההגדרה הזו קובעת אם יוצגו סיכומים של שורות בתרשים טבלה
limit	הגדרת מגבלת השורות שתשמש לשאילתה של הרכיב
column_limit	הגדרת מגבלת העמודות שתשמש לשאילתה של הרכיב
‫filters (לרכיבים)	הגדרת המסננים שאי אפשר לשנות בשאילתה של הרכיב
filter_expression	ההגדרה מגדירה מסנן מותאם אישית שאי אפשר לשנות בשאילתת הרכיב
listen	המאפיין מגדיר את המסננים שאפשר לשנות בשאילתה של הרכיב, אם נוצרו filters (ללוח בקרה)
query_timezone	הפרמטר הזה מגדיר את אזור הזמן שבו צריך להשתמש כשמריצים את השאילתה
analysis_config	Added 21.14 מגדיר את ניתוח התחזית שצריך לבצע כשהשאילתה מופעלת. כדי להשתמש בתכונה הזו, צריך להפעיל את התכונה 'תחזיות' ב-Labs.
merged_queries	הגדרת שאילתה של תוצאות ממוזגות
פרמטרים של עמודות
auto_size_all_columns	התאמה אוטומטית של הגודל של כל עמודה בטבלה לרוחב של כותרת העמודה או של ערך הנתונים הארוך ביותר, לפי הרחב מביניהם
column_order	קובע את סדר העמודות בתרשים הטבלה
pinned_columns	הגדרת העמודות שיוצמדו או יוקפאו בצד ימין של תרשים הטבלה
פרמטרים של תרשים
table_theme	החלת אחת מחמש אפשרויות צביעה של טבלה על תצוגה חזותית של טבלה
show_row_numbers	הגדרת האפשרות להצגת מספר שורה בתחילת כל שורה בטבלה
hide_totals	ההגדרה הזו קובעת אם יוצגו סיכומים של עמודות בתצוגה חזותית של טבלה
hide_row_totals	ההגדרה הזו קובעת אם בתצוגה חזותית של טבלה יוצגו סיכומים של שורות
transpose	הגדרה אם להפוך את השורות בעמודות בטבלה
hidden_fields	מציין שדות לשימוש בשאילתה אבל להסתרה בתרשים
limit_displayed_rows	הצגה או הסתרה של שורות בתרשים לפי המיקום שלהן בתוצאות
פרמטרים של סדרות
truncate_text	מקצר את הכותרות של העמודות ואת הטקסט בתאי הנתונים באמצעות שלוש נקודות (…)
show_view_names	השם של התצוגה המפורטת יופיע לצד שם השדה בכל כותרת של עמודה
size_to_fit	הרוחב של כל העמודות מוגדר באופן אוטומטי כך שהטבלה תתאים בדיוק לרוחב של הרכיב שבו היא מוצגת
dynamic_fields	כולל חישובים בטבלה או שדות בהתאמה אישית בתרשים הטבלה
series_labels	מציינת תווית מותאמת אישית לכל עמודה בהדמיה
series_column_widths	הגדרת רוחב ספציפי לעמודות בתצוגה החזותית
series_cell_visualizations	ההגדרה קובעת אם העמודות משתמשות באפשרות ההמחשה Cell Visualization. לפרמטר הזה יש את הפרמטרים המשניים is_active,‏ palette ו-value_display.
series_text_format	מגדיר את פריסת הטקסט בתאים של כל עמודה. לפרמטר הזה יש את פרמטרי המשנה fg_color,‏ bg_color,‏ bold,‏ italic ו-align.
series_collapsed	מציינת אם עמודה עם סכומי ביניים תופיע מכווצת
series_value_format	הגדרת פורמט הערך של עמודה באמצעות עיצוב בהתאמה אישית
פרמטרים של עיצוב
color_application	הוספת צבעים להמחשות של תאים ולעיצוב מותנה
header_font_color	הגדרת צבע הגופן של כותרות העמודות
header_background_color	הגדרת צבע לרקע של כותרות העמודות
header_text_alignment	החלת יישור לשמאל, לימין או למרכז על כותרות העמודות
header_font_size	הגדרת גודל גופן לכותרות של עמודות
rows_font_size	הגדרת גודל גופן לטקסט בתאי נתונים
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_state

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

note_display

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

note_text

הפרמטר note_text מציין את הטקסט שמוצג בהערה של רכיב.

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

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

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, ולמיון בסדר עולה לא צריך להוסיף סיומת.

## single sort example
- name: orders_by_date
  sorts: order.order_date desc

## multiple sort example
- name: orders_by_date
  sorts: [order.order_date desc, customer.name]

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]

fill_fields

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

- name: orders_by_date
  fill_fields: [orders.created_date, orders.shipped_date]

subtotals

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

subtotals: [products.department, distribution_centers.name]

total

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

total: true | false

## default value: false

row_total

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

row_total: right | left | false

## default value: false

limit

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

- name: orders_by_date
  limit: 100

column_limit

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

- name: orders_by_date
  column_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 בביטוי המסנן כדי לקבל ערכי מסנן גמישים.

filter_expression

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

- name: element_name
  filter_expression:
  - diff_days(${users.created_date},${user_order_facts.first_order_date}) > 60

בדף התיעוד בנושא ביטויי סינון ב-Looker מפורטים ביטויי הסינון ב-Looker.

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

analysis_config

אפשר להשתמש בפרמטרים המשניים הבאים כדי להגדיר ניתוחים:

• forecasting
• confidence_interval
• field_name
• forecast_n
• forecast_interval
• seasonality

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

  analysis_config:
    - forecasting:
      confidence_interval: 0.95
      field_name: orders.count
      forecast_n: 14
      forecast_interval: day
      seasonality: 7

forecasting

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

מידע נוסף מופיע בדף התיעוד בנושא תחזיות בהדמיות.

כדי להוסיף תחזיות להדמיות, צריך להפעיל את התכונה 'תחזיות' ב-Labs.

confidence_interval

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

confidence_interval: 0.99 | 0.98 | 0.95 | 0.90 | 0.80

אפשר לעיין בקטע מרווח התחזית בדף התיעוד תחזיות בהדמיות.

כדי להוסיף תחזיות להדמיות, צריך להפעיל את התכונה 'תחזיות' ב-Labs.

field_name

‫field_name מציין את השמות של המדדים – עד חמישה – שייכללו בתחזיות.

field_name: view_name.field_name

forecast_n

‫forecast_n מציין את אורך התחזית.

forecast_n: N # An integer that represents the length of the forecast

אפשר לעיין בקטע Length בדף התיעוד Forecasting in visualizations.

כדי להוסיף תחזיות להדמיות, צריך להפעיל את התכונה Forecasting ב-Labs.

forecast_interval

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

forecast_interval: day | month # a timeframe with dimension fill

מידע נוסף זמין בדף מאמרי העזרה בנושא אורך.

כדי להוסיף תחזיות להדמיות, צריך להפעיל את התכונה 'תחזיות' ב-Labs.

seasonality

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

seasonality: N # An integer that represents the number of rows over which a cycle or pattern repeats

הגדרת העונתיות אוטומטית מיוצגת כערך ריק seasonality.

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

כדי להוסיף תחזיות להדמיות, צריך להפעיל את התכונה 'תחזיות' ב-Labs.

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

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

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

auto_size_all_columns

הפרמטר auto_size_all_columns משנה את הגודל של כל עמודה בטבלה באופן אוטומטי לרוחב של כותרת העמודה או של ערך הנתונים הארוך ביותר, לפי הרחב מביניהם. הפרמטר הזה מבטל את הפרמטרים series_column_widths ו-size_to_fit, אם הם מוגדרים.

- name: orders_by_date
  auto_size_all_columns: true

column_order

הפרמטר column_order מגדיר את סדר העמודות בתרשים הטבלה.

- name: orders_by_date
  column_order: [customer.city, customer.state, customer.count]

pinned_columns

הפרמטר pinned_columns מגדיר את העמודות שמוצמדות לצד ימין של תרשים הטבלה.

- name: orders_by_date
  pinned_columns:
    orders.created_date: left
    distribution_centers.name: left

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

הפרמטרים הבאים תואמים לאפשרויות בתפריט תרשים של עורך התרשימים לתרשימי טבלה.

table_theme

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

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

table_theme: editable | white | gray | transparent | unstyled

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

transpose

הפרמטר transpose מאפשר להפוך את השורות של הטבלה לעמודות. אפשר להזין בו את הערך true או false.

- name: orders_by_date
  transpose: true

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_text

הפרמטר truncate_text קובע אם כותרות העמודות והטקסט בתוך תאי הנתונים יקוצרו באמצעות שלוש נקודות (…).

truncate_text: true | false

show_view_names

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

show_view_names: true | false

## default value: true

size_to_fit

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

size_to_fit: true | false

dynamic_fields

הפרמטר dynamic_fields ותתי הפרמטרים שלו מתארים חישובים בטבלה או שדות מותאמים אישית שבהם יש להשתמש עם התרשים. כדי להוסיף description באורך של עד 255 תווים או להשתמש בcalculation_type עבור קבוצות מותאמות אישית או קטגוריות מותאמות אישית, צריך הרשאה ליצור שדות מותאמים אישית. כדי להוסיף description באורך של עד 255 תווים לחישובים בטבלה או להשתמש ב-calculation_type לחישובים מהירים, צריכה להיות לכם הרשאה ליצור חישובים בטבלה.

אפשר להשתמש בפרמטרים המשניים הבאים כדי להגדיר שדות דינמיים:

• table_calculation
• measure
• dimension
• label
• based_on
• type
• expression
• filter_expression
• value_format
• value_format_name
• calculation_type
• args
• _kind_hint
• _type_hint
• is_disabled
• description

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

dynamic_fields:
  - table_calculation: running_total
    label: Running Total of Items
    expression: running_total(${inventory_items.count})
    value_format_name: decimal_0
    description: your description of up to 255 characters here
    _kind_hint: measure
    _type_hint: number
    is_disabled: false

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

dynamic_fields:
- category: table_calculation
  description: your description of up to 255 characters here
  label: Percent of Orders Count
  value_format:
  value_format_name: percent_0
  calculation_type: percent_of_column_sum
  table_calculation: percent_of_orders_count
  args:
  - orders.count
  _kind_hint: measure
  _type_hint: number
- category: table_calculation
  description: your description of up to 255 characters here
  label: Percent of previous - Orders Count
  value_format:
  value_format_name: percent_0
  calculation_type: percent_of_previous
  table_calculation: percent_of_previous_orders_count
  args:
  - orders.count
  _kind_hint: measure
  _type_hint: number
- category: table_calculation
  description: your description of up to 255 characters here
  label: Percent change from previous - Orders Count
  value_format:
  value_format_name: percent_0
  calculation_type: percent_difference_from_previous
  table_calculation: percent_change_from_previous_orders_count
  args:
  - orders.count
  _kind_hint: measure
  _type_hint: number
- category: table_calculation
  description: your description of up to 255 characters here
  label: Rank of Orders Count
  value_format: ## this field is optional
  value_format_name: ## this field is optional
  calculation_type: rank_of_column
  table_calculation: rank_of_orders_count
  args:
  - orders.count
  _kind_hint: measure
  _type_hint: number
- category: table_calculation
  description: your description of up to 255 characters here
  label: Running total of Orders Count
  value_format: ## this field is optional
  value_format_name: ## this field is optional
  calculation_type: running_total
  table_calculation: running_total_of_orders_count
  args:
  - orders.count
  _kind_hint: measure
  _type_hint: number

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

dynamic_fields:
  - measure: avg_sale_price
    label: Average Sale Price
    based_on: products.sale_price
    type: average
    value_format_name: usd
    description: your description of up to 255 characters here
    _kind_hint: measure
    _type_hint: number

אתם יכולים ליצור מדד מותאם אישית מסונן לשימוש בהדמיה באמצעות תחביר כמו זה:

dynamic_fields:
  - measure: order_count_for_25_47_year_olds
    based_on: order_items.order_count
    type: count_distinct
    label: Order Count for 25- to 47-Year-Olds
    description: your description of up to 255 characters here
    value_format: 00#
    _kind_hint: measure
    _type_hint: number
    filter_expression: "${users.age} >= 25 AND ${users.age} <= 47"

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

dynamic_fields:
  - dimension: user_city_state
    label: User City and State
    expression: concat(${users.city}, ", ", ${users.state})
    description: your description of up to 255 characters here
    _kind_hint: dimension
    _type_hint: string

אפשר ליצור קבוצות מותאמות אישית למאפיין כדי להשתמש בהן בהדמיה באמצעות תחביר כמו זה:

  - category: dimension
  description: 'States by region'
  label: State Groups
  value_format: ## this field is optional
  value_format_name: ## this field is optional
  calculation_type: group_by
  dimension: state_groups
  args:
  - users.state
  - - label: Pacific Northwest
      filter: Oregon,Idaho,Washington
  - Other
  _kind_hint: dimension
  _type_hint: string

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

- category: dimension
  description: Order item sale prices, in tiers of 10
  label: Sale Price Bins
  value_format:
  value_format_name:
  calculation_type: bin
  dimension: sale_price_bins
  args:
  - order_items.sale_price
  - '10'
  - '0'
  - '100'
  -
  - classic
  _kind_hint: dimension
  _type_hint: string

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

table_calculation

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

measure

תת-הפרמטר measure מגדיר את השם של מדד מותאם אישית או של מדד מותאם אישית עם סינון. זה השם שמשמש להפניה למדד ב-LookML.

dimension

תת-הפרמטר dimension מגדיר את השם של מאפיין מותאם אישית. זה השם שמשמש להפניה למאפיין ב-LookML.

label

פרמטר המשנה label מגדיר את הכותרת של השדה הדינמי כמו שהיא תוצג בתרשים. השם הזה יכול להיות זהה לשם שמופיע בפרמטרים המשניים table_calculation, measure או dimension, או שונה ממנו.

based_on

אם אתם משתמשים במדד מותאם אישית או במדד מותאם אישית מסונן, פרמטר המשנה based_on מזהה את המדד שהוא מבוסס עליו באמצעות התחביר view_name.field_name.

type

אם משתמשים במדד בהתאמה אישית, תת-הפרמטר type מזהה את סוג הצבירה. היא מקבלת את הערכים count_distinct, sum, average, min, max או median.

description

אפשר להוסיף תיאור באורך של עד 255 תווים לכל שדה מותאם אישית או חישוב בטבלה באמצעות תת-פרמטר description. תיאור השדה מוצג ב-Looker כשהמשתמש לוחץ על סמל המידע משמאל לשם השדה בכלי לבחירת שדות, וכשהמשתמש מעביר את העכבר מעל שם העמודה בטבלה או בתרשים טבלה בתצוגה של ניתוח נתונים, לוח בקרה או Look.

expression

אם משתמשים בחישוב טבלה, תת-הפרמטר expression מגדיר את ביטוי של Looker שמשמש ליצירת חישוב הטבלה.

filter_expression

אם משתמשים במדד מסונן בהתאמה אישית, תת-הפרמטר filter_expression מגדיר את הביטוי של Looker שמשמש לסינון המדד.

value_format

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

value_format_name

פרמטר המשנה האופציונלי value_format_name מחיל פורמט ברירת מחדל על השדה הדינמי. אם רוצים להשתמש בפורמט מותאם אישית, צריך להשתמש ב-value_format.

calculation_type

תת-הפרמטר calculation_type מגדיר את סוג הפונקציה Shortcut Calculation או Group שמשמשת ליצירת חישוב בטבלה או ליצירת קבוצה מותאמת אישית למאפיין:

אפשרויות של שדות בהתאמה אישית calculation_type:

• ‫group_by – מקבץ ערכי מאפיינים תחת תוויות קבועות בהתאמה אישית, על סמך תנאי מותאם אישית שצוין. בדומה ל-CASE WHEN ב-SQL, או לפרמטר השדה case ב-LookML.
• ‫bin – קיבוץ ערכים למאגרי נתונים מותאמים אישית או לרמות, למאפיינים מסוג מספרי ולמאפיינים מותאמים אישית. דומה לסוג המאפיין LookML tier.

אפשרויות של חישובים בטבלה calculation_type:

• ‫percent_of_column_sum – ערך בשורה חלקי סכום הערכים בעמודה. החישוב הזה כולל רק ערכים שנמצאים בטבלת הנתונים כשהשאילתה מגיעה למגבלת השורות שלה.
• ‫percent_of_previous – הערך של השורה הנוכחית חלקי הערך של השורה הבאה.
• ‫percent_difference_from_previous – ההפרש בין הערך בשורה הנוכחית לבין הערך בשורה הבאה, חלקי הערך בשורה הבאה.
• ‫rank_of_column – הדירוג של הערך בשורה מתוך כל הערכים בעמודה. החישוב הזה כולל רק ערכים שנמצאים בטבלת הנתונים כשהשאילתה מגיעה למגבלת השורות שלה.
• ‫running_total – הסכום המצטבר של הערך בשורה הנוכחית וכל הערכים בשורות הקודמות בעמודה.
• ‫percent_of_previous_column – בשדות ציר, הערך של העמודה הנוכחית חלקי הערך של העמודה שמשמאל.
• ‫percent_change_from_previous_column – בשדות ציר, ההפרש בין הערך בעמודה הנוכחית לבין הערך בעמודה שמימין, חלקי הערך בעמודה שמימין.
• ‫percent_of_row – בשדות ציר, אחוז הערך של העמודה הנוכחית חלקי סכום השורה של השדה הזה.
• ‫running_row_total – בשדות שמוצגים בפורמט ציר, הסכום המצטבר של העמודה הנוכחית וכל העמודות הקודמות בשורה הזו.

args לקבוצות בהתאמה אישית

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

args:
- view_name.field_name
  - label: specified custom label
    filter: condition for values
  - label: another specified custom label
    filter: a different condition for values
- Other ## An optional customizable group label for values that do not meet specified conditions.

אפשר להוסיף כמה תנאים של label ושל filter שרוצים, בהתאם למספר הקבוצות הרצוי.

אפשר לעיין בדוגמה הקודמת.

args עבור סלי מיון בהתאמה אישית

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

  args:
  - view_name.field_name
  - bin_size ## The numeric interval on which to base each bin, in single quotes
  - min ## The numeric value of the minimum bin size, in single quotes
  - max ## The numeric value of the maximum bin size, in single quotes
  - override ## A value will only appear when a custom bin uses a Custom-sized bin type.
  - style ## The bin display style. Currently, only classic is supported.

אפשר לעיין בדוגמה הקודמת.

‫args לחישובים של קיצורי דרך

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

- args:
  - view_name.field_name   ## the field on which the calculation is based

אפשר לעיין בדוגמה הקודמת.

_kind_hint

פרמטר המשנה האופציונלי _kind_hint מציין אם השדה הדינמי מחזיר מאפיין או מדד. אפשר להזין בו את הערכים dimension ו-measure.

_type_hint

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

is_disabled

פרמטר המשנה האופציונלי is_disabled מציין אם חישוב הטבלה מופיע בתצוגה החזותית ובניתוח הבסיסי שלה ב-Explore. אפשר להזין בו את הערכים true ו-false.

series_labels

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

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

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

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

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

series_column_widths

מגדירים את הרוחב של עמודה אחת או יותר על סמך שם הסדרה. אם הפרמטר auto_size_all_columns מוגדר לערך true, הוא מבטל את series_column_widths.

series_column_widths:
  order_times.shipping_time: 50
  orders.count: 60

series_cell_visualizations

מציינים אם בעמודה אחת או יותר נעשה שימוש באפשרות Cell Visualization (הדמיה של תאים) על ידי ציון שם הסדרה באמצעות הפורמט view_name.field_name. לפרמטר series_cell_visualizations יש את הפרמטרים המשניים is_active, palette ו-value_display.

series_cell_visualizations:
  order_items.count:
    is_active: true
    palette:
      palette_id: my-custom-colors-sequential-0
      collection_id: my-custom-colors
    value_display: true

is_active

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

palette

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

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

ל-palette יש פרמטר חלופי של צאצא, custom_colors, שמגדיר שניים עד חמישה צבעים מותאמים אישית לשימוש בעמודות:

series_cell_visualizations:
  order_items.count:
    palette:
      custom_colors:
      - orange
      - "#0000ff"
      - red

value_display

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

series_text_format

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

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

  series_text_format:
    order_items.shipping_time:
      align: right
    order_items.shipped_date:
      align: center
      fg_color: "#EA8A2F"
      bg_color: "#64518A"
      bold: true
      italic: true

fg_color

פרמטר המשנה fg_color מציין את צבע הגופן של הטקסט בתא. ערך הצבע יכול להיות מחרוזת הקסדצימלית, כמו #2ca6cd, או מחרוזת של שם צבע ב-CSS, כמו mediumblue.

bg_color

פרמטר המשנה bg_color מציין את צבע הרקע של התא. ערך הצבע יכול להיות מחרוזת הקסדצימלית, כמו #2ca6cd, או מחרוזת של שם צבע ב-CSS, כמו mediumblue.

bold

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

italic

פרמטר המשנה italic מציין אם הטקסט בתא מוטה, והוא מקבל את הערכים true או false.

align

תת-הפרמטר align מציין את היישור של הטקסט בתא ומקבל את הערכים left, ‏center או right.

series_collapsed

הפרמטר series_collapsed מגדיר אם לכווץ או להרחיב את סכומי הביניים של סדרה מסוימת. מזהים את הסדרה באמצעות התחביר view_name.field_name והערכים true או false.

series_collapsed:
  users.city: false
  users.state: true

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

series_value_format

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

מזהים את הסדרה שרוצים לעצב באמצעות התחביר view_name.field_name.

תת-הפרמטר format_string מאפשר להגדיר את הפורמט של הסדרה באמצעות עיצוב בסגנון Excel.

series_value_format:
  products.retail_price:
    format_string: "$#,##0.00"

אפשר גם להגדיר את העיצוב כך:

series_value_format:
  order_items.count: "00#"

הפורמט שמשמש לתת-הפרמטר format_string זהה לפורמט שמשמש לפרמטר LookML‏ value_format. בדף התיעוד בנושא הוספת עיצוב מותאם אישית לשדות מספריים מוסבר איך מציינים את הפורמטים האלה.

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

הפרמטרים הבאים תואמים לאפשרויות בתפריט עיצוב של עורך התצוגות החזותיות לתרשימי טבלה.

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.

header_font_color

הפרמטר header_font_color מחיל צבע גופן על כותרות של עמודות.

ערך הצבע יכול להיות מחרוזת הקסדצימלית, כמו #2ca6cd, או מחרוזת של שם צבע ב-CSS, כמו mediumblue.

header_font_color: purple

צבע ברירת המחדל תלוי בעיצוב הטבלה שמוגדר באמצעות הפרמטר table_theme.

header_background_color

הפרמטר header_background_color מחיל צבע על כותרות העמודות ברקע.

ערך הצבע יכול להיות מחרוזת הקסדצימלית, כמו #2ca6cd, או מחרוזת של שם צבע ב-CSS, כמו mediumblue.

header_background_color: #add8e6

צבע ברירת המחדל תלוי בעיצוב הטבלה שמוגדר באמצעות הפרמטר table_theme.

header_text_alignment

הפרמטר header_text_alignment מחיל יישור left, right או center על כותרות העמודות.

header_text_alignment: center

היישור שמוגדר כברירת מחדל הוא left.

header_font_size

הפרמטר header_font_size מחיל גודל גופן מ-1 עד 99 על כותרות העמודות.

header_font_size: 16

גודל ברירת המחדל של הגופן בכותרות ובשורות הוא 12.

rows_font_size

הפרמטר rows_font_size מחיל גודל גופן מ-1 עד 99 על הטקסט בתוך תאי הנתונים, אבל לא על כותרות העמודות.

rows_font_size: 8

גודל ברירת המחדל של הגופן בכותרות ובשורות הוא 12.

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 מציין אם ערכים ריקים (null) יוצגו כאפסים.

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 ]