איך להפיק את המרב מאוסף הפתרונות של המחשות חזותיות ב-Looker: התאמה אישית של הסברים קצרים

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

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

משתמש מעביר את הסמן מעל קליפורניה כדי להציג תיאור קצר עם הערך 'קליפורניה' של המדינה והערך '‎$988,018.58' של שולי הרווח ברוטו הכולל.

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

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

רכיבים

דרישות מוקדמות

כדי להתאים אישית את תיאור הכלי:

שיקולים להתאמה אישית של הסברים קצרים

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

  • הערכים בפרמטר html הופכים לציר ה-Y בתצוגה החזותית.
  • הערך שרוצים להציג בציר ה-Y צריך להיות הערך בפרמטר sql של המדד.
  • כשמשתמשים במדד בפורמט כלשהו (מדד של type: percent_of_total או מדד עם פרמטר value_format_name או value_format), צריך להשתמש בתחביר Liquid לערך המעובד {{ field_name._rendered_value }} (כאשר field_name הוא השם בפועל של המדד או המאפיין).

דוגמה

כברירת מחדל, בתיאור הכלים של נקודות הנתונים בתרשים מוצגים הערכים של Total Gross Margin (שולי רווח ברוטו כולל) ושל State (מדינה). אבל מה אם רוצים לספק למשתמשים מידע נוסף שלא מצוין במפה או שלא נכלל בשאילתת החיפוש בכרטיסייה 'מה יש באזור'? מה קורה אם רוצים לכלול את הערך של שדה שנקרא Percent of Total Gross Margin במקום State? הכללת המדד אחוז הרווח הכולל תעזור למשתמשים להבין איך ערך הרווח הכולל של נקודה על הגרף מושווה לרווח הכולל במערך הנתונים.

כדי להתאים אישית את תיאור הכלי:

measure: total_gross_margin {
  type: sum
  value_format_name: decimal_2
  sql: ${gross_margin} ;;
  html: {{ rendered_value }} | {{percent_of_gross_margin._rendered_value }} of total ;;
}

  1. במצב פיתוח, עוברים להגדרת LookML של השדה שרוצים להתאים אישית.

    אפשר לעבור ישירות להגדרת LookML של שדה מתוך ניתוח נתונים.

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

  3. מוסיפים פרמטר html למדד המקורי שאליו מתייחסת השאילתה ב'ניתוח נתונים' ומוצג בתיבת הטיפ. במקרה הזה, המדד שמופיע כרגע בשאילתת הניתוח ומוצג בתיבת הטיפ הוא Total Gross Margin (רווח גולמי כולל).

  4. בפרמטר html, יוצרים ביטוי עם משתני Liquid שמצרף את השדות הנוספים לערך של המדד הקיים.

    • בדוגמה הזו נעשה שימוש במשתנה Liquid‏ _rendered_value כדי להציג ערכים בפורמט Looker. לדוגמה, total_gross_margin משתמש בעיצוב של Looker לשני שברים עשרוניים, ו-percent_of_total_gross_margin משתמש בעיצוב של Looker לאחוז עם שני שברים עשרוניים.
    • אפשר להשתמש בקו אנכי,|, כדי להפריד בין הערכים של שדות שונים.
    • אפשר גם להוסיף מילים אחרות שיבהירו את המשמעות של הערכים האחרים שמוצגים בתיבת הטיפ. במקרה הזה, מוסיפים את of total כדי להבהיר מה משמעות הערך של האחוז.

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

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

השלבים הבאים

אחרי שיוצרים את התרשים עם תיאור הכלים המותאם אישית, אפשר לשתף אותו עם אחרים: