אחרי שיוצרים הטמעה – שאפשר לעשות באופן ציבורי, באופן פרטי, באמצעות הטמעה חתומה או דרך ה-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 לרשימת ההיתרים בדף Embed בחלונית Admin של Looker. כדי לעשות את זה:
בשדה רשימת ההיתרים של הדומיין המוטמע, מזינים את הדומיין שבו משתמשים ב-iframe, ואז לוחצים על מקש Tab כדי שהדומיין יופיע בתיבה בתוך השדה.
לוחצים על עדכון.
אתם יכולים להשתמש בתו הכללי לחיפוש * ברשימת ההיתרים כדי ליצור תבנית דומיין. לדוגמה, https://*.myownpersonaldomain.com יאפשר גם את https://analytics.myownpersonaldomain.com וגם את https://data.myownpersonaldomain.com.
אם אתם משתמשים בהטמעה ללא קובצי Cookie ב-Looker מגרסה 23.8 ואילך, אפשר לציין את הדומיין להטמעה כשמקבלים את הסשן ללא קובצי Cookie. זוהי חלופה להוספת הדומיין המוטמע לרשימת ההיתרים באמצעות החלונית Admin > Embed. אם אתם מחליטים להשתמש בתכונה הזו, כדאי לעיין בשיטות המומלצות לאבטחה.
אחזור נתונים מה-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 |
נוסף בגרסה 22.20
מרכז בקרה הועבר למצב עריכה. האירוע dashboard:save:complete יופעל כשמרכז הבקרה יישמר בהצלחה. |
dashboard:edit:cancel |
נוסף בגרסה 22.20 יציאה ממרכז בקרה שנמצא במצב עריכה בלי לשמור את השינויים. |
dashboard:save:complete |
מרכז בקרה נערך ונשמר. |
dashboard:delete:complete |
מרכז בקרה נמחק. |
dashboard:tile:start |
משבצת התחילה לטעון נתונים או לשלוח שאילתות לגבי נתונים. |
dashboard:tile:complete |
המשבצת סיימה להריץ את השאילתה. |
dashboard:tile:download |
התחילה הורדה של נתוני משבצת. |
dashboard:tile:explore |
משתמש לחץ על האפשרות Explore From Here (התחלת החקירה מכאן) במשבצת של מרכז בקרה. |
dashboard:tile:merge |
נוסף בגרסה 25.14 משתמש לחץ על הכפתור או על הפריט בתפריט "עריכת השאילתה הממוזגת". |
dashboard:tile:view |
משתמש לחץ על האפשרות הצגת ה-Look המקורי במשבצת של מרכז הבקרה. |
dashboard:filters:changed |
המסננים של מרכז הבקרה הוחלו או שונו. |
look:ready |
התחילה טעינה של נתוני שאילתה ב-Look, גם אם השאילתה לא תופעל. |
look:run:start |
התחילה טעינה של נתוני שאילתה ב-Look והשאילתה התחילה לפעול. |
look:run:complete |
השאילתה של Look הסתיימה. |
look:edit:start |
נוסף ב-25 באוקטובר
Look הועבר למצב עריכה. האירוע look:save:complete יופעל כשהלוק יישמר. |
look:edit:cancel |
נוסף ב-25 באוקטובר יצאתם ממצב עריכה של Look בלי לשמור את השינויים. |
look:save:complete |
טבלת Look נערכה ונשמרה. |
look:delete:complete |
ה-Look הועבר לתיקיית האשפה. |
drillmenu:click |
משתמש לחץ על תפריט פירוט בלוח בקרה שנוצר באמצעות הפרמטר link של LookML. |
drillmodal:download |
משתמש פתח תיבת דו-שיח של פירוט ממשבצת במרכז הבקרה ולחץ על האפשרות Download. |
drillmodal:explore |
משתמש לחץ על האפשרות Explore From Here (התחלת חקירה מכאן) בתיבת דו-שיח של פירוט. |
explore:ready |
התחילה טעינה של נתוני שאילתה בניתוח, בין אם השאילתה תפעל ובין אם לא. |
explore:run:start |
התחילה טעינה של נתוני שאילתה בכלי הניתוחים, והשאילתה התחילה לפעול. |
explore:run:complete |
השאילתה של הניתוח הסתיימה. |
explore:state:changed |
כתובת ה-URL של דף הניתוח השתנתה כתוצאה מפעולות המשתמש. |
merge:ready |
שאילתת מיזוג סיימה לטעון את נתוני השאילתה הראשוניים. |
merge:run:start |
התחילה הרצה של שאילתת מיזוג. |
merge:run:complete |
הסתיימה ההרצה של שאילתת המיזוג. |
merge:run:fail |
שאילתת מיזוג נכשלה והחזירה שגיאה. |
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". אחרת, הפונקציה status מחזירה את הערך "error". אם מרכז הבקרה הפעיל הופסק, דרך ממשק המשתמש או באמצעות הפעולה 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
נוסף בגרסה 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
האירוע הזה נוצר כשמשתמש לוחץ על האפשרות Explore From Here (המשך החקירה מכאן) במשבצת במרכז הבקרה.
אפשר לבטל את האירוע הזה, כלומר האפליקציה המוטמעת יכולה להחזיר את הערך {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
האירוע הזה נוצר כשמשתמש לוחץ על האפשרות הצגת ה-Look המקורי במשבצת של מרכז הבקרה.
אפשר לבטל את האירוע הזה, כלומר האפליקציה המוטמעת יכולה להחזיר את הערך {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
נוסף בגרסה 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
נוסף ב-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. האירוע הזה נוצר כשמשתמש מבצע אחת מהמשימות הבאות:
- לוחצים על הכפתור Edit כדי לערוך את ה-Look ואז לוחצים על Save.
- שומרים תבנית עיצוב באמצעות האפשרות בתפריט שמירה > שמירה בשם…
- העברת Look מתיקייה אחת לאחרת
האירוע הזה לא נוצר אם טבלת Look נשמרת באמצעות האפשרות Save (שמירה) > To existing dashboard (ללוח בקרה קיים) או Edit Settings (עריכת הגדרות) בתפריט.
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 | הערך הוא _self אם יעד הקישור יחליף את ה-iframe הנוכחי, או _blank אם יעד הקישור יפתח חלון חדש |
url |
String | כתובת ה-URL של יעד הקישור |
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 היחסית של הניתוח (הנתיב בלבד) להורדה. |
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
האירוע הזה נוצר כשמתחילה טעינה של נתוני שאילתה ב-Explore, גם אם השאילתה לא פועלת.
type: "explore:ready",
explore: {
url: "/embed/explore/...",
absoluteUrl: "https://instance_name.looker.com/embed/explore/...",
}
| מאפיין | פורמט | תיאור |
|---|---|---|
explore.url |
String | כתובת ה-URL היחסית של Explore (הנתיב בלבד) |
explore.absoluteUrl |
String | כתובת ה-URL המלאה של הכלי "ניתוחים" |
explore:run:start
האירוע הזה נוצר כשמתחילים לטעון נתוני שאילתה ב-Explore והשאילתה מתחילה לפעול.
type: "explore:run:start",
explore: {
url: "/embed/explore/...",
absoluteUrl: "https://instance_name.looker.com/embed/explore/...",
}
| מאפיין | פורמט | תיאור |
|---|---|---|
explore.url |
String | כתובת ה-URL היחסית של Explore (הנתיב בלבד) |
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 (הנתיב בלבד) |
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 (הנתיב בלבד) |
explore.absoluteUrl |
String | כתובת ה-URL המלאה של הכלי "ניתוחים" |
merge:ready
האירוע הזה נוצר כששאילתת מיזוג מסיימת לטעון את נתוני השאילתה הראשוניים.
{
type: "merge:ready",
mergeQuery: {
id: "123",
client_id: "abc"
}
}
| מאפיין | פורמט | תיאור |
|---|---|---|
mergeQuery.id |
String | המזהה של שאילתת המיזוג. |
mergeQuery.client_id |
String | מזהה הלקוח של שאילתת המיזוג. |
merge:run:start
האירוע הזה נוצר כששאילתת מיזוג מתחילה לפעול.
{
type: "merge:run:start",
mergeQuery: {
id: "123",
client_id: "abc"
}
}
| מאפיין | פורמט | תיאור |
|---|---|---|
mergeQuery.id |
String | המזהה של שאילתת המיזוג. |
mergeQuery.client_id |
String | מזהה הלקוח של שאילתת המיזוג. |
merge:run:complete
האירוע הזה נוצר כששאילתת מיזוג מסיימת להריץ את השאילתה.
{
type: "merge:run:complete",
mergeQuery: {
id: "123",
client_id: "abc"
}
}
| מאפיין | פורמט | תיאור |
|---|---|---|
mergeQuery.id |
String | המזהה של שאילתת המיזוג. |
mergeQuery.client_id |
String | מזהה הלקוח של שאילתת המיזוג. |
merge:run:fail
האירוע הזה נוצר כששאילתת מיזוג נכשלת ומחזירה שגיאה.
{
type: "merge:run:fail",
mergeQuery: {
id: "123",
client_id: "abc"
},
error: "Execution timeout"
}
| מאפיין | פורמט | תיאור |
|---|---|---|
mergeQuery.id |
String | המזהה של שאילתת המיזוג. |
mergeQuery.client_id |
String | מזהה הלקוח של שאילתת המיזוג. |
error |
String | הודעת השגיאה שמוחזרת כששאילתת המיזוג נכשלת. |
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 של מרכז הבקרה משתנה. האפשרות הזו לא זמינה ל-Look או ל-Explore, כי הגובה של הפריטים האלה מותאם אוטומטית לגודל של ה-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 |
מספר | משך החיים של אסימון האימות בשניות. נכלל כשה-iframe נוצר. לא נכלל בתשובה לבקשה ליצור אסימונים או אם פג תוקף הסשן. |
api_token |
String | טוקן API. לא נכלל אם פג תוקף הסשן. |
api_token_ttl |
מספר | משך החיים של טוקן ה-API בשניות. לא נכלל אם פג תוקף הסשן. |
navigation_token |
String | טוקן ניווט. לא נכלל אם פג תוקף הסשן. |
navigation_token_ttl |
מספר | משך החיים של אסימון הניווט בשניות. לא נכלל אם פג תוקף הסשן. |
session_references_token_ttl |
מספר | משך החיים של הסשן בשניות. הערך יהיה 0 כשתוקף הסשן יפוג. כדי לשחזר, האפליקציה המוטמעת צריכה ליצור סשן חדש. |
session:expired
נוסף בגרסה 25.10 האירוע הזה מופעל כשהסשן של המשתמש המוטמע מסתיים.
type: "session:expired",
לאירוע הזה אין מטען ייעודי (payload).
session:status
האירוע נוצר כשאפליקציית Looker המוטמעת מטפלת בבקשות לטוקנים לסשן.
{
"type": "session:status",
"session_ttl": 0,
"expired": true,
"interrupted": false
}
| מאפיין | פורמט | תיאור |
|---|---|---|
session_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 | סוג תיבת הדו-שיח. האירוע הזה מופעל רק כשפותחים או סוגרים את תיבת הדו-שיח מסוג "drilling". |
placement |
String | מיקום תיבת הדו-שיח. בתיבות דו-שיח מסוג "drilling" תמיד נעשה שימוש ב-placement מסוג "cover". |
open |
בוליאני | מציין אם תיבת הדו-שיח נפתחה או נגללה. |
ביצוע שינויים ב-iframe
אחרי שהכנתם את ה-iframe לאחזור נתונים, אתם יכולים לבצע שינויים ב-iframe לפי השלבים הבאים:
כתיבת הבקשה ב-JSON
אתם יכולים לבצע כמה שינויים ב-iframe, שאותו תשלחו בפורמט JSON. האפשרויות הזמינות מתוארות בקטע הפנייה לפעולה בדף הזה. אל תשכחו להשתמש ב-JSON.stringify כדי להפוך את הפעולה ל-JSON, כך:
var my_request = JSON.stringify(
{
type: "dashboard:run"
}
);
פרסום הבקשה במאפיין contentWindow של ה-iframe
לבסוף, מפרסמים את ההודעה ב-contentWindow של ה-iframe, כך:
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 |
נוסף בגרסה 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 |
מריץ את ה-Explore ב-iframe. |
explore:filters:update |
מעדכן או מסיר מסנן קיים של Explore ב-iframe. |
merge:run |
מריץ את שאילתת המיזוג ב-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
נוסף בגרסה 22.20 הפעולה הזו משמשת כדי להעביר מרכז בקרה קיים ב-iframe למצב עריכה. הפעולה הזו זהה לבחירה באפשרות Edit dashboard בתפריט של מרכז הבקרה.
{
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. המערכת מתעלמת מכל המאפיינים שהוגדרו ולא הוחזרו קודם על ידי המאפיין 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 מציין שרוצים לפתוח את תיבת הדו-שיח Schedule. |
dashboard:stop
הפעולה הזו משמשת כדי לעצור לוח בקרה שפועל או טוען מחדש נתונים. הפעולה הזו זהה ללחיצה על הלחצן ביטול במרכז הבקרה. מרכז בקרה שהשימוש בו הופסק באמצעות dashboard:stop שולח אירוע dashboard:run:complete עם status: שמוגדר כ-"stopped".
{
type: "dashboard:stop"
}
| מאפיין | פורמט | תיאור |
|---|---|---|
type |
String | הסוג dashboard:stop מציין שאתם רוצים להפסיק את מרכז השליטה לאימוני ריצה. |
look:run
הפעולה הזו מריצה ב-iframe את השאילתה שעליה מבוסס ה-Look. הפעולה הזו דומה ללחיצה על הלחצן Run ב-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
הפעולה הזו מריצה את ה-Explore ב-iframe. הפעולה הזו דומה ללחיצה על הלחצן Run ב-Explore, אבל explore:run תמיד שולח שאילתה ישירות למסד הנתונים ולא מאחזר נתונים ממטמון Looker.
{
type: "explore:run"
}
| מאפיין | פורמט | תיאור |
|---|---|---|
type |
String | השימוש בסוג explore:run מציין שאתם רוצים להריץ את הניתוח. |
explore:filters:update
הפעולה הזו משמשת לעדכון או להסרה של מסנן קיים ב-Explore ב-iframe. אם תוסיפו מסנן חדש שמפנה לשדה תקין, המסנן החדש יתווסף לניתוח.
{
type: "explore:filters:update",
filters: {
"orders.created_at": "90 days",
"orders.status": "complete"
}
deleteFilters: ["products.department"]
}
| מאפיין | פורמט | תיאור |
|---|---|---|
type |
String | השימוש בסוג explore:filters:update מציין שאתם רוצים לעדכן את המסננים שבהם נעשה שימוש ב-Explore. |
filters |
אובייקט | המסננים החדשים שרוצים להחיל על הניתוח. אם filters כולל מסנן שלא קיים ב-Explore אבל מפנה לשדה חוקי, המסנן הזה יתווסף ל-Explore. הפורמט של האובייקט הזה הוא {"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", ...] |
merge:run
הפעולה הזו מריצה את שאילתת המיזוג ב-iframe.
{
type: "merge:run"
}
| מאפיין | פורמט | תיאור |
|---|---|---|
type |
String | השימוש בסוג merge:run מציין שאתם רוצים להריץ את שאילתת המיזוג. |
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 |
מספר | המיקום של scrollY במארח האפליקציה. |