המחשה

Usage

visualization: {
  id: "unique-id" 
  label: "Visualization Label" 
  url: "visualization_url" 
  sri_hash: "SRI hash" 
  dependencies: ["dependency_url_1","dependency_url_2"]
  file: "visualization_file_path" 
}
היררכיה
visualization
ערך ברירת המחדל
ללא

כללים מיוחדים
התג visualization חייב לכלול את הפרמטר url או את הפרמטר file, אבל לא את שניהם

הגדרה

הפרמטר visualization מוסיף פריט ויזואלי מותאם אישית לפרויקט LookML, שהמשתמשים יכולים לגשת אליו מהכרטיסייה Visualization ב-Explores של הפרויקט. ההדמיה בהתאמה אישית צריכה להיות מוגדרת בקובץ JavaScript, שאפשר לכלול בקובצי פרויקט של LookML או לארח במקום אחר.

הפרמטר visualization כולל את הפרמטרים המשניים הבאים:

פרמטר תיאור
id מציין מזהה ייחודי לתרשים שמוצג בדף תרשימים בתפריט אדמין של Looker.
label התווית של התצוגה החזותית שמוצגת בכרטיסייה Visualization בדפי הניתוח של הפרויקט ובדף Visualizations בתפריט Admin של Looker.
url הפרמטר url מספק את כתובת ה-URL לקובץ ה-JavaScript של התרשים, אם הקובץ מאוחסן בשרת מחוץ למופע Looker. במקום להשתמש בפרמטר url, אפשר לגרור את הקובץ אל Looker IDE ואז להשתמש בפרמטר file כדי להפנות אל הקובץ.

NOTE: האפליקציה חייבת לכלול פרמטר url או פרמטר file, אבל לא את שניהם.
sri_hash ה-hash של SRI משמש רק כשקובץ ה-JavaScript של הוויזואליזציה מצוין באמצעות הפרמטר url. אם האתר שמארח את קוד הוויזואליזציה המותאמת אישית משתמש בגיבוב של תקינות משאבי המשנה (SRI) למטרות אימות, צריך להזין את הגיבוב של ה-SRI בשדה sri_hash.
dependencies רשימה מופרדת בפסיקים של כתובות URL של תלות, שנדרשות לטעינת הוויזואליזציה.
file מציין את הנתיב לקובץ JavaScript (עם הסיומת .js) שמגדיר את ההדמיה. הנתיב הוא יחסי לשורש הפרויקט. הדוגמה בעמודה הבאה מצביעה על הקובץ calendar-heatmap.js בספרייה visualizations של פרויקט LookML.

NOTE: האפליקציה צריכה לכלול את הפרמטר url או את הפרמטר file, אבל לא את שניהם.

דוגמה: הוספת כתובת URL של תרשים מותאם אישית לפרויקט של LookML

אחת מהאפשרויות להוספת תרשים מותאם אישית לפרויקט של LookML היא להשתמש בכתובת ה-URL של קובץ תרשים מותאם אישית. לדוגמה, הוספת קוד LookML הזה לקובץ המניפסט של פרויקט מוסיפה לפרויקט Looker ויזואליזציה מותאמת אישית של CDN עם כמה ערכים. הוויזואליזציה הזו מוגדרת בקובץ JavaScript שנמצא ב-Looker Marketplace:

visualization: {
  id: "spider-marketplace-dev"
  label: "Spider Viz"
  url: "https://marketplace-api.looker.com/viz-dist/spider.js"
  sri_hash: "oqVuAfXRKap7fdgcCY5uykM6+R9GqQ8K/uxy9rx7HNQlGYl1kPzQho1wx4JwY8wC"
  dependencies: ["https://code.jquery.com/jquery-2.2.4.min.js","https://cdnjs.cloudflare.com/ajax/libs/underscore.js/1.9.1/underscore-min.js","https://cdnjs.cloudflare.com/ajax/libs/d3/3.5.6/d3.min.js","https://cdnjs.cloudflare.com/ajax/libs/d3-legend/1.13.0/d3-legend.min.js"]
}

אחרי שמבצעים קומיט של השינויים ופורסים אותם בסביבת הייצור, השם של התרשים המותאם אישית מוצג ב-Looker כאפשרות בכרטיסייה Visualization של ניתוחי הנתונים בפרויקט.

הוויזואליזציה תופיע גם בדף Visualizations (וויזואליזציות) בקטע Platform (פלטפורמה) בתפריט Admin (אדמין) של Looker. מידע נוסף זמין בדף התיעוד הגדרות אדמין – וויזואליזציות.

דוגמה: הוספה של קובץ ויזואליזציה בהתאמה אישית לפרויקט של LookML

אפשרות נוספת היא להוסיף את קובץ ה-JavaScript של התרשים המותאם אישית לפרויקט של LookML באמצעות Looker IDE:

  1. ב-Looker IDE, גוררים ומשחררים את קובץ ה-JavaScript שמגדיר את התרשים בהתאמה אישית אל פרויקט LookML.
  2. אופציונלי: מעבירים את קובץ התצוגה החזותית לתיקייה בסביבת הפיתוח המשולבת של Looker, או יוצרים תיקייה חדשה לקובץ התצוגה החזותית.
  3. לוחצים על קובץ הוויזואליזציה בחלונית של דפדפן הקבצים כדי להציג את תוכן הקובץ, ואז לוחצים על שמירה כדי לשמור את הקובץ.
  4. בקובץ המניפסט של הפרויקט, מגדירים את הפרמטרים של התצוגה החזותית. לדוגמה, קוד ה-LookML הבא מוסיף פריט ויזואליזציה מותאם אישית של מד עגול לפרויקט Looker. ההדמיה מוגדרת בקובץ JavaScript שנמצא בספרייה visualizations של פרויקט של LookML:
  visualization: {
  id: "radial_gauge"
  label: "Radial Gauge"
  file: "visualizations/radialgauge_v2.js"
   }

  1. שומרים את השינויים ופורסים אותם בסביבת הייצור.

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

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

הוויזואליזציה מופיעה גם בדף Visualizations (וויזואליזציות) בקטע Platform (פלטפורמה) בתפריט Admin (אדמין) של Looker. מידע נוסף זמין בדף התיעוד Admin settings - Visualizations (הגדרות אדמין – וויזואליזציות).