תווית (לשדות)

הקטע הזה מתייחס לפרמטר label שהוא חלק משדה.

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

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

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

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

Usage

view: view_name {
  dimension: field_name {
    label: "desired label name"
  }
}
היררכיה
view
סוג השדה
label
סוגי שדות אפשריים
מאפיין, קבוצת מאפיינים, מדד, מסנן, פרמטר

מקבל
מחרוזת

הגדרה

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

משתני Liquid עם label

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

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

לדוגמה, המשתנה Liquid‏ {{ _user_attributes['name_of_attribute'] }} מחליף את המשתנה Liquid בערך של מאפיין המשתמש שצוין. אם למשתמש יש מאפיין משתמש בשם name עם הערך John Smith, התחביר הבא label ישנה את שם השדה בבורר השדות ל-John Smith:

label: "{{ _user_attributes['name'] }}"

בדוגמה הבאה, המאפיין name משתמש במבנה Liquid‏ {% if %} {% else %} {% endif %} עם משתנה Liquid‏ _user_attributes['name_of_attribute'] כדי לשנות את הערך label שלו בהתאם למאפיין המשתמש company:

dimension: name {
  label: "{% if _user_attributes['company'] == 'Looker' %} Employee Name {% else %} Customer Name {% endif %}"
  sql: ${TABLE}.name ;;
}

בדף השיטות המומלצות דרכים מעניינות לשימוש ב-Liquid בתוויות אפשר לראות דוגמאות נוספות לשימוש ב-label עם משתני Liquid כדי להגדיר תוויות דינמיות.

דוגמה

כדי שהמדד הזה יופיע כמספר הלקוחות במקום מספר הלקוחות הייחודי בכלי לבחירת שדות.

measure: customer_count_distinct {
  label: "# of Customers"
  type: count_distinct
  sql: ${customer.id} ;;
}

דברים שכדאי לקחת בחשבון

סביבת הפיתוח המשולבת מסמנת תוויות כפולות בתצוגה

כדי למנוע כפילויות של תוויות שדות באותו תצוגה, בסביבת הפיתוח המשולבת (IDE) של Looker מוצג סמל מידע לצד מספר השורה של כל תוויות השדות הכפולות בקובץ תצוגה של LookML. אם מעבירים את העכבר מעל סמל המידע שליד מספר השורה, בתיאור הכלי מצוין שכבר יש שדה עם התווית בתצוגה.

אותו מידע יוצג בחלונית עזרה מהירה ב-IDE של Looker אם תבחרו את הטקסט של הצהרת label ב-IDE: