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

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

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

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

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

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

רכיבים

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

כדי להתאים אישית את ההסבר הקצר:

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

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

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

דוגמה

כברירת מחדל, ההסבר הקצר של נקודות הנתונים בתצוגה החזותית יכלול את הערכים של Total Gross Margin ו-State. אבל מה אם אתם רוצים לספק למשתמשים מידע נוסף שלא מצוין במפה או לא נכלל בשאילתה של Explore? מה אם רוצים לכלול את הערך של שדה שנקרא 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 של שדה מתוך Explore.

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

  3. מוסיפים פרמטר html למדד המקורי שאליו מפנה השאילתה ב-Explore, ומוצג בתיאור. במקרה הזה, המדד שמופיע כרגע בשאילתה של Explore ומוצג בהסבר הקצר הוא 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.

השלבים הבאים

אחרי שיוצרים את התצוגה החזותית עם הסבר קצר בהתאמה אישית, אפשר לשתף אותה עם אחרים: