שימוש חוזר בקוד בצורה יעילה באמצעות DRY LookML: הגדרת מחרוזת פעם אחת לשימוש בכל פרויקט LookML

הערה: הדף הזה הוא חלק מאוסף פתרונות של Looker: מינוף מחדש של קוד בצורה יעילה באמצעות DRY LookML.

אפשר להשתמש בפרמטר constant LookML בקובץ המניפסט של הפרויקט כדי להגדיר מחרוזת שאפשר להשתמש בה בכל הפרויקט. קבועים ב-LookML יכולים להיות שימושיים כשצריך להגדיר מחרוזת ספציפית – כמו מספר, שם או עיצוב HTML לערכי שדות – ולעשות שימוש חוזר בערך הזה בכל הפרויקט.

בדף הזה מופיעות הדוגמאות הבאות לשימוש בקבועים של LookML כדי להגדיר ולתחזק ערכי מחרוזות לשימוש חוזר במקום אחד:

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

רכיבים

• קובץ המניפסט של הפרויקט
• הפרמטר constant ב-LookML
• תחביר @{constant_name} להפניה לקבועים קיימים
• הפרמטר html ב-LookML
• משתני Liquid

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

• מודל LookML מוגדר
• הרשאות לפיתוח LookML

דוגמה: שימוש באותו מחרוזת בתוויות של כמה ניתוחים

נניח שאתם רוצים ליצור שני דוחות ניתוח, עם התוויות San Francisco Users ו-San Francisco Orders בממשק המשתמש, אבל אתם לא רוצים להקליד את הטקסט של כל תווית באופן ידני.

כדי לעשות את זה, אפשר להגדיר קבוע place_name עם הערך "San Francisco" בקובץ המניפסט של הפרויקט:

constant: place_name {
  value: "San Francisco"
}

אחר כך אפשר להפנות לקבוע הזה בכל חלק בפרויקט שבו מתקבל מחרוזת, באמצעות התחביר @{place_name}. בדוגמה הזו, אפשר להגדיר את הניתוחים users ו-orders, ולציין את הערכים "@{place_name} Users" ו-"@{place_name} Orders" לפרמטר label, כמו בדוגמה הבאה:

explore: users {
  label: "@{place_name} Users"
}

explore: orders {
  label: "@{place_name} Orders"
}

בדוגמה הזו, Looker מציג את האפשרויות San Francisco Users ו-San Francisco Orders בתפריט Explore ובכותרות של ניתוחי הנתונים, במקום התוויות Users ו-Orders שמוצגות כברירת מחדל.

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

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

constant: place_name {
  value: "Bay Area"
}

מכיוון שהגדרתם את הקבוע place_name, אתם לא צריכים לשנות את San Francisco ל-Bay Area בכמה מקומות באופן ידני. ההפניות אל San Francisco עם הקבוע place_name יוחלפו ב-Bay Area, כך ש-Looker יציג את האפשרויות Bay Area Users ו-Bay Area Orders בתפריט 'ניתוח נתונים' ובכותרות של ניתוחי הנתונים.

דוגמה: החלת אותו פורמט על ערכים שליליים בכמה שדות

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

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

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

constant: negative_format {
  value: "{% if value < 0 %}
            <p style='color:red;'>({{rendered_value}})</p>
          {% else %}
            {{rendered_value}}
          {% endif %}"
}

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

לדוגמה, אפשר ליצור את המדד סכום כולל של type: sum ולציין את הערך @{negative_format} לפרמטר html:

measure: total_amount {
  type: sum
  value_format_name: usd
  sql: ${amount} ;;
  html: @{negative_format} ;;
}

בטבלה, ערכים שליליים במדד Total Amount יעוצבו בהתאם להגדרה של הקבוע negative_format, עם גופן אדום וסוגריים.

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