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

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

בדף הזה מוסבר איך להוסיף ולהתאים אישית רכיב בלוח הבקרה של LookML‏ type: button באמצעות פרמטרים של מרכז שליטה של LookML בקובץ dashboard.lkml. הלחצנים שימושיים להצבת קישורים בלוחות הבקרה. אתם יכולים לקשר לתוכן ב-Looker, כמו תצוגות ולוחות בקרה, או לאתרים אחרים.

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

דוגמה לשימוש


## BASIC PARAMETERS
type: button
name: text
height: N
width: N
row: N
col: N

## BUTTON PARAMETER
rich_content_json: '{
 "text": "button text",
 "description": "description",
 "newTab": true | false,
 "alignment": "left" | "right" | "center",
 "size": "small" | "medium" | "large",
 "style": "OUTLINED" | "FILLED" | "TRANSPARENT",
 "color": "hex string or css color",
 "href": "link"
 }'

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

שם הפרמטר תיאור
פרמטרים בסיסיים
‫type (לרכיבים) קובע את סוג התצוגה החזותית שתשמש ברכיב
‫name (לרכיבים) יצירת רכיב
‫height (לרכיבים) המאפיין מגדיר את הגובה של תיבת המשבצת של רכיב לחצן. הגובה הוא ביחידות של שורות בלוחות בקרה מסוג layout: newspaper
‫width (לרכיבים) מגדיר את הרוחב של תיבת המשבצת של רכיב לחצן. הרוחב הוא ביחידות של עמודות בלוחות בקרה של layout: newspaper
row המאפיין הזה מגדיר את המיקום מלמעלה למטה של תיבת המשבצת של רכיב לחצן ביחידות של שורות בלוחות בקרה של layout: newspaper
col המאפיין מגדיר את המיקום משמאל לימין של תיבת המשבצת של רכיב לחצן ביחידות של עמודות בלוחות בקרה של layout: newspaper
פרמטר של לחצן
rich_content_json אובייקט JSON שמכיל צמדי מפתח/ערך עם מידע על הלחצן

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

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

הפרמטרים height,‏ width,‏ row ו-col חלים על תיבת האריח של רכיב לחצן, ולא על הלחצן עצמו.

name

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

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

כל הצהרת name יוצרת רכיב בלוח הבקרה חדש ומקצה לו שם. שמות הרכיבים צריכים להיות ייחודיים.

הערך name שניתן ללחצן לא יופיע בממשק המשתמש של לוח הבקרה.

- name: orders_by_date

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_geo_coordinates | looker_geo_choropleth | looker_waterfall |
        looker_wordcloud | looker_boxplot | button

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

height

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

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

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

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

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

- dashboard: sales_overview
  layout: newspaper
  ...

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

width

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

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

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

רוחב תיבת האריח של רכיב לחצן מוגדר כברירת מחדל ל-8 עמודות, שהן שליש מהרוחב המלא של לוח הבקרה. הרוחב המינימלי של תיבת המשבצת של לחצן הוא 2.

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

- dashboard: sales_overview
  layout: newspaper
  ...

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

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

row

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

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

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

- dashboard: sales_overview
  layout: newspaper
  ...

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

col

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

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

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

- dashboard: sales_overview
  layout: newspaper
  ...

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

פרמטר של לחצן

אפשר להשתמש בפרמטר שמתואר בקטע הזה כדי להוסיף תוכן לרכיב של לוח בקרה ב-LookML של type: button.

rich_content_json

‫rich_content_json הוא אובייקט JSON עם כמה צמדי מפתח/ערך שמגדירים מאפיינים של לחצן לוח הבקרה.

בדוגמה הבאה מוצג לחצן בלוח בקרה שמעביר ללוח בקרה אחר.

rich_content_json: '{
 "text": "Go to Sales Dashboard",
 "description": "View sales from the last 18 months.",
 "newTab": true,
 "alignment": "center",
 "size": "medium",
 "style": "FILLED",
 "color": "forestgreen",
 "href":"https://instance_name.looker.com/dashboards/152?State=California&Created+Fiscal+Quarter=2022"
 }'

בדוגמה הבאה לשימוש מוצג לחצן בלוח הבקרה שמעביר לכרטיסייה בלוח הבקרה.

rich_content_json: '{
 "text": "Go to Users tab",
 "description": "View user data from the last 18 months.",
 "newTab": false,
 "alignment": "center",
 "size": "medium",
 "style": "FILLED",
 "color": "forestgreen",
 "targetTabName":"Users"
 "href":""
 }'

text

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

description

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

newTab

‫newTab הוא ערך בוליאני שקובע אם הקישור של הלחצן ייפתח בכרטיסייה חדשה (true) או בכרטיסייה הנוכחית (false). ברירת המחדל של newTab היא true.

alignment

‫alignment מגדיר את היישור של הכפתור בתוך תיבת המשבצת של רכיב הכפתור. ברירת המחדל של alignment היא center.

size

‫size מגדיר את הגודל של הלחצן והטקסט שלו ל-small,‏ medium או large. הערך של size לא משפיע על הגודל של תיבת האריחים של רכיב הלחצן או על הפרמטר height.

style

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

  • ‫FILLED: צבע הגוף של הכפתור מוגדר ב-color. הטקסט של הכפתור הוא לבן. זה ערך ברירת המחדל.
  • ‫OUTLINED: הכפתור מוקף בקו מתאר, אבל הגוף שלו שקוף. הצבע של הטקסט בכפתור מוגדר על ידי color.
  • ‫TRANSPARENT: גוף הכפתור שקוף. הצבע של הטקסט בכפתור מוגדר על ידי color.

color

‫color מגדיר את הצבע של הלחצן או של הטקסט שמופיע בו, בהתאם להגדרה של style. color ברירת המחדל היא הצבע הראשון באוסף הצבעים לקטגוריות – ברירת המחדל של מופע Looker.

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

targetTabName

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

מידע נוסף על לוחות בקרה עם כרטיסיות

href

‫href מגדיר את כתובת ה-URL שאליה הלחצן יעביר את המשתמשים. קישורים ללוחות בקרה אחרים ב-Looker יכולים לכלול פרמטרים של מסננים שמגדירים את המסננים של לוח הבקרה לערכים ספציפיים.