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

אתם יכולים להתאים אישית את ההסברים הקצרים שמופיעים כשמשתמשים מעבירים את העכבר מעל רכיבים בתצוגות החזותיות של Looker. התאמה אישית של הסברים מאפשרת לכם לספק יותר הקשר, להציג מדדים נוספים ולהתאים את המידע שמוצג למשתמשים. הגדרת התצוגה החזותית Custom Tooltip מאפשרת להגדיר הסברים קצרים בכרטיסייה Style של Explore (או בתפריט Edit של התצוגה החזותית ב-Explore הקלאסי) באמצעות שילוב של הגדרות ממשק משתמש ועורך HTML שתומך בתבניות Liquid.

בדף הזה מוסבר איך להפעיל את הגדרת התצוגה החזותית הסברים בהתאמה אישית ולהשתמש בה במכונה של Looker (original). הדף הזה כולל את הקטעים הבאים:

• דרישות לגבי המשתמשים והמכונות
• מגבלות
• איך משתמשים בהסברים בהתאמה אישית
• דוגמאות
• מקורות מידע שקשורים לנושא

דרישות לגבי משתמשים ומופעים

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

• במכונה של Looker (original)‎ צריכה לפעול גרסה 26.4 ומעלה של Looker.
• כדי ליצור הסברים בהתאמה אישית ב-Explores, צריכה להיות לכם ההרשאה explore וגישה למודל LookML הבסיסי.

מגבלות

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

• אפשר להשתמש בהסברים מותאמים אישית ברוב סוגי התרשימים, חוץ מהסוגים הבאים:
  • תרשימי טבעת מרובים
  • תרשימי ענן מילים
  • תרשימי מפה סטטית (אזורים)
  • תרשימי מפות סטטיות (נקודות)
  • תרשימים שנוצרו באמצעות עורך הגדרות התרשים (למעט תרשימי סאנקי)
  • המחשות בהתאמה אישית
• ההסברים הקצרים בהתאמה אישית יכולים להפנות רק לשדות שנכללים בשאילתה של Explore.
• ההסברים הקצרים יכולים להציג רק את אותה רמת פירוט של הנתונים כמו בשדה נתון. אם המשתמשים רוצים לראות נתונים ברמה מפורטת יותר מזו שזמינה בהסבר הקצר, הם צריכים להשתמש בפונקציונליות של הצגת פירוט.
• ההסברים הקצרים המותאמים אישית נשמרים ברמת התצוגה החזותית. אי אפשר לשמור אותם ברמת הניתוח.
• אם מסירים שדה משאילתת Explore שיש לה הסבר קצר בהתאמה אישית, המשתמש עדיין יכול לראות את ההסבר הקצר אם שאילתת Explore משותפת איתו והוא מוסיף את השדה בחזרה לשאילתת Explore.
• HTML שעבר רינדור בתיאורי כלים בהתאמה אישית כפוף לכללי הסרת תוכן זדוני או רגיש ב-HTML של Looker.
• יכול להיות שחלק ממשתני Liquid לא נתמכים בתיאורי כלים בהתאמה אישית.
• התאמות אישיות של הסברים קצרים יבטלו כל עיצוב שמוחל על מרכז בקרה פנימי (לא מוטמע) או על מרכז בקרה מוטמע.

איך משתמשים בהסברים מותאמים אישית

אם יש לכם את ההרשאות המתאימות, אתם יכולים להתאים אישית את ההסבר הקצר של סדרה בתצוגה החזותית של Explore. כדי להתאים אישית את ההסבר הקצר:

1. פותחים או יוצרים שאילתת Explore ובוחרים סוג תצוגה חזותית נתמך.
2. כדי לערוך את התצוגה החזותית, לוחצים על הכרטיסייה סגנון בחלונית הגדרה. בניתוחים קלאסיים, לוחצים על עריכה בכרטיסייה תצוגה חזותית של הניתוח כדי לפתוח את עורך התצוגה החזותית.
3. פותחים את התפריט סדרה.
   • בתרשימים של מפות Google ובתרשימי Boxplot, לוחצים על הכרטיסייה Plot וממשיכים לשלב 5.
   • בתרשימי מפל, לוחצים על התפריט סדרה וממשיכים לשלב 5.
   • בתרשימי KPI (ערך יחיד), תרשימי ערך יחיד (קודמים) ותרשימי רשומה יחידה, לוחצים על התפריט סגנון וממשיכים לשלב 5.
   • בתרשימי משפך, לוחצים על התפריט תוויות וממשיכים לשלב 5.
   • בתרשימי ציר זמן, לוחצים על התפריט Options וממשיכים לשלב 5.
4. בקטע התאמות אישיות, מוצאים את הסדרה שרוצים להוסיף לה את ההסבר הקצר. אם יש כמה סדרות, מרחיבים את הסדרה שרוצים להוסיף לה הסבר קצר.
5. לוחצים על המתג הסבר קצר בהתאמה אישית כדי להפעיל את הפונקציונליות של ההסבר הקצר בהתאמה אישית לסדרה או לתרשים הספציפיים האלה.
6. בקטע Custom Tooltip, אתם יכולים לשנות את המראה הבסיסי של התיאור באמצעות האפשרויות הבאות:
   • גודל גופן: מגדיר את גודל הגופן של ההסבר הקצר.
   • משפחת גופנים: מגדירה את משפחת הגופנים של הגופן של ההסבר הקצר.
   • רדיוס הגבול: מגדיר את מידת העיגול של קצוות התיאור. ככל שהמספר גבוה יותר, כך הפינות של ההסבר הקצר מעוגלות יותר.
   • הצללת תיבה: מגדירה את ההצללה של תיבת ההסבר הקצר.
   • צבע גופן: מגדיר את צבע הגופן של התיאור.
   • צבע רקע: מגדיר את צבע הרקע של ההסבר הקצר.
   • צבע גבול: מגדיר את צבע הגבול של ההסבר הקצר.
   • יישור הטקסט: מגדיר את היישור של הגופן של התיאור. בוחרים באפשרות יישור לשמאל, יישור למרכז או יישור לימין. יישור לשמאל היא הגדרת ברירת המחדל.
7. בנוסף לאפשרויות הקודמות או במקומן, אתם יכולים להחיל אפשרויות עיצוב מתקדמות יותר. כדי לעשות את זה, לוחצים על עריכת התוכן של ההסבר הקצר כדי לפתוח את עורך ה-HTML עריכת התוכן של ההסבר הקצר.

8. בעורך Edit Tooltip Content, אתם יכולים להשתמש ב-HTML ובמשתני Liquid כדי ליצור את המבנה של התיאור הקצר ולמלא אותו.

   • אפשר להשתמש בתגי HTML רגילים כדי לעצב את התוכן של ההסבר הקצר (לדוגמה, <div>, <span>, <strong>, <table>,<ul>, <ol>). שימו לב שה-HTML שעבר רינדור כפוף לכללי הסרת תוכן זדוני או רגיש ב-HTML של Looker.
   • יכול להיות שחלק ממשתני Liquid לא נתמכים בתיאורי כלים מותאמים אישית.

9. בזמן שאתם עורכים את התוכן של ההסבר הקצר בהתאמה אישית, אתם יכולים לראות תצוגה מקדימה של ההסבר הקצר. כדי לעשות את זה, לוחצים על תצוגה מקדימה (או על מקשי הקיצור Command-Return ב-Mac או Ctrl+Enter ב-PC) ומעבירים את העכבר מעל הנקודות על הגרף בחלונית התצוגה המקדימה של התצוגה החזותית.

10. לוחצים על Save בעורך ה-HTML, ואז שומרים את הניתוח כ-Look או כמשבצת במרכז הבקרה כדי לשמור את השינויים.

דוגמאות

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

• הסבר קצר בהתאמה אישית עם כמה ערכי מדידה
• הסבר קצר בהתאמה אישית עם ערכים מוסתרים במבנה של טבלה
• הסבר קצר בהתאמה אישית עם פונקציות Liquid נפוצות

הסבר קצר בהתאמה אישית עם כמה ערכי מדידה

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

בדוגמה הזו, תרשים ערך יחיד בשם "מספר ההזמנות ב-2025" מציג את הערך של מספר ההזמנות של מדינת המשתמשים "ארה"ב", והוא מבוסס על שאילתת Explore שכוללת גם את מספר הפריטים בהזמנה. עם זאת, הערך של מספר הפריטים בהזמנה לא מוצג בתרשים.

קוד ה-HTML הבא מוזן בעורך Edit Tooltip Content (עריכת תוכן של הסבר קצר) לסדרה Orders Count (מספר ההזמנות), ומגדיר את התוכן כך שיכלול את הערך Order Items Count (מספר הפריטים בהזמנה) בהסבר הקצר:

<div style="padding: 5px; font-family: Arial, sans-serif; font-size: 13px;">
  <div>
    <strong>Order Items Count:</strong> {{ order_items.count }}
  </div>
  <div>
    <strong>Orders Count:</strong> {{ orders.count }}
  </div>
</div>

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

הסבר קצר בהתאמה אישית עם ערכים מוסתרים במבנה של טבלה

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

בדוגמה הזו, טבלת נתונים ב-Explore כוללת את המדדים Orders Count ו-Order Items Count, שמקובצים לפי המאפיינים Users State ו-Orders Status. המפתח רוצה להציג למשתמשים טבלה קטנה, ומסתיר את השדות סטטוס הזמנה ומספר הפריטים בהזמנה מתרשים הטבלה. עם זאת, המפתח עדיין רוצה שהמשתמשים יראו את הערכים של סטטוס הזמנה ומספר הפריטים בהזמנה שמשויכים למספר הזמנות נתון.

קוד ה-HTML הבא הוזן בעורך Edit Tooltip Content בסדרה Orders Count, והוא מגדיר את התוכן כך שיכלול את הערכים של סטטוס הזמנה ו-Order Items Count בהסבר הקצר, במבנה של טבלה:

<div>
    <div>
        <table border="1">
          <!-- Table Body -->
          <tbody>
            <!-- Row 1 -->
            <tr>
              <td>
                <strong>Order status</strong>
              </td>
              <td>
                {{ orders.status }}
              </td>
            </tr>
            <!-- Row 2 -->
            <tr>
              <td>
                <strong>State</strong>
              </td>
              <td>
                {{ users.state }}
              </td>
            </tr>
            <!-- Row 3 -->
            <tr>
              <td>
                <strong>Count of orders</strong>
              </td>
              <td>
                {{ orders.count }}
              </td>
            </tr>
            <!-- Row 4 -->
            <tr>
              <td>
                <strong>Count of order items</strong>
              </td>
              <td>
                {{ order_items.count }}
              </td>
            </tr>
          </tbody>
        </table>
      </div>
  </div>

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

הסבר קצר בהתאמה אישית עם פונקציות Liquid נפוצות

ההסברים המותאמים אישית תומכים בפונקציות נפוצות של Liquid, כמו העברת נתונים (piping) ושימוש בהצהרות downcast. בדוגמה הזו, בתרשים עמודות אנכי מוצג מספר ההזמנות מקובץ לפי סטטוס ההזמנה. המפתח רוצה לעצב את ההסבר הקצר כך שהמשתמשים יוכלו לזהות במהירות את ההבדל בין מספר ההזמנות בסטטוס הזמנה "מבוטלת" לבין מספר ההזמנות בסטטוס הזמנה "הושלמה".

ה-HTML וה-Liquid הבאים הוזנו בעורך Edit Tooltip Content לסדרה Orders Count, והם מגדירים את ערך ההסבר הקצר כך שיופיע באדום עבור ספירות הזמנות עם סטטוס "cancelled" ובירוק עבור הזמנות עם סטטוס "complete". הקוד משתמש בהקצאת משתנים ובצינור עיבוד נתונים כדי לוודא שהמחרוזת מדויקת, ולהחיל את העיצוב המותנה שצוין:

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

{% assign my_variable = orders.status | downcase | strip %}
{% if my_variable == "complete" %}
  <span style="color:green">{{orders.count}}</span>
{% else %}
  <span style="color:red">{{orders.count}}</span>
{% endif %}

הערך Orders Count של העמודה "complete" ב-סטטוס הזמנה מוצג כטקסט ירוק בהסבר הקצר.

הערך Orders Count של העמודה "cancelled" ב-Orders Status מוצג בטקסט אדום בהסבר הקצר.

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

מקורות מידע שקשורים לנושא

• מידע נוסף על יצירת תצוגות חזותיות
• בדף העזרה הפניה למשתנה Liquid מפורטות דרכים נוספות לשימוש ב-Liquid ב-Looker.
• מידע נוסף על תגי HTML שנתמכים ב-Looker זמין בדף התיעוד בנושא חיטוי HTML.