פרמטרים של לחצנים בלוחות בקרה של 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 | group

בדף התיעוד 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 מגדיר את השורה שבה ממוקם הקצה העליון של תיבת המשבצת של רכיב הלחצן. אם הלחצן ממוקם בתוך קבוצת משבצות באמצעות הפרמטר group, הפרמטר row מגדיר את מיקום השורה של הלחצן ביחס לחלק העליון של מאגר הקבוצה (row: 0).

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

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

- dashboard: sales_overview
  layout: newspaper
  ...

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

col

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

מרכזי הבקרה מחולקים ל-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 יכולים להכיל פרמטרים של סינון שמגדירים מסננים של מרכז הבקרה לערכים ספציפיים.