אירועי JavaScript מוטמעים

אחרי שיוצרים הטמעה – אפשר לעשות זאת באופן ציבורי, באופן פרטי, באמצעות הטמעה חתומה או דרך 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_domain.

אם אתם משתמשים ב-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. לשם כך, מבצעים את השלבים הבאים:

1. בשדה Embedded Domain Allowlist (רשימת הדומיינים המורשים להטמעה), מזינים את הדומיין שבו נעשה שימוש ב-iframe, ואז מקישים על מקש Tab כדי שהדומיין יופיע בתיבה בתוך השדה.

   חשוב: אל תכללו קו נטוי בסוף (/) בכתובת ה-URL של הדומיין.

2. לוחצים על עדכון.

אתם יכולים להשתמש בתו הכללי לחיפוש * ברשימת ההיתרים כדי ליצור תבנית דומיין. לדוגמה, https://*.myownpersonaldomain.com יאפשר גם https://analytics.myownpersonaldomain.com וגם https://data.myownpersonaldomain.com.

אם אתם משתמשים בהטמעה ללא קובצי Cookie ב-Looker 23.8 ואילך, אפשר לציין את דומיין ההטמעה כשמקבלים את הסשן ללא קובצי Cookie. זוהי חלופה להוספת הדומיין של ההטמעה לרשימת ההיתרים באמצעות החלונית ניהול > הטמעה. אם אתם רוצים להשתמש בתכונה הזו, כדאי לעיין בשיטות המומלצות לאבטחה.

אחזור נתונים מ-iframe

אחרי שמבצעים את שלבי ההכנה, אפשר לגשת לאירועים שמועברים בין ה-iframe של Looker לבין הדומיין שלכם על ידי האזנה לאירועים מסוג postMessage.

חשוב: כדי להימנע מהודעות זדוניות, חשוב לוודא שהאירועים הגיעו מ-iframe ומדומיין של Looker.

ה-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	Added 25.14 משתמש לחץ על הלחצן או על פריט התפריט 'עריכת שאילתה שמוזגה'.
dashboard:tile:view	משתמש לחץ על האפשרות View Original 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 בלי לשמור.
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	מערך אובייקטים	מערך של אובייקטים שמספקים את הסטטוסים של המשבצות. מאפייני האובייקט הם: ‫tileId – מספר המזהה של המשבצת. ‫status – אם השאילתה של המשבצת הופעלה בהצלחה, הפונקציה status מחזירה "complete". אחרת, הפונקציה status מחזירה "error". ‫errors — מאוכלס כשהמאפיין status הוא "error". מערך של אובייקטים שמספקים פרטים על השגיאה, כולל הטקסט של הודעת השגיאה, תיאור מפורט יותר של השגיאה ושאילתת ה-SQL של המשבצת שהובילה לשגיאה.

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

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

אפשר לבטל את האירוע הזה, כלומר אפליקציית ההטמעה יכולה להחזיר {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 האירוע הזה נוצר כשהמשתמש לוחץ על הלחצן Edit Merged Query או על פריט התפריט Edit Merged Query. התנהגות ברירת המחדל של הכפתור הזה היא פתיחת חלון חדש ברמה העליונה שמאפשר לערוך את שאילתת המיזוג.

אפשר לבטל את האירוע הזה, כלומר אפליקציית ההטמעה יכולה להחזיר {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 האירוע הזה מופעל כשעוברים ממצב צפייה במבט למצב עריכה.

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 מתיקייה אחת לתיקייה אחרת

האירוע הזה לא נוצר אם שומרים את טבלת 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

האירוע הזה נוצר כשמשתמש לוחץ על תפריט פירוט בלוח בקרה שנוצר באמצעות הפרמטר link LookML. לדוגמה, קוד ה-LookML הבא יוצר תפריט drill שבו משתמש יכול להציג נתונים שמסוננים לפי המאפיין 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 היחסית של התוכן ב-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

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

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

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 המלאה של Explore

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	מספר	אורך החיים של אסימון ה-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 מסוג 'כיסוי'.
open	בוליאני	מציין אם תיבת הדו-שיח נפתחה או שהמשתמש גלל בה.

ביצוע שינויים ב-iframe

אחרי ההכנה של ה-iframe לאחזור נתונים, אפשר לבצע שינויים ב-iframe באופן הבא:

1. כותבים את הבקשה ב-JSON.
2. פרסום הבקשה ב-iframe של contentWindow.

כתיבת הבקשה ב-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	הפעלת התכונה 'אפשרויות נוספות' ב-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. כל מאפיין שהוגדר ולא הוחזר קודם לכן על ידי מאפיין 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. הם יהיו בפורמט דומה לזה: id: "string", dashboard_id: "string", type: "newspaper", active: boolean, column_width: number, width: number
layouts.dashboard_layout_components	אובייקט	אובייקט אחד או יותר של רכיב פריסת לוח הבקרה שהוחזר על ידי מאפיין options באירוע dashboard:run:complete. הם יהיו בפורמט דומה לזה: id: "string", dashboard_layout_id: "string", dashboard_element_id: "string", row: number, column: number, width: number, height: number, deleted: boolean,
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:stop שולח אירוע dashboard:run:complete עם status: שהערך שלו הוא "stopped".

{
  type: "dashboard:stop"
}

מאפיין	פורמט	תיאור
type	String	שימוש בסוג dashboard:stop מציין שרוצים להפסיק את הפעלת מרכז הבקרה.

look:run

אפשר להשתמש בפעולה הזו כדי להריץ את השאילתה שעליה מבוסס ה-Look ב-iframe. הפעולה הזו דומה ללחיצה על הלחצן 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. הפעולה הזו דומה ללחיצה על הלחצן הפעלה בכלי הניתוחים, אבל 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 של הגלילה.