אחרי שיוצרים הטמעה – שאפשר לעשות באופן ציבורי, באופן פרטי, באמצעות הטמעה עם חתימה או דרך API – אפשר ליצור אינטראקציה עם ה-iframe האלה באמצעות JavaScript. אתם יכולים להפוך את הדף לדינמי יותר על סמך הסטטוס של הפריט המוטמע, ואפילו לבצע שינויים בפריט המוטמע מתוך דף האינטרנט.
חשוב לדעת ש-Looker לא שולט בסדר שבו הדפדפנים שולחים אירועים לאפליקציות אינטרנט. המשמעות היא שסדר האירועים לא מובטח בדפדפנים או בפלטפורמות שונות. חשוב לכתוב את קוד ה-JavaScript בצורה מתאימה כדי להתחשב בטיפול באירועים בדפדפנים שונים.
אפשר להשתמש ב-JavaScript באחת מהדרכים הבאות לתוכן מוטמע ב-Looker:
- שימוש בערכת הכלים לפיתוח תוכנה (SDK) להטמעה של Looker, שמתוארת בדף התיעוד בנושא Embed SDK
- שימוש באירועי JavaScript, שמתואר בקטע גישה לאירועים ב-JavaScript בדף הזה
הכנה
כדי ליצור אינטראקציה עם ה-iframe המוטמע, צריך לבצע את השלבים הבאים:
- מוסיפים מזהה ל-iframe.
- מוסיפים את הדומיין של ההטמעה למאפיין
srcשל ה-iframe. - מוסיפים את הדומיין של ההטמעה לרשימת ההיתרים.
הוספת מזהה ל-iframe
בהמשך, כשמאחזרים נתונים מה-iframe, צריך לוודא שהמידע שאתם עובדים איתו הגיע באמת מה-iframe של Looker. כדי לעשות את זה, צריך להוסיף מזהה ל-iframe, אם עדיין לא עשיתם את זה. בדוגמה הבאה, המזהה מוגדר ל-looker על ידי הוספת id="looker" ל-iframe:
<iframe id="looker" src="https://instance_name.looker.com/embed/dashboards/1"></iframe>
הוספת הדומיין להטמעה למאפיין src של ה-iframe
במאפיין src של ה-iframe, מציינים את הדומיין שבו נעשה שימוש ב-iframe. בדוגמה הבאה, אפשר לציין את myownpersonaldomain.com כדומיין על ידי הוספת ?embed_domain=https://myownpersonaldomain.com" לסוף כתובת ה-URL במאפיין src:
<iframe
id="looker"
src="https://instance_name.looker.com/embed/dashboards/1?embed_domain=https://myownpersonaldomain.com">
</iframe>
אם אתם משתמשים בהטמעה חתומה, הקפידו להוסיף את הפרמטר embed_domain לכתובת ה-URL להטמעה.
אם אתם משתמשים ב-Embed SDK, מוסיפים את המחרוזת sdk=3 לסוף כתובת ה-URL של ההטמעה. הפרמטר sdk=3 מציין שערכת ה-SDK קיימת ושאפשר להשתמש ב-Looker בתכונות נוספות שערכת ה-SDK מספקת, כמו העברת אירועי JavaScript בין ה-iframe של Looker לבין הדומיין שלכם. ה-SDK לא יכול להוסיף את הפרמטר הזה בעצמו כי הוא חלק מכתובת ה-URL החתומה. לדוגמה:
<iframe
id="looker"
src="https://instance_name.looker.com/embed/dashboards/1?embed_domain=https://myownpersonaldomain.com&sdk=2">
</iframe>
הוספת הדומיין של ההטמעה לרשימת ההיתרים
בסוף, צריך להוסיף את הדומיין שבו נעשה שימוש ב-iframe לרשימת ההיתרים בדף הטמעה בחלונית ניהול של Looker. כדי לעשות את זה, מבצעים את השלבים הבאים:
בשדה רשימת הדומיינים המורשים להטמעה, מזינים את הדומיין שבו נעשה שימוש ב-iframe, ואז מקישים על מקש Tab כדי שהדומיין יופיע בתיבה בתוך השדה.
לוחצים על עדכון.
אתם יכולים להשתמש בתו הכללי לחיפוש * ברשימת ההיתרים כדי ליצור תבנית דומיין. לדוגמה, https://*.myownpersonaldomain.com יאפשר גם את https://analytics.myownpersonaldomain.com וגם את https://data.myownpersonaldomain.com.
אם אתם משתמשים בהטמעה ללא קובצי Cookie ב-Looker 23.8 ואילך, אפשר לציין את דומיין ההטמעה כשמקבלים את הסשן ללא קובצי Cookie. זוהי חלופה להוספת הדומיין להטמעה לרשימת ההיתרים באמצעות החלונית ניהול > הטמעה. אם אתם רוצים להשתמש בתכונה הזו, כדאי לעיין בשיטות המומלצות לשיפור האבטחה.
אחזור נתונים ממסגרת ה-iframe
אחרי שמבצעים את שלבי ההכנה, אפשר לגשת לאירועים שמועברים בין ה-iframe של Looker לבין הדומיין שלכם על ידי האזנה לאירועים מסוג postMessage.
ה-iframe המוטמע יכול ליצור כמה סוגי אירועים, כמו שמתואר בקטע הפניה לסוגי אירועים בדף הזה.
גישה לאירועים ב-JavaScript
הנה דוגמה להאזנה לאירועים האלה ב-JavaScript, ולאחר מכן לרישום האירועים במסוף:
window.addEventListener("message", function(event) {
if (event.source === document.getElementById("looker").contentWindow) {
if (event.origin === "https://instance_name.looker.com") {
console.log(JSON.parse(event.data));
}
}
});
הנה דוגמה להאזנה לאירועים האלה ב-jQuery, ואז לרישום שלהם במסוף:
$(window).on("message", function(event) {
if (event.originalEvent.source === $("#looker")[0].contentWindow) {
if (event.origin === "https://instance_name.looker.com") {
console.log(JSON.parse(event.data));
}
}
});
טבלת סיכום של סוגי האירועים
בטבלה הבאה מפורטים סוגי האירועים. בוחרים סוג אירוע כדי לראות את הפרטים שלו.
| סוג האירוע | הסיבה לאירוע |
|---|---|
dashboard:loaded |
במרכזי בקרה שבהם המשבצות לא מוגדרות להפעלה אוטומטית, מרכז הבקרה והרכיבים שלו נטענו אבל השאילתות עדיין לא פועלות. |
dashboard:run:start |
טעינת לוח הבקרה התחילה, והמשבצות שלו התחילו להיטען ולשאול שאילתות לגבי נתונים. |
dashboard:run:complete |
ההפעלה של לוח הבקרה הסתיימה, וגם הטעינה והשאילתות של כל המשבצות. |
dashboard:download |
הורדה של קובץ PDF של לוח הבקרה התחילה. |
dashboard:edit:start |
Added 22.20
מרכז בקרה עבר למצב עריכה. האירוע dashboard:save:complete יופעל כשהמרכז לשליטה יישמר בהצלחה. |
dashboard:edit:cancel |
Added 22.20 יצאתם ממצב עריכה של לוח בקרה בלי לשמור. |
dashboard:save:complete |
מרכז בקרה נערך ונשמר. |
dashboard:delete:complete |
מרכז בקרה נמחק. |
dashboard:tile:start |
התחילה טעינה של משבצת או שליחת שאילתה לגבי נתונים. |
dashboard:tile:complete |
הריצת השאילתה של משבצת הסתיימה. |
dashboard:tile:download |
ההורדה של הנתונים של המשבצת התחילה. |
dashboard:tile:explore |
משתמש לחץ על האפשרות הצגת נתונים נוספים במשבצת בלוח הבקרה. |
dashboard:tile:merge |
Added 25.14 משתמש לחץ על הלחצן או על פריט התפריט 'עריכת שאילתה ממוזגת'. |
dashboard:tile:view |
משתמש לחץ על האפשרות View Original Look (הצגת ה-Look המקורי) במשבצת של מרכז בקרה. |
dashboard:filters:changed |
המסננים של לוח הבקרה הופעלו או שונו. |
look:ready |
דוח Look התחיל לטעון נתוני שאילתה, בין אם השאילתה תופעל ובין אם לא. |
look:run:start |
התחילה טעינה של נתוני שאילתה ב-Look והשאילתה התחילה לפעול. |
look:run:complete |
ההרצה של השאילתה ב-Look הסתיימה. |
look:edit:start |
נוספה ב-25.10
טבלת Look הועברה למצב עריכה. האירוע look:save:complete יופעל כשהתצוגה המקדימה תישמר. |
look:edit:cancel |
נוסף ב-25.10 בוצעה יציאה ממצב עריכה של תבנית עיצוב בלי לשמור. |
look:save:complete |
טבלת Look נערכה ונשמרה. |
look:delete:complete |
העברתם Look לתיקיית האשפה. |
drillmenu:click |
משתמש לחץ על תפריט פירוט בדאשבורד שנוצר באמצעות link פרמטר LookML. |
drillmodal:download |
משתמש פתח תיבת דו-שיח של ניתוח מעמיק מתוך משבצת בלוח בקרה ולחץ על האפשרות הורדה. |
drillmodal:explore |
משתמש לחץ על האפשרות הצגת נתונים מנקודה זו בתיבת דו-שיח של פירוט. |
explore:ready |
תהליך הטעינה של נתוני השאילתה בניתוח התחיל, בין אם השאילתה תופעל ובין אם לא. |
explore:run:start |
התחיל תהליך טעינה של נתוני שאילתה בניתוח, והשאילתה התחילה לפעול. |
explore:run:complete |
ניתוח ב-Explore סיים להריץ את השאילתה. |
explore:state:changed |
כתובת ה-URL של דף החיפוש השתנתה כתוצאה מהפעולות של המשתמש. |
page:changed |
משתמש עבר לדף חדש בתוך ה-iframe. |
page:properties:changed |
הגובה של iframe של לוח בקרה השתנה. |
session:tokens |
כדי להמשיך, לקוח Looker צריך טוקנים. |
session:expired |
נוסף ב-25.10 פג התוקף של הסשן של המשתמש. |
session:status |
שליחת מידע על סטטוס הסשן. |
env:client:dialog |
נפתחה תיבת דו-שיח שאולי לא מוצגת במלואה, כמו תיבת דו-שיח של פירוט. האירוע הזה מאפשר לאפליקציית האירוח לגלול את תיבת הדו-שיח לתצוגה. |
מידע על סוגי אירועים
ה-iframe המוטמע יכול ליצור סוגים רבים ושונים של אירועים:
dashboard:loaded
במרכזי בקרה שבהם ההפעלה האוטומטית של המשבצות לא מוגדרת, האירוע הזה נוצר אחרי שמרכז הבקרה והרכיבים שלו נטענו, אבל לפני שהשאילתות מופעלות.
type: "dashboard:loaded",
status: "complete",
dashboard: {
id: 1,
title: "Business Pulse",
canEdit: true,
dashboard_filters: {
"date": "Last 6 Years",
"state": ""
},
absoluteUrl: "https://self-signed.looker.com:9999/embed/dashboards/1?embed_domain=https%3A%2F%2Fself-signed.looker.com%3A9999&date=Last+6+Years&state=",
url: "/embed/dashboards/1?embed_domain=https%3A%2F%2Fself-signed.looker.com%3A9999&date=Last+6+Years&state=",
options: {
layouts: [
{
id: 1,
dashboard_id: 1,
type: "newspaper",
active: true,
column_width: null,
width: null,
deleted: false,
dashboard_layout_components: [
{
id: 1,
dashboard_layout_id: 1,
dashboard_element_id: 1,
row: 0,
column: 0,
width: 8,
height: 4,
deleted: false
},
{
id: 2,
dashboard_layout_id: 1,
dashboard_element_id: 2,
row: 0,
column: 8,
width: 8,
height: 4,
deleted: false
}
]
}
],
elements: {
1: {
title: "Total Orders",
title_hidden: false,
vis_config: {
type: "single_value",
font_size: "medium",
title: "Total Orders"
}
},
2: {
title: "Average Order Profit",
title_hidden: false,
vis_config: {
type: "single_value",
title: "Average Order Profit"
}
}
}
}
}
| מאפיין | פורמט | תיאור |
|---|---|---|
status |
String | מציין אם לוח הבקרה והאלמנטים שלו נטענו בהצלחה. |
dashboard.id |
מספר/מחרוזת | המזהה של לוח הבקרה. |
dashboard.title |
String | הכותרת, כפי שהיא מוצגת בחלק העליון של לוח הבקרה. |
dashboard.canEdit |
בוליאני |
נוסף בגרסה 22.20
אם true, המשתמש יכול לערוך את לוח הבקרה. |
dashboard.dashboard_filters |
אובייקט | המסננים שהוחלו על לוח הבקרה. הפורמט של האובייקט הזה הוא: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...} |
dashboard.absoluteUrl |
String | כתובת ה-URL המלאה של לוח הבקרה. |
dashboard.url |
String | כתובת ה-URL היחסית של לוח הבקרה (רק הנתיב). |
dashboard.options |
אובייקט | המאפיינים והערכים של פריסת לוח הבקרה, רכיב פריסת לוח הבקרה ורכיב לוח הבקרה. אפשר לתת ערכים מעודכנים לכל המאפיינים שמוחזרים באובייקט options באמצעות האירוע dashboard:options:set. |
dashboard:run:start
האירוע הזה נוצר כשלוח הבקרה מתחיל להיטען, כשמשבצות המידע שלו מתחילות להיטען ולשאול שאילתות לגבי נתונים.
type: "dashboard:run:start",
dashboard: {
id: 23,
title: "My Dashboard",
canEdit: true,
url: "/embed/dashboards/...",
absoluteUrl: "https://instance_name.looker.com/embed/dashboards/...",
dashboard_filters: {
"Date": "Last 28 days",
"Total Orders": "Greater than 100"
}
}
| מאפיין | פורמט | תיאור |
|---|---|---|
dashboard.id |
מספר/מחרוזת | המזהה של לוח הבקרה. |
dashboard.title |
String | הכותרת, כפי שהיא מוצגת בחלק העליון של לוח הבקרה. |
dashboard.canEdit |
בוליאני |
נוסף בגרסה 22.20
אם true, המשתמש יכול לערוך את לוח הבקרה. |
dashboard.url |
String | כתובת ה-URL היחסית של לוח הבקרה (רק הנתיב). |
dashboard.absoluteUrl |
String | כתובת ה-URL המלאה של לוח הבקרה. |
dashboard.dashboard_filters |
אובייקט | המסננים שהוחלו על לוח הבקרה. הפורמט של האובייקט הזה הוא: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...} |
dashboard:run:complete
האירוע הזה נוצר כשלוח בקרה סיים את ההרצה וכל האריחים סיימו את הטעינה והשאילתות. האירוע הזה נוצר בין אם כל המשבצות נטענות בהצלחה ובין אם לא.
type: "dashboard:run:complete",
status: "complete",
dashboard: {
id: 23,
title: "My Dashboard",
canEdit: true,
url: "/embed/dashboards/...",
absoluteUrl: "https://my.looker.com/embed/dashboards/...",
dashboard_filters: {
"Date": "Last 28 days",
"Total Orders": "Greater than 100"
}
options: {
layouts: [
{
id: 1,
dashboard_id: 1,
type: "newspaper",
active: true,
column_width: null,
width: null,
deleted: false,
dashboard_layout_components: [
{
id: 1,
dashboard_layout_id: 1,
dashboard_element_id: 1,
row: 0,
column: 0,
width: 8,
height: 4,
deleted: false
},
{
id: 2,
dashboard_layout_id: 1,
dashboard_element_id: 2,
row: 0,
column: 8,
width: 8,
height: 4,
deleted: false
}
]
}
],
elements: {
1: {
title: "Total Orders",
title_hidden: false,
vis_config: {
type: "single_value",
font_size: "medium",
title: "Total Orders"
}
},
2: {
title: "Average Order Profit",
title_hidden: false,
vis_config: {
type: "single_value",
title: "Average Order Profit"
}
}
}
}
}
| מאפיין | פורמט | תיאור |
|---|---|---|
status |
String | מציין אם לוח הבקרה והאלמנטים שלו הופעלו בהצלחה. אם הפעלת לוח הבקרה והרכיבים שלו הסתיימה בהצלחה, הפונקציה status מחזירה "complete". אחרת, היא מחזירה "error".status אם לוח הבקרה הפעיל הופסק, דרך ממשק המשתמש או באמצעות הפעולה dashboard:stop, הפונקציה status תחזיר "stopped". |
dashboard.id |
מספר/מחרוזת | המזהה של לוח הבקרה. |
dashboard.title |
String | הכותרת, כפי שהיא מוצגת בחלק העליון של לוח הבקרה. |
dashboard.canEdit |
בוליאני |
נוסף בגרסה 22.20
אם true, המשתמש יכול לערוך את לוח הבקרה. |
dashboard.url |
String | כתובת ה-URL היחסית של לוח הבקרה (רק הנתיב). |
dashboard.absoluteUrl |
String | כתובת ה-URL המלאה של לוח הבקרה. |
dashboard.dashboard_filters |
אובייקט | המסננים שהוחלו על לוח הבקרה. הפורמט של האובייקט הזה הוא: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...} |
dashboard.options |
אובייקט | המאפיינים והערכים של פריסת לוח הבקרה, רכיב פריסת לוח הבקרה ורכיב לוח הבקרה. אפשר לעדכן את הערכים של כל המאפיינים שמוחזרים באובייקט options באמצעות הפעולה dashboard:options:set. |
dashboard.tileStatuses |
מערך אובייקטים | מערך של אובייקטים שמספקים את הסטטוסים של המשבצות. מאפייני האובייקט הם:
|
dashboard:download
האירוע הזה נוצר כשהורדה של קובץ PDF של לוח בקרה מתחילה.
type: "dashboard:download",
dashboard: {
id: 23,
title: "My Dashboard",
canEdit: true,
url: "/embed/dashboards/...",
absoluteUrl: "https://instance_name.looker.com/embed/dashboards/...",
dashboard_filters: {
"Date": "Last 28 days",
"Total Orders": "Greater than 100"
}
}
fileFormat: "pdf"
| מאפיין | פורמט | תיאור |
|---|---|---|
dashboard.id |
מספר/מחרוזת | המזהה של לוח הבקרה. |
dashboard.title |
String | הכותרת, כפי שהיא מוצגת בחלק העליון של לוח הבקרה. |
dashboard.canEdit |
בוליאני |
נוסף בגרסה 22.20
אם true, המשתמש יכול לערוך את לוח הבקרה. |
dashboard.url |
String | כתובת ה-URL היחסית של לוח הבקרה (רק הנתיב). |
dashboard.absoluteUrl |
String | כתובת ה-URL המלאה של לוח הבקרה. |
dashboard.dashboard_filters |
אובייקט | המסננים שהוחלו על לוח הבקרה. הפורמט של האובייקט הזה הוא: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...} |
fileFormat |
String | הפורמט של מרכז השליטה שהורדתם (רק "pdf" בשלב הזה). |
dashboard:edit:start
נוסף 22.20 האירוע הזה נוצר כשעוברים למצב עריכה בלוח בקרה.
type: "dashboard:edit:start",
dashboard: {
id: 23,
title: "My Dashboard",
canEdit: true,
url: "/embed/dashboards/...",
absoluteUrl: "https://instance_name.looker.com/embed/dashboards/...",
dashboard_filters: {
"Date": "Last 28 days",
"Total Orders": "Greater than 100"
}
}
| מאפיין | פורמט | תיאור |
|---|---|---|
dashboard.id |
מספר/מחרוזת | המזהה של לוח הבקרה. |
dashboard.title |
String | הכותרת, כפי שהיא מוצגת בחלק העליון של לוח הבקרה. |
dashboard.canEdit |
בוליאני |
נוסף בגרסה 22.20
אם true, המשתמש יכול לערוך את לוח הבקרה. |
dashboard.url |
String | כתובת ה-URL היחסית של לוח הבקרה (רק הנתיב). |
dashboard.absoluteUrl |
String | כתובת ה-URL המלאה של לוח הבקרה. |
dashboard.dashboard_filters |
אובייקט | המסננים שהוחלו על לוח הבקרה. הפורמט של האובייקט הזה הוא: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...} |
dashboard:edit:cancel
Added 22.20 האירוע הזה נוצר כשיוצאים ממצב עריכה של לוח בקרה בלי לשמור.
type: "dashboard:edit:cancel",
dashboard: {
id: 23,
title: "My Dashboard",
canEdit: true,
url: "/embed/dashboards/...",
absoluteUrl: "https://instance_name.looker.com/embed/dashboards/...",
dashboard_filters: {
"Date": "Last 28 days",
"Total Orders": "Greater than 100"
}
}
| מאפיין | פורמט | תיאור |
|---|---|---|
dashboard.id |
מספר/מחרוזת | המזהה של לוח הבקרה. |
dashboard.title |
String | הכותרת, כפי שהיא מוצגת בחלק העליון של לוח הבקרה. |
dashboard.canEdit |
בוליאני |
נוסף בגרסה 22.20
אם true, המשתמש יכול לערוך את לוח הבקרה. |
dashboard.url |
String | כתובת ה-URL היחסית של לוח הבקרה (רק הנתיב). |
dashboard.absoluteUrl |
String | כתובת ה-URL המלאה של לוח הבקרה. |
dashboard.dashboard_filters |
אובייקט | המסננים שהוחלו על לוח הבקרה. הפורמט של האובייקט הזה הוא: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...} |
dashboard:save:complete
האירוע הזה נוצר כשעורכים לוח בקרה ואז שומרים אותו.
type: "dashboard:save:complete",
dashboard: {
id: 23,
title: "My Dashboard",
canEdit: true,
dashboard_filters: {
"Date": "Last 28 days",
"Total Orders": "Greater than 100"
}
absoluteUrl: "https://instance_name.looker.com/embed/dashboards/...",
url: "/embed/dashboards/...",
options: {
layouts: [
{
id: 1,
dashboard_id: 1,
type: "newspaper",
active: true,
column_width: null,
width: null,
deleted: false,
dashboard_layout_components: [
{
id: 1,
dashboard_layout_id: 1,
dashboard_element_id: 1,
row: 0,
column: 0,
width: 8,
height: 4,
deleted: false
},
{
id: 2,
dashboard_layout_id: 1,
dashboard_element_id: 2,
row: 0,
column: 8,
width: 8,
height: 4,
deleted: false
}
]
}
],
elements: {
1: {
title: "Total Orders",
title_hidden: false,
vis_config: {
type: "single_value",
font_size: "medium",
title: "Total Orders"
}
},
2: {
title: "Average Order Profit",
title_hidden: false,
vis_config: {
type: "single_value",
title: "Average Order Profit"
}
}
}
}
}
| מאפיין | פורמט | תיאור |
|---|---|---|
dashboard.id |
מספר/מחרוזת | המזהה של לוח הבקרה. |
dashboard.title |
String | הכותרת, כפי שהיא מוצגת בחלק העליון של לוח הבקרה. |
dashboard.canEdit |
בוליאני |
נוסף בגרסה 22.20
אם true, המשתמש יכול לערוך את לוח הבקרה. |
dashboard.dashboard_filters |
אובייקט | המסננים שהוחלו על לוח הבקרה. הפורמט של האובייקט הזה הוא: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...} |
dashboard.absoluteUrl |
String | כתובת ה-URL המלאה של לוח הבקרה. |
dashboard.url |
String | כתובת ה-URL היחסית של לוח הבקרה (רק הנתיב). |
dashboard.options |
אובייקט | המאפיינים והערכים של פריסת לוח הבקרה, רכיב פריסת לוח הבקרה ורכיב לוח הבקרה. אפשר לתת ערכים מעודכנים לכל המאפיינים שמוחזרים באובייקט options באמצעות האירוע dashboard:options:set. |
dashboard:delete:complete
האירוע הזה נוצר כשלוח בקרה נמחק.
type: "dashboard:delete:complete",
dashboard: {
id: 23,
title: "My Dashboard",
canEdit: true,
dashboard_filters: {
"Date": "Last 28 days",
"Total Orders": "Greater than 100"
}
absoluteUrl: "https://instance_name.looker.com/embed/dashboards/...",
url: "/embed/dashboards/...",
options: {
layouts: [
{
id: 1,
dashboard_id: 1,
type: "newspaper",
active: true,
column_width: null,
width: null,
deleted: false,
dashboard_layout_components: [
{
id: 1,
dashboard_layout_id: 1,
dashboard_element_id: 1,
row: 0,
column: 0,
width: 8,
height: 4,
deleted: false
},
{
id: 2,
dashboard_layout_id: 1,
dashboard_element_id: 2,
row: 0,
column: 8,
width: 8,
height: 4,
deleted: false
}
]
}
],
elements: {
1: {
title: "Total Orders",
title_hidden: false,
vis_config: {
type: "single_value",
font_size: "medium",
title: "Total Orders"
}
},
2: {
title: "Average Order Profit",
title_hidden: false,
vis_config: {
type: "single_value",
title: "Average Order Profit"
}
}
}
}
}
| מאפיין | פורמט | תיאור |
|---|---|---|
dashboard.id |
מספר/מחרוזת | המזהה של לוח הבקרה. |
dashboard.title |
String | הכותרת, כפי שהיא מוצגת בחלק העליון של לוח הבקרה. |
dashboard.canEdit |
בוליאני |
נוסף בגרסה 22.20
אם true, המשתמש יכול לערוך את לוח הבקרה. |
dashboard.dashboard_filters |
אובייקט | המסננים שהוחלו על לוח הבקרה. הפורמט של האובייקט הזה הוא: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...} |
dashboard.absoluteUrl |
String | כתובת ה-URL המלאה של לוח הבקרה. |
dashboard.url |
String | כתובת ה-URL היחסית של לוח הבקרה (רק הנתיב). |
dashboard.options |
אובייקט | המאפיינים והערכים של פריסת לוח הבקרה, רכיב פריסת לוח הבקרה ורכיב לוח הבקרה. אפשר לתת ערכים מעודכנים לכל המאפיינים שמוחזרים באובייקט options באמצעות האירוע dashboard:options:set. |
dashboard:tile:start
האירוע הזה נוצר כשמתחילה טעינה של משבצת או כשמתבצעת שאילתה לגבי נתונים.
type: "dashboard:tile:start",
dashboard: {
id: 23,
title: "My Dashboard",
canEdit: true,
url: "/embed/dashboards/...",
absoluteUrl: "https://instance_name.looker.com/embed/dashboards/...",
dashboard_filters: {
"Date": "Last 28 days",
"Total Orders": "Greater than 100"
}
}
tile: {
id: 123,
title: "Quarterly Sales",
listen: {
"Date": "order.date",
"Total Orders": "order.count"
}
}
| מאפיין | פורמט | תיאור |
|---|---|---|
dashboard.id |
מספר/מחרוזת | המזהה של לוח הבקרה שאליו שייכת המשבצת. |
dashboard.title |
String | הכותרת של לוח הבקרה, כפי שמופיעה בחלק העליון של לוח הבקרה שאליו שייכת המשבצת. |
dashboard.canEdit |
בוליאני |
נוסף בגרסה 22.20
אם true, המשתמש יכול לערוך את לוח הבקרה. |
dashboard.url |
String | כתובת ה-URL היחסית של לוח הבקרה (רק הנתיב) שאליו שייכת המשבצת. |
dashboard.absoluteUrl |
String | כתובת ה-URL המלאה של לוח הבקרה שאליו שייכת המשבצת. |
dashboard.dashboard_filters |
אובייקט | המסננים שהוחלו על לוח הבקרה שאליו שייכת המשבצת. הפורמט של האובייקט הזה הוא: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...} |
tile.id |
מספר שלם | מספר המזהה של האירוע, לא של המשבצת. |
tile.title |
String | הכותרת של המשבצת, כפי שהיא מוצגת בחלק העליון של המשבצת. |
tile.listen |
אובייקט | המסננים של מרכז הבקרה הגלובלי הם אלה שהמשבצת הזו מאזינה להם. הפורמט של האובייקט הזה הוא: {"Filter Label": "Filter Field", ...} |
dashboard:tile:complete
האירוע הזה נוצר כשמשבצת מסיימת להריץ את השאילתה.
type: "dashboard:tile:complete",
dashboard: {
id: 23,
title: "My Dashboard",
canEdit: true,
url: "/embed/dashboards/...",
absoluteUrl: "https://instance_name.looker.com/embed/dashboards/...",
dashboard_filters: {
"Date": "Last 28 days",
"Total Orders": "Greater than 100"
}
}
status: "complete",
truncated: false,
tile: {
id: 123,
title: "Quarterly Sales",
listen: {
"Date": "order.date",
"Total Orders": "order.count"
}
}
| מאפיין | פורמט | תיאור |
|---|---|---|
dashboard.id |
מספר/מחרוזת | המזהה של לוח הבקרה שאליו שייכת המשבצת. |
dashboard.title |
String | הכותרת של לוח הבקרה, כפי שמופיעה בחלק העליון של לוח הבקרה שאליו שייכת המשבצת. |
dashboard.canEdit |
בוליאני |
נוסף בגרסה 22.20
אם true, המשתמש יכול לערוך את לוח הבקרה. |
dashboard.url |
String | כתובת ה-URL היחסית של לוח הבקרה (רק הנתיב) שאליו שייכת המשבצת. |
dashboard.absoluteUrl |
String | כתובת ה-URL המלאה של לוח הבקרה שאליו שייכת המשבצת. |
dashboard.dashboard_filters |
אובייקט | המסננים שהוחלו על לוח הבקרה שאליו שייכת המשבצת. הפורמט של האובייקט הזה הוא: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...} |
status |
String | האם השאילתה של הכרטיס הושלמה בהצלחה. הערכים האפשריים הם "complete" או "error". |
truncated |
בוליאני | האם תוצאות השאילתה של המשבצת נחתכו כי השאילתה החזירה יותר שורות ממגבלת השורות של השאילתה. מגבלת השורות יכולה להיות מגבלת שורות שהמשתמש הגדיר או מגבלת השורות שמוגדרת כברירת מחדל ב-Looker, שהיא 5,000. |
tile.id |
מספר שלם | מספר המזהה של האירוע, לא של המשבצת. |
tile.title |
String | הכותרת של המשבצת, כפי שהיא מוצגת בחלק העליון של המשבצת. |
tile.listen |
אובייקט | המסננים של מרכז הבקרה הגלובלי הם אלה שהמשבצת הזו מאזינה להם. הפורמט של האובייקט הזה הוא: {"Filter Label": "Filter Field", ...} |
tile.errors |
מערך אובייקטים | השדה הזה מאוכלס כשהערך של המאפיין status הוא "error". מערך של אובייקטים שמספקים פרטים על השגיאה, כולל טקסט הודעת השגיאה, תיאור מפורט יותר של השגיאה ושאילתת ה-SQL של המשבצת שיצרה את השגיאה. |
dashboard:tile:download
האירוע הזה נוצר כשההורדה של הנתונים של משבצת מתחילה.
type: "dashboard:tile:download",
dashboard: {
id: 23,
title: "My Dashboard",
canEdit: true,
url: "/embed/dashboards/...",
absoluteUrl: "https://instance_name.looker.com/embed/dashboards/...",
dashboard_filters: {
"Date": "Last 28 days",
"Total Orders": "Greater than 100"
}
}
tile: {
id: 123,
title: "Quarterly Sales"
listen: {
"Date": "order.date",
"Total Orders": "order.count"
}
}
fileFormat: "pdf"
| מאפיין | פורמט | תיאור |
|---|---|---|
dashboard.id |
מספר/מחרוזת | המזהה של לוח הבקרה שאליו שייכת המשבצת. |
dashboard.title |
String | הכותרת של לוח הבקרה, כפי שמופיעה בחלק העליון של לוח הבקרה שאליו שייכת המשבצת. |
dashboard.canEdit |
בוליאני |
נוסף בגרסה 22.20
אם true, המשתמש יכול לערוך את לוח הבקרה. |
dashboard.url |
String | כתובת ה-URL היחסית של לוח הבקרה (רק הנתיב) שאליו שייכת המשבצת. |
dashboard.absoluteUrl |
String | כתובת ה-URL המלאה של לוח הבקרה שאליו שייכת המשבצת. |
dashboard.dashboard_filters |
אובייקט | המסננים שהוחלו על לוח הבקרה שאליו שייכת המשבצת. הפורמט של האובייקט הזה הוא: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...} |
tile.id |
מספר שלם | מספר המזהה של האירוע, לא של המשבצת. |
tile.title |
String | הכותרת של המשבצת, כפי שהיא מוצגת בחלק העליון של המשבצת. |
tile.listen |
אובייקט | המסננים של מרכז הבקרה הגלובלי הם אלה שהמשבצת הזו מאזינה להם. הפורמט של האובייקט הזה הוא: {"Filter Label": "Filter Field", ...} |
fileFormat |
String | הפורמט של המשבצת שהורדתם (רק "pdf" בשלב הזה). |
dashboard:tile:explore
האירוע הזה נוצר כשמשתמש לוחץ על האפשרות הצגת נתונים נוספים במשבצת במרכז הבקרה.
אפשר לבטל את האירוע הזה, כלומר אפליקציית ההטמעה יכולה להחזיר {cancel: true} ו-Looker לא ימשיך עם אירוע ההפעלה.
type: "dashboard:tile:explore",
label: 'Explore From Here',
url: '/embed/explore/model/view...',
dashboard: {
id: 23,
title: "My Dashboard",
canEdit: true,
url: "/embed/dashboards/...",
absoluteUrl: "https://instance_name.looker.com/embed/dashboards/...",
dashboard_filters: {
"Date": "Last 28 days",
"Total Orders": "Greater than 100"
}
}
tile: {
id: 123,
title: "Quarterly Sales",
listen: {
"Date": "order.date",
"Total Orders": "order.count"
}
}
| מאפיין | פורמט | תיאור |
|---|---|---|
label |
String | תווית הכפתור. |
url |
String | כתובת ה-URL היחסית (רק הנתיב) של הניתוח שרוצים להציג. |
dashboard.id |
מספר/מחרוזת | המזהה של לוח הבקרה שאליו שייכת המשבצת. |
dashboard.title |
String | הכותרת של לוח הבקרה, כפי שמופיעה בחלק העליון של לוח הבקרה שאליו שייכת המשבצת. |
dashboard.canEdit |
בוליאני |
נוסף בגרסה 22.20
אם true, המשתמש יכול לערוך את לוח הבקרה. |
dashboard.url |
String | כתובת ה-URL היחסית של לוח הבקרה (רק הנתיב) שאליו שייכת המשבצת. |
dashboard.absoluteUrl |
String | כתובת ה-URL המלאה של לוח הבקרה שאליו שייכת המשבצת. |
dashboard.dashboard_filters |
אובייקט | המסננים שהוחלו על לוח הבקרה שאליו שייכת המשבצת. הפורמט של האובייקט הזה הוא: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...} |
tile.id |
מספר שלם | מספר המזהה של האירוע, לא של המשבצת. |
tile.title |
String | הכותרת של המשבצת, כפי שהיא מוצגת בחלק העליון של המשבצת. |
tile.listen |
אובייקט | המסננים של מרכז הבקרה הגלובלי הם אלה שהמשבצת הזו מאזינה להם. הפורמט של האובייקט הזה הוא: {"Filter Label": "Filter Field", ...} |
dashboard:tile:view
האירוע הזה נוצר כשמשתמש לוחץ על האפשרות הצגת המראה המקורי במשבצת של לוח בקרה.
אפשר לבטל את האירוע הזה, כלומר אפליקציית ההטמעה יכולה להחזיר {cancel: true} ו-Looker לא ימשיך עם אירוע ההפעלה.
type: "dashboard:tile:view",
label: 'View Original Look',
url: '/embed/look/...',
dashboard: {
id: 23,
title: "My Dashboard",
canEdit: true,
url: "/embed/dashboards/...",
absoluteUrl: "https://instance_name.looker.com/embed/dashboards/...",
dashboard_filters: {
"Date": "Last 28 days",
"Total Orders": "Greater than 100"
}
}
tile: {
id: 123,
title: "Quarterly Sales",
listen: {
"Date": "order.date",
"Total Orders": "order.count"
}
}
| מאפיין | פורמט | תיאור |
|---|---|---|
label |
String | תווית הכפתור. |
url |
String | כתובת ה-URL היחסית (רק הנתיב) של טבלת ה-Look שרוצים להציג. |
dashboard.id |
מספר/מחרוזת | המזהה של לוח הבקרה שאליו שייכת המשבצת. |
dashboard.title |
String | הכותרת של לוח הבקרה, כפי שמופיעה בחלק העליון של לוח הבקרה שאליו שייכת המשבצת. |
dashboard.canEdit |
בוליאני |
נוסף בגרסה 22.20
אם true, המשתמש יכול לערוך את לוח הבקרה. |
dashboard.url |
String | כתובת ה-URL היחסית של לוח הבקרה (רק הנתיב) שאליו שייכת המשבצת. |
dashboard.absoluteUrl |
String | כתובת ה-URL המלאה של לוח הבקרה שאליו שייכת המשבצת. |
dashboard.dashboard_filters |
אובייקט | המסננים שהוחלו על לוח הבקרה שאליו שייכת המשבצת. הפורמט של האובייקט הזה הוא: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...} |
tile.id |
מספר שלם | מספר המזהה של האירוע, לא של המשבצת. |
tile.title |
String | הכותרת של המשבצת, כפי שהיא מוצגת בחלק העליון של המשבצת. |
tile.listen |
אובייקט | המסננים של מרכז הבקרה הגלובלי הם אלה שהמשבצת הזו מאזינה להם. הפורמט של האובייקט הזה הוא: {"Filter Label": "Filter Field", ...} |
dashboard:tile:merge
Added 25.14 האירוע הזה נוצר כשהמשתמש לוחץ על הלחצן עריכת השאילתה הממוזגת או על פריט התפריט עריכת השאילתה הממוזגת. התנהגות ברירת המחדל של הלחצן הזה היא פתיחת חלון חדש ברמה העליונה שמאפשר לערוך את שאילתת המיזוג.
אפשר לבטל את האירוע הזה, כלומר אפליקציית ההטמעה יכולה להחזיר {cancel: true} ו-Looker לא ימשיך עם אירוע ההפעלה. האירוע הזה מאפשר לאפליקציה המטמיעה לפתוח את עריכת שאילתת המיזוג ב-iframe ולא בחלון ברמה העליונה. האפליקציה להטמעה לא צריכה לנסות לטעון את כתובת ה-URL ב-iframe שהפעיל את האירוע. במקום זאת, צריך ליצור iframe חדש.
javascript
type: dashboard:tile:merge,
label: 'Edit Merged Query',
dashboard_id: '13',
dashboard_modified: false,
tile_id: '218',
tile_title: 'Untitled',
url: '/embed/merge/edit?did=218&dbnx=1',
absoluteUrl: 'https://.../embed/merge/edit?did=218&dbnx=1',
target: '_blank',
| מאפיין | פורמט | תיאור |
|---|---|---|
label |
מחרוזת | תווית הכפתור. |
dashboard_id |
מחרוזת | המזהה של לוח הבקרה שאליו משויכת משבצת השאילתה הממוזגת. |
dashboard_modified |
בוליאני | אם הערך הוא true, המאפיין הזה מציין שהייתה עריכה בלוח הבקרה. אם תמשיכו לערוך את שאילתת המיזוג, יכול להיות שהעדכונים בלוח הבקרה יאבדו. אפליקציית ההטמעה יכולה לבטל את העריכה של שאילתת המיזוג או להזהיר את המשתמש שאולי יש שינויים שלא נשמרו אם הוא ימשיך. |
tile_id |
מחרוזת | המזהה של משבצת השאילתה הממוזגת. |
tile_title |
מחרוזת | השם של המשבצת. |
url |
מחרוזת | כתובת ה-URL של השאילתה הממוזגת. אפשר להשתמש במאפיין הזה עם SDK להטמעה כדי ליצור iframe חדש לשאילתה הממוזגת. |
absoluteUrl |
מחרוזת | כתובת ה-URL המלאה של השאילתה הממוזגת. אפשר להשתמש במאפיין הזה כsrc של רכיב ה-iframe. יהיה צורך במאפיינים נוספים. |
target |
מחרוזת | המזהה שישמש לשם החלון שייפתח. |
dashboard:filters:changed
האירוע הזה נוצר כשמחילים או משנים מסננים בלוח בקרה.
type: "dashboard:filters:changed",
dashboard: {
id: 23,
title: "My Dashboard",
canEdit: true,
url: "/embed/dashboards/...",
absoluteUrl: "https://instance_name.looker.com/embed/dashboards/...",
dashboard_filters: {
"Date": "Last 28 days",
"Total Orders": "Greater than 100"
}
options: {
layouts: [
{
id: 1,
dashboard_id: 1,
type: "newspaper",
active: true,
column_width: null,
width: null,
deleted: false,
dashboard_layout_components: [
{
id: 1,
dashboard_layout_id: 1,
dashboard_element_id: 1,
row: 0,
column: 0,
width: 8,
height: 4,
deleted: false
},
{
id: 2,
dashboard_layout_id: 1,
dashboard_element_id: 2,
row: 0,
column: 8,
width: 8,
height: 4,
deleted: false
}
]
}
],
elements: {
1: {
title: "Total Orders",
title_hidden: false,
vis_config: {
type: "single_value",
font_size: "medium",
title: "Total Orders"
}
},
2: {
title: "Average Order Profit",
title_hidden: false,
vis_config: {
type: "single_value",
title: "Average Order Profit"
}
}
}
}
}
| מאפיין | פורמט | תיאור |
|---|---|---|
dashboard.id |
מספר/מחרוזת | המזהה של לוח הבקרה. |
dashboard.title |
String | הכותרת, כפי שהיא מוצגת בחלק העליון של לוח הבקרה. |
dashboard.canEdit |
בוליאני |
נוסף בגרסה 22.20
אם true, המשתמש יכול לערוך את לוח הבקרה. |
dashboard.url |
String | כתובת ה-URL היחסית של לוח הבקרה (רק הנתיב). |
dashboard.absoluteUrl |
String | כתובת ה-URL המלאה של לוח הבקרה. |
dashboard.dashboard_filters |
אובייקט | המסננים שהוחלו על לוח הבקרה. הפורמט של האובייקט הזה הוא: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...} |
dashboard.options |
אובייקט | המאפיינים והערכים של פריסת לוח הבקרה, רכיב פריסת לוח הבקרה ורכיב לוח הבקרה. אפשר לתת ערכים מעודכנים לכל המאפיינים שמוחזרים באובייקט options באמצעות האירוע dashboard:options:set. |
look:ready
האירוע הזה נוצר כשמתחילים לטעון נתוני שאילתה ב-Look, בין אם השאילתה מופעלת ובין אם לא.
type: "look:ready",
look: {
url: "/embed/looks/...",
absoluteUrl: "https://instance_name.looker.com/embed/looks/...",
}
| מאפיין | פורמט | תיאור |
|---|---|---|
look.url |
String | כתובת ה-URL היחסית של ה-Look (רק הנתיב) |
look.absoluteUrl |
String | כתובת ה-URL המלאה של טבלת Look |
look:run:start
האירוע הזה נוצר כשמתחילים לטעון נתוני שאילתה ב-Look והשאילתה מתחילה לפעול.
type: "look:run:start",
look: {
url: "/embed/looks/...",
absoluteUrl: "https://instance_name.looker.com/embed/looks/...",
}
| מאפיין | פורמט | תיאור |
|---|---|---|
look.url |
String | כתובת ה-URL היחסית של ה-Look (רק הנתיב) |
look.absoluteUrl |
String | כתובת ה-URL המלאה של טבלת Look |
look:run:complete
האירוע הזה נוצר כששאילתה של Look מסתיימת.
type: look:run:complete
look: {
url: "/embed/looks/...",
absoluteUrl: "https://instance_name.looker.com/embed/looks/...",
}
| מאפיין | פורמט | תיאור |
|---|---|---|
look.url |
String | כתובת ה-URL היחסית של ה-Look (רק הנתיב) |
look.absoluteUrl |
String | כתובת ה-URL המלאה של טבלת Look |
look:edit:start
נוסף ב-25.10 האירוע הזה מופעל כשמבצעים מעבר של טבלת Look למצב עריכה.
type: "look:edit:start",
look: {
id: 46,
title: "My Look",
url: "/embed/looks/46",
absoluteUrl: "https://instance_name.looker.com/embed/looks/46",
}
| מאפיין | פורמט | תיאור |
|---|---|---|
look.id |
String | המזהה של טבלת ה-Look. |
look.title |
String | השם של ה-Look. |
url |
String | כתובת ה-URL היחסית של ה-Look (רק הנתיב). |
absoluteUrl |
String | כתובת ה-URL המלאה של ה-Look. |
look:edit:cancel
Added 25.10 האירוע הזה מופעל כשיוצאים ממצב עריכה של טבלת Look בלי לשמור אותה.
type: "look:edit:cancel",
look: {
id: 46,
title: "My Look",
url: "/embed/looks/46",
absoluteUrl: "https://instance_name.looker.com/embed/looks/46",
}
| מאפיין | פורמט | תיאור |
|---|---|---|
look.id |
String | המזהה של טבלת ה-Look. |
look.title |
String | השם של ה-Look. |
url |
String | כתובת ה-URL היחסית של ה-Look (רק הנתיב). |
absoluteUrl |
String | כתובת ה-URL המלאה של ה-Look. |
look:save:complete
האירוע הזה נוצר כשעורכים ושומרים Look. האירוע הזה נוצר כשמשתמש מבצע אחת מהמשימות הבאות:
- לוחץ על הלחצן עריכה כדי לערוך את התצוגה ואז לוחץ על שמירה
- שמירת Look באמצעות אפשרות התפריט Save > Save As… (שמירה > שמירה בשם…).
- העברת Look מתיקייה אחת לתיקייה אחרת
האירוע הזה לא נוצר אם שומרים את טבלת Look באמצעות האפשרות שמירה > ללוח בקרה קיים או עריכת ההגדרות בתפריט.
type: look:save:complete
look: {
url: "/embed/looks/...",
absoluteUrl: "https://instance_name.looker.com/embed/looks/...",
folderid: 123
}
| מאפיין | פורמט | תיאור |
|---|---|---|
look.url |
String | כתובת ה-URL היחסית של ה-Look (רק הנתיב) |
look.absoluteUrl |
String | כתובת ה-URL המלאה של טבלת Look |
look.folderid |
מספר שלם | מזהה התיקייה שבה שמור ה-Look |
look:delete:complete
האירוע הזה נוצר כשמעבירים טבלת Look לתיקיית האשפה.
type: look:delete:complete
look: {
url: "/embed/looks/...",
absoluteUrl: "https://instance_name.looker.com/embed/looks/...",
}
| מאפיין | פורמט | תיאור |
|---|---|---|
look.url |
String | כתובת ה-URL היחסית של ה-Look (רק הנתיב) |
look.absoluteUrl |
String | כתובת ה-URL המלאה של טבלת Look |
drillmenu:click
האירוע הזה נוצר כשמשתמש לוחץ על תפריט פירוט בדשבורד שנוצר באמצעות הפרמטר LookML link. לדוגמה, קוד ה-LookML הבא יוצר תפריט של התעמקות בנתונים שבו משתמש יכול להציג נתונים שמסוננים לפי המאפיין state:
dimension: state {
type: string
sql: ${TABLE}.state ;;
link: {
label: "Filter by {{ state | encode_uri }}"
url: "filter::q={{ state | encode_uri }}"
icon_url: "https://google.com/favicon.ico"
}
}
כשהמסנן state מוגדר לערך Illinois, האירוע drillmenu:click מחזיר את הערכים הבאים למארח של ה-iframe:
type: "drillmenu:click",
label: "Filter by Illinois",
link_type: "url",
modal: false,
target: '_self',
url: "#filter::state=Illinois"
context: ' '
אפשר לבטל את האירוע הזה, כלומר אפליקציית ההטמעה יכולה להחזיר {cancel: true} ו-Looker לא ימשיך עם אירוע ההפעלה.
| מאפיין | פורמט | תיאור |
|---|---|---|
label |
String | התווית של הקישור כפי שהיא מוצגת בתפריט ההסתעפות |
link_type |
String | סוג האובייקט ביעד הקישור |
modal |
בוליאני | אם תיבת הדו-שיח של ההסתעפות תהיה בשימוש במקום הניווט בדפדפן |
target |
String | Is _self אם יעד הקישור יחליף את ה-iframe הנוכחי, _blank אם יעד הקישור יפתח חלון חדש |
url |
String | כתובת היעד של הקישור |
context |
String | מאפיין פנימי שמשמש חלק מסוגי ההדמיות |
הוספת ארגז חול ל-iframe תמנע פתיחה של לחיצות על תפריט ההסתעפות בחלון חדש. משתמשים בערכי הארגז חול האלה בתוך תג ה-iframe:
sandbox = "allow-same-origin allow-scripts"
drillmodal:download
האירוע הזה נוצר כשמשתמש פותח תיבת דו-שיח של הסתעפות מפרט בלוח בקרה ולוחץ על האפשרות הורדה.
{
type: "drillmodal:download",
dashboard: {
id: 23,
title: "My Dashboard",
url: "/embed/dashboards/…",
absoluteUrl: "https://instance_name.looker.com/embed/dashboards/…",
dashboard_filters: {
"Date": "Last 28 days",
"Total Orders": "Greater than 100"
}
}
drillExploreUrl: "/embed...",
fileFormat: "pdf"
}
| מאפיין | פורמט | תיאור |
|---|---|---|
dashboard.id |
מספר/מחרוזת | המזהה של לוח הבקרה שאליו שייכת המשבצת. |
dashboard.title |
String | הכותרת של לוח הבקרה, כפי שמופיעה בחלק העליון של לוח הבקרה שאליו שייכת המשבצת. |
dashboard.url |
String | כתובת ה-URL היחסית של לוח הבקרה (רק הנתיב) שאליו שייכת המשבצת. |
dashboard.absoluteUrl |
String | כתובת ה-URL המלאה של לוח הבקרה שאליו שייכת המשבצת. |
dashboard.dashboard_filters |
אובייקט | המסננים שהוחלו על לוח הבקרה שאליו שייכת המשבצת. הפורמט של האובייקט הזה הוא: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...} |
drillExploreUrl |
String | כתובת ה-URL היחסית של הדוח ב-Explore (רק הנתיב) להורדה. |
fileFormat |
String | פורמט הקובץ של הנתונים להורדה. |
drillmodal:explore
האירוע הזה נוצר כשמשתמש לוחץ על האפשרות Explore From Here (המשך החיפוש מכאן) בתיבת דו-שיח של הסתעפות.
אפשר לבטל את האירוע הזה, כלומר אפליקציית ההטמעה יכולה להחזיר {cancel: true} ו-Looker לא ימשיך עם אירוע ההפעלה.
type: "drillmodal:explore",
label: "Explore From Here",
url: "/embed/explore/model/view..."
| מאפיין | פורמט | תיאור |
|---|---|---|
label |
String | תווית הלחצן כפי שהיא מוצגת בתפריט ההסתעפות |
url |
String | כתובת ה-URL היחסית של התכונה 'חיפוש חזותי' (רק הנתיב) שרוצים להציג |
explore:ready
האירוע הזה נוצר כשמתחילים לטעון נתוני שאילתה ב'ניתוח נתונים', בין אם השאילתה מופעלת ובין אם לא.
type: "explore:ready",
explore: {
url: "/embed/explore/...",
absoluteUrl: "https://instance_name.looker.com/embed/explore/...",
}
| מאפיין | פורמט | תיאור |
|---|---|---|
explore.url |
String | כתובת ה-URL היחסית של התכונה 'הצעות תוכן עבורך' (רק הנתיב) |
explore.absoluteUrl |
String | כתובת ה-URL המלאה של התכונה 'חיפוש' |
explore:run:start
האירוע הזה נוצר כשמתחילים לטעון נתוני שאילתה ב'ניתוח נתונים' והשאילתה מתחילה לפעול.
type: "explore:run:start",
explore: {
url: "/embed/explore/...",
absoluteUrl: "https://instance_name.looker.com/embed/explore/...",
}
| מאפיין | פורמט | תיאור |
|---|---|---|
explore.url |
String | כתובת ה-URL היחסית של התכונה 'הצעות תוכן עבורך' (רק הנתיב) |
explore.absoluteUrl |
String | כתובת ה-URL המלאה של התכונה 'חיפוש' |
explore:run:complete
האירוע הזה נוצר כשניתוח מסוג Explore מסיים להריץ את השאילתה.
type: "explore:run:complete",
explore: {
url: "/embed/explore/...",
absoluteUrl: "https://instance_name.looker.com/embed/explore/...",
}
}
| מאפיין | פורמט | תיאור |
|---|---|---|
explore.url |
String | כתובת ה-URL היחסית של התכונה 'הצעות תוכן עבורך' (רק הנתיב) |
explore.absoluteUrl |
String | כתובת ה-URL המלאה של התכונה 'חיפוש' |
explore:state:changed
האירוע הזה נוצר כשכתובת ה-URL של דף החיפוש משתנה כתוצאה מהפעולות של המשתמש.
type: "explore:state:changed",
explore: {
url: "/embed/explore/...",
absoluteUrl: "https://instance_name.looker.com/embed/explore/..."
}
| מאפיין | פורמט | תיאור |
|---|---|---|
explore.url |
String | כתובת ה-URL היחסית של התכונה 'הצעות תוכן עבורך' (רק הנתיב) |
explore.absoluteUrl |
String | כתובת ה-URL המלאה של התכונה 'חיפוש' |
page:changed
האירוע הזה נוצר כשמשתמש מנווט לדף חדש בתוך ה-iframe.
type: "page:changed",
page: {
type: "dashboard",
url: "/embed/dashboards/...",
absoluteUrl: "https://instance_name.looker.com/embed/dashboards/..."
}
| מאפיין | פורמט | תיאור |
|---|---|---|
page.type |
String | סוג הדף שאליו בוצעה הניווט, כמו "dashboard", "look" או "explore" |
page.url |
String | כתובת ה-URL היחסית (רק הנתיב) של הדף שאליו בוצעה הניווט |
page.absoluteUrl |
String | כתובת ה-URL המלאה של הדף שאליו בוצעה הניווט |
page:properties:changed
האירוע הזה נוצר כשגובה ה-iframe של לוח הבקרה משתנה. האפשרות הזו לא זמינה ב-Looks או ב-Explores כי הגובה של הפריטים האלה מותאם אוטומטית לגודל של ה-iframe.
type: "page:properties:changed",
height: 1000
| מאפיין | פורמט | תיאור |
|---|---|---|
height |
מספר שלם | גובה ה-iframe של לוח הבקרה בפיקסלים |
session:tokens
האירוע הזה מציין שלקוח Looker נדרשים אסימונים כדי להמשיך. האירוע הזה נוצר מיד עם יצירת ה-iframe, ומעכשיו ואילך באופן תקופתי למשך הסשן.
{
"type": "session:tokens",
"api_token": "eyJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwczovL3NlbGYtc2lnbmVkLmxvb2tlci5jb206OTk5OSIsImV4cCI6MTY3MDYyNjMzMCwic3ViIjoiYVdrNWFGUzM4RnRwNzFFWXhuS3ZaMXdKRmV3ZjB2VzYtTV9zLWtCcHE1dXIiLCJ0b2tlbl90eXBlIjoiYXBpX3Rva2VuIiwicmFuZG9taXplciI6IkxjYnpOeDNTVjNOb3o3UVlqTVJjNmhlMkdodjh1a2UwWUhiZWNRMHVCYm1KIn0.CBv1__QGc_H7bKNe31SHMMQCsc5ya1xOiEv1UDWAyxM",
"api_token_ttl": 463,
"navigation_token": "eyJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwczovL3NlbGYtc2lnbmVkLmxvb2tlci5jb206OTk5OSIsImV4cCI6MTY3MDYyNjMzMCwic3ViIjoiYVdrNWFGUzM4RnRwNzFFWXhuS3ZaMXdKRmV3ZjB2VzYtTV9zLWtCcHE1dXIiLCJ0b2tlbl90eXBlIjoibmF2aWdhdGlvbl90b2tlbiIsInJhbmRvbWl6ZXIiOiJHVVNlc00tdTRPRDlNdktodFJDU2pEcVFhUkJNeTh5dm42Q1FDUXhuLTNxMiJ9.sWo7LUEI5LeragVmeDamUR7u2myXpFJ0aqK_IIALUqI",
"navigation_token_ttl": 463,
"session_reference_token_ttl": 2924
}
| מאפיין | פורמט | תיאור |
|---|---|---|
authentication_token |
String | טוקן אימות. הפרמטר הזה נכלל כשה-iframe נוצר. לא נכלל בתשובה לבקשה ליצירת טוקנים או אם תוקף הסשן פג. |
authentication_token_ttl |
מספר | אורך חיים (TTL) של טוקן האימות בשניות. הפרמטר הזה נכלל כשה-iframe נוצר. לא נכלל בתשובה לבקשה ליצירת טוקנים או אם תוקף הסשן פג. |
api_token |
String | טוקן API. לא נכלל אם תוקף הסשן פג. |
api_token_ttl |
מספר | אורך חיים (TTL) של אסימון ה-API בשניות. לא נכלל אם תוקף הסשן פג. |
navigation_token |
String | טוקן ניווט. לא נכלל אם תוקף הסשן פג. |
navigation_token_ttl |
מספר | אורך חיים (TTL) של אסימון הניווט בשניות. לא נכלל אם תוקף הסשן פג. |
session_references_token_ttl |
מספר | אורך חיים (TTL) של הסשן בשניות. הערך יהיה 0 כשהתוקף של הסשן יפוג. כדי לשחזר את הגישה, אפליקציית ההטמעה צריכה לקבל סשן חדש. |
session:expired
Added 25.10 האירוע הזה מופעל כשפג תוקף הסשן של המשתמש שמוטמע.
type: "session:expired",
לאירוע הזה אין מטען ייעודי (payload).
session:status
האירוע נוצר כשאפליקציית Looker המוטמעת מטפלת בבקשות לטוקנים של סשנים.
{
"type": "session:status",
"session_ttl": 0,
"expired": true,
"interrupted": false
}
| מאפיין | פורמט | תיאור |
|---|---|---|
session_ttl |
מספר | אורך חיים (TTL) של הסשן בשניות. |
expired |
בוליאני | כשמופיע true, זה אומר שתוקף הסשן פג. |
interrupted |
בוליאני | כשמופיע true, זה מציין שלא הייתה תגובה לבקשה של טוקנים לסשן. יכול להיות שהמשמעות היא שהשרת לא זמין באופן זמני. |
recoverable |
בוליאני | השדה הזה מאוכלס רק אם הערך של interrupted הוא true. מציין אם אפשר לשחזר את הסשן או לא. ערך של false כנראה מצביע על בעיה באפליקציה להטמעה. |
env:client:dialog
האירוע נוצר כשנפתח חלון עזר שעשוי להיות מחוץ לתצוגה באופן חלקי, כמו חלון עזר של קידוח. האירוע הזה מאפשר לאפליקציה המארחת לגלול את תיבת הדו-שיח לתצוגה באמצעות הפעולה env:host:scroll.
{
type: "env:client:dialog",
dialogType: 'drilling',
placement: 'cover',
open: true
}
| מאפיין | פורמט | תיאור |
|---|---|---|
type |
String | env:client:dialog מציין שתיבת דו-שיח נפתחה או נסגרה. רק תיבת הדו-שיח של הפירוט נתמכת, אבל יכול להיות שבעתיד יתווספו עוד תיבות דו-שיח. יכול להיות שהחלק העליון של תיבת הדו-שיח של הניתוח לא מוצג כי תיבת הדו-שיח מכסה את אזור התצוגה של ה-iframe. האירוע הזה מאפשר לאפליקציית המארח לגלול את החלק העליון של תיבת הדו-שיח לתצוגה. |
dialogType |
String | סוג תיבת הדו-שיח. האירוע הזה מופעל רק כשפותחים או סוגרים את תיבת הדו-שיח מסוג 'פירוט'. |
placement |
String | המיקום של תיבת הדו-שיח. תיבות דו-שיח מסוג 'הסתעפות' תמיד משתמשות בערך placement cover. |
open |
בוליאני | מציין אם תיבת הדו-שיח נפתחה או שהמשתמש גלל בה. |
ביצוע שינויים ב-iframe
אחרי שמכינים את ה-iframe לאחזור נתונים, אפשר לבצע שינויים ב-iframe באופן הבא:
כתיבת הבקשה ב-JSON
אפשר לבצע כמה שינויים ב-iframe, ואז לשלוח אותו בפורמט JSON. האפשרויות הזמינות מתוארות בקטע הפניה לפעולות בדף הזה. אל תשכחו להשתמש ב-JSON.stringify כדי להפוך את הפעולה ל-JSON, כמו בדוגמה הבאה:
var my_request = JSON.stringify(
{
type: "dashboard:run"
}
);
פרסום הבקשה במאפיין contentWindow של ה-iframe
לבסוף, מפרסמים את ההודעה ב-iframe contentWindow, כך:
var my_iframe = document.getElementById("my_iframe_id");
my_iframe.contentWindow.postMessage(my_request, 'https://instance_name.looker.com');
טבלת סיכום הפעולות
בטבלה הבאה מפורטות הפעולות. בוחרים פעולה כדי לראות את הפרטים שלה.
| פעולה | תיאור הפעולה |
|---|---|
page:load |
טוען דף חדש ב-iframe, ומחליף את הדף הקיים. |
dashboard:load |
טוען לוח בקרה חדש ב-iframe, ומחליף לוח בקרה קיים. |
dashboard:run |
הפעלת מרכז הבקרה ב-iframe. |
dashboard:edit |
Added 22.20 מעבר של מרכז הבקרה אל מצב עריכה. |
dashboard:filters:update |
מעדכן מסנן קיים של מרכז בקרה ב-iframe. |
dashboard:options:set |
כתיבת ערכים חדשים לפריסת לוח הבקרה ולמאפיינים של רכיבי לוח הבקרה. |
dashboard:schedule_modal:open |
פותח את כלי התזמון, שמאפשר למשתמשים לשלוח תוכן של Looker ליעדים שונים. |
dashboard:stop |
הפעולה הזו מפסיקה את הפעולה של מרכז בקרה או את טעינת הנתונים שלו. |
look:run |
מריצה את ה-Look ב-iframe. |
look:filters:update |
מעדכן מסנן Look קיים ב-iframe. |
explore:run |
הפעלת התכונה 'אפשרויות נוספות' ב-iframe. |
explore:filters:update |
מעדכן או מסיר מסנן קיים של ניתוח ב-iframe. |
session:tokens:request |
שולח טוקנים בתגובה לאירוע session:tokens:request. |
env:host:scroll |
שולח מידע על מיקום הגלילה הנוכחי של ה-iframe המארח לאפליקציית Looker המוטמעת. |
מידע על פעולות
אלה הפעולות הזמינות שאפשר לפרסם ב-iframe המוטמע:
page:load
אפשר להשתמש בפעולה הזו כדי לנווט לתוכן חדש בתוך ה-iframe, במקום התוכן הקיים. הפעולה הזו דומה לפעולה dashboard:load, אבל היא גמישה יותר כי אפשר לציין פרמטרים נוספים בכתובת ה-URL.
יש הבדלים בהתנהגות שצריך לקחת בחשבון לפני שמשתמשים ב-page:load. dashboard:load ימנע את הניווט אם מרכז הבקרה הנוכחי נמצא בעריכה. page:load לא מונע את הניווט. אפליקציית המארח יכולה לקבוע אם מתבצעת עריכה של מרכז בקרה או של Look על ידי מעקב אחרי dashboard:edit:start, look:edit:start ואירועי סיום העריכה התואמים שלהם. לכן, מומלץ להשתמש ב-SDK להטמעה. ה-SDK להטמעה עוקב אחרי עריכה של מרכז בקרה או Look, ולכן אפשר להריץ שאילתה על החיבור כדי לראות אם התוכן נערך לפני הניווט.
{
type: 'page:load',
url: '/embed/dashboard/32?state=california,
pushHistory: false
}
| מאפיין | פורמט | תיאור |
|---|---|---|
type |
String | השימוש בסוג page:load מציין שרוצים לטעון תוכן חדש לתוך ה-iframe. |
url |
String | כתובת ה-URL של התוכן לטעינה. |
pushHistory |
בוליאני | אם true, התוכן שנטען יוצר רשומה חדשה בהיסטוריית הדפדפן, והמשתמש יכול להשתמש בלחצן 'הקודם' בדפדפן כדי לחזור לתוכן הקודם. אם הערך הוא false, התוכן הנוכחי מוחלף ואי אפשר להשתמש בניווט בדפדפן כדי לחזור אליו. |
dashboard:load
משתמשים בפעולה הזו כדי לטעון לוח בקרה חדש ב-iframe, במקום לוח בקרה קיים. לוח הבקרה החדש יתחיל להריץ שאילתות כאילו נפתח דף חדש של לוח הבקרה.
{
type: "dashboard:load",
id: "101",
pushHistory: false
}
| מאפיין | פורמט | תיאור |
|---|---|---|
type |
String | השימוש בסוג dashboard:load מציין שרוצים לטעון ל-iframe לוח בקרה חדש. |
id |
String | המזהה של לוח הבקרה שרוצים לטעון. |
pushHistory |
בוליאני | אם true, מרכז הבקרה שנטען יוצר רשומה חדשה בהיסטוריית הדפדפן, והמשתמש יכול להשתמש בכפתור 'הקודם' בדפדפן כדי לחזור למרכז הבקרה הקודם. אם false, מרכז הבקרה הנוכחי מוחלף ואי אפשר להשתמש בניווט בדפדפן כדי לחזור אליו. |
dashboard:run
אפשר להשתמש בפעולה הזו כדי להריץ את לוח הבקרה ב-iframe. זו אותה פעולה כמו לחיצה על הלחצן הפעלה או טעינה מחדש של הנתונים בלוח הבקרה.
{
type: "dashboard:run"
}
| מאפיין | פורמט | תיאור |
|---|---|---|
type |
String | שימוש בסוג dashboard:run מציין שרוצים להפעיל את לוח הבקרה. |
dashboard:edit
Added 22.20 משתמשים בפעולה הזו כדי להעביר לוח בקרה קיים ב-iframe למצב עריכה. זו אותה פעולה כמו בחירה באפשרות עריכת לוח הבקרה בתפריט לוח הבקרה.
{
type: "dashboard:edit"
}
| מאפיין | פורמט | תיאור |
|---|---|---|
type |
String | השימוש בסוג dashboard:edit מציין שרוצים להעביר את מרכז הבקרה למצב עריכה. |
dashboard:filters:update
משתמשים בפעולה הזו כדי לעדכן מסנן קיים של לוח בקרה ב-iframe. אי אפשר להוסיף מסנן חדש ללוח הבקרה באמצעות השיטה הזו.
{
type: "dashboard:filters:update",
filters: {
"Sale date": "Last 28 days",
"Sale amount": "Greater than 100"
}
}
| מאפיין | פורמט | תיאור |
|---|---|---|
type |
String | השימוש בסוג dashboard:filters:update מציין שרוצים לעדכן את המסננים שבהם נעשה שימוש בלוח הבקרה. |
filters |
אובייקט | המסננים החדשים שרוצים להחיל על לוח הבקרה. הפורמט של האובייקט הזה הוא: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...} |
dashboard:options:set
הפעולה הזו זמינה אחרי האירוע dashboard:run:complete.
הקוד להטמעה יוצר את ההודעה ושולח אותה ל-iframe, אבל לוח הבקרה לא מגיב עד שמתרחש dashboard:run:complete. הפעולה dashboard:options:set כותבת ערכים חדשים לפריסת לוח הבקרה ולמאפיינים של רכיבים בלוח הבקרה. אפשר לעדכן באמצעות dashboard:options:set רק נכסים שהוחזרו במאפיין options של אירוע dashboard:run:complete. מערכת Analytics מתעלמת מכל מאפיין שהוגדר ולא הוחזר קודם לכן על ידי מאפיין options של האירוע dashboard:run:complete.
{
type: "dashboard:options:set",
layouts: [
{
id: 1,
dashboard_id: 1,
type: "newspaper",
active: true,
column_width: null,
width: null,
deleted: false,
dashboard_layout_components: [
{
id: 1,
dashboard_layout_id: 1,
dashboard_element_id: 1,
row: 0,
column: 0,
width: 8,
height: 4,
deleted: false
},
{
id: 2,
dashboard_layout_id: 1,
dashboard_element_id: 2,
row: 0,
column: 8,
width: 8,
height: 4,
deleted: false
}
]
}
],
elements: {
1: {
title: "Total Orders",
title_hidden: false,
vis_config: {
type: "single_value",
font_size: "medium",
title: "Total Orders"
}
},
2: {
title: "Average Order Profit",
title_hidden: false,
vis_config: {
type: "single_value",
title: "Average Order Profit"
}
}
}
}
| מאפיין | פורמט | תיאור |
|---|---|---|
type |
String | השימוש בסוג dashboard:options:set מציין שרוצים לכתוב ערכים חדשים לפריסות של לוחות בקרה ולמאפיינים של רכיבים בלוחות בקרה. |
layouts |
אובייקט | מאפייני פריסת מרכז הבקרה שמוחזרים על ידי מאפיין options באירוע dashboard:run:complete. הם יהיו בפורמט דומה לזה:
|
layouts.dashboard_layout_components |
אובייקט | אובייקט אחד או יותר של רכיב פריסת לוח הבקרה שמוחזר על ידי מאפיין options באירוע dashboard:run:complete. הם יהיו בפורמט דומה לזה:
|
elements |
אובייקט | אובייקט אחד או יותר של רכיב בלוח הבקרה שמוחזרים על ידי המאפיין options באירוע dashboard:run:complete. הם יהיו בפורמט דומה לזה:id: { title: "string", title_hidden: boolean, vis_config: { type: "string", title: "string" }} |
dashboard:schedule_modal:open
הפעולה הזו מאפשרת לפתוח את הכלי לתזמון, שמאפשר למשתמשים לשלוח תוכן מ-Looker ליעדים שונים.
{
type: "dashboard:schedule_modal:open"
}
| מאפיין | פורמט | תיאור |
|---|---|---|
type |
String | השימוש בסוג dashboard:schedule_modal:open מציין שרוצים לפתוח את תיבת הדו-שיח תזמון. |
dashboard:stop
משתמשים בפעולה הזו כדי לעצור לוח בקרה שפועל או כדי לטעון מחדש נתונים. זו אותה פעולה כמו לחיצה על הלחצן ביטול בלוח הבקרה. כשמפסיקים להשתמש בלוח בקרה , נשלח אירוע עם הערך בפרמטר .dashboard:stopdashboard:run:completestatus:"stopped"
{
type: "dashboard:stop"
}
| מאפיין | פורמט | תיאור |
|---|---|---|
type |
String | שימוש בסוג dashboard:stop מציין שרוצים להפסיק את הפעלת מרכז הבקרה. |
look:run
אפשר להשתמש בפעולה הזו כדי להריץ את השאילתה שעליה מבוסס ה-Look ב-iframe. הפעולה הזו דומה ללחיצה על הלחצן הפעלה בטבלת Look, אבל ההבדל הוא ש-look:run תמיד שולפת נתונים ישירות ממסד הנתונים ולא מאחזרת נתונים ממטמון Looker.
{
type: "look:run"
}
| מאפיין | פורמט | תיאור |
|---|---|---|
type |
String | שימוש בסוג look:run מציין שרוצים להריץ את ה-Look. |
look:filters:update
משתמשים בפעולה הזו כדי לעדכן מסנן Look קיים ב-iframe. אי אפשר להוסיף מסנן חדש ל-Look באמצעות השיטה הזו.
{
type: "look:filters:update",
filters: {
"orders.created_at": "90 days",
"products.department": "sweaters"
}
}
| מאפיין | פורמט | תיאור |
|---|---|---|
type |
String | השימוש בסוג look:filters:update מציין שרוצים לעדכן את המסננים שבהם נעשה שימוש בדוח Look. |
filters |
אובייקט | המסננים החדשים שרוצים להחיל על ה-Look. הפורמט של האובייקט הזה הוא: {"view_name.field_name_1": "value 1", "view_name.field_name_1": "value 2", ...} |
explore:run
משתמשים בפעולה הזו כדי להריץ את הניתוח ב-iframe. הפעולה הזו דומה ללחיצה על הלחצן הפעלה בכלי הניתוחים, אבל explore:run תמיד שולחת שאילתות ישירות למסד הנתונים ולא מאחזרת נתונים ממטמון Looker.
{
type: "explore:run"
}
| מאפיין | פורמט | תיאור |
|---|---|---|
type |
String | השימוש בסוג explore:run מציין שרוצים להריץ את התכונה 'מה יש באזור'. |
explore:filters:update
משתמשים בפעולה הזו כדי לעדכן או להסיר מסנן קיים של ניתוח ב-iframe. אם כוללים מסנן חדש שמפנה לשדה תקין, המסנן החדש יתווסף לניתוח.
{
type: "explore:filters:update",
filters: {
"orders.created_at": "90 days",
"orders.status": "complete"
}
deleteFilters: ["products.department"]
}
| מאפיין | פורמט | תיאור |
|---|---|---|
type |
String | השימוש בסוג explore:filters:update מציין שרוצים לעדכן את המסננים שמשמשים את התכונה 'ניתוח נתונים'. |
filters |
אובייקט | המסננים החדשים שרוצים להחיל על הניתוח. אם filters כולל מסנן שלא קיים בכלי הניתוחים אבל מפנה לשדה תקין, המסנן הזה יתווסף לכלי הניתוחים. הפורמט של האובייקט הזה הוא {"view_name.field_name_1": "value 1", "view_name.field_name_1": "value 2", ...}. |
deleteFilters |
מערך | המסננים הקיימים שרוצים להסיר מהניתוח. המערך הוא בפורמט: ["view_name.field_name_1", "view_name.field_name_2", ...] |
session:tokens:request
משתמשים בפעולה הזו כדי לשלוח אסימונים בתגובה לבקשת session:tokens:request.
{
type: "session:tokens:request",
}
| מאפיין | פורמט | תיאור |
|---|---|---|
type |
String | שימוש בסוג session:tokens:request מציין שרוצים לשלוח טוקנים בתגובה לאירוע session:tokens:request. |
env:host:scroll
משתמשים בפעולה הזו כדי לשלוח מידע על מיקום הגלילה הנוכחי של ה-iframe המארח לאפליקציית Looker המוטמעת.
{
type: "env:host:scroll",
offsetTop: 10,
offsetLeft: 10,
scrollX: 5,
scrollY: 5
}
| מאפיין | פורמט | תיאור |
|---|---|---|
type |
String | השימוש בסוג env:host:scroll מציין שאתם רוצים לשלוח מידע על מיקום הגלילה הנוכחי של ה-iframe המארח לאפליקציית Looker המוטמעת. |
offsetTop |
מספר | ההיסט העליון של ה-iframe. |
offsetLeft |
מספר | ההיסט שמאלה של ה-iframe. |
scrollX |
מספר | המיקום של scrollX במארח האפליקציה. |
scrollY |
מספר | המיקום של מארח האפליקציה בציר Y של הגלילה. |